AN10846 Getting started with NicheLite for LPC3250
Contents
1. to display a list of available commands AN10846_1 NXP B V 2009 All rights reserved Application note Rev 01 1 July 2009 11 of 17 NXP Semiconductors AN1 0846 Getting started with NicheLite for LPC3250 Terminal HyperTerminal File Edit view Call Transfer Help De 3 2p INET gt help SNMP Station general commands help help with menus state show current station setup delay set milliseconds to wait between pings host set default active IP host length set default ping packet length quit quit station program ping send a ping setip set interface IP address version display version information fcommand pass command to OS shell Alan try help generalidiagnosticivfsitftpcizzzl gt a ANSIW 115200 8 N 1 Fig 12 System console displaying a list of available commands As an example you can try the state command in order to get the current device setup INET gt state iface 0 if0 IP addr 192 168 1 102 subnet 255 255 255 0 gateway 192 168 1 1 current tick count 1959334 Task wakeups netmain 385211318 nettick 978109 keyboard 979085 webport 385211320 The host command allows you to specify the remote host IP address INET gt host 192 168 1 100 Then use the ping command to check if the host is reachable or not INET gt ping AN10846_1 NXP B V 2009 All rights reserved Application note Rev 01 1 July 2009 12 of 17 NXP S2. AN10846 Getting started with NicheLite for LPC3250 Rev 01 1 July 2009 Application note Document information Info Content Keywords LPC3250 NicheLite Ethernet TCP IP Stack Web Server TFTP Absiract A guide to getting started with NicheLite for LPC3250 founded by Philips NXP Semiconductors AN1 0846 Getting started with NicheLite for LPC3250 Revision history Rev Date Description 01 20090701 Initial version Contact information For additional information please visit http www nxp com For sales office addresses please send an email to salesaddresses nxp com AN10846_1 NXP B V 2009 All rights reserved Application note Rev 01 1 July 2009 2 of 17 NXP Semiconductors AN10846 1 Introduction Geiting started with NicheLite for LPC3250 The NXP LPC3250 microcontroller is an ARM926E J S core with a Vector Floating Point VFP co processor and a large set of standard peripherals including an Ethernet controller The NicheLite for LPC source code which is a variant of the full stack available from InterNiche is available for free download from NXP s website http www standardics nxp com su ort software nichelite This application note will assist the user in configuring and testing the NicheLite Stack using the phyCORE LPC3250 evaluation board from PHYTEC Keil tool chain is used full version is required in this application note but the same concepts appl
3. F E517 F021 E3 x 1 t L 70 DO 9F E5 1B FO 21 E3 6C DO 9F E5 1F F021 E3 p Ll l 68 DO 9F E5 00 FO AO E1 64 00 9F E501 10 AO E3 h o epee 00 10 80 E5 00 00 AO E3 10 OF 01 EE 17 OF 07 EE 17 OF 08 EE E9 FF FF EB 40 5600 EB 1300 00 EA V 00 10 OF E1 00 10 80 E5 80 10 81 E3 01 FO2F E1 nenn l OE FO AO E1 00 10 90 E5 01 FO 2F E1 OE FOAOE 1 rasis 20 00 9F E5 14 10 9F E5 OE FO AO E1 00 ED 03 08 niecne 00 F1 03 08 00 F2 03 08 00 F3 03 08 00 F4 03 08 00 EC 03 08 14 40 00 40 6C AC 01 08 00 00 00 00 l NXP B V 2009 All rights reserved Application note Rev 01 1 July 2009 13 of 17 NXP Semiconductors AN1 0846 AN10846_1 Getting started with NicheLite for LPC3250 The linkstats command displays information for the hardware associated with the provided interface INET gt linkstats 1 Interrupts rx 109 tx 23 total 132 coll1 0 collx 0 overrun 0 Sendq max 1 current 0 Int enable B9 pending 40 Rx Descriptors and Status Next In 1 Next Out 1 08023480 08022436 800005FD 08023498 C420003F 00FF014D 08023488 08020C16 800005FD 080234A0 C420003F 007E014D 08023490 08022A3E 800005FD 080234A8 C460005D 01FE019F Tx Descriptors and Status Next In 1 Next Out 1 080234BC 080231DE C000002D 080234CC 00000000 080234C4 08021826 C0000156 080234D0 00000000 5 5 3 Statistic commands The following commands can be used to display statistics related to their protocol laye
4. _1 NXP B V 2009 All rights reserved Application note Rev 01 1 July 2009 10 of 17 NXP Semiconductors AN1 0846 Getting started with NicheLite for LPC3250 Terminal Hyper Terminal Fie Edit Yiew Call Transfer Help Da 33 0A INET gt tfsry tftp server ON INET gt tftp server moved 1048576 bytes to 192 168 1 100 Fig 11 The NicheLite system console provides status regarding the TFTP server activity In order to upload a local file from the PC to the device use the following syntax tftp 192 168 1 102 put filename Then use the following command in order to retrieve it from the board to check if it was successfully saved in the board s TFTP server tftp 192 168 1 102 get filename Before using the above command delete or rename the original local file to be sure the file is retrieved from the server The vfsfilelist command from the system console may also be used in order to get a list of the file system and verify that the new uploaded file is there The Windows command line interface and the NicheLite system console both provide status of the commands execution 5 5 Using the command line interface When the stack is running the INET gt prompt is shown in the system console Use this prompt in order to interact with the stack This will allow the ability to Monitor Debug or even Configure the stack at runtime 5 5 1 General commands Type the word help or question mark
5. completeness of information included herein and shall have no liability for the consequences of use of such information 6 2 Disclaimers General Information in this document is believed to be accurate and reliable However NXP Semiconductors does not give any representations or warranties expressed or implied as to the accuracy or completeness of such information and shall have no liability for the consequences of use of such information Right to make changes NXP Semiconductors reserves the right to make changes to information published in this document including without limitation specifications and product descriptions at any time and without notice This document supersedes and replaces all information supplied prior to the publication hereof Suitability for use NXP Semiconductors products are not designed authorized or warranted to be suitable for use in medical military aircraft space or life support equipment nor in applications where failure or malfunction of a NXP Semiconductors product can reasonably be expected AN10846_1 to result in personal injury death or severe property or environmental damage NXP Semiconductors accepts no liability for inclusion and or use of NXP Semiconductors products in such equipment or applications and therefore such inclusion and or use is for the customer s own risk Applications Applications that are described herein for any of these products are for illustrative purp
6. ct an incoming HTTP request and no matter what file is requested it will always respond with the same web page which can be seen in Fig 8 In order to test it open a web browser and enter the board address 192 168 1 102 in this case and the HTTP listener will respond with the web page as shown in Fig 8 NicheLite for LPC Sample Project Windows Internet Explorer E http 192 168 1 102 v i x eri iel File Edit view Favorites Tools Help Snagit Bs i w k NicheLite for LPC Sample Project B a v p Page Gi Tools Hello World NicheLite for LPC Sample Project Congratulations you are now ready to tailor this project to fitthe needs of your particular project For questions regarding the LPC please visit NXP at httov www nxp com microcontrollers For questions regarding NicheLite add on products protocol upgrades or to arrange for technical support please visit InterNiche at http www iniche com Ipclite php Some key features of the NicheLite for LPC stack ARP IPv4 without fragmentation reassembly ICMP UDP TCP Supporting InterNiche s Light Weight API and a Zero Copy option DHCP Client DNS Client BOOTP Ping App NicheTool NicheFile VFS TFTP client and server Local intranet 100 Fig 8 Using the web browser to access the HTTP listener 5 4 Testing TFTP server NicheLite includes both TFTP server and TFTP c
7. cted to and configure it as 115200 N 8 1 Start Keil uVision3 and open the NicheLite software project Build the project if necessary and start a Debug session Once the code is loaded pressing the Run button starts code execution Fig 6 shows a screenshot of the NicheLite system s console after initialization In this case a default IP address is configured and DHCP is enabled After the Ethernet module initialization the address 192 168 1 120 is assigned to the interface However after DHCP successfully acquires a dynamic IP address the new leased address 192 168 1 102 is reassigned to this interface AN10846_1 NXP B V 2009 All rights reserved Application note Rev 01 1 July 2009 7 of 17 NXP Semiconductors AN1 0846 AN10846_1 Getting started with NicheLite for LPC3250 Terminal HyperTerminal File Edit View Call Transfer Help Dw 5S O08 amp NicheLite for LPC v3 0 Copyright 1997 2006 by InterNiche Technologies All rights reserved LPC3250 Auto negotiation 100 Mbps Full Duplex IP address of if 192 168 1 120 Acquired IP address via DHCP client for interface if IP address 192 168 1 102 Subnet Mask 259 259 259 0 Gateway 192 168 1 1 INET gt _ A 0 00 51 ANSIW 115200 8 N 1 NUM Fig 6 NicheLite system s console after initialization After dynamic IP assignment the CLI command line interface prompt appears General commands and diagnostic commands can be used from th
8. emiconductors AN1 0846 AN10846_1 5 5 2 Getting started with NicheLite for LPC3250 ping sent check icmp for reply Use the icmp command described in Section 5 5 3 to check the reply Diagnostic commands help diagnostic can be used in order to display available commands some are for diagnostic purposes while others are for statistic information described in the next section The buffers command displays allocated packet buffer information INET gt buffers PACKET len buffer que data offset 0 0801B958 1536 08020004 big 00 00 FF FF FF FF FF FF 00 1C 23 OD 0801B998 1536 0802060C non 00 00 01 00 5E 00 00 FB 00 1C 23 OD 0801 B9D8 1536 08020C14 big 00 00 FF FF FF FF FF FF 00 1D 7E E0O 0801BA18 1536 0802121C non 00 00 FF FF FF FF FF FF 00 1D 7E EO 0801BA58 1536 08021824 big 00 00 00 1D 7E E0 A2 D2 00 OF CC 23 4 0801 BA98 1536 08021E2C big 00 00 00 OF CC 23 00 01 00 1D 7E EO It is possible to dump a block of memory using the dbytes command INET gt dbytes 0x0 100 18 FO 9F E5 18 F0 9F E5 18 FO 9F E518 F0 9F ES 18 FO 9F E5 18 F0 9F E5 18 FO 9F E5 18 F0 9F ES 88 00 00 08 40 00 00 08 88 5A 01 08 48 00 00 08 Z H 4C 00 00 08 44 00 00 08 B4 5A 01 08 38 5D 01 08 L D Z 8 FE FF FF EA FE FF FF EA FE FF FF EA FE FF FF EA OE 00 AO E1 13 FO 21 E3 7C DO 9F E5 12 FO 21 E3 Vikeal 78 DO 9F E5 11 FO 21 E3 74 DO 9
9. es mem and null define PRINTF_STDARG 1 build printf using stdarg h define TK_STDIN_DEVICE 1 Include stdin uart console code define BLOCKING_APPS_ 1 applications block rather than poll define INCLUDE_TCP 1 this link will include NetPort TCP w MIB Disabling unused modules helps minimize resource requirements NXP B V 2009 All rights reserved Application note Rev 01 1 July 2009 5 of 17 NXP Semiconductors AN1 0846 Geiting started with NicheLite for LPC3250 4 2 Setting the MAC address The MAC address is hard coded in the emac c file The eth_info structure is initialized with the default value static struct eth info eth_info ETH_DEVICES MAC BASE_ADDR 0x00 OxOf Oxcc 0x23 0x00 0x01 0x00 0x00 EMAC_INT Fig 3 The eth_info structure in the emac c file contains the default MAC address ff MAC address 00 0F CC 23 00 01 4 3 Configuring the IP address 4 3 1 In a TCP IP Network every station has to be configured with a unique and valid IP address This configuration can be hard coded into the program known as a static IP address or it could be assigned dynamically using a specific protocol such as DHCP Dynamic Host Configuration Protocol which requires a DHCP server attending the request from the DHCP client component running on the devices known as a Dynamic IP address Static IP address configuration In the following code snippe
10. ftp B vfs The LPC_30doc folder contains the documentation The LPC_30src folder contains the source code which is organized in the following directories AN10846_1 allports code common to all ports and not specific to any TCP IP layer h most header files are included in this folder listener files necessary to implement a simple TCP listener a kind of simple web server lpc325x this folder includes all code specific to the LPC3250 Lst all listing files generated by the tool are included in this folder mip this folder contains the implementation of IP ARP ICMP and UDP protocols misclib contains the files which implement a command line interface CLI used for testing and monitoring the stack micp this files implement the TCP layer net this folder contains network support files DHCP DNS and code for manage queues Obj all object files generated by Keil The executable code is also generated into this folder tftp a TFTP client and server code vfs files needed for a File System implementation NXP B V 2009 All rights reserved Application note Rev 01 1 July 2009 4 of 17 NXP Semiconductors AN1 0846 Getting started with NicheLite for LPC3250 The Keil project files are located in the LPC_30src directory 4 Configuring the TCP IP stack AN10846_1 4 1 Selecting the TCP IP stack modules In the ipport h header file the modules can be disabled enabled by c
11. g network connectivity eeeeeeeee Testing ATT Piisccccccccecccieeestectestiee atten scncieee Testing TFTP server Using the command line interface 11 General COMMANAGS cccesteeeeeseeeeeeseeeees 11 Diagnostic Commands cceceeeeeeeeeeeeeeees 13 Statistic COMMAMNAS cceceeceeeeesteeeseteeees 14 Legal information ccssseecesseeeesseeeeensseeneeneee 16 DefIMIMONS isset eeina 16 DiSCIAIMELS ccceeeeeeeeeeeeeeeeeeeeeeeteeeeeeeeeeeeeaee 16 Trademarks aisiais adea 16 COMLCIUS i scceis casscccscacscecicacecissseceascacsetsscasedsaxeececiss 17 founded by Please be aware that important notices concerning this document and the product s described herein have been included in the section Legal information NXP B V 2009 All rights reserved For more information please visit http www nxp com For sales office addresses email to salesaddresses nxp com Date of release 1 July 2009 Document identifier AN10846_1
12. is prompt For more details refer to Section 5 5 5 2 Testing network connectivity While the stack runs you can test the network connectivity using the ping utility Use Windows command line interface cmd exe program for this c C WINDOWS system32 cmd exe gt ping 192 168 1 182 192 168 1 1 2 TTL 64 192 168 1 182 TTL 64 192 168 1 142 i TTL 64 192 168 1 182 TTL 64 ing statistics for 192 168 1 162 Packets Sent 4 Received 4 Lost O z loss pproximate round trip times in milli seconds Minimum ms Maximum ms Average Gms gt Fig 7 Using ping utility for test network connectivity If there are no replies from the board check the network cables or any network device such as a router switch or hub In general if DHCP is used and a dynamic IP address is obtained the network is okay and the problem may be something like a network cable being disconnected If the hardware is checked and still not working check if the stack is running verified by using the CL interface Section 5 5 This can be used last in order to issue a ping command to the PC NXP B V 2009 All rights reserved Application note Rev 01 1 July 2009 8 of 17 NXP Semiconductors AN1 0846 Getting started with NicheLite for LPC3250 5 3 Testing HTTP NicheLite includes an HTTP listener which acts as a very simple embedded web server It offers a basic functionality consisting on dete
13. lient components This section will show how to test the server functionality For help regarding the client component please refer to NicheLite documentation The first step in the test is to start the TFTP server using the tfsrv command from the CLI interface See Fig 9 The same command is used to stop the server AN10846_1 NXP B V 2009 All rights reserved Application note Rev 01 1 July 2009 9 of 17 NXP Semiconductors AN1 0846 Getting started with NicheLite for LPC3250 Terminal HyperTerminal INET gt tfsrv tftp server ON Fig 9 Starting the TFTP server using the tfsrv command Next issue a TFTP command from Windows command line interface using the following syntax tftp 192 168 1 102 get mem1M where mem1M is an existing file in NicheLite files system Fig 10 shows the results cn C WINDOWS system32 cmd exe C NTFTP_Test gt tftp 192 168 1 182 get memiM Transfer successful 16048576 bytes in 1 second 1648576 bytes s C TFTP_Test gt dir Volume in drive C has no label Volume Serial Number is BCEE 181B Directory of C TFTP_Test 06 17 2669 53 PM lt DIR gt 53 PM lt DIR gt oe 53 PM 1 653 719 memiM 52 PM O TFTP3968 2 File lt s gt 1 053 719 bytes 2 Dirts gt 17 973 194 752 bytes free C NTFTP_Test gt Fig 10 The mem1M file 1Mb size is retrieved from the board The status of the TFTP transfer is shown in the system console see Fig 11 AN10846
14. ommenting uncommenting the corresponding lines define INCLUDE_ARP 1 use Ethernet ARP define FULL_ICMP 1 use all ICMP ping only define OMIT_IPV4 not IPV4 use with MINI_IP define MINI_IP Use Nichelite mini IP layer define MINI_TCP Use Nichelite mini TCP layer define MINI_PING Build Light Weight Ping App for Niche Lite define BSDISH_RECV Include a BSD recv like routine with mini_tcp define BSDISH_SEND define NB_CONNECT define MUTE_WARNS define IN_ MENUS define NET_STATS include statistics printfs define QUEUE CHECKING 1 include code to check critical queues define INICHE_TASKS 1 define MEM_BLOCKS 1 list memory heap stats define TFTP_CLIENT 1 include TFTP client code define TFTP_SERVER 1 include TFTP server code 1 1 1 A 1 1 A 1 1 Include a BSD send like routine with mini_tcp 1 support Non Blocking connects TCP PPP et al 1 gen extra code to suppress compiler warnings 1 support for InterNiche menu system A InterNiche multitasking system define DNS_CLIENT include DNS client code define INICHE_TIMERS Provide Interval timers define DHCP_CLIENT include DHCP client code define INCLUDE_NVPARMS 1 non volatile NV parameters logic define NPDEBUG 1 turn on debugging dprintf s define VFS_FILES 1 include Virtual File System define USE_MEMDEV 1 Pseudo VFS fil
15. oses only NXP Semiconductors makes no representation or warranty that such applications will be suitable for the specified use without further testing or modification Export control This document as well as the item s described herein may be subject to export control regulations Export might require a prior authorization from national authorities 6 3 Trademarks Notice All referenced brands product names service names and trademarks are property of their respective owners NXP B V 2009 All rights reserved Application note Rev 01 1 July 2009 16 of 17 NXP Semiconductors AN10846 7 Contents Getting started with NicheLite for LPC3250 4 1 4 2 4 3 4 3 1 4 3 2 4 3 3 5 1 5 2 5 3 5 4 5 5 5 5 1 5 5 2 5 5 3 6 6 1 6 2 6 3 7 INtrodUCtiON eaiseivsecsesenicissctecscantsliscecsatisccxceetissweside Connecting and configuring the PHY3250 DOAN seeds ces E T E E Installing the software sssssssssssenunnnnnnnennnnnnnnnnnnn Configuring the TCP IP Stack ccsssseesee Selecting the TCP IP stack modules Setting the MAC address cscceseeeeeeeees Configuring the IP AddreSS ccscceeeeeee Static IP address configuration Dynamic IP address configuration Dynamic IP address configuration with a default IP address iniaeeaa iaaea a ea a Testing the TCP IP Stack ccssecssesseenseeeneeee Initial testre aaiae arae aana Testin
16. r INET gt arp arp Requests In 6 out 3 arp Replys In 3 out 6 X MAC Address iface pend IP ctime Itime 7 001D7E EOA2D2 1 N 192 168 1 1 867052 867052 INET gt ip IP MIB statistics Gateway YES default TTL 64 rcv total 96 headererr 0 address err 54 rcv unknown Protocls 0 delivered 42 send total 14 discarded 0 No routes 0 INET gt icmp ICMP layer stats icmpInMsgs 8 icmplInErrors 0 echoRegs 0 echoReps 8 unhandledTypes 0 NXP B V 2009 All rights reserved Application note Rev 01 1 July 2009 14 of 17 NXP Semiconductors AN1 0846 AN10846_1 Getting started with NicheLite for LPC3250 icmpOutMsgs 3 icmpOutErrors 0 INET gt udp UDP MIB dump In Good 6 NoPort 0 Bad 31 Out 11 INET gt tcp tcpRtoAlgorithm 0 tcpRtoMin 0 tcpRtoMax 0 tcpMaxConn 0 tcpActiveOpens 0 tcpPassiveOpens 0 tcpAttemptFails 0 tcpEstabResets 0 tcpCurrEstab 0 tcplnSegs 0 tcpOutSegs 0 tcpRetransSegs 0 tcpInErrs 0 tcpOutRsts 0 NXP B V 2009 All rights reserved Application note Rev 01 1 July 2009 15 of 17 NXP Semiconductors AN10846 6 Legal information Geiting started with NicheLite for LPC3250 6 1 Definitions Draft The document is a draft version only The content is still under internal review and subject to formal approval which may result in modifications or additions NXP Semiconductors does not give any representations or warranties as to the accuracy or
17. t located in the pre_task_setup function in the in_stubs c file the desired Static IP address is assigned to 192 168 1 120 when the DHCP option is disabled the line define DHCP_CLIENT 1 should be commented out ifdef USE_EMAC Ethernet ifdef DHCP CLIENT netstatic 0 n flags NF_DHCPC netstatic i n_ipaddr 0xo00000000 020 000 4 else netstatic i n_ipaddr 0x780148C0 f 292 268 2 120 47 endif netstatic i snmask OxOOFFFFFF f 255 255 255 0 netstatic i n_defgw 0x010148C0 f 192 168 1 2 i endif Fig 4 Code snippet that configures the IP address AN10846_1 4 3 2 Please be aware that this code is executed when the non volatile NV parameters are not taken into account so this option is disabled line define INCLUDE_NVPARMS 1 should be commented out Dynamic IP address configuration If a Dynamic IP address configuration is needed then the DHCP option needs to be enabled uncomment the define DHCP_CLIENT 1 line if necessary Under these conditions the IP address is assigned to 0 0 0 0 see Fig 4 but using DHCP protocol a new IP address will be assigned from a DHCP server a leased IP address Of course a DHCP server should be available from the LAN NXP B V 2009 All rights reserved Application note Rev 01 1 July 2009 6 of 17 NXP Semiconductors AN1 0846 Getting started with NicheLite for LPC3250 4 3 3 Dynamic IP address configura
18. tion with a default IP address In some cases where Dynamic IP address is configured it would be desirable to have a default IP address assigned just in case a DHCP server is temporary unavailable so the device can continue working on the network For such particular cases configure the previous code as Fig 5 shows ifdef USE_EMAC Ethernet ifdef DHCP_CLIENT netstatic 0 n_flags NF_DHCPC netstatic i n_ipaddr 0x780148C0 E 292 268 2 220 7 else netstatic i n_ipaddr 0x780148C0 192 16852 22027 endif netstatic i snmask OxOOFFFFFF f 255 255 255 0 netstatic i n_defgw 0x010148C0 FE 292 266 252 y i endif Fig 5 Dynamic IP address configuration with a default IP address 5 Testing the TCP IP stack Once the stack configuration steps are completed some tests can be performed 5 1 Initial test In order to use the PC for the test the IP address must be configured accordingly Thus the PC s IP address should be in the same sub network as the board For example if the board is configured with a static IP address such 192 168 1 120 and subnet mask 255 255 255 0 then the PC could have an IP address like 192 168 1 100 or any other IP address not used in the same sub network In case the stack is configured using DHCP then the same DHCP server could be used to assign a dynamic IP address to the PC Open HyperTerminal using the PC s COM port where the serial cable is conne
19. y for other tools 2 Connecting and configuring the PHY3250 board AN10846_1 Configure all jumpers in the default position as per the PHY3250 board s User Manual Follow the below steps in order to prepare the connections see Fig 1 for details JTAG header phyCORE LPC3250 Carrier Board Ethernet input jack RJ 45 jack Fig 1 phyCORE LPC3250 board connectors UART5 DB9 connector bottom Power Supply 1 Connect the Keil U Link to the JTAG header connector 2 Connect a serial cable between the PHY3250 board UART5 DB9 connector and the PC serial port NXP B V 2009 All rights reserved Application note Rev 01 1 July 2009 3 of 17 NXP Semiconductors AN1 0846 3 4 Geiting started with NicheLite for LPC3250 Use an Ethernet cable to connect the PHY3250 s Ethernet port with an Ethernet router switch hub or directly to a PC using a crossover cable If dynamic IP assignment is desired use a router switch with DHCP server or install DHCP server software in the PC Connect the external Power Supply adaptor to the PHY3250 s power input jack 3 Installing the software Unzip the software into the PC s disk drive Fig 2 shows the directory structure Fig 2 NicheLite Source Code Organization B LPC3250NicheLite_Phytec3250 LPC_30doc a LPc_30sre O allports h O listener O Ipc325x D Lst O mip O misclib B mtcp O net obj O t
Download Pdf Manuals
Related Search
AN10846 Getting started with NicheLite for LPC3250