Home

Linux Development Environment User Guide

1. Telit Development Platform Setup Completing the Telit Development Platform Setup Wizard Thank you for installing the Telit Development Platform Click Finish time to change the IP addresses of the development environment refer to Appendix A for As previously explained if you already have in your system the 192 168 121 0 network it is a further details Go to Network Connections right click on the device called TAP Win32 Adapter V8 and choose the menu voice Properties Select the Internet Protocol TCP IP and click on the button properties you should see the following window m i L Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 24 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 Internet Protocol TCP IP Properties You can get IP settings assigned automatically if your network supports this capability Otherwise you need to ask your network administrator for the appropriate IP settings Obtain an IP address automatically Use the following IP address IP address 192 168 121 1 Subnet mask Default gateway Prefered DNS server Alttemate DNS server If this configuration is not available you have to manually insert the following values IP address 192 168 121 1 Subnet mask 255 255 255 0 then click Ok Go to Start menu All Programs Telit Developmen
2. view Favorites Tools Z Telit Development Environment User Guide for PRO3 with Linux Advanced Help Search Key Folders Eii 1vv0300780 Rev 2 21 05 09 DEK ae Address Network Connections Network Tasks Create a new connection Change Windows Firewall settings Other Places G Control Panel My Network Places My Documents 4 My Computer Details 2 items selected 1 v Ej L ocal 4rea Connection 6 P Connected aia nx USB Ethernet RNDIS Ga Bx ocal 4rea Connection 3 etw able unplugged ai 4P Win32 Adapter Y8 coLinuxig Connect multiple network connections to Form a network bridge Local 4rea Connection Connected jn p Broadcom Netxtreme 57xx Gig Bridge Connections If the operation is successful you should see a new network bridge like pictured in the following image if the bridge doesn t show up reboot your Windows system Network Connections File Edit view Favorites Tools Advanced Help Back ig wi Ka Search E Folders Ez DER Address e Network Connections Network Tasks E Create a new connection Change Windows Firewall settings See Also i Network Troubleshooter Other Places G Control Panel My Network Places My Documents i My Computer Details Network Connections System Folder LAN or High Speed Internet Local 4rea Connection Connected E ia Broadcom Netxtreme 57xx Gig
3. PuTTY Security Alert The server s host key is not cached in the registry You have no guarantee that the server is the computer you think it is The server s rsaz key Fingerprint is ssh rsa 2046 43 62 a2 as shies ze 07i deer Se gache afb IF you trust this host hit Yes to add the key to PUTT Y s cache and carry on connecting TF you want to carry on connecting just once without adding the key to the cache hit Mo TF you do not trust this host hit Cancel to abandon the connection Yes Mo Cancel Click Yes Congratulations you have installed Telit Development Platform 3 3 2 Starting coLinux Before using any component of the development environment you have to start coLinux going to without Telit Communications S p A written authorization All Rights Reserved page 26 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 4 Connecting the target to the host To get the most out of the development environment it is necessary to create an IP connection through the target and the host There are two options using a normal Ethernet connection via RJ45 port or using an Ethernet on USB connection via USB port The first step is to configure the target Please note that if you have executed the procedure in Appendix A in the following paragraphs you have to consider the new IP addresses values instead of the written ones 4 1 1 Configuring the target
4. In order to build the application select the menu option Project Build Project You should see in the console the messages shown below ee E en Et Problerns ig Tasks E Console Poe E Properties rww Build of configuration Release for project Hello make root workspace Hello all make Nothing to be done for froot workspace Hello Building file fhella c Invoking uclibc compiler fopt crosstools usr bin arm Linux uclibe gcc Lyfopt crosstools usr include 00 fmessage Length c o hello o f hello c Finished building hello c Building target Hello Inveking uclibc Linker fopt crosstools usr bin farm Linux ucLlibe gee L fopt crosstools lib o Hello hello o Finished building target Hello After a successful compilation the binary file will be stored in the directory lt your workspace directory gt Project_Name Releasel Please note that C programs need libraries which by default are not present in the target Refer to Appendix D for further details Fa i r P E9 i m e l CE F j Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 47 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 6 2 Linking an application against a library If your application makes use of an external library the library itself and its header files must be into th
5. Launch Telit Customized Eclipse Go to Window Preferences and click on the item Telit GE863 Preferences Modify the addresses in coLinux IP address and GE863 IP address text boxes with the proper values When configuring the target IP address remember to use the new value see paragraph 4 1 2 for details Pr tions S p A written authorization All Rights Reserved page 7 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 Appendix B How to make a back up If you wish to make a back up of the entire development environment go to its installation directory and copy the following files e root fs img e swap img If you want to restore the system to this back up copy back the two files to the development environment installation directory sam Please note that if your Eclipse workspace is in Windows filesystem this won t be backed up Reproduction ioridden without Telit Communications S p A written authorization All Rights Reserved page 78 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 Appendix C Recovering from a serious error If the development environment doesn t work anymore you can follow these steps to restore the system A If running close coLinux Go to Telit Development Environment installation directory Double click on the file dskimageC_Cpp_dd_mm_yyyy exe where dd_mm_yy
6. 1vv0300780 Rev 2 21 05 09 Telit Upgrade Kernel Sele a Simple mode Advanced mode When you are ready confirm the action clicking Ok otherwise Cancel Be sure to have coLlinux started and running ATTENTION this procedure completely remove all Files The upgrade takes some seconds If the update succeeds it is shown the following pop up ot par qa e T i a A J F i R sacl E ii _ vw Ba j 2 Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 82 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 Simple mode O Advanced mode Start Upgrade Statpatade e f the update doesn t succeed a pop up like this will appear Error in upgrading kernel TIP System Wek Sockets SocketException A connection attempt Failed because the connected party did not properly respond after a period of time or established connection Failed because connected host has Failed to respond 197 166 121 2 22 at System Net Sockets Socket DoConnectiEndPoint endPointSnapshot SocketAddress socketAddress at System Net Sockets Socket Connect EndPoint remoteEP at Tamir SharpSsh java net Socket ctor String host Int32 port in DTELIT WORK Tools Daniele Syviluppi_SimonalySharp5SH 1 1 1 13 srcy5harpSSHijavaljnet Socket cs line 39 at Tamir SharpSsh jsch Util createSockett String
7. Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 Now type in the terminal ifconfig usbO 192 168 121 3 netmask 255 255 255 0 to configure the IP address Then type telnetd to start the telnet daemon For further details about Ethernet on USB configuration refer to document 3 Note that you have to repeat these configuration steps excluding the Windows driver installation each time the target is started It is possible to make the process automatic refer to 4 1 4 for details Note that after a reboot of the target you have to un plug and plug the USB cable to make the connection work 4 1 3 Configuring the host Ethernet connection Close all the applications opened in the development environment and coLinux itself Go to My Network Places View Network Connections and identify the following two connections e The virtual connection used for coLinux whose Device Name is TAP Win32 Adapter V8 coLinux e The connection used for the target it could be a normal Ethernet link or the Ethernet on USB link You can find an example on the image below Faaa I Reproduction forbidden without Telit Communica tions S p A written authorization All Rights Reserved page 31 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 Network Connections E mf Fie Edit View Favorites Tools Adwanced Help Address Network Connectio
8. Native ve C Work Projects GE863 PRO3 workbench Hello hello c fine 5 Embedded GDB 08 01 08 9 33 Suspended C Work Projects GE863 PRO3 workbench Hello hello c fine 7 one Thread i Geos Breakpoint hit pa C os Fies yagarto bin arm eif odb exe 08 01 08 9 33 bE C Work projects GE863 PRO3 workbench Hello Release nello 08 01 08 9 33 Variable dis p l ay Breakpoint summary Debug Control Register display etc ello c 3 lt s is not available gt 0x B outline Disassembly 3 Lc hell E 1 lt symbol is not available gt 0x40000930 i include lt stdio h gt im 2 OxO000083ac lt main gt push ir str ir sp 3int main void printf nHello world n 4 Ox000083b0 lt main 4 gt ldr rO pce 8 7 0x83c0 lt m BD 5 printf nHello world n 0x000083b4 lt main 8 gt bl 0x82b0 lt puts gt m7 return 0 return 0 7 OF eoanansen lt main C Code Display oxooo0esbe lt nainy Assembler sp x cO lt main 2 g Console 2 J Tasks 2i Problems J Memory O Ex fi amp el eT gy ass Hello Embedded debug Native C Work Projects GE863 PRO3 workbench Hello Release hello 08 01 08 9 33 GDB Debugger Command Window To start the debugging select the line Embedded GDB under the project name debug configuration row and click the green arrow highlighted in the screenshot Reproduction forbidden without Telit Communications S p A written authorization All Rights R
9. Network Bridge Network Bridge Network Bridge Connected MAC Bridge Miniport Local Area Connection 6 Connected Bridged call ia Linux USB Ethernet RNDIS Ga Local 4rea Connection 3 Connected Bridged a d TAP Win32 Adapter 8 coLinux page 34 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 Ss Network Connections Sel File Edit view Favorites Tools Advanced Help Q bx Q wi Ka Search Folders Gii Address e Network Connections l LAN or High Speed Internet Network Tasks Local 4rea Connection E Create anew Connected connection ES a Broadcom Netxtreme 57xx Gig Change Windows Firewall settings Disable this network __ Network Bridge device Xx Repair this connection Network Bridge Network Bridge Local 4rea Connection 3 3 Network cable unplugged Connected fa_TAP itin3 Adapter Y8 fcoLlinux view status of this Disable connection Local Grea Connection 6 Status 2 Delete this connection E e R Repair nux USB Ethernet RNDIS G4 Change settings of this Loe sald connection Create Shortcut Delete m Rename this connection Rename Other Places Properties G Control Panel My Network Places My Documents ig My Computer Details View or change settings For this connection such as adapter protocol or modem configuration settings Select the voice Internet Protocol TCP IP and click the button Pr
10. Search Project Wals Window Help Run Fle Edt Refactor Navigate Start debugger F Download file to GE863 PRO3 F Download binary to GE863 PRO3 include lt stdio h gt int main void gt i Binaries printf Hello Worle gt Hi Includes gt Libraries gt E Release gt e hello c return Alternatively in the Project Explorer you can right click on the binary to be debugged and choose the voice Telit Start Debugger of the pop up menu page 68 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 O HeloWonddihelloc Eclipse Paton File Edt Refactor Navigate Search Project Elt Run Window Help Pir be ba es al i cy F Tr ici gi le Gr amp 8 ag ar Or b aman E xplorer 2 H fra gt 0 e hello e 23 include lt stdio h gt i HelloWorld v 4 Binaries I7 int maini void printti Hello World t HelloWorld arrle NE Mews gt Hi Includes Po Libraries Open Open With gt E Release p ke hello c 35 Copy Ctrl e 23 Paste Ctritv Delete Delete Move Rename lmpart Export Refresh Exclude from build Build Conf gurations Make targets Run As Debug As Clean Selected File s Build Selected File s Bam Compare With Replace With i Start Debugger Download Binary Target Properties i Note that the telnet daemon
11. a ue Reproduction forbidden without Telit Communica Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 Salts S a Eia Er File Edt Navigate Search Projet Run Window Help lea E ia Hr Or AAE By Fie Gr OD Fry ReDebug Figycic F5 Debug 53 oOo gt 0 bf 3 Bw RW Y B O0 variables 28 2o Breakpoints Skea amp E VCO z T gt m Be Outline 23 m An outline is not available g Console 3 vA Tasks i Problems ne Ap td No consoles to display at this time i a If your display doesn t look exactly like the debug display above click on Window Show View and select any of the missing elements Once the server in the target has been started go to Run Open Debug Dialog choose the debug configuration for the project you wish to debug and click the Debug button In the screenshot below there are shown the components of the Debug perspective ak page 71 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 Debug Hello hello c Eclipse Platform Joey File Edit Refactor Navigate Search Run Project Window Help tt 31 O Q i g ES 3 Debug aCA F Debug eS a Eens i veo 9 Variables o Breakpoints 3 sioi Registers BA Modules ee amp B a H E S can o 76 Hello Embedded debug
12. boot in coLinux development environment The updated u boot version depends on the tool version Usage For using the u boot Upgrade Tool follow these steps Double click on the file Telit UpgradeU boot_ lt version_number gt exe and choose the directory where the tool can be unpacked 2ip self extracting archive Extract to CATMPS x Extract Cancel Go to the directory where the tool has been unpacked and double click on the file UpgradeU boot exe for launching the tool lf you have kept the default ip addresses for coLinux and the target then simply click the Start Upgrade button ma fey Reproduction forbidden without Telit Communica tions S p A written authorization All Rights Reserved page 86 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 cs Telit Upgrade oe i l Eol A felit Simple mode gt Advanced mode Start Upgrade When you are ready confirm the action clicking Ok otherwise Cancel Be sure to have coLlinux started and running ATTENTION this procedure completely remove all Files The upgrade takes some seconds If the update succeeds it is shown the following pop up 5 r D a Beet a i a j e l Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 87 of 91 Telit Development Environment User Guide for PRO3 w
13. button s down arrowhead you will see the Hello debug launch configuration installed as a favorite as shown below aa i T Reproduction forbidden without Telit Communica tions S p A written authorization All Rights Reserved page 65 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 p 0 Q4 By Debug Open Debug Dialog Organize Favorites Now everything is in place to debug the project To debug it is needed to switch from the C C perspective to the Debug perspective The standard way is to click on Window Open Perspective Debug as shown below Run Window Help New Window New Editor Open Perspective Show View O L wr Customize Perspective Other Save Perspective As Reset Perspective Close Perspective o world n Close All Perspectives Navigation Ge Working Sets b Preferences A more convenient way to switch perspectives is to click on the perspective buttons at the Eclipse upper right window location Click on the OpenPerspective toolbar button below on the left and then choose Debug when the other perspectives are displayed a a li j faf ae b i j rt ae E i aa Reproduction forbidden without Telit Communications S p A writte
14. must be running in the target If the operation succeeds you should see in the console named Telit Command Output a similar message Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 69 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 Problerns J Tasks E Console 2 b E Properties Blt Command Output spawn telnet 192 168 121 3 Trying 192 168 121 3 Connected to 192 168 121 3 Escape character is gdbserver 192 168 121 2 2345 HellowWorld amp Process HelloWorld created pid 438 Listening on port 2345 If you want to manually start the gdbserver type in a target shell gdbserver 192 168 121 2 2345 filename amp If The host 2345 argument means that gdbserver is to expect a TCP connection from machine host your workstation running Eclipse to local TCP port 2345 filename is your application s filename with its own path It is recommended to let gdbserver run in background adding the amp symbol to the command line as shown above Now gdbserver listens on port 2345 for a remote connection 7 3 2 Running GDB To start the Eclipse debugger click on the Debug perspective button at the upper right to open the Debug Perspective display shown below tions S p A written authorization All Rights Reserved page 70 of 91 Y a l i
15. oo he i ae OE rE 4 isj i i x a ih i m lt Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 63 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 nosharedlibrary set solib absolute prefix opt crosstools symbol filename target remote tcp 192 168 121 3 2345 tbreak main continue 5 Debie Create manage and run configurations Name Hello Release ft filter text z TE SREMUPEISEE Main Fr Debugger E Commands b fe Source E Common E C C Attach to Local Applicatie c CIC Local Application Initialize commands c C C Postmortem debugger nosharedibrary set solib absolute prefix fopt crosstools 2G Zylin Ernbedded debug Cygwin symboal root workspace Hello Release H ello target remote tcp 192 168 L21 3 2345 o 6G Zyln Embedded debug Native Areas SA p Ze Hello Release i Run commands C iy Fiter matched 6 of 6 terns In the previous lines filename refers to the binary to be debugged including the file path for example the default workspace is root workspace project_name Release f7 e_name The target remote tcp command debugs using a TCP connection to port 2345 on 192 168 121 3 the IP address you should use in the target if you have not changed default configuration Click on Apply followed by Close to finish specifica
16. void tate thread for gprs n Ak Enter ifi pthread create amp threads ID 1 NULL veid send sms void amp arg printf nUnable to create thread for sending sms n The Properties tab for the application will appear Now from the C C Build left menu select Settings and then from the Tool settings tab select Libraries as shown below A E 5 yp Pa ie e y Rea a cn a ai F F 1 F F B EE s r l r gt E fl J Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 49 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 Properties foncmux test threaded type filter text Settings gar Resource Configuration Release Manage configurations Builders C C Build asics sai ES bol settings Build steps Build artifact on Binary parsers E Error parsers Environment wr Bb uclibc compile Library search path L d_ K a jopticrosstoolsttelitilib fopt crosstoals lib Bol chain ieor ee Preprocessor Variables ee Symbols C C General he Directories Project References ce Optimization Refactoring History ge Debugging RunfDebug Settings 23 warnings ee Miscellaneous v 883 uclibe C linker Libraries l es General ce Libraries Epy uelibe daira 2 General Restore Defaults Now push the Add button highlighted above to link the librar
17. with Linux 1vv0300780 Rev 2 21 05 09 Now select the Debugger tab as shown below In the text box labeled GDB Debugger use the Browse button to locate the arm linux gdb file It will be found in the opt crosstools usr bin folder Finally remove the gdbinit GDB init script filename from the GDB command file text box 0 E Name Helo Release ft filter text 2 EEEN em i i Ype niter te Main FF Debugger _ H Commands Be Source z Common E C C Attach to Local Applic Debugger Embedded GOB Advanced e C C Local Application E C C Postmortem debuggs Debugger Options 26 Zylin Embedded debug Cyqv Main 26 Zylin Embedded debug N ati Ef Hello Release GDE debugger iopticrosstools usr bin arm linux gdb Browse GDB command file Warning Some commands in this fle may interfere with the startup operation of the debugger for example run GDE command set Standard w Protocol mi _ verbose console mode CU i Fiter matched 6 of 6 terms GDB can communicate with the target over an IP network Ethernet link on USB using TCP or UDP GDB IP network connection configuration Ethernet or USB Select the Commands tab If your target is accessible through a network cable in the Initialize commands text window enter the following GDB startup commands as shown in the picture below PT ied ff A
18. 1 Appendix F Upgrading U boot with U boot upgrade Tool c1ssccensccensecennecensesennesensesenns 86 OV CCW rori E E E EA E 86 SAG E E A E O EE EE NA T E E E E A A EEE E A 86 Appendix G Transferring files between coLinux and WiNdOWS 1 1s11sccnscneceennsennnenenes 91 r 4 paret id at vf i A mn i eaid p a PEV Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 5 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 1 Introduction 1 1 Scope This user guide serves the following purpose e Describes how to install Telit Development Environment e Describes how to develop deploy and debug a simple application on the PRO with Linux operating system 1 2 Audience This User Guide is intended for software developers who develop applications in Linux on the GE863 PRO module 1 3 Contact Information Support Our aim is to make this guide as helpful as possible Keep us informed of your comments and suggestions for improvements For general contact technical support report documentation errors and to order manuals contact Telit s Technical Support Center at TS EMEA telit com or http www telit com en products technical support center contact php Telit appreciates feedback from the users of our information 1 4 Open Source Licenses Telit Development Environme
19. 5 09 Once all the library components have been correctly set up the application can be linked against the library itself Under Eclipse right click on the project folder and select Properties as shown below tireadediemu esee Eclipse Plalionn SCC emuk tesi Edt Refaqtor Navigate Search Project Elt Run Window Help File Ra 5 al a F gir Bir r Gr amp st i er Or Gr se B E oo US Project Explorer p5 gt Et mime N a i wj Ta p HS ELUTE LUE TRT EEUU CUTEST ERLE CEST ETELURLERIEETIELEC TESST a L a 3 E 3 int main int arge k 3 E AS mux test threaded p Hi Includes gt Libraries gt Release a Ctrl C b Le emux_test c ae Ctl Delete char argv kfcmuxl dev emux2 dew emuxs f f Cm huxl cmux2 cmux f f Log filenames lof thread args to be passed to threads butput Log files Export Build Project Clean Project t ChanOpenPtm cmux_port i 0 Refresh open cmux port s n cmux_port i Close Project jCan t open port Close Unrelated Projects open Logfilename i O RDOWR O CREAT O_TRUNC Exclude fram build Build Configurations Fh open out file s n Llogfilename i Make targets Can t open output Log file Index Convert 5 Run As krted on virtual channel s n cmux_port al Debug As Bam Compare With hy Restore from Local History ID 0 NULL void connect_gprs
20. 6 1 4 1 PMA st acters cst ec nai eect aces atta tsb a ce ave nec OE sidan nace costes akan E area a ete T 1 4 2 COLIN enpe a wen R ar a aa adi te eee ees aa T 1 4 3 AN e eu afc en ain lett he abit ec A oie eect el osc tab eit te ag ct nlc a nea la ult alan at hao sue T 1 4 4 E opoe IDE orea EEE EEE EE E A E O EE E AE ee E T 14 5 Product Overvi W iisisrirssnssasnnriiiinnneniicinnaiinainn onkotan anaandaa inaandaa riii aana niaii 7 1 6 Document Organization ccccccscccsecceseeecceecceeeeeeeeeeeeseeeseneeeeaneuaeeueeeueeeeeseeeeeenaseceseasseeess 7 Meh Text CONVENUONS seereis a Ea aE a Ei 8 t8 Related DOCUMIEMIS sacian iE EE E A Ai 8 19 Doc mMent TIS LORY as E E 9 2 PRO Hardware interfaces sscsssscecsesseessesserscessescessenseessensenssessenscenseaseessensenssensenseessenees 10 3 DevelopMent CNviITONMENh sssr aaah 11 231 PAV AMANO FES e A E E EE EA EN 11 32 SySlemMm REgUINEMENIS srsisiienin n an seiesieecaaucedeeacvaceseutecccneceaaumesadenseteesetesccexe 11 S9 MVS eM AU NO apnar E E a a a 11 3 0 1 Installation of the development ENVIFONMENL ccccccsecceceeececeeeeeseceesecesseecessueeesaueeeseeeeeseensaes 12 3 3 2 SANNT COCUK esea E E E AE E E E EATE A ENEE 26 4 Connecting the target to the NOSE sisccssicsdees setedacwcnnsdaonenvsdans censdaeonns deusecnesensseredamecete teasers 27 4 1 1 Configuring the target connection via RU4D5 cc ccecccceeseeceeceeeeeeeeeeeeesaeeeeesaeeeeeesaeseeeseaeeeesaeeeesaaes 27 4 1 2 Configur
21. M EDE E EE 5513 Closing remote connection The binary can be found in the root directory of the target filesystem Pay attention that the first method will work only if the binary has the same name of the selected project and if the binary can be found inside the Release directory of the project If you need to download to the target any other file than the compiled binary of a project follow these steps Goto Telit Download file to GE863 PRO3 or click on the button highlighted by the red circle in the picture we C Ce HeloWonddhelloe Eclipse Paton File Edt Refactor Navigate Search Project Sie Run Window Help aes cs Start debugger lr E a SETE Or is Bapiedt Explorer 2 TE Y5 HelloWorld include lt stdic h gt p yr Binaries int main void intfi Hello Worled gt RIH Includes ii i Po Libraries return gt E Release gt ic hello c Use the file selector to choose the file to be transferred and click Ok Reproduction ioridden without Telit Communications S p A written authorization All Rights Reserved page 54 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 Vines nurs Ala por iis ils re onnea P root mnt windows temp TestAppPC A File System 13 1107 Ie estAppPc sin 1307 07 stAppPe suo 1Y 1Yo7 2 Remove Alternatively in the Project Explorer if you have in a p
22. and root cpp_libraries 1ibgcc_s so 1 in the target using one of the methods described in previous chapters e Move the two files in the target to the directory 11b at j F tions S p A written authorization All Rights Reserved page 80 of 91 Faaa a i Reproduction forbidden without Telit Communica Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 Appendix E Upgrading the firmware kernel sources with Kernel Upgrade Tool Overview The Kernel Upgrade Tool is a Windows application used for upgrading kernel Linux in coLinux development environment The updated kernel version depends on the tool version Usage For using the Kernel Upgrade Tool follow these steps Double click on the file Telit UpgradeKernel lt version_number gt exe and choose the directory where the tool can be unpacked Zip self extracting archive Extract bo Extract Cancel Go to the directory where the tool has been unpacked and double click on the file UpgradeKernel exe for launching the tool lf you have kept the default ip addresses for coLinux and the target then simply click the Start Upgrade button 4 d 1 oe id Yt ee oe eit P as a rte wii et peat eis Bl Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 81 of 91 Telit Development Environment User Guide for PRO3 with Linux
23. arn how to make a back up A Run the installation of the development environment by clicking twice on the setupDevEnvironment C Cpp exe file and follow the instructions on the screenshots 3 3 1 Installation of the development environment Telit Development Platform Setup Welcome to the Telit Development Platform Setup Wizard This wizard will guide you through the installation of Telit Development Platform It is recommended that vou close all other applications before starting Setup This will make it possible to update relevant system Files without having to reboot your computer Click Next to continue Click Next m 4 P F Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 12 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 amp Telit Development Platform Setup Read Me Please review the following important information About Telit Development Platform For installation follow the instructions in the Development Environment User Guide Please note that firewall should be disabled for a correct installation Click on scrollbar arrows or press Page Down to review the entire text Nullsoft Install System v2 34 Carefully read the information then click Next amp Telit Development Platform Setup Choose Install Location Choose the Folder in which to install Telt D
24. ccnsnncnenncnennennnenennscensesensssensesensssensesensesensesensssensesenes 59 LI OVW ce E E eee eens ea sneer 59 LA Co niNgu ring the SU Ca itech cance ces es rece ec sew ees 59 7 2 1 Creating a Debug Launch Configuration ccccccccccssseecceeesceceeeseeeceeseeeceuseeeseaeeesseageeessagseessaaes 59 7 2 2 OCI ZN TV OS S ees dates ames aaseeeteem aces doe nce EN 65 had Ru unNnNINg GOD SERV CN sarge orettawesttasvietieavasaovenverccsinvasnsvaeesumerestadwesusersuuetvsancs dassntesaencmensinvesvavievates 67 7 3 1 Remote IP MEIWOLK COMMECH ON sser i 67 7 3 2 ROn COD scotia sees aspects econ Gene tamatieale note eneehe dan E EE A 70 8 General suggestionS s ssssnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn annnm nnn 75 Appendix A How to change default IP addresses 11cccescccneccennnscnenscnenseenseenseeensnnesenas 76 Appendix B How to make a DaCkK UP 1sccsssccsnsccnnsccsnnenennsnennsnensssensssensssensssensssensssensssensssenes 78 Appendix C Recovering from a Serious CIOL sscccnscccnscnenncnennssensesensssensssensssensesensssesssenes 79 Appendix D Copying C libraries in the target 1 scccssscccnnnesennenenensnenensnssensesennnesenenssens 80 Appendix E Upgrading the firmware kernel sources with Kernel Upgrade Tool 81 OV OT VY aiurea aE A ete E EEE E E TEE ENE E OE NA 81 US AO o E nonsadusneunandsiuaiddusunuencnontedanvanolsaeskdahasvendiismeusansuddumwesansniweds 8
25. connection via RJ45 Turn on the target connect the Ethernet cable and open a terminal after the boot type modprobe macb ifconfig ethO hw ether AA BB AA BB AA BB ifconfig ethO 192 168 121 3 netmask 255 255 255 0 to configure the network interface then type telnetd to start the telnet daemon For further details about Ethernet configuration refer to document 3 A 4 1 2 Configuring the target connection via USB Note that you have to repeat these configuration steps each time the target is started It is possible to make the process automatic refer to 4 1 4 for details Turn on the target and open a terminal after the boot type modprobe g_ether then connect the USB cable If this is the first time you use the connection via USB you have to configure Windows i ih j ee id SL Pe ri et p r y A F i i al ay a as Ca ae ivi Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 27 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 Note that Windows driver installation is needed only if it is the first time you use the USB connection or if you change USB port Otherwise you can skip over this part and go directly to the IP configuration with ifconfig page 31 A Plug the USB cable into the targets USB Device port B type and into the PC A type you will be asked
26. e Eclipse Platform stores your projects in a folder called a workspace Choose a workspace folder to use for this session Workspace Prgctiworkspaca Browse Use this as the default and do not ask again e When the workspace has been created click on the Workbench icon z nh f pen d i Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 39 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 GG neySenalenewsern e Eclipse Patrom A gg File Edt Refactor Navigate Search Projet Run Window Help Seasensoed Welcome to Eclipse 3 3 a lt Tutorials Samples What s New Overview a Workbench Now you are ready to develop your first application for the Pro 7 j j ay EEA e B i oo aoe Fe Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 40 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 6 Creating a project 6 1 C or C project To create a project follow these steps e Open the IDE Start menu All Programs Telit Development Platform Telit Customized Eclipse e Open the menu File New C Project As an alternative you can right click on the Project Explorer frame and select the C Project like shown in the picture b
27. e Colinux Development Environment So start the Colinux console Windows Start Menu All Programs Telit Development Platform Console and make sure that all the library components are correctly installed To find out the library type Is opt crosstools lib or Is opt crosstools telit lib then type Is opt crosstools usr include or Is opt crosstools telit include to find out the library header files Whenever the library you want to use is not into the Colinux Development Environment you can install it Let s assume for example you want to install the libpthread a library which is actually already installed into the Colinux Development Environment Copy the library typing cp mnt windows lt PATH gt libpthread a opt crosstools lib Copy the header file typing cp mnt windows lt PATH gt pthread h opt crosstools usr include where lt PATH gt is the windows folder where you have stored the library files For example if you store them within C Temp you have to type cp mnt windows Temp libpthread a opt crosstools lib and cp mnt windows Temp pthread h opt crosstools usr include E 1 5 4 4 a ie rt a i TAR E Beh i T E ki eet s Rimi E asaz gs Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 48 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 0
28. e Encoding and choose for example ISO 8859 1 Occasional Xming crashes happen close coLinux and restart it to solve the problem Using Ethernet on USB with a Windows bridge ad described in chapter 4 causes ARP problems i e the target doesn t succeed in communicating with other systems if those haven t previously sent data to it This problem seems to be related in the RNDIS driver a workaround is to manually insert entries in ARP table for example in a startup script for linking a NIC mac address to its IP address The shell command to be used is arp s hostname hw_address If the software Putty is present in your system be sure that its default configuration is ssh and not serial otherwise Telit Development Environment applications won t start tions S p A written authorization All Rights Reserved page 75 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 Appendix A How to change default IP addresses Telit Development Environment default installation will create a C class network 192 168 121 0 however it is possible that you already have in your system such a network In this case you have to manually change all the 192 168 121 x addresses to a free address space in your network Follow these steps e Start coLinux e Goto Telit Development Environment installation directory and run colinux console fltk exe e After login user root password root type in t
29. e Close button The host configuration is complete To test its working start coLinux and open a windows shell type ping 192 168 121 2 to check for the connection to coLinux Type ping 192 168 121 3 to check for the connection to the target Summarizing network configuration after default installation Windows IP address 192 168 121 1 coLinux IP address 192 168 121 2 GE863 PRO IP address 192 168 121 3 Y wk 7 Fa PE Eos s iL n gn ee al m Ee J Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 36 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 4 1 4 Making the target IP configuration automatic In order to avoid manual IP configuration of the target each time it is rebooted you can follow these steps e Type in the terminal vi etc init d S00 e Atvi prompt press the 1 key on the keyboard to enter in edit mode amp GE863 PRO3 HyperTerminal Sele File Edit View Call Transfer Help Auto detect 115200 84 1 e For Ethernet RJ45 connection type modprobe macb ifconfig ethO hw ether AA BB AA BB AA BB ifconfig ethO 192 168 121 3 netmask 255 255 255 0 telnetd Lily i ase EE TRR F BY F m Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 37 of 91 Telit Develo
30. ectory wget http 192 168 121 2 apache2 default TestAppPc sln Connecting to 192 168 121 2 192 168 121 2 80 TestAppPc sln as 8 ETA Test AppPc slr 1 g l WERE RREEEREEREEREEEREREREEREEREEREEREEEEE l 916 Sieh eee ETA Closing remote connection A L Alternatively you can choose not to use the IDE Goto Start Telit Development Platform Console Copy the files to be transferred in the directory var www apache2 defaul1t for example opening a terminal and using the cp command cp lt file to be copied gt var www apache2 default From the target shell within the directory where you want to place the downloaded file type wget http 192 168 121 2 apache2 default file_to_be copied amp GE863 PRO5 HyperTerminal File Edit View Call Transfer Help Ca aA A wget http 192 168 121 2 apache default serial bin Connecting to 192 168 121 2 192 168 121 2 86 Connected 0 21 43 Auto detect 115200 8 N 1 b Th ii i A tr b ipp tT ji I Far ois i F ae A H f aN ig i 5 i i J a oT eae 3 ie Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 57 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 chmod 744 filename 6 3 2 Download through the s
31. elow CC Helps tren File Edt Refactor Navigate Search Project Run Window Help Convene pened pa nnn ae oe Brenn pir H one oe oe B Project cs C Project C Project gE Other See ee ee ee ee ee ee ee ee Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 41 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 Choose a name for the project and its location and then select the ARM uclibc C executable for C projects or Arm Cpp C executable for C or mixed C C projects Click Next a C Project Create C project of selected type Project name Hella Use default location Location imntiwindowsitempiworkspace H elle Browse Project types olchain amp Executable Linux GCC gt Shared Library gt Static Library ARM Cpp C executable gt ARM uclibc executable gt E Makefile project Show project types and toolchains only if they are supported on the plattonn page 42 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 Now you can choose the configuration for your project Make sure that at least one configuration is selected Click Finish s Select Configurations Select platforms and configurations you wish to deploy on Project type ARM uclibe executable Tol uclibc toolchain Co
32. enu option Run Open Debug Dialog ation 1vv0300780 Rev 2 21 05 09 to bring up the Debug Configuration Window arch Project Mimi Window Help amp Toggle Breakpoint Shitt tri B Toggle Line Breakpoint Toggle Method Breakpoint ee Toggle Watchpoint Skip All Breakpoints Sg Remove All Breakpoints a Run TE Debug Run History Run As i Open Run Dialog Ctrlt F1l1 Debug History Debug As Ww Open Debug Dialog FN External bols ns UES sritcattets ToP page 60 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 In the Debug Create manage and run configurations window below click on Zylin Embedded debug Native followed by the New button Debus Create manage and run configurations Configure launch settings from this dialag lr a Press the New button to create a configuration of the selected type 5 New launch configuration Press the Duplicate button to copy the selected conh guration e Cfo Attach to Local Applic fe C C Local Application Press the Delete button to remove the selected configuration fe C C Postmortem debugge Press the Fiter button to configure filtering options 2G Zylin Embedded debug Cyg Edit or view an existing configuration by selecting tt Hf Zylin Embedded debug Nati Configure launch perspective settings from the Perspec
33. erial port Make sure your target Upper AP UARTO serial port is configured with the baudrate you wish to use for transferring the file Open a console and type the following command to change the baudrate stty ispeed baudrate lt dev ttyS1 Then type rz zmodem lt dev ttyS1 gt dev ttyS1 in order to let the target receive your binary file through the zmodem protocol using ttyS1 Now use the send file option from your terminal make sure that zmodem file transfer option has been set to download your application to the target If the file is an application you need to change its permission to execute it Therefore type chmod 744 filename Ye x q fii i a a m SE ee nf E i Hh a Ta m J F ee Oe ie CFs Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 58 of 91 7 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 Debugging an application 7 1 Overview Telit Development Environment allows remote debugging on the target through Ethernet USB connection Two applications are needed gdbserver server part of the debugger which runs in the target it must be launched every time the debugging starts The file can be found in coLinux filesystem directory opt crosstools arm linux uclibc target_utils gdbserver and it needs to be copied in the target using one of the methods seen i
34. eserved page 72 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 Now you are ready to debug your application To set breakpoints double click on the far left edge of the line Double clicking on the same spot will remove it E hello c ge gO l inelude lt stdio h gt Sint main void af printf nHello world n D im om L return 0 io oo Note in the upper right Breakpoint Summary pane the new breakpoint at line 5 has been indicated as shown below ee b Variables 2o Breakpoints pi olol Registers Bi Modules lo ae es BE ies ee TE a ao C WaorkProjects GES63PRO3 workbenchHellothelo c Nine 5 Use the debug control buttons shown below to control debugging i a f fy F a Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 73 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 Stop Button Clear Button Run Continue Resume Kill Button Erases debug view Button Stops after Kill everything Switch between C language stepping and assembler stepping F Hello Embedded debug Native Embedded GDB 08 01 08 9 37 Suspended _ b g Thread 1 Suspended Breakpoint hit Pere rere E rr
35. evelopment Platform Setup will install Telit Development Platform in the Following folder To install in a different Folder click Browse and select another Folder Click Next bo continue Destination Folder Space required 777 46 Space available 27 566 i H h j Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 13 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 Choose the directory where Telit Development Platform should be installed according to the following rule e The directory tree must end with the directory coLinux in such a way device letter path colinux where path is a filesystem path preferably without spaces Some examples are c colinux PREFERRED c telit colinux Note that all the other packages should be installed inside this directory For example considering Xming c colinux Xming c telit colinux Xming After choosing the directory click Next Telit Development Platform Setup Choose Start Menu Folder Choose a Start Menu Folder For the Telit Development Platform shortcuts Select the Start Menu folder in which vou would like to create the program s shortcuts You can also enter a name to create a new Folder elit Development Platform Zip Accessories Administrative Tools Agilent IO Libraries Suite Agilent AS40108 WLAN Test Suite Agile
36. fiw Wwinpcap orgs RECO ww winpcap orgfinstalll Click Next Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 17 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 Hardware Installation Click Continue Anyway The software you are installing for this hardware TAP Wins2 Adapter Y8 coLinus has not passed Windows Logo testing to werty its compatibility with Windows F Lell me why this testing i important Continuing your installation of this software may impair or destabilize the correct operation of pour system either immediately or in the future Microsoft strongly recommends that you stop this installation now and contact the hardware vendor for software that has passed Windows Logo testing Continue Anyway STOP Installation Cooperative Linux 0 7 1 Setup Completing the Cooperative Linux 0 7 1 Setup Wizard Cooperative Linux 0 7 1 has been installed on your computer Click Finish to close this wizard Show Readme Visit the Cooperative Linux website Uncheck the voice Show Readme and click Finish page 18 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 After installing coLinux or choosing not to install it you will be asked to install Xming Telit Development Platform S x ws w
37. for a driver Linux USB Ethernet RNDIS Gadget Follow the actions described by the screenshots Pound New Hardware Wizard Welcome to the Found New Hardware Wizard Windows will search for current and updated software by looking on your computer on the hardware installation CD or on the Windows Update Web site with your permission Read our privacy policy Can Windows connect to Windows Update to search for software Yes this time only O Yes now and every time connect a device Click Next to continue is age i z Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 28 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 Ti Pou ler lardieira vi reard This wizard helps you install software for Linux USB Ethemet RNDIS Gadget your hardware with an installation CD GEA or floppy disk insert it now What do you want the wizard to do Install the software automatically Recommended Install from a list or specific location Advanced Click Next to continue ces Found lev rlardiears irre Please choose your search and installation options Search for the best driver in these locations Use the check boxes below to limit or expand the default search which includes local paths and removable media The best driver found will be installed Search removable med
38. gainst a library Added Appendix E Upgrading the firmware kernel sources modified Appendix F Upgrading U boot added a a ff ia H l i Fa EE e ae ay a ES l A F rip Fi Gs Bianco i Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 9 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 2 PRO Hardware interfaces Serial Port Upper AP UART 0 Used for debugging Serial Port Lower AP DEBUG Used for the Command Shell Ethernet Port USB Device Port For further details about hardware interfaces refer to document 1 and document 2 Aiae e ae Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 10 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 3 Development environment This section contains information about the development environment for the host The development environment is based on coLinux and Xming that permit you to work in Linux under Microsoft Windows XP 3 1 Available Files The development environment consists of the following file setupDevEnvironment_C Cpp exe the development environment C C version This file is available on the Telit web site www telit com in the download zone 3 2 System Requirements To in
39. he console nano etc network interfaces and modify the rows address 192 168 121 2 netmask 255 255 2550 0 with the proper addresses then save the file ae e Type in the console Pay attention that you always need to keep the correct correspondence between addresses nano root profile and modify the row DISPLAY 192 166 121 1750 0 with the proper address then save the file e Type in the console halt then close the coLinux window TE ne m ae Ba Tt t 1 i wr oa A Bia g ff r Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 76 of 91 i i Reproduction forbidden without Telit Communica Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 Go to Telit Development Environment installation directory enter in the Xming directory and open the file XO hosts with a text editor Modify the rows LOZ ph Ore dazed ot CIRC pera oo arlene with the proper addresses then save the file Modify the IP address of the network bridge according to the proper value see paragraph 4 1 3 for details Go to Start menu All Programs Telit Development Platform and right click on the item Console modify the addresses 192 168 121 2 and192 168 121 1 0 0 with the proper values then click Ok Repeat the same procedure for the items Telit Customized Eclipse mc and Synaptic Start coLinux
40. host Int32 port Int32 timeout in DATELIT WORK Tools Daniele Sviluppi_SimonalSharpS5H 1 1 1 13 src 5harpSSHijschi til cssline 245 sf tions S p A written authorization All Rights Reserved page 83 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 If you have not kept the default ip addresses for coLinux and the target then choose the Advanced Mode of the Radio Button and insert the proper ip address in the coLinux ip text field then click the Start Upgrade button Telit Upgrade Kernel BAA Info E amp Telit 2 Simple mode Advanced mode coLinux IF 132 1 68 121 2 page 84 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 If you want to see which updates the tool carry out click on Info Show Updates ES Telit Upgrade Kernel Sel f Telit Simple mode Advanced mode coLinux IP 192 168 121 2 Start Upgrade List of files j Firmware ge 63 tar gz version 50 01 04 mg 5 i a re i j i Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 85 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 Appendix F Upgrading U boot with U boot upgrade Tool Overview The u boot Upgrade Tool is a Windows application used for upgrading u
41. ia floppy CD ROM Include this location in the search es Dont search will choose the driver to install Choose this option to select the device driver from a list Windows does not guarantee that the driver you choose will be the best match for your hardware Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 29 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 Click the Browse button and search for the file linux inf given with Telit package inside coLinux installation directory slarerara Irilo The software you are installing for this hardware Linux USB Ethemet RNDIS Gadget has not passed Windows Logo testing to venfy its compatibility with Windows XP Tell me why this testing is important Continuing your installation of this software may impair or destabilize the comect operation of your system either immediately or in the future Microsoft strongly recommends that you stop this installation now and contact the hardware vendor for software that has Click Continue Anyway Completing the Found New Hardware Wizard The wizard has finished installing the software for Linux USB Ethemet RNDIS Gadget Click Finish to close the wizard Frosh Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 30 of 91 Telit Development
42. ight Commander allows executing all normal operations on files copying renaming deleting You can find the content of your Windows filesystem inside mnt windows For help press F1 n without Telit Communications S p A written authorization All Rights Reserved page 91 of 91 i Reproduction forbidde
43. ing the target connection via USB ceecccccceececeeeeeeeaeeeeeesaeeeeseeeeeeeseeeeesaaeeeeeaeeeeeesaess 27 4 1 3 Configuring the host Ethernet connection ccccecccceseeeeeeeeeeceeseeeeeeeaeeeeeseeeeeeesaeeeesaaeeeeseeseeesaees 31 4 1 4 Making the target IP configuration automatic ccc ccecceeeeeeeeeeeeeeseeeeeeaeeeeeeseaeeeesseeeeesaaeeeeeseeeeeens 37 5 Starling i ed 9 ee eT ee eee Ee Eee ee ane oe ne e i eee ee 39 0 CREATING a POCO o E E EA EEEE EEE EEEE EAEE 41 61 CO a Ou had 0 9 0 en EE EREE E E E 41 6 2 Linking an application against a library 0 ccccceeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeseneseneseneseneaeaes 48 6 3 Downloading a file to the target cccccceeceeeeeeeeeeeeeeeeeeeeeeeseeneesaeeceneseasesaeesenesennesenesenees 52 6 3 1 Download through the Ethernet USB port ccceeccccseeeeeeeeeeeeeeeeeeeeeaeeeeeseeeeeeesaeeeeesaeeeeeseeeeeeas 52 6 3 2 Download through the serial Port ccccccccccsssceceeececeeceseeeeeceeceseueceeeeeesaseeesaseessseeensueessgesensegs 58 b Reproduct E _ Ph omer 7 m j a i a z l Aik f E eE ja a 1 j HF E gF y a F s tis Cr t a i i m l h F i F E ion forbidden without Telit Communications S p A written authorization All Rights Reserved page 4 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 7 Debugging an application 11sccsecccen
44. ith Linux 1vv0300780 Rev 2 21 05 09 wT u beot OX A e Telit 3 Simple mode O Advanced mode i Start Upgrade TAN oi E AA Vere e i j j P AE of i A oe 35 gy I Ey P Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 88 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 e f the update doesn t succeed a pop up like this will appear Error in upgrading u boot TIP System Net Sockets SocketException 4 amp connection attempt Failed because the connected party did not properly respond after a period of time or established connection Failed because connected host has Failed to respond 192 168 171 2 22 at System Wek Sockets Socket DoConnect EndPoint endPointSnapshot SocketOddress socket ddress at System Wek Sockets Socket Connect EndPoint remoteEP at Tamir Sharpssh java net Socket chor String hast Ink32 port in Ds TELIT_ WORK Tools _Simona Upograde_U boot SharpSSH 1 1 1 13 sre SharpSSHijavalneth Socket cs line 39 at Tamir SharpSsh jsch Util createSocket String hast Inks port Int3e timeout in DAiTELIT WORK Tools Simona Upgrade U boot SharpSSH 1 1 1 13 src5harpSsHijschi til cssline 245 page 89 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 Ifyou have not kept the default ip addre
45. liant GE863 product family which includes a powerful ARM9 processor core exclusively dedicated to customer applications The concept of collocating a powerful processor core with the GSM GPRS engine allows developers to host their application directly The PRO incorporates much of the necessary hardware for communicating microcontroller solutions including the critical element of memory significant simplification of the bill of material vendor management and logistics effort are achieved 1 6 Document Organization This manual contains the following chapters Chapter 1 Introduction provides a scope for this manual target audience technical contact information and text conventions H f j a a z l Dah eT i m itt R A T 5 nie e EoI k Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 7 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 Chapter 2 PRO Hardware interfaces describes the various hardware interfaces of the PRO Chapter 3 Development Environment describes the files provided with the installer the hardware requirements and the installation process Chapter 4 Connecting the Target to the Host describes how to setup the various possible connection configurations between the target and the host Chapter 5 Starting Eclipse describes the first steps
46. n authorization All Rights Reserved page 66 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 Jes Jes Caio fy a cic He Debug B cic FF Debug S TH i E Oo i f J oO Oz o H o am E Now a Debug button is shown below You may have to drag on the edge to expose all the perspective buttons You can also right click on any of the buttons and Close them in order to reduce the display to only the perspectives you are interested in 7 3 Running gdbserver 7 3 1 Remote IP network connection As previously explained the gdbserver should be present in the target in the directory and the libthread_db so 1 in the ib directory Be sure your application also a stripped version of this latter can be used has been already copied into the target see paragraph 6 3 1 If you are using the IDE the simplest way to launch the debugger is highlighting the project to be debugged and going to Telit Start Debugger or click on the button pointed out by the red circle in the following picture EN E Din a i y Matit n _ e E tions S p A written authorization All Rights Reserved page 67 of 91 Faaa a i Reproduction forbidden without Telit Communica Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 Ws helowonahello c Edipe Hationn
47. n chapter 6 Remember to set the executable flag for the file using the chmod command as explained in 6 3 2 You also need to copy in the target inside the 11b directory ibthread_db so 1 that can be found in coLinux filesystem directory opt crosstools 1lib arm linux gdb client part of the debugger which runs in coLinux The file can be found in coLinux filesystem directory opt crosstools usr bin arm linux gdb It commands the debugger behaviour and it is used through a graphical user interface in Telit Development Environment provided by Eclipse Both the server and the client need to be configured as explained in the following paragraphs 7 2 Configuring the Debugger 7 2 1 Creating a Debug Launch Configuration Before start debugging your application a Debug Launch Configuration for the project shall be created into Eclipse The Debug Launch Configuration locates the GDB debugger for Eclipse locates the project s executable file in this case it is used only to look up symbol information and provides a startup script of GDB commands that are to be run as the debugger starts up A Debug Launch Configuration will be created for each project 4 f j 4 i a r i ier iT a ff it F 5i Li 7 R ae b Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 59 of 91 d Telit Development Environment User Guide for PRO3 with Linux Select the m
48. nf gurations a i d Release Select all Deselect all Advanced settings Use Advanced settings button to edit project s properties Additional configurations can be added after project creation Use Manage configurations buttons ether on toolbar or on property pages Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 The following alert may appear Open Associated Perspective This kind of project is associated with the C C perspective Do you want to open this perspective now Remember my decision Select Yes to proceed A folder with the newly created project will now appear in the Project Explorer section it is empty because currently there are no files In order to add a new file right click on the project name and select New File in the context menu page 44 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 LOG Eclipse Matrom Fle Edt Refactor Navigate Search Project Run Window Help r 2 av Le hs Sy e O Q S 9 ore poled ania B I HET AR E ae ales gt Hi Ineclud New Open in New Window Copy Ctrl C Cj Folder Paste Ctrley ss hy Header File Delete Delete z Gi Source File Mowe as Rename p2 Source peper my Import C Project neh ay Export C Project A Other Clean Project B Refresh F5 Close Pr
49. ns LAN or High Speed Internet Network Tasks i Local Area Connection 6 x Local Area Connection Create a new connection Connected Connected Change Windows Firewall E m Linux USB EthernetiRNDIS Ga k Broadcom Metstreme 57xx Gig settings y Local 4rea Connection 3 Connected See Also Lia TAP Wins2 Adapter v coLinux ij Network Troubleshooter Other Places g Control Panel J My Network Places My Documents a My Computer Details Network Connections System Folder Select the two connections page 32 of 91 s Network Connections File Edit View Favorites Tools Advanced Help gt amp GE sek as DB P Search gt Folders Address Network Connections LAN or High Speed Internet Network Tasks ocal Area Connection 6 Local 4rea Connection E Create a new connection Connected Connected Change Windows Firewall Lf Sess EthernetiRNDIS Ga O k Broadcom Netstreme 57xx Gig settings e gs Repair the selected ocal Grea Connection 3 connections Connected l m S4P Winse Adapter YS tcoLinus Other Places E Control Panel J My Network Places My Documents ig My Computer Details 2 items selected 2 objects selected Once selected right click and choose the voice Bridge Connections Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 EES page 33 of 91 s Network Connections File Edit Back gp Pi
50. nt Wireless Test Manager MET Audio Related Programs Broadcom TA CSR UniFi Dell Filezilla Click Install page 14 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 Telit Development Platform 5 Ed a Would vou like to install Colinux a E You will be asked to install coLinux if you haven t previously installed it click Ok otherwise click Cancel and skip to Xming installation If you have chosen to install coLinux follow the next screenshots Cooperative Linux 0 7 1 Setup Welcome to the coLinux 0 7 1 Setup Wizard This wizard will guide you through the installation of Cooperative Linux 0 7 1 Click Next bo continue Click Next Reproduction forbidde n without Telit Communications S p A written authorization All Rights Reserved page 15 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 Cooperative Linux 0 7 1 Setup 4h License Agreement Please review the license terms before installing Cooperative Linux 0 7 1 Press Page Down to see the rest of the agreement GAL GENERAL PUBLIC LICENSE Version 2 June 1991 Copyright 2 1989 1991 Free Software Foundation Inc 59 Temple Place Suite 330 Boston MA 02111 1307 USA Everyone is permitted to copy and distribute verbatim copies of this license document but changing it is not allowed Preamble The licenses For mos
51. nt consists of different Open Source Software licensed as described in the following paragraphs f 5 ely i oa a pele i rai B iF tI nt ai y i r g oa Cia g Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 6 of 91 gaj Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 1 4 1 Linux Linux is an operating system for computers it was originally created starting in 1991 by Finnish programmer Linus Torvalds with the assistance of developers from around the globe It is licensed under the Free Software Foundation s GNU Project s GNU General Public License version 2 1 4 2 coLinux Cooperative Linux short named coLinux is a port of the Linux kernel that allows it to run cooperatively alongside another operating system on a single machine It is released under GNU General Public License 1 4 3 Xming Xming is the leading free unlimited X Window Server for Microsoft Windows It is released under MIT X11 license 1 4 4 Eclipse IDE Eclipse is an open source community whose projects are focused on building an open development platform comprised of extensible frameworks tools and runtimes for building deploying and managing software across the lifecycle Its projects are released under the Eclipse Public License 1 5 Product Overview The GE863 PRO is an innovation to the quad band RoHS comp
52. nt due to typographical errors inaccurate information or improvements to programs and or equipment at any time and without notice Such changes will nevertheless be incorporated into new editions of this document Copyright Transmittal reproduction dissemination and or editing of this document as well as utilization of its contents and communication thereof to others without express authorization are prohibited Offenders will be held liable for payment of damages All rights are reserved Copyright Telit Communications SpA 2008 2009 i Y j E l b Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 2 of 91 wireless solutions Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 Applicable Products GSM GPRS Recommended U Boot version 05 0005 20 00 0000 Linux SW Version ae All Rights Reserved page 3 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 Contents CONTENT S aonan A een eee A AA ee eee 4 DWT O OU CUO soei E E E E E E 6 a Pa E ee e E E E E E 6 ka PRIS CO serne NEE ENT 6 1 3 Contact Information SUPPOFt cc ccccccee cess ee eeeeeeeeeneeeneeenscaesea seen seen eseuesanesaasoeeeseesonesoeenes 6 1 4 Open Source COINS OS acs seta sear vnerncdsnatacemnacavecteeated cause uetenwesdacer ss eeusaueeuaestasvecexescbecteranies
53. oject Close Unrelated Projects Exclude from build Build Configurations b Make targets b Now write the desired file name in the appropriate field if necessary write also the subdirectory where the file should be located and then click on the Finish button in order to end the file creation procedure Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 45 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 SEE File Create a new file resource Enter or select the parent folder Hella File name hello d lt lt Advanced Link te file in the file systern Browse Variables A blank text editor sheet will now appear in the main frame where you can write your application In the following example the classic Hello world program is shown page 46 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 GG Hello hello c Eclipse Plationm File Edt Refactor Navigate Search Project Run Window Help ray e i a amp G amp B H O Q HE E Project Explorer 5 T FoR as l hello ER ETa Se en Seite Be on or include estdia h gt wr Hello gt inl Includes z hello c int maini void printfi nHello world in EI stdio h return manlwoidi
54. operties Network Bridge Network Bridge 3 Properties fx Authentication Advanced Adapters Select the adapters you want to use to connect to computers on your local network EJ El Local Area Connection El Local 4rea Connection 3 El Local 4rea Connection 6 This connection uses the following items El Client for Microsoft Networks Jal File and Printer Sharing for Microsoft Networks i gos Packet Scheduler Intemet Protocol TCPAP 3 Install Uninstall Properties Show icon in notification area when connected page 35 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 Check the radio button Use the following IP address and insert these data e P address 192 168 121 1 e Subnet mask 255 255 255 0 Internet Protocol TCP IP Properties General ou can get IF settings assigned automatically if your network supports thie capability Otherwise you need to ask your network administrator for the appropriate IP settings Obtain an IP address automatically Use the following IP address IP address 192 168 121 1 Subnet mask 255 250 i Default gateway J Obtain DHS server address automatically Use the following DNS server addresses Preferred ONS server Alternate DNS server Click the Ok button then th
55. or ming Mw Run utility start programe with hidden console window Normal Pul TY Link SSH client O Portable PuTTY Link SSH client use with Portable PuT T Don t install an SSH client Current selection requires at least 9 3 MB of disk space Click Next Reproduction forbid page 20 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 24 Setup Xming Select Start Menu Folder Where should Setup place the program s shortcuts Don t create a Start Menu folder Click Next gt Setup Xming Select Additional Tasks Which additional tasks should be pertormed Select the additional tasks you would like Setup to pertorm while installing ming then click Mest Additional icons _ Create a desktop icon forming C Create a desktop icon for Launch Create a Quick Launch icon for ming _ Create a Quick Launch icon for Launch Other tasks Associate SLaunch exe with the launch file extension Reproduction forbidden without Telit C ommunications S p A written authorization All Rights Reserved page 21 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 Click Next 2 Setup Xming Ready to Install Setup is now ready to begin installing arming on Your computer Click Install to continue with the installation or click Back if you want to review or change any set
56. ould you like to install ming M Cancel If you haven t previously installed it click Ok otherwise Cancel and skip to the file system image installation If you have chosen to install Xming follow the next screenshots Setup Xming Welcome to the Xming Setup Wizard This will install Sring 6 9 0 7 on your computer lk is recommended that you close all other applications before continuing Click Nest to continue or Cancel to exit Setup Click Next page 19 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 2 Setup Xming Select Destination Location Where should ming be installed CJ Setup will install rung into the following Folder To continue click Mest IF vou would like to select a different folder click Browse Cscolinux smin At least 4 7 MB of free disk space is required Click Browse to select the previously chosen Telit Development Platform installation directory The installer will automatically add the path part for Xming according to the previous examples the path will become c colinux Xming or c telit colinux Xming 24 Setu p Xming Select Components Which components should be installed Select the components you want to install clear the components you do not want to Install Click Nest when you are ready to continue Full installation ic Mon LIS Keyboard support M Launch wizard frontend f
57. pment Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 e For Ethernet on USB connection type modprobe g_ether ifconfig usbO 192 168 121 3 netmask 255 255 255 0 telnetd e Press the Esc key then press the following keys on the keyboard in succession wq and Enter You should see again the shell prompt GE863 PRO3 HyperTerminal KB Fie Edit View Call Transfer Help la o3 05 E modprobe g_ether ifconfig usb 192 168 121 3 netmask 259 299 209 0 telnetd ee a A ee ce a a a A Connected 0 01 54 Auto detect 115200 84 1 After reboot the IP configuration should be working ai f i th iy Di n ae i P Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 38 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 5 Starting Eclipse To start the IDE follow these steps e Be sure that Colinux has been started to start it go to Start menu All Programs Telit Development Platform Start Colinux e After loading go to Start menu All Programs Telit Development Platform Telit Customized Eclipse e You will be prompted to choose a location in the filesystem for creating the workspace A path without spaces is recommended Note that you can find your Windows filesystem in mnt windows Workspace launcher Select a workspac
58. r J ih e l Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 51 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 6 3 Downloading a file to the target Once the project has been compiled you can download it to the target There are two possible options e Downloading the file using the Ethernet USB port e Downloading the file using the serial port 6 3 1 Download through the Ethernet USB port The simplest way to download the binary of a project is to use the IDE note that the telnet daemon must be running in the target Highlight the project whose binary is going to be transferred and go to Telit Download binary to GE863 PRO3 or click on the button highlighted by the red circle in the picture COG HeloWonddhelloe Eclipse Paton File Edt Refactor Navigate Search Project Mal Bela ls cir A ine Explorer x N Run Window Help Ee Start debugger erii El Download file to GE863 PRO3 Download binary to GE863 PRO3 include lt stdio he gt E gH HelloWorld p pr Binaries int maini void b K Includes printf Hello World gt Libraries return gt E Release i bo hella c j Reproduction ioridden without Telit Communications S p A written authorization All Rights Reserved page 52 of 91 Telit Development Environment User Guide for PRO3 wi
59. r rere rete rer rr rir rire rere irre ri rr tr rir irr rrr rere e ri rir ir rir ir rit ri rrrie tire riitty fire ir irr rr rit rrrtr rit eitiiis ferry 3 pd C Program Files yagarto binarm lf gdb exe 03 01 08 9 37 p C Work Projects GE863 PR O3 workbench Hello Release Hello See Eclipse s Help Contents for further information Window Help ue E Welcome ee F Help Contents R DP Search Dynamic Help key Assist Ctl shift Tips and Tricks Cheat Sheets Software Updates About Edipse Platform r J me i T g Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 74 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 8 General suggestions Using a workspace in Windows filesystem it is not possible to rename an existing project if you try the project name changes but connection to the files included is lost Using a workspace in Windows filesystem it is not possible to delete a project if you try the project seems to be deleted in the workspace but its files are still present in the filesystem Using a workspace in Windows filesystem sometimes Eclipse reports error in preferences saving however this is only a warning If Eclipse reports error in saving files containing special characters you have to change text enconding preferences Go to Windows Preferences General Workspace Text Fil
60. roject the file to be transferred you can right click on it and choose the voice Download File to Target of the pop up menu page 55 of 91 lelit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 w Ofer slalloVorlel jello e Eclipse Platonm File Edt Refactor Navigate Search Project Elt Run Window Help juo amp teja a Ky G 4 o H O A L Project Explorer EN T a 1 e hello 2 confguration txt 7 eS HelleWorld include lt stdio h gt b 3 Binaries int main void b K Includes printf Hello World gt A Libraries return gt E Release i gt e hello c B confguration txt New Open Open With Copy Ctrl C 3 Paste trie Delete Delete Mowe Rename ET Irnpert A Export 2 Refresh Clean Selected Filels Build Selected File s Bun As Debug As Bam Compare With Replace With Download File Target Properties Exclude frorn build Build onf gurations Make targets iz Fa f i 5 on i ee i og i j j 5 ye Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 56 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 N Problerns J Tasks E Console 4 k E Properties Blt Command Output 7 irm TestAppPc sln rm cannot remove TestAppPC sln No such file or dir
61. sses for coLinux and the target then choose the Advanced Mode of the Radio Button and insert the proper ip address in the coLinux ip text field then click the Start Upgrade button C Telit Upgrade u boot a olx d Telit c Simple mode Advanced mode coLinux IF 192 168 121 2 If you want to see which updates the tool carried out click on Info Show Updates he U book st91sam9260 tar gz version 20 00 0000 page 90 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 Appendix G Transferring files between coLinux and Windows For transferring files between coLinux and Windows filesystems it is possible to use a program called Midnight Commander X me deblan mnt Shes EE Command Options Right E a rity SF H EI tie UP IIR A Abi windows 1024 Jul 24 2007 EEn fete zlost ound media mont ropt zta Fale Aver f dl RE app Windows rbin Hint To change directory halfway through typing a command use M c quick cdi iHelp 2em O sMiew 4Edit 5Eopg O GRentow Hedin Slelete gfain 100uit It works as a normal file explorer the window is divided into two columns each one showing the content of a directory in the filesystem Midn
62. stall the development environment a 32 bit x86 platform with the following characteristics is required e Microsoft Windows XP installed e Atleast 1GB of Ram e 5 1 GB of hard disk space 3 3 Installation This paragraph shows how to install and configure the development environment on a Windows XP based host PC Note that the development environment must be installed with an administrator account For a correct installation and usage of Telit Development Environment it is strongly suggested to turn off any software firewall especially Windows Firewall service active in the host system Otherwise an aimed configuration of the firewall is needed in order to allow the communications between Windows and coLinux Note that the installation will create a C class network 192 168 121 0 if you already have in your system such a network you have to change manually after the SS 1 4 a z l oer BiT n j E il f gt d F Bia fl TE a s Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 11 of 91 b Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 installation all the 192 168 121 x addresses to a free address space in your network Refer to Appendix A for details Note that a new installation of the development environment will completely destroy a previous installation if present Refer to Appendix B to le
63. t Platform Start Colinux _ i p Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 25 of 91 lelit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 NET Registered protocol family 17 RAMDISK Compressed image found at block UFS Mounted root Cext2 Filesystem input AT Translated Set 2 keyboard on cokhd peree ree cobd warning sh 2O21 reiserfs_fill_super can not find reiserfs on co ERTS fs INFO recovery required on readonly filesystem FRTS fs write access will be enabled during recovery kjournald starting Commit interval 5 seconds FRTS3 fs recovery complete EAT3 fs mounted Filesystem with ordered data mode ERT3 fs mounted filesystem with ordered data mode UFS Mounted root text3 Filesystem readonly Trying to move old root to initrd okay Freeing unused kernel memory 112k freed kjournald starting Commit interval 5 seconds Adding 1648568k swap on e dev ecohbdi Priopity 1 extents 1 EAT3 fs warning maximal mount count reached running e2fsck is recommended ERTS FS on cobd internal journal NET Registered protocol family i Disabled Privacy Extensions on device ch2hffF2ht los IPu6 over Pv4 tunneling driver ethl no Pv6 routers present eth no ITPv6 routers present After loading go to The first time you launch the application you will be prompted with the following window
64. t software are designed to take away your TF you accept the terms of the agreement click I Agree to continue You musk accept the agreement to install Cooperative Linux 0 7 1 Click Agree Choose Components Choose which Features of Cooperative Linux 0 7 1 vou want to install Check the components you want to install and uncheck the components you don t wank to install Click Next to continue Select components to install E f colin SME Root Filesystem image Download Description Space required 5 1MB Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 16 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 Cooperative Linux 0 7 1 Setup Choose Install Location Choose the Folder in which to install Cooperative Linux 0 7 1 Setup will install Cooperative Linux 0 7 1 in the Following Folder To install in a different Folder click Browse and select another Folder Click Next bo continue Destination Folder Space required 5 1MB Space available 76 66 Select the previously chosen Telit Development Installation directory for example c colinux or c telit colinux Get WinPCAP Install Bridged Ethernet WinPCAP dependency Cooperative Linux depends on the WinPtap library in order bo provide Bridged Ethernet support Please download and install WinPCap From one of the addresses below http
65. th Linux 1vv0300780 Rev 2 21 05 09 Alternatively in the Project Explorer you can right click on the binary to be transferred and choose the voice Telit Download Binary to Target of the pop up menu G HelloWonddihelloe Eclipse Mationm Fle Edt Refactor Navigate Search Project Elt Run Window Help OH S S O helo z Fa Project Explorer 2 4 x x a HelloWorld l include lt stdio h gt v H Binaries ist aint 4 printf Hello World t HelloWorld arrn le gt Hi Includes New gt Libraries ERED gt E Release Open With gt hello c Copy Ctrl e 3 Paste trit Delete Delete Mowe Rename TEL lmpart A Export 2 Retresh Exclude from build Build Configurations Make targets Run As Debug As Clean Selected Filefs Build Selected Filels Bam Compare With Replace With Start Debugger Download Binary Target Properties Alt Enter If the transfer succeeds you should see in the console a similar message page 53 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 fai Proablerns JE Tasks Console xie EE Ek bE Tal El mir E Blt Command Output F Pel Irm Helloworld wget http 192 168 121 2 apache2 default Helloworld Connecting to 192 168 121 2 192 168 121 2 80 HelloWorld Gs Hell oo rl d 100 TRC CARR CRC C D C D C E DC JA D D E DE D
66. tings CA coLinux ming Setup type Full installation Selected components ming binary Non US Keyboard support Launch wizard frontend for Srning Run utility start programe with hidden console window Normal PuTTY Link SSH client Click Install 25 Setup Xming Completing the Xming Setup Wizard Setup has finished installing ming on your computer The application may be launched by selecting the installed icons Click Finish to exit Setup C Launch ming Uncheck the voice Launch Xming and click Finish den without Telit Communications S p A written authorization All Rights Reserved page 22 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 After installing Xming or choosing not to install it you will be prompted with the following window T Zip self extracting archive Extract to Extract Select the previously chosen Telit Development Platform installation directory and click Extract normally the directory is already correct and you have only to click Extract Please note that this step can last several minutes amp Telit Development Platform Setup Installation Complete Setup was completed successfully Completed SLL LLL ELLE LEE EL EL ELLE LEE ELLE ELLE LELELELLLLLL Show details Click Next page 23 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09
67. tion of the debug launch configuration for Hello debugging Eclipse may ask you if you want to save this configuration answer Yes lhl T A F Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 64 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 The Source and Common tabs can be left in their default state 7 2 2 Organizing Favorites In order to simplify the debug process you can add the launch configuration that you wish to use in the Favorites For example add the Hello embedded debug launch configuration into the Debug pull down menu s list of favorites In the toolbar click on the down arrowhead next to the debug symbol and then click Organize Favorites O Q BS Debug As F gt i Open Debug Dialog ZE Organiz Favorites Click on Add and either checkmark the Hello or click the Select All button Finally click OK to enter this debug launch configuration into the debugger list of favorites as shown below Add Debug Favorites fj EEE E Select Launch Configurations Organize Debug Favorites Organize Debug Favorites Favorites Favorites FC Hello Select All Deselect All Now when you click on the Debug Toolbar
68. tives preference page C ii Fiter matched 5 of 5 terns M den without Telit Communications S p A written authorization All Rights Reserved page 61 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 The Debug Create manage and run configurations window changes to the dialog shown below Start by making sure that the Main tab is selected In the Name text box enter the name of this debug launch configuration usually the project name In this example use the Hello In the Project text box use the Browse button to find the project Hello In the C C Application text box use the Search Project button to find the executable Hello Debug Create manage and run configurations Name Helo Release PR a i aera ce a T x E ain Ke ebugger W Cormmands Be ource Common E CIT Attach to Local Applic ce C C Local Application Project E C C Postmortem debuggs Helle Browse F Zylin Embedded debug Cyg C C Application To ag Zylin Embedded debug iN atn Release H aiis Search Project Browse FE Hello Release C Application console 1 Sy Fiter matched 6 of 6 terms ee Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 62 of 91 Telit Development Environment User Guide for PRO3
69. wireless solutions Teli Development Environment User Guide For C C applications in GE863 PRO with Linux 1vv0300780 Rev 2 21 05 09 N N has ma fi Q T a i i E h T t 1 k rail p ti 3 ee F wee 2 Making machines talk Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 Disclaimer The information contained in this document is the proprietary information of Telit Communications S p A and its affiliates TELIT The contents are confidential and any disclosure to persons other than the officers employees agents or subcontractors of the owner or licensee of this document without the prior written consent of Telit is strictly prohibited Telit makes every effort to ensure the quality of the information it makes available Notwithstanding the foregoing Telit does not make any warranty as to the information contained herein and does not accept any liability for any injury loss or damage of any kind incurred by use of or reliance upon the information Telit disclaims any and all responsibility for the application of the devices characterized in this document and notes that the application of the device must comply with the safety standards of the applicable country and where applicable with the relevant wiring rules Telit reserves the right to make modifications additions and deletions to this docume
70. with the IDE Chapter 6 Creating a Project describes how to create a C C project and how to deploy it to the target Chapter 7 Debugging an Application describes how to debug your programs Chapter 8 General Suggestion contains some practical advices Various appendixes with useful information for other tasks 1 7 Text Conventions This section lists the paragraph and font styles used for the various types of information presented in this user guide Format Content Arial monospaced Linux shell commands at command prompt 1 8 Related Documents The following documents are related to this user guide 1 TelitGE863PRO3 Hardware User Guide 1vv0300773a 2 TelitGE863PRO3 EVK User Guide 1VV0300776 3 TelitGE863PRO3 Linux SW User Guide 1vv0300781 4 TelitGE863PRO3 Linux GSM Library User Guide 1vv0300782 5 TelitGE863PRO3 Product Description 80285ST10036a 6 TelitGE863PRO3 U boot Software User Guide 1vv0300777 All documentation can be downloaded from Telit s official web site www telit com if not otherwise indicated ite i A i i blll a j j i h tions S p A written authorization All Rights Reserved page 8 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 1 9 Document History Revision Date Changes ISSUE 0 26 05 08 First Release ISSUE 1 31 07 08 Added new paragraph 8 General Suggestion ISSUE 2 21 05 09 6 2 Linking an application a
71. y Simply type the pthread value when the window below will appear and then push the OK button FEnter Value Libraries i l pthread Please note that the l linker option automatically completes the library name with the lib prefix therefore there is no need to indicate the full library name libpthread h j s Gs m F i 5 Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 50 of 91 Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 Once libpthread a has been successfully added to the project push the Apply and then the OK buttons of the main tab Now the project using libpthread a is ready to be compiled Properties for cmu test threaded Settings gia ka ae bl Resource Configuration Release 7 Manage configurations Builders reso Build i ol tl Ee bol settings A Build steps eer uild artifact oy Binary parsers 9 Error parsers Environment ia z uclibe cornpile Library search path L E oe foptfcrosstoolsttelitylib fopt crasstools lib Bal TEA editor ee Preprocessor Variables ae Symibals C C General 3 Directories Project References ee Optimization Refactoring History i Debugging Run Debug Settings 83 warnings ga Miscellaneous 683 uelibe C linker ee General g Libraries e uclibe adaki E General Restore Defaults Apply pi r A 7 r i ii j f
72. yy is a date Click Extract THIS METHOD COMPLETELY DESTROYS ALL THE DATA YOU HAVE STORED INSIDE COLINUX FILESYSTEM USE THIS ONLY IF YOU HAVE NOT ANY OTHER SOLUTION TO RESTORE THE SYSTEM After several minutes the development environment will be restored If this method doesn t work uninstall the entire development environment including coLinux and Xming delete the installation directory and try to reinstall it following the steps reported in 3 3 o i j gale A Di i ang pi PeF F r AA r Tr haa ff r Reproduction forbidden without Telit Communications S p A written authorization All Rights Reserved page 79 of 91 i i Telit Development Environment User Guide for PRO3 with Linux 1vv0300780 Rev 2 21 05 09 Appendix D Copying C libraries in the target By default the target does not have the libraries necessary for C applications In order to copy them follow these steps e Start coLinux Start menu All Programs Telit Development Platform Start Colinux e Open a console Start menu All Programs Telit Development Platform Console e Inthe console type mkdir root cpp_libraries cd opt crosstools usr arm linux uclibc 11b arm linux objcopy strip debug libstdc so 6 root cpp_libraries libstdct so 6 arm linux objcopy strip debug libgcc_s so 1 root cpp_libraries 1libgcc_s so 1 e Copy the two files root cpp_libraries 1libstdct so 6

Linux Development Environment User Guide

Contents

Download Pdf Manuals

Related Search

Related Contents