FaqTwister < DULG

---+!! Using the TAM3517 __"Twister"__ Board with ELDK 5.0
%TOC%
Installation is a somewhat complicated procedure, as we will basically
update all software components on the system, including the =U-Boot=
boot loader and it's environment settings.

*Note:* This description assumes you are using the configuration of
the =Twister+ board with a 17.8 cm (7") LCD panel.  Other LCD panel
will need both other DIP switch settings (SW3.1 ... SW3.3) and other
software settings.
---++ Download the SDCard Image
The demo image is currently available in the ="beta-eldk/twister"=
directory of the DENX FTP server.
Please contact
[[mailto:info@denx.de?subject=Please%20send%20ELDK%20Beta%20access%20data][DENX]]
for access data.
<verbatim>
$ ncftpget -u eldk-beta ftp://ftp.denx.de/twister/Twister-Demo-SDCard.img.gz
Password: ***********
Twister-Demo-SDCard.img.gz:                            638.74 MB    1.58 MB/s 
</verbatim>
---++ Install Root File System on SD-Card
   * You need a Micro-SD-Card of at least 2 GB (or bigger).
     Attach it to your host using any suitable Micro-SD-Card reader.
   * To find out as which device it was registered, run for example:
     <verbatim>
$ dmesg | tail -40
...
... kernel: [576512.948487] sd 18:0:0:2: [sdh] 3862528 512-byte logical blocks: (1.97 GB/1.84 GiB)
... kernel: [576512.953356] sd 18:0:0:2: [sdh] Write Protect is off
... kernel: [576512.953363] sd 18:0:0:2: [sdh] Assuming drive cache: write through
... kernel: [576512.955979] sd 18:0:0:2: [sdh] Assuming drive cache: write through
... kernel: [576512.955986]  sdh:
... kernel: [576512.961490] sd 18:0:0:2: [sdh] Assuming drive cache: write through
... kernel: [576512.961495] sd 18:0:0:2: [sdh] Attached SCSI removable disk
     </verbatim>
     In this case the SD-Card has been registered as ="sdh"=.
     %BR% %BR%
     *%RED%WARNING:%ENDCOLOR%* Be careful and double-check the data!
     Using the wrong device may corrupt your host computer's hard disk
     or destroy other important data!
     %BR% %BR%
     Note: Also make sure to use the whole device (i. e. ="/dev/sdX"=) and
     not for example a partition on that device (like ="/dev/sdX1"= or so).
   * Write image to SD-Card (double-check the output device name!):
     <verbatim>
$ gzip -c -d <Twister-Demo-SDCard.img.gz | sudo dd bs=512k of=/dev/sdh 
[sudo] password for wd: 
     </verbatim> 
   * Wait until the command completes. Depending on the speed of your
     system and your SD-Card this may take several minutes. Do not
     remove the SD-Card from the Reader before the command has
     completed and any LEDs or similar on your reader show that the
     SD-Card is no longer active.

---++ Prepare ="Twister"= Board
   * Make sure the ="Twister"= board is powered off.
   * Insert the SD-Card with the demo image.
   * Connect the serial console cable and the power supply to the
     ="Twister"= board as documented, and turn on the power.
   * Press ENTER (or any other key) on your keyboard as soon as you
     see the initial start messages on th console, thus interrupting
     the boot procedure, so you can enter commands at the u-boot
     prompt.
---++ Update the =U-Boot= boot loader
   * Download the =U-Boot= binary image file
     ="u-boot-32-256-nand-16.bin"= from the FTP server. Depending on
     your download tool, make sure to use binary format for download.
     <verbatim>
$ ncftpget -u eldk-beta ftp://ftp.denx.de/twister/u-boot-32-256-nand-16.bin
     </verbatim>
     Move the file to your TFTP server.
   * Download the file into the RAM of your ="Twister"= board.
     %BR%
     *Note:* You will probably have to adjust the network related
     environment settings on your board, i. e. especially the
     environment variables ="ipaddr"=, ="serverip"=, and ="netmask"=.
     <verbatim>
TAM3517 # tftp 80100000 twister/u-boot-32-256-nand-16.bin
smc911x: MAC 00:1f:7b:15:01:59
smc911x: detected LAN9220 controller
smc911x: phy initialized
smc911x: MAC 00:1f:7b:15:01:59
Using smc911x-0 device
TFTP from server 192.168.1.1; our IP address is 192.168.20.29
Filename 'twister/u-boot-32-256-nand-16.bin'.
Load address: 0x80100000
Loading: ########################################
done
Bytes transferred = 203480 (31ad8 hex)
smc911x: MAC 00:1f:7b:15:01:59
     </verbatim>
   * Update the =U-Boot= Image in NAND flash.
     %BR%
     *%RED%WARNING:%ENDCOLOR%* Be careful and double-check each
     command before executing it, and then check that no errors were
     reported. If needed, repeat all these steps from the beginning.
     Do *not* reset or turn off the board.
     <verbatim>
TAM3517 # nandecc sw
SW ECC selected
     </verbatim>
     <verbatim>
TAM3517 # nand erase ${uboot_nand_addr} 40000

NAND erase: device 0 offset 0x80000, size 0x40000
Erasing at 0xa0000 -- 100% complete.
OK
     </verbatim>
     <verbatim>
TAM3517 # nand write 80100000 ${uboot_nand_addr} 100000

NAND write: device 0 offset 0x80000, size 0x100000
 1048576 bytes written: OK
     </verbatim>
---++ Adjust the U-Boot environment settings
   * Download the script ="env-demo.img"= with environment settings
     from the FTP server. Depending on your download tool, make sure
     to use binary format for download.
     <verbatim>
$ ncftpget -u eldk-beta ftp://ftp.denx.de/twister/env-demo.img
     </verbatim>
     Move the file to your TFTP server.
   * Download the file into the RAM of your ="Twister"= board
     <verbatim>
TAM3517 # tftp 80100000 twister/env-demo.img
     </verbatim>
   * Execute the script image and save the results:
     <verbatim>
TAM3517 # source 80100000
## Executing script at 80100000
     </verbatim>
     <verbatim>
TAM3517 # saveenv
Saving Environment to NAND...
Erasing Nand...
Erasing at 0x180000 -- 100% complete.
Writing to Nand... done
     </verbatim>
   * Power off the ="Twister"= board.
---++ Select the target environment
The SDCard contains support for three different target environments:
   1 __Ångström__ distribution for embedded devices like handhelds, set
     top boxes and network-attached storage devices
   1 __Android__ smartphone operating system
   1 ELDK 5.0 __Sato__ mobile target environment based on the
     _GNOME Mobile and Embedded_ stack.
   * To select the target environment, please set DIP switch =SW3= as
     follows:
     | *Switch* | *0* | *9* | *8* | *7* | *6* | *5* | *4* | *3* | *2* | *1* |
     | Ångström | off | ON  | off | off | off | off | off | off | off | ON  |
     | Android  | off | ON  | off | off | off | ON  | off | off | off | ON  |
     | ELDK 5.0 | off | ON  | off | off | ON  | off | off | off | off | ON  |
     SW3.1 ... SW3.4: select display type
     %BR%
     SW3.5 ... SW3.7: select target environment
     %BR%
     SW3.8: select auto-update mode
     %BR%
     SW3.9 ... SW3.0: select root file system location (NAND, MMC or NFS)
   * Power on the ="Twister"= board and boot into the selected
     environment.
   * Log in on the serial console port as "root" (no password
     required)
---++ Using the ELDK Environment
   * The ELDK environment is primarily oriented for a touch screen
     operated device. Normally such devices do not show a cursor.
     For easier testing you can attach a USB keyboard and/or mouse,
     and to be able to use the mouse the cursor has be enabled.
     [This can be easily changed.]
   * If you find your touch screen is operating not reliably, you may
     want to recalibrate it.  Log in on the serial console port as
     "root" (no password needed) and enter the following commands:
     <verbatim>
root@twister:~# /etc/init.d/xserver-nodm stop
root@twister:~# ts_calibrate
     </verbatim>
     Press the crosshairs (in the 4 corners, then in the middle) on
     the LCD to calibrate the touch. It is recommended to do this
     carefully, using a suitable pin to allow for exact input.
     If you pressed a bad location, just complete the sequence and
     then re-run the ="ts_calibrate"= command.
     Once completed, restart the GUI:
     <verbatim>
root@twister:~# /etc/init.d/xserver-nodm start
     </verbatim>
   * If you ="Twister"= board is connected to a network, it will try
     to auto-configure using DHCP. If you have a working DHCP server,
     you can log in over the network using =ssh=. To find out the
     assigned IP address you can run the following command on the
     serial console port:
     <verbatim>
root@twister:~# ifconfig
eth0      Link encap:Ethernet  HWaddr 00:1F:7B:15:01:59  
          inet addr:192.168.5.218  Bcast:192.168.255.255 Mask:255.255.0.0
          inet6 addr: fe80::21f:7bff:fe15:159/64 Scope:Link
          UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1
          RX packets:186 errors:0 dropped:0 overruns:0 frame:0
          TX packets:104 errors:0 dropped:0 overruns:0 carrier:0
          collisions:0 txqueuelen:1000 
          RX bytes:18149 (17.7 KiB)  TX bytes:20407 (19.9 KiB)
          Interrupt:57 

eth1      Link encap:Ethernet  HWaddr 00:1F:7B:15:01:58  
          UP BROADCAST MULTICAST  MTU:1500  Metric:1
          RX packets:0 errors:0 dropped:0 overruns:0 frame:0
          TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
          collisions:0 txqueuelen:1000 
          RX bytes:0 (0.0 B)  TX bytes:0 (0.0 B)
          Interrupt:67 
...
     </verbatim>
     Here the network cable was attached to the left Ethernet
     connector (interface eth0). It was assigned IP address
     =192.168.5.218=.  We can login over the network like this:
     <verbatim>
$ ssh root@192.168.5.218  
...
root@192.168.5.218's password: 
root@twister:~# 
     </verbatim>
     Just press enter when prompted for the password.

Enjoy exploring the new ELDK demo on the ="Twister"= board.