PDF User Manual

  1. Home
  2. Manuals
  3. 8 devices Carambola 2 Manual

8 devices Carambola 2 Manual

Made by: 8 devices
Type: Manual
Category: Control Unit
Pages: 14
Size: 0.94 MB

 

Download PDF User Manual


Related Product Video

 

Full Text Searchable PDF User Manual



background image

 

 

 
 

 

 

 
 

 

 

 
 

 

 

 
 

 

 

 

 
 

 

 

 
 

 

Carambola 2 manual 

 
 
 
 
 

 
 

 

 


background image

Table of Contents 

Introduction ....................................................................................................................... 3 

Where to start .................................................................................................................... 5 

Install packages to your PC ........................................................................................................................................... 5 
Get latest sources .............................................................................................................................................................. 5 
Get older revision ............................................................................................................................................................. 5 
Stable version ..................................................................................................................................................................... 5 
More packages ................................................................................................................................................................... 5 
Build image ......................................................................................................................................................................... 6 

Connect using serial cable .................................................................................................. 8 

RS‐232 level ........................................................................................................................................................................ 8 
TTL 3.3V level..................................................................................................................................................................... 8 

Software ............................................................................................................................................................................... 8 

Start terminal ..................................................................................................................... 9 

Connection settings ......................................................................................................................................................... 9 

Windows .............................................................................................................................................................................. 9 
Linux minicom ................................................................................................................................................................... 9 
Linux picocom .................................................................................................................................................................... 9 
Other Linux uart settings and useful commands ................................................................................................. 9 

Set up TFTP server ............................................................................................................ 10 

Windows ........................................................................................................................................................................... 10 
Linux ................................................................................................................................................................................... 11 

Upload new firmware to Carambola 2 .............................................................................. 12 

sysupgrade ....................................................................................................................................................................... 12 
mtd ....................................................................................................................................................................................... 12 
Serial connection only ................................................................................................................................................. 12 
TFTP .................................................................................................................................................................................... 12 
Upgrading bootloader .................................................................................................................................................. 12 
Web interface / LUCI .................................................................................................................................................... 12 
Terminal programs for various OS, settings and usage examples ............................................................ 12 
Carambola2 automated flashing (linux version) .............................................................................................. 12 

Change default configuration ........................................................................................... 13 

Change Network parameters .................................................................................................................................... 13 
Cahnge default banner (welcome screen) ........................................................................................................... 13 

Appendix A Cheat sheet ................................................................................................... 14 

 

 
 

 
 

 

 


background image

Introduction 

 

8devices Carambola 2 is a member of Carambola wireless modules family and is based 

on Qualcomm/Authors AR9331 SoC. Carambola 2 is a surface mountable, single sided, 
Wi‐Fi enabled Linux module, featuring the lowest power consumption in the industry. 

Module comes bundled with an open source development board for a quick start of your 
new Internet of Things era project. 8devices is providing OpenWRT linux distribution 

source code with necessary patches on GitHub https://github.com/8devices and is 
supported by our growing community on http://www.8devices.com/community forum. 

 

 

 

Carambola 2 specification overview 
CPU  

AR9331, 400 MHz  

Memory  

16 MB SPI Flash with 64 MB DDR2 RAM  

Frequency  

2.4 GHz  

Max output power 21 dBm  

Wireless standard  802.11 bgn  

Antenna (port)  

U.FL connector  

Power supply  

3.3 V, power consumption 0.5 W  

Interfaces  

USB host/slave, serial port, 2 x Ethernet, I2S, SLIC, SPDIF, 23 x GPIO 

Size  

28 by 38 mm  

Software  

OpenWRT  

 

 

Antennas 

12dBi omni­directional antenna

  

Model: 

2400A-12

 

Gain-dBi

 

12 

Manufacturer: 

Anteny24 

 
3dBi built­in ceramic antenna

 

Model: 

ACA-5036-A2-CC-S

 

Gain-dBi

 

Manufacturer: 

INPAQ TECHNOLOGY CO., LTD. 

 

 


background image

Where to start 

 

Install packages to your PC 

sudo apt-get install subversion g++ ncurses-term zlib1g-dev gawk flex patch 
openssh-server minicom picocom tftp tftpd gettext libncurses5 libncurses5-
dev unzip quilt git git-doc git-gui  

Get latest sources 

git clone https://github.com/8devices/carambola carambola cd carambola 

Get older revision 

For some reason you might wish to get older source revision. To see available tags execute these commands:  

git tag -l 

You should see something like this  

carambola/v1.0 carambola/v1.1 carambola/v1.1-rc1 carambola/v2.0 
carambola/v2.0-rc1 carambola/v2.1 carambola/v2.1-rc1 carambola/v2.1-rc2 
carambola/v2.2-rc1 carambola/v2.3-rc1 

In order to get older version, type this command (but this should be rare case)  

git checkout carambola/v1.0 

Stable version 

At this point (2012-11-11) stable version is carambola/v2.3-rc4. To get this version type command:  

git checkout carambola/v2.3-rc4 

More packages 

Edit file:  

vi feeds.conf.default  
src-git packages git://github.com/8devices/packages.git #src-git luci 
https://github.com/8devices/luci.git src-git luci src-git 
git://nbd.name/luci.git #src-svn packages 
svn://svn.openwrt.org/openwrt/packages src-svn xwrt http://x-
wrt.googlecode.com/svn/trunk/package #src-svn luci 
http://svn.luci.subsignal.org/luci/trunk/contrib/package #src-svn phone 
svn://svn.openwrt.org/openwrt/feeds/phone #src-svn efl 
svn://svn.openwrt.org/openwrt/feeds/efl #src-svn xorg 
svn://svn.openwrt.org/openwrt/feeds/xorg #src-svn desktop 
svn://svn.openwrt.org/openwrt/feeds/desktop #src-svn xfce 
svn://svn.openwrt.org/openwrt/feeds/xfce #src-svn lxde 
svn://svn.openwrt.org/openwrt/feeds/lxde #src-link custom 
/usr/src/openwrt/custom-feed 

Type  

./scripts/feeds update -a ./scripts/feeds install -a 

I suppose you would also like to add 

luci

.  

 


background image

Build image 

If you wish you can change kernel settings, but at this time skip this step.  

make kernel_menuconfig 

Type  

make menuconfig 

You should see configuration window like this:  

 

Let's leave everything untouched for now and and exit.  

Type  

make  

for standard building procedure or  

make -j 2 

if you want to use more than 1 thread and you have more than 1 CPU core on your system. This process takes 
long time (it took ~1 hour on 4 core machine) or  

make V=99 

 


background image

if you need or want to see more details.  

You should see build log like this:  

 

Or if you feel really advanced, you can get email notification upon completing build proces. For this you need to 
install and configure 

email client

. After you are done, type this long command:  

date > /tmp/text.txt; make -j 2 >> /tmp/text.txt; date >> /tmp/text.txt; 
mail -s "done" email_where_to_send_report@server.com < /tmp/text.txt 

If you wish to observe current progress on computer, type in another console  

tail -f /tmp/text.txt 

 

 
 

 

 


background image

Connect using serial cable 

 

RS‐232 level 

It is best to connect to carambola using standard RS-232 male cable. Just plug cable to carambola, set 115200 
8N1 settings without hardware flow control and power up your carambola.  

TTL 3.3V level 

However, if you have TTL level USB to serial converter, you should do some soldering.  

Remove J9 and J10 jumpers and connect FTDI 3.3V TTL serial to USB cable. J9.1 – RX(input), J10.1 – 
TX(output). I used FTDI 3.3V USB to serial converter.  

 

Software 

You can use any 

terminal

 program you wish to communicate.  

 
 

 

 

 


background image

Start terminal 

 

Connection settings 

• 

115200 8N1, no hardware flow control. 

Windows 

I recommend using 

V-term32

 (no need to install just unzip and run) or 

TeraTerm

 program.  

Linux minicom 

TODO  

Linux picocom 

picocom -f n -p n -b 115200 -i -r -l /dev/ttyUSB0 
picocom -b 9600 /dev/ttyUSB0 

• 

Picocom 

man

 

• 

To exit, press and hold CTRL, A, Q. 

Other Linux uart settings and useful commands 

If you do not have installed stty you should get it by typing  

opkg install coreutils-stty 

To set options:  

stty -F /dev/ttyUSB0 cs8 9600 ignbrk -brkint -icrnl -imaxbel -opost -onlcr 
-isig -icanon -iexten -echo -echoe -echok -echoctl -echoke noflsh -ixon -
crtscts 

To get options:  

stty -a -F /dev/ttyUSB0 

To read from device  

tail -f /dev/ttyUSB0 

 

 

 
 

 

 

 


background image

Set up

Windo

You can 

Enable T

p TFTP se

ws 

set up TFTP s

TFTP server. Y

erver 

server very qu

Your settings s

uickly using 

T

should look li

TFTP32

 sofwa

ke:  

 

are. It is free. 

 

 


background image

Linux 

If you wish, you can use linux machine to do the same task.  

sudo apt-get install xinetd tftpd tftp 
sudo touch /etc/xinetd.d/tftp 
sudo nano /etc/xinetd.d/tftp 

Paste this code:  

service tftp {  protocol = udp  port = 69  socket_type = dgram  wait = yes  
user = nobody  server = /usr/sbin/in.tftpd  server_args = /home/tftpboot  
disable = no } 
sudo mkdir /home/tftpboot 
sudo chmod -R 777 /home/tftpboot 
sudo chown -R nobody /home/tftpboot 
sudo service xinetd restart 

 
 

 
 

 

 

 


background image

Upload new firmware to Carambola 2 

 

This topic covers few methods how to upgrade firmware on Carambola. Some methods require only serial 
connection, some only LAN, some LAN and Serial. Also you might need to install/setup other software to 
perform these tasks.  

sysupgrade 

sysupgrade

 is best ever way to upgrade firmware. For this to work you must be connected to Carambola 

terminal. It does not matter using Serial, LAN ir Wireless connection.  

mtd 

mtd

 method is similar to sysupgrade. Use any one you like.  

Serial connection only 

Using 

serial

 cable is most dangerous one. There many things that can go wrong. Ensure you have good serial 

cable (cheaper usb-serial adapters don't work), rock solid power supply and steel nerves :)  

TFTP 

TFTP

 method to upgrade firmware requires you serial connection to Carambola and configured TFTP server 

over LAN. Wireless connection does not work.  

Upgrading bootloader 

If for some reason you have older bootloader and wish to upgrade, you must proceed 

here

. It is even more 

dangerous than upgrading firmware using serial connection only. If something fails, there are big chances you 
render your module useless.  

Web interface / LUCI 

This method is recommended for novices. Connect Carambola web interface, browse for firmware upgrade, 
select file and press upgrade.  

Terminal programs for various OS, settings and usage examples 

terminals

 

Carambola2 automated flashing (linux version) 

Pyton based flash utility for Carambola2

 

 
 

 

 

 


background image

Change default configuration 

 

Change Network parameters 

Edit:  

carambola/target/linux/ramips/base-files/etc/config/network 

Cahnge default banner (welcome screen) 

Change welcome screen example

 

Edit:  

carambola/package/base-files/files/etc/banner 

 

 

 

 


background image

Appe

 

If you are

 

 

eet 

where to start,, reading this flow chart mig

ght be helpfull.

 

 


background image

 
FCC Warning Statement:
Any Changes or modifications not expressly approved by the party responsible for compliance could 
void the user's authority to operate the equipment. 
This device complies with part 15 of the FCC Rules. Operation is subject to the following two 
conditions: 
(1) This device may not cause harmful interference, and (2) this device must accept any interference 
received, including interference that may cause undesired operation. 
This equipment has been tested and found to comply with the limits for a Class B digital device, 
pursuant to Part 15 of the FCC Rules. These limits are designed to provide reasonable protection 
against harmful interference in a residential installation. This equipment generates uses and can 
radiate radio frequency energy and, if not installed and used in accordance with the instructions, may 
cause harmful interference to radio communications. However, there is no guarantee that interference 
will not occur in a particular installation. If this equipment does cause harmful interference to radio or 
television reception, which can be determined by turning the equipment off and on, the user is 
encouraged to try to correct the interference by one or more of the following 
measures: 
Reorient or relocate the receiving antenna. 
Increase the separation between the equipment and receiver. 
Connect the equipment into an outlet on a circuit different from that to which the receiver is connected. 
Consult the dealer or an experienced radio/TV technician for help. 
 

FCC Radiation Exposure Statement 

This equipment complies with FCC radiation exposure limits set forth for an 

uncontrolled environment. This equipment should be installed and operated with 
minimum distance 20cm between the radiator includeantennaand your body. 

 

Labeling requirement 

The Host device of OEM integrator must be labeled with ‘Contains FCC ID: Z9W‐CM2’ 

 

IC warning 

This device complies with Industry Canada licence-exempt RSS standard(s). 
Operation is subject to the following two conditions: 
(1) This device may not cause interference and (2) this device must accept any interference, 
including interference that may cause undesired operation of the device. 
 
Le présent appareil est conforme aux CNR d'Industrie Canada applicables aux appareils radio exempts de 
licence.L'exploitation est autorisée aux deux conditions suivantes : 
(1) l'appareil ne doit pas produire de brouillage, et 
(2) l'utilisateur de l'appareil doit accepter tout brouillage radioélectrique subi, même si le brouillage est 
susceptible d'en compromettre le fonctionnement. 
 
Under Industry Canada regulations, this radio transmitter may only operate using an antenna of a 
type and maximum (or lesser) gain approved for the transmitter by Industry Canada. To reduce 
potential radio interference to other users, the antenna type and its gain should be so chosen that the 
equivalent isotropically radiated power (e.i.r.p.) is not more than that necessary for successful 
communication. 
This radio transmitter (identify the device by certification number, or model number if Category II) has 
been approved by Industry Canada to operate with the antenna types listed below with the maximum 
permissible gain and required antenna impedance for each antenna type indicated. Antenna types not 
included in this list, having a gain greater than the maximum gain indicated for that type, are strictly 
prohibited for use with this device.