user manual
Contents
1. Figure 1 8 Packages selection 12 AAA EVIDENCE Chapter 1 Build 1 1 Create a custom filesystem To add some external files into target filesystem you can put them into HOME ev sdk workspace evelin bsp binaries directory and type sb2 t imx25 make create_filesystem The new file filesystem jffs2 in mages directory will contain the additional files inserted IMPORTANT manually modifying the filesystem romfs directory could produce a bad filesystem image Please do not add or remove files from this directory 13 2 Connecting to the device 2 1 Serial connection To open a console on the GEAM6425 board which does not have a keyboard you need use a remote serial communication program running on a host machine To connect to the device follow the next steps 1 Connect a serial cable to the serial interface of the target and to your PC 2 Start your favorite terminal tool e g Hyperterminal Putty Minicom Kermit and set the following parameters Speed bps 115200 Parity None Data Bits 8 Stop Bits 1 Flow Control Xon Xoff 2 2 File transfer The target runs a minimal FTP server for file transfers To transfer files e g applica tions to the target follow the next steps 1 Connect to the target as explained in Section 2 1 Then on the target run the ifconfig tool to know the IP address of the device 2 On a PC run your favorite FTP client to connect to the devi2. lt gt for Help Legend built in excluded lt M gt module lt gt module capable lt Exit gt lt Help gt Figure 1 5 ccache selection Arrow keys navigate the menu lt Enter gt selects submenus gt Highlighted letters are hotkeys Pressing lt Y gt includes lt N gt excludes lt M gt modularizes features Press lt Esc gt lt Esc gt to exit lt gt for Help Legend built in excluded lt M gt module lt gt module capable Default usybox utomation gt evelopment gt N twork gt raphics gt oad an Alternate Configuration File ave Configuration to an Alternate File lt Exit gt lt Help gt Figure 1 6 Busybox and filesystem selection 11 AJA EVIDENCE Chapter 1 Build Use the arrow keys to navigate this window or press the hotkey of the item you wish to select followed by the lt SPACE BAR gt Press lt gt for additional information about this option ustom lt Help gt Figure 1 7 Busybox configuration Arrow keys navigate the menu lt Enter gt selects submenus gt Highlighted letters are hotkeys Pressing lt Y gt includes lt N gt excludes lt M gt modularizes features Press lt Esc gt lt Esc gt to exit lt gt for Help Legend built in excluded lt M gt module lt gt module capable libqt QT 4 X embedded libraries slib touch screen library lt Exit gt lt Help gt
3. ta r ES 22 RE 22 53 INE kerjel a hee eee eee eRe ee So E 23 5 3 1 External kernel modules 8 22h 44 ee oc ES 23 Dod Td Pa eT o ee ERR EEE SRE See RE SES 23 AE 24 5 4 1 Running applications 2 404224 28 bee e reta ess 24 5 5 Serial interfaces o eocnor rosana a A 24 AOL OO a Gow a RA AA ee HR Oe 24 5 6 Busybox specific commands 000 0 eee eee eee 24 SE Boot eS gopa ER eR dee WOOK be eG 24 ie Tene oe ee ee es ca o dd ai 24 Too IP addres ra E Ee ee Ow 25 6 Technical support 26 List of Figures 1 1 Sereenshot of make mennconfig cis o e RK A RH 9 ee TE O aaa eK Ree ES Ee a E A 9 1 3 Kernel pateh selection 4 4 45 45 2224450 8 bb Oe eRe eee 10 LA kermel screw cbs kee bawidbrewtdbin Pi adh Od ES 10 Tay CORRS PUSO e ca AAA ee he RES Dd HO 11 1 6 Busybox and filesystem selection 000000 ee eae 11 17 Busybos connguration lt lt he eR eee Ee EES BEERS 12 1 8 Packages selection 2 45024 eae PR a ee es 12 2L Were PENE ce ek hs HE Bk ea Boh we a E RS ed 15 2 2 VMware network configuration menu 0 16 About this document This document contains the instructions to compile the Evelin BSP for the GEAM6425 GEA4LAN boards Evelin which stands for Evidence Embedded Linux is the Linux distribution for embedded systems created provided and maintained by Evidence Srl The purpose of this document is to provide information about the usage of the envi ronment to d
4. time e Complete source code Notice that the Evelin BSP is meant to be compiled only using the Evelin SDK 3 environment provided by Evidence 1 Build In this chapter we will build a Linux distribution for the GEAM6425 board The same steps can be repeated for the GEA4LAN board with few differences To build the Linux distribution for the GEAM6425 board follow the next steps 1 Install Evelin SDK on your Linux distribution or run the virtual machine contain ing the development environment Please refer to the Evelin SDK User s manual 3 for further information 2 Enter the directory containing the source code cd ev sdk workspace evelin bsp 3 Put into the binaries directory any additional file you want to be present in the filesystem 4 Configure the system sb2 t imx25 make menuconfig The screenshot shown in Figure 1 1 will appear 5 Select the Vendor Product Selection menu Use the following settings Vendor imx25 Board GEAM6425 as shown in Figure 1 2 6 Select the Kernel Configuration menu Use the following settings Default Kernel default selections Apply PREEMPT_RT patch as shown in Figure 1 3 and Figure 1 4 7 If you want to use the ccache option during compilation select the Compiler cache ccache Selection and check Use ccache as show in Figure 1 5 AAs EVIDENCE Chapter 1 Build 8 9 10 11 12 13 14 Do not change the settings for the Toolc
5. www evidence eu com This document is Copyright 2005 2010 Evidence S r l Information and images contained within this document are copyright and the property of Evidence S r l All trademarks are hereby acknowledged to be the properties of their respective owners The information text and graphics contained in this document are provided for information purposes only by Evidence S r l Evidence S r l does not warrant the accuracy or completeness of the information text and other items contained in this document Matlab Simulink Mathworks are registered trademarks of Matworks Inc Microsoft Windows are registered trademarks of Microsoft Inc Java is a registered trademark of Sun Microsystems in the USA and other countries and are used under license All other trademarks used are properties of their respective owners This document has been written using IXTFX Contents 1 Build 7 1 1 Create a custom filesystem sec 6a we pve o we 13 2 Connecting to the device 14 oh Sere CONOR 2 chs ek eh ee eM we ON Ew ON he OHS 14 22 Pie Gee cr smp ee RRR DRED RS A 14 Oy TPT ie oscar rr EE SE EEE SESH ESLER SRS 15 BO NEG AE 15 3 Flashing 17 4 Usage of ATK 19 4 1 How to use ATK to restore U Boot 19 4 2 How to use ATK to flash Linux and filesystem 21 5 Further commands 22 OL Pere eee PARKERS ARE Eee hee BS ee 22 DL MAG Gees cc be we ok ba Pon be eRe we eR 22 Sia NFS mont ca ee eni par OS pu ea pa niia
6. BATES Embedded Linux distribution for GEAM6425 GEA4LAN User s manual Version 3 0 March 4 2011 AA AS AAs EVIDENCE About Evidence S r l Evidence is a company operating in the field of software for embedded real time systems It started in 2002 as a spin off company of the Real Time Systems ReTiS Lab of the Scuola Superiore Sant Anna Pisa Italy Today Evidence is a dynamic company having collaborations in the field of electronics telecommunications automotives and industrial automation People at Evidence are experts in the domain of embedded and real time systems with a deep knowledge on the design and specification flow of embedded software especially for the embedded market Besides providing consultancy services Evidence also provides BSPs based on Linux for embedded devices evaluation boards featuring most innovative 8 16 and 32 bit microcontrollers for the embedded market development tools for making embedded software development easier and tools for the schedulability analysis of real time tasks running on your final product Contact Info Evidence Srl Via Carducci 56 Localit Ghezzano 56010 S Giuliano Terme PISA Italy Tel 39 050 99 11 224 Fax 39 050 99 10 812 For more information about Evidence products please send an e mail to the follow ing address info evidence eu com Other information about the Evidence product line can be found at the Evidence web site at http
7. EAM6425 board The device connected to this interface is dev ttymxc2 Just use common userspace system calls e g open read write to access the device 5 6 Busybox specific commands This Section contains a list of commands available only on the minimal distribution the one containing Busybox They are different in the full Debian distribution 5 6 1 Boot programs On the target the programs started at boot are located in the etc init d directory The directory contains a set of scripts Scripts that starts with a S are executed during the boot Script that starts with a K are executed at shutdown 5 6 2 Telnetd On the device a telnet server i e telnetd provided by Busybox is running To access the device through telnet however an account must be created using the serial interface For security reasons in fact it is not allowed to access the device through telnet using the existing root account Usually the new account is called anonymous See 5 2 for information about creating a new account 24 AAA EVIDENCE Chapter 5 Further commands 5 6 3 IP address On the board a DHCP client is started at boot time If you prefer to have a static IP address follow the next steps l Connect to the board through a serial cable Open the etc init d S11 network script Comment the line containing udhcpc Set the static IP address using the ifconfig command see the example in the script its
8. atus H Memory 1024 MB mc Processors a Connect at power on E Hard Disk SCSI 40 GB 2 CD DVD IDE Auto detect Network Connection ty Network Adapter Bridged q Bridged Connected directly to the physical network amp USB Controller Present M Sound Card Auto detect O Replicate physical network connection state Printer Present NAT Used to share the host s IP address W Display Auto detect Host only A private network shared with the host 0 Hep 9 cancel 2 save Figure 2 2 VMware network configuration menu 1 Open a terminal console and type sudo vi etc exports 2 Add a line at the end of file like nfs_gea lt network address gt lt network mask gt rw sync no_root_squash where e network address is the address of your local network e network mask is the mask of your local network 16 3 Flashing On the NAND of the board binaries are located at the following addresses Address Size Content 0x0000000 OxOOFFFFF u boot bin 0x0100000 0x02FFFFF uImage 0x0400000 Ox3BFFFFF filesystem jffs2 To flash the system follow the next steps LL 2 Compile the firmware as explained in Chapter 1 Put the images created in the images directory on a working TFTP server Connect a serial cable to the target and start a terminal program as explained in Chapter 2 Reboot the board At the U Boot prompt press a key to stop the automatic boot seque
9. ce whose IP address has been discovered in the previous step For instance run ftp target_1p_address 14 AAA EVIDENCE Chapter 2 Connecting to the device Note the FTP server does not support authentication thus there is no need of id and passwords 2 3 TFTP transfer If you run a VMware machine you need to setup the TFTP server for export its service on the network For do this follow the next steps 1 Open VMware Player and select the evelin bsp machine image 2 On menu select Virtual Machine Virtual Machine Settings as shown in Fig ure 2 1 3 For Network Adapter select Bridged Connected directly to the physical network and press Save as show in Figure 2 2 4 Login into VMware machine and get the IP address of your Ethernet interface if DHCP isn t present on network set your own IP address with ifconfig command 5 The IP address of the VMware machine is the serverip value to set in target s U Boot On VMware machine the default location of TFTP directory is tftp_boot The files generated by the compile process have to be copied into this directory bd VMware Player File Virtual Machine Help A Virtual Machine Settings Ctri D mo gt i Power gt Figure 2 1 VMware settings menu 2 4 NFS To setup a NFS on your VMware machine follow the next steps 15 RAA EVIDENCE MESON SATEGUN DLGS Chapter 2 Connecting to the device Hardware Options Device St
10. elf Set the gateway using the route command see the example in the script itself 25 6 Technical support A mailing list exists to join the users community or to ask technical questions about the Linux distribution To join the mailing list visit the following URL http ml tux embedded com mailman listinfo evelin gea The URL also contains a useful public archive of the messages sent on the mailing list Important please remember that the official language of the list is English so do not post messages in different languages 26 Bibliography 1 Busybox The Swiss Army Knife of Embedded Linux http www busyboz net 2 Das U boot The Universal Bootloader http sourceforge net projects u boot 3 Evidence Srl Evelin SDK User s manual 27
11. evelopers who are going to use it Acronyms BSP Board Support Package SDK Software Development Kit Description of the software The Evelin BSP provided by Evidence contains e Build scripts for automatic generation of initial firmware images e The Das U Boot 2 bootloader Das U Boot is an Open Source universal cross platform bootloader supporting hundreds of embedded boards and a wide variety of CPUs the one of GEA included e The Linux kernel 2 6 31 with JFFS2 support and drivers for the GEAM6425 GEA4LAN boards e JFFS2 filesystem containing Busybox 1 with network support Modbus communication protocol for automation GNU Compiler Collection for C C Objective C Objective C Fortran and Java ScicosLab a GTK version of Scilab AAA EVIDENCE i List of Figures QT graphical libraries Tslib library for the touchscreen support Boa webserver FTP and Telnet servers Dropbear for SSH connections Network utilities like tc iproute and tcng for traffic shaping Python support Gambas support SMTP mail client Samba client Mplayer for multimedia applications Irzsz Unix communication package for XMODEM YMODEM and ZMODEM file transfer protocols dpkg apt and aptitude support for handling of packages Postgres SQL database VNC and LXDE e Around 1 5 GB of Debian packages that can be chosen at compile time or installed at run
12. hain Path Selection option Select Exit and save the current settings The system will build the next menu Select the Simple System option as show in Figure 1 6 1 Select the Default Busybox menu Use the following settings X Default Custom as shown in Figure 1 7 Select Graphics and choose the packages needed as shown in Figure 1 8 Note that you need both QT Libraries and Touchscreen to run graphical applications Exit from the menuconfig environment Then type sb2 t imx25 make At the end of the compilation the images directory will contain the following files e u boot bin binary image of the U Boot bootloader e ulmage binary image of the Linux kernel in U Boot format e filesystem jffs2 Linux filesystem in JFFS2 format EVIDENCE A oo Chapter 1 Build Arrow keys navigate the menu lt Enter gt selects submenus gt Highlighted letters are hotkeys Pressing lt Y gt includes lt N gt excludes lt M gt modularizes features Press lt Esc gt lt Esc gt to exit lt gt for Help Legend built in excluded lt M gt module lt gt module capable ernel Configuration gt ompiler cache ccache Selection gt oolchain Path Selection gt oad an Alternate Configuration File ave Configuration to an Alternate File Esitlie lt Exit gt lt Help gt Figure 1 1 Screenshot of make menuconfig Arrow keys navigate the menu lt Enter gt selects submenus g
13. nce On the U Boot prompt set the TF TP IP address using the following command set serverip lt IP address gt On the U Boot prompt set a static IP address for the board through the following command set ipaddr lt IP address gt Transfer the U boot image and flash it through the following commands nand erase 000000 FFFFF tftp u boot bin nand write 0x81000000 00000 100000 If U Boot does not start anymore or you have to flash it for the first time see Section 4 1 17 AAA EVIDENCE Chapter 3 Flashing 9 Transfer the Linux kernel and flash it through the following commands nand erase 100000 300000 t tp ulmage nand write 0x81000000 100000 300000 10 Transfer the filesystem and flash it through the following commands nand erase 400000 F7FFFFF tftp filesystem jffs2 nand write 0x81000000 400000 filesize 11 Reboot the board 18 4 Usage of ATK ATK is a utility running on Microsoft Windows and developed by Freescale to flash images on the board using a USB cable Notice that this utility has been developed by Freescale not by Evidence hence you have to refer to Freescale for any technical issue Currently ATK does not support the Microsoft Windows 7 64 bit operating system ATK can be run also on Linux through the wine emulator To run ATK you need to install wine and create a link to the serial console in the wine dosdevices directory e g ln s dev ttyUSBO com1 4 1 How to use ATK
14. t Highlighted letters are hotkeys Pressing lt Y gt includes lt N gt excludes lt M gt modularizes features Press lt Esc gt lt Esc gt to exit lt gt for Help Legend built in excluded lt M gt module lt gt module capable Select the Vendor you wish to target imx25 endor Select the Board you wish to target GEAM6425 oard ESTER lt exit gt lt Help gt Figure 1 2 Target selection EVIDENCE BAD aan Chapter 1 Build Arrow keys navigate the menu lt Enter gt selects submenus gt Highlighted letters are hotkeys Pressing lt Y gt includes lt N gt excludes lt M gt modularizes features Press lt Esc gt lt Esc gt to exit lt gt for Help Legend built in excluded lt M gt module lt gt module capable Default Kernel default selections pply PREEMPT RT patch lt Exit gt lt Help gt Figure 1 3 Kernel patch selection Use the arrow keys to navigate this window or press the hotkey of the item you wish to select followed by the lt SPACE BAR gt Press lt gt for additional information about this option ustom BIES lt hHelp gt Figure 1 4 Kernel configuration 10 EVIDENCE A oo Chapter 1 Build Arrow keys navigate the menu lt Enter gt selects submenus gt Highlighted letters are hotkeys Pressing lt Y gt includes lt N gt excludes lt M gt modularizes features Press lt Esc gt lt Esc gt to exit
15. the following parameters e setenv fec_addr 00 00 00 00 00 01 e setenv serverip lt IP address of TFTP server gt e setenv ipaddr lt IP address of board e setenv ethprime fec e setenv ethaddr 00 50 C2 A0 E0 3E e setenv netdev eth0 20 AAA EVIDENCE Chapter 4 Usage of ATK e for 3 5 board setenv bootargs console ttymxc0 115200 root dev mtdblock2 rootfstype jffs2 video mxcfb 320x240 16bpp Var QVGA for 7 board setenv bootargs console ttymxc0 115200 root dev mtdblock2 rootfstype jffs2 video mxcfb 800x480 16bpp Amp WD e Save e reset 4 2 How to use ATK to flash Linux and filesystem With ATK is also possible to flash ulmage and filesystem jffs2 images using the appro priate addresses specified in Chapter 3 i e 0x0100000 for ulmage and 0x0400000 for filesystem jffs2 Important remember to insert the jumper and to use the Erase command before using the Program command otherwise the NAND will not be flashed correctly If you want to erase the whole flash just specify Address 0x00000000 and Size 0x10000000 21 5 Further commands 5 1 Networking 5 1 1 MAC address To set the MAC address on U Boot type setenv fec_addr lt MAC address gt For instance to set the MAC address equal to 00 00 00 00 00 01 type setenv fec_addr 00 00 00 00 00 01 5 1 2 NFS mount To mount a directory available on a NFS server on a target s local directory type on Linux mount t nfs o nfsvers 3 nolock lt server IP gt lt ser
16. to restore U Boot In case U Boot does not start for some reason you need to flash it using the i MX Advanced Tool Kit ATK located in the atk directory ATK is a Freescale software working only under Windows XP OS To flash U Boot use the following procedure 1 Insert the jumper JM2 in the geaM6425 board 2 Install ATK on Windows using the FSL_ATK_TOOL_WINS_STD_INSTALL_xxx exe file 3 Connect the USB OTG device of the board to the USB interface of the PC 4 Start ATK on Windows 5 Select the following values e IMX CPU i MX25_T01 1 architecture e Device Memory Initial DDR2 memory type e Host Setting USB port 6 Press Next select Flash Tool and than press Go 19 AAA EVIDENCE Chapter 4 Usage of ATK 7 In the flash tool utility select e Flash Model Custom Model and provide the mx25_nand bin file e Operation Type Erase e Address 0x0000000 e Size OXOOFFFFF 8 Press Erase on the right side of the window 9 In the flash tool utility select e Flash Model Custom Model and provide the mx25_nand bin file e Operation Type Program and check read back check option e Address 0x00000000 e Image File provide the uboot bin file 10 Press Program on the right side of the window 11 Wait until the entire process finish and check if Flash program successfulis reported 12 Remove the jumper JM2 from the board 13 Restart the board Once the board is restarted enter in the u boot menu typing ENTER on boot and insert
17. ver directory gt lt target directory gt 5 2 Users To add a new user on Linux type adduser lt name gt This will automatically create the etc shadow file Use the command passwd lt name gt to set the password 22 AAA EVIDENCE Chapter 5 Further commands 5 3 Linux kernel 5 3 1 External kernel modules To build a kernel module located in a directory different than the directory containing the Linux kernel enter the directory containing the module and type sb2 t imx25 make C HOME ev sdk workspace evelin bsp linux linux 2 6 31 geaM6425 M pwd modules 5 3 2 tc and tcng support To use the tc and tcng tools the Linux kernel must be compiled with the following options enabled in the config file CONFIG_NETFILTER y CONFIG_NETFILTER_ADVANCED y CONFIG_NETFILTER_NETLINK y CONFIG_NETFILTER_NETLINK_QUEUE y CONFIG_NET_SCHED y CONFIG_NET_SCH_CBQ y CONFIG_NET_SCH_HTB y CONFIG_NET_SCH_PRIO y CONFIG_NET_SCH_SFQ y CONFIG_NET_SCH_DSMARK y CONFIG_NET_SCH_INGRESS y CONFIG_NET_CLS y CONFIG_NET_CLS_BASIC y CONFIG_NET_CLS_TCINDEX y CONFIG_NET_CLS_FW y CONFIG_NET_CLS_U32 y CONFIG_NET_CLS_ACT y CONFIG_NET_ACT_POLICE y CONFIG_NET_SCH_FIFO y 23 AAA EVIDENCE Chapter 5 Further commands 5 4 QT 5 4 1 Running applications To run QT applications on the target programs need the qws parameter i e run in local mode 5 5 Serial interfaces 5 5 1 RS485 A R5S485 serial interface is available on the G
Download Pdf Manuals
Related Search