8 devices Carambola 2 User manual



























Carambola2manual








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






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 power21 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 3
Manufacturer：INPAQ TECHNOLOGY CO., LTD.


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.

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

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 protected] < /tmp/text.txt
If you wish to observe current progress on computer, type in another console
tail -f /tmp/text.txt




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.




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






Setu
p
Windo
You can
Enable
T
p
TFTPs
e
ws
set up TFTP
s
T
FTP server.
Y
e
rver
s
erver very q
u
Y
our settings
s
u
ickly using
T
s
hould look li
T
FTP32 sofw
a
ke:
a
re. It is free.

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




