Linux LPC17XX BSP (Board Support Package) Guide for the Emcraft Systems LPC-LNX-EVB Board

Transcription

1 Linux LPC17XX BSP (Bard Supprt Package) Guide fr the Release

2 Table f Cntents 1. OVERVIEW PRODUCT CONTENTS SHIPPABLE HARDWARE ITEMS DOWNLOADABLE HARDWARE MATERIALS DOWNLOADABLE SOFTWARE MATERIALS DOWNLOADABLE DOCUMENTATION MATERIALS 3 3. SOFTWARE FUNCTIONALITY SUPPORTED FEATURES NEW AND CHANGED FEATURES KNOWN PROBLEMS & LIMITATIONS 5 4. HARDWARE SETUP HARDWARE INTERFACES BOARD CONNECTIONS EXTENSION INTERFACES User LEDs Expansin Interface Test Pints LPC-LNX-EVB BOARD LINUX SOFTWARE SET-UP U-BOOT ENVIRONMENT ETHERNET MAC ADDRESS NETWORK CONFIGURATION RUNNING PRE-INSTALLED LINUX IMAGE LOADING LINUX IMAGES U-BOOT BUILD U-BOOT INSTALLATION FURTHER MATERIALS SUPPORT.. 11 Linux LPC17XX BSP Guide fr the 2/11 Release

3 1. Overview This dcument is a Linux LPC17XX BSP (Bard Supprt Package) Guide fr the Emcraft Systems LPC-LNX-EVB bard, Release The BSP prvides a sftware develpment envirnment fr evaluatin and develpment f Linux n the Crtex-M3 prcessr cre f the NXP LPC17XX micrcntrller using the LPC-LNX-EVB bard as a hardware platfrm. This BSP is prvided as part f the Linux LPC17XX Evaluatin Kit. The evaluatin kit prvides a hardware platfrm and Linux sftware develpment envirnment fr the NXP LPC17XX micrcntrller. 2. Prduct Cntents This prduct includes the fllwing cmpnents Shippable Hardware Items The fllwing hardware items are shipped t custmers f this prduct: 1. LPC-LNX-EVB bard; 2. Mini-USB cable Dwnladable Hardware Materials The fllwing hardware materials are available fr dwnlad frm Emcraft's web site t custmers f this prduct: 1. LPC-LNX-EVB-2_0-schem.pdf - LPC-LNX-EVB schematics in PDF frmat; 2. LPC-LNX-EVB-2_0-bm.xls - LPC-LNX-EVB Bill-Of-Materials (BOM) in Excel frmat Dwnladable Sftware Materials The fllwing sftware materials are available fr dwnlad frm Emcraft's web site t custmers f this prduct: 1. u-bt.hex - prebuilt U-Bt file in the frmat suitable fr installatin int embedded Flash f Crtex-M3 n the LPC-LNX-EVB bard; 2. netwrking.uimage - prebuilt Linux image ready t be laded t the LPC-LNX-EVB bard; 3. linux-lpc tar.bz2 - Linux LPC17XX sftware develpment envirnment, including: a) U-Bt firmware; b) Linux kernel; c) busybx and ther target cmpnents; d) Linux-hsted crss-develpment envirnment; e) Framewrk fr develping multiple prjects (embedded applicatins) frm a single installatin, including sample prjects allwing t kick-start sftware develpment fr Linux LPC17XX Dwnladable Dcumentatin Materials The fllwing dcumentatin materials are available fr dwnlad frm Emcraft's web site t custmers f this prduct: 1. linux-crtexm-um pdf - Linux Crtex-M User's Manual; Linux LPC17XX BSP Guide fr the 3/11 Release

4 2. linux-lpc-lnx-evb-bspg pdf - Linux LPC17XX BSP (Bard Supprt Package) Guide fr the (this dcument). 3. Sftware Functinality 3.1. Supprted Features The fllwing list summarizes the features and capabilities f Linux LPC17XX, Release : U-Bt firmware: U-Bt v ; Target initializatin frm pwer-n / reset; Runs frm the internal envm and internal SRAM (n external memry required fr standalne peratin); Serial cnsle; Ethernet driver fr lading images t the target; Serial driver fr lading images t the target; Device driver fr built-in Flash (envm) and self-upgrade capability; Device driver fr string envirnment and Linux images in external Flash; Autbt feature, allwing bt f OS images frm Flash r ther strage with n peratr interventin; Persistent envirnment in Flash fr custmizatin f target peratin; Sphisticated cmmand interface fr maintenance and develpment f the target. Linux: uclinux kernel v2.6.33; Bt frm cmpressed and uncmpressed images; Ability t run critical kernel cde frm integrated Flash f LPC17XX; Serial device driver and Linux cnsle; Ethernet device driver and netwrking (ping, NFS, Telnet, FTP, ntpd, etc.); busybx v1.17; POSIX pthreads; Prcess-t-kernel and prcess-t-prcess prtectin using the Memry Prtectin Unit (MPU) f the LPC17XX cre; Hardened exceptin handling; an exceptin triggered by a prcess affects nly the ffending prcess; Ladable kernel mdules; Secure shell (ssh) daemn; Web server; MTD-based Flash partitining and persistent JFFS2 Flash file system fr external Flash; Device driver fr the DMA interface; Device driver fr the USB hst interface; SD Card device driver; I2C device driver; I2S device driver; Linux LPC17XX BSP Guide fr the 4/11 Release

5 RTC device driver; Framebuffer device driver; SPI cntrller master-mde device driver; Supprt fr RS-485 in the serial device driver; Watchdg device driver. Develpment tls: ARMv7-ptimized GNU tlchain frm CdeSurcery (2010q1) is used fr develpment f U-Bt, Linux and user-space applicatins (tlchain must be dwnladed separately frm the CdeSurcery web site); Crss GDB fr debugging user-space applicatins; mkimage tl used by the Linux kernel build prcess t create a Linux image btable by U-Bt. Develpment envirnment: Linux-hsted crss-develpment envirnment; Develpment f multiple prjects (embedded applicatins) frm a single installatin; hell sample prject ("Hell, wrld!" single-prcess cnfiguratin); netwrking sample prject (basic shell, netwrking and Flash management tls demnstratin); develper sample prject (template prject that can be used t jump-start develpment f custm user-space applicatins and ladable kernel mdules) New and Changed Features This sectin lists new and changed features f this release: Nne Knwn Prblems & Limitatins This sectin lists knwn prblems and limitatins f this release: 1. CONFIG_KERNEL_IN_ENVM requires disabling CONFIG_ARM_UNWIND and CONFIG_EARLY_PRINTK. ID: RT Wrkarund: When enabling CONFIG_KERNEL_IN_ENVM in the kernel, disable CONFIG_ARM_UNWIND and CONFIG_EARLY_PRINTK. 2. Debugging f multi-threaded applicatins using GDB is nt supprted. ID: RT Wrkarund: Nne. This issue will be reslved in future releases f the prduct. 3. If the LPC-LNX-EVB bard has been reset using a reset cmmand f U-Bt, Ethernet may be mis-cnfigured. ID: RT Wrkarund: Use hardware reset (pwer ff/n r pushbuttn). 4. Hardware Setup This sectin explains hw t set up the LPC-LNX-EVB bard. Linux LPC17XX BSP Guide fr the 5/11 Release

6 4.1. Hardware Interfaces The LPC-LNX-EVB bard prvides the fllwing cmpnents and interfaces: LPC1788FBD208 Test pints 16MB NOR Flash 25 MHz scillatr Reset buttn In-System prgrammer buttn 10/100 Ethernet interface JTAG interface Expansin interface USB pwer and USB-UART interface t PC 32MB SDRAM User LED Pwer-gd LED 4.2. Bard Cnnectins T pwer the LPC-LNX-EVB bard up, simply cnnect it t a PC / ntebk by plugging a mini-usb cable int the P1 mini-usb cnnectr n the bard. As sn as the cnnectin t the PC has been made, the n-bard LED DS2 shuld lit up, indicating that the bard is up and running. On the PC side, the USB link prvides a serial cnsle device t the LPC-LNX-EVB. The sftware installed n the bard is cnfigured fr a K terminal. On the Linux hst, the serial cnsle is available using a /dev/ttyusbn device. T prvide netwrk cnnectivity t the bard, cnnect it int yur LAN by plugging a standard Ethernet cable int the 10/100 Ethernet cnnectr. The bard is pre-cnfigured with an IP address f Extensin Interfaces The LPC-LNX-EVB prvides the fllwing interfaces that can be used t prttype custm hardware extensins t the main hardware design f the bard as well as t develp new sftware drivers and applicatins. Linux LPC17XX BSP Guide fr the 6/11 Release

7 User LEDs LED CPU_LED P5.1 LPC17XX Pin Expansin Interface P3 Pin LPC17XX Pin P3 Pin LPC17XX Pin 1 VCC3 2 VCC3 3 P P P P P P P P GND 12 GND 13 P P P P GND 18 GND 19 P P0.13 P4 Pin LPC17XX Pin P4 Pin LPC17XX Pin 1 GND 2 GND 3 P P P P GND 8 GND 9 P P P P GND 14 GND 15 P P P P P P Test Pints Test Pint # LPC17XX Pin Test Pint # LPC17XX Pin 1 P GND 2 P GND 3 P P P P P GND 14 P GND 15 P GND 16 nrstout Linux LPC17XX BSP Guide fr the 7/11 Release

8 5. LPC-LNX-EVB Bard Linux Sftware Set-up 5.1. U-Bt Envirnment When the LPC-LNX-EVB bard is reset, the Linux btstrap will prceed t bt the U-Bt firmware frm the built-in Flash printing the fllwing utput t the serial cnsle: U-Bt linux-crtexm (Dec :43:45) CPU : LPC178x/7x series (Crtex-M3) Freqs: SYSTICK=108MHz,EMCCLK=54MHz,PCLK=54MHz Bard: LPC-LNX-EVB rev 1.A, DRAM: 32 MB Flash: 16 MB In: serial Out: serial Err: serial Net: LPC178X_MAC Hit any key t stp autbt: 0 LPC-LNX-EVB> U-bt makes use f the s-called envirnment variables t define varius aspects f the system functinality. Parameters defined by the U-bt envirnment variables include: target IP address, target MAC address, address in RAM where a Linux btable images will be laded, and many mre. T examine the current settings f the envirnment variables, run printenv frm the U-Bt cmmand interface. U-Bt prvides a cmmand called saveenv that stres the up-t-date run-time envirnment t the persistent strage, which will be the external Flash fr the U-Bt cnfiguratin used n the LPC-LNX-EVB bard. Yu need t call saveenv any time when yu want t cpy current settings f the envirnment variables t the persistent strage in Flash. This is hw yu can write the current U-Bt envirnment t the external Flash: LPC-LNX-EVB> saveenv Saving Envirnment t Flash LPC-LNX-EVB> 5.2. Ethernet MAC Address In Linux LPC17XX, the MAC address f the Ethernet interface is defined by the ethaddr U- Bt envirnment variable. The value f the MAC address can be examined frm the U-Bt cmmand line mnitr as fllws: LPC-LNX-EVB> printenv ethaddr ethaddr=c0:b1:3c:88:88:88 LPC-LNX-EVB> The LPC-LNX-EVB bard cmes with ethaddr set t a MAC address uniquely allcated fr the specific bard. Given that each LPC-LNX-EVB bard has a unique MAC address allcated t it, there is n need t update the ethaddr variable (althugh it is pssible t d s). The MAC address can be changed by mdifying the ethaddr variable as fllws: LPC-LNX-EVB> setenv ethaddr C0:B1:3C:88:88:89 Dn't frget t stre yur update in the persistent strage using saveenv s it is remembered acrss resets and pwer cycles Netwrk Cnfiguratin Yu will have t update the netwrk cnfiguratin f yur bard t match settings f yur lcal envirnment. Linux LPC17XX BSP Guide fr the 8/11 Release

9 Typically, all yu have t allw lading images ver netwrk frm a TFTP server is update the U-Bt envirnment variables ipaddr (the bard IP address) and serverip (the IP address f the TFTP server). Here is hw it is dne. Update ipaddr and serverip: LPC-LNX-EVB> setenv ipaddr LPC-LNX-EVB> setenv serverip and then save the updated envirnment t the external Flash s that yur changes are persistent acrss resets/pwer cycles Running Pre-installed Linux Image The LPC-LNX-EVB bard cmes with a Linux btable image fr the netwrking prject installed int external Flash. T bt this Linux cnfiguratin nt the LPC-LNX-EVB bard just reset the bard and let U-Bt perfrm the autbt sequence. Detailed infrmatin n functinality f the pre-installed Linux image can be fund in Linux Crtex-M User's Manual, Sectin Lading Linux Images At this pint, yu are able t lad Linux btable images t the bard ver TFTP and either bt them directly r install them t the external Flash t allw bting Linux frm Flash n pwer-up/reset. On the hst, activate the Linux LPC17XX develpment envirnment and build the netwrking prject: -bash-3.2$. ACTIVATE.sh -bash-3.2$ cd prjects/netwrking/ -bash-3.2$ make -bash-3.2$ Cpy the Linux btable image t the TFTP dwnlad directry: -bash-3.2$ cp netwrking.uimage /tftpbt/vlad/ -bash-3.2$ T lad the image directly, use the netbt U-Bt macr: LPC-LNX-EVB> setenv image vlad/netwrking.uimage LPC-LNX-EVB> run netbt TFTP frm server ; ur IP address is Filename 'vlad/netwrking.uimage'. Lading: ################################################################# ################################################################# ############# dne Bytes transferred = (1fcf60 hex) Image Name: Linux arm1 Image Type: ARM Linux Kernel Image (uncmpressed) Verifying Checksum OK Lading Kernel Image OK OK Starting kernel Linux versin arm1 (vlad@cean.emcraft.cm) (gcc versin (Surcery G++ Lite 2010q1-189) ) #1 Fri Dec 06 15:43:44 MSK 2013 T lad the image int the Flash, use the U-Bt update macr: Linux LPC17XX BSP Guide fr the 9/11 Release

10 LPC-LNX-EVB> setenv image vlad/netwrking.uimage LPC-LNX-EVB> run update TFTP frm server ; ur IP address is Filename 'vlad/netwrking.uimage'. Lading: ################################################################# ################################################################# ############# dne Bytes transferred = (1fcf60 hex).. dne Un-Prtected 32 sectrs.. dne Erased 32 sectrs Cpy t Flash dne LPC-LNX-EVB> Reset the bard and verify that the newly prgrammed image bts n the target in the autbt mde: LPC-LNX-EVB> reset resetting U-Bt linux-crtexm (Dec :19:37) Starting kernel init started: BusyBx v (Dec :19:37) ~ # 5.6. U-Bt Build The BSP distributin cmes with U-Bt pre-built fr the LPC-LNX-EVB bard. If hwever yu need t re-build U-Bt fr yur bard, please fllw the instructins belw: 1. Install the Linux LPC17XX distributin t the develpment hst, as described in the Linux Crtex-M User's Manual. 2. Frm the tp f the Linux LPC17XX installatin, activate the Linux LPC17XX crsscmpile envirnment by running. ACTIVATE.sh. 3. G t the U-Bt surce directry (cd u-bt/). 4. Run the fllwing cmmands: [psl@pvr u-bt]$ make lpc-lnx-evb_cnfig Cnfiguring fr lpc-lnx-evb bard [psl@pvr u-bt]$ make -s [psl@pvr u-bt]$ make -s u-bt.hex 5.7. U-Bt Installatin The LPC-LNX-EVB bard arrives with the U-Bt firmware pre-installed int the n-chip Flash f the LPC17XX. The U-Bt cmmand line interface prvides cmmands that allw upgrading U-Bt n the running target in self-upgrade mde. Hwever, shuld yu prgram a faulty U-Bt image int LPC17XX, U-Bt can be reinstalled using FlashMagic sftware tl. Please fllw the prcedure described belw: 1. Cnnect the LPC-LNX-EVB bard t a Windws hst using a mini-usb cable; 2. Open the Windws Device Manager and determine the COM prt number the bard is available at in Windws; 3. Get the FlashMagic sftware at and install it; Linux LPC17XX BSP Guide fr the 10/11 Release

11 4. Run FlashMagic and cnfigure it as fllws: a) Set device type t LPC1788; b) Set COM Prt number t the value yu already knw frm the Windws Device Manager; c) Set Baud Rate t 57600; d) Set Interface t Nne (ISP); e) Check the ptin Erase blcks used by Hex File. 5. On the LPC-LNX-EVB bard, hld dwn the S2 buttn while resetting the bard (push S1) t put it in ISP mde. 6. In FlashMagic, select u-bt.hex frm the file system and click Start; 7. Reset the bard after prgramming U-Bt. 6. Further Materials Refer t Linux Crtex-M User's Manual fr detailed infrmatin n the sftware architecture f the Linux LPC17XX distributin. Visit ' web site at t btain additinal materials related t Linux LPC17XX. 7. Supprt We appreciate yur review f ur prduct and welcme any and all feedback. Cmments can be sent directly by t: a2f-linux-supprt@emcraft.cm The fllwing level f supprt is included with yur purchase f this prduct: supprt fr installatin, cnfiguratin and basic use scenaris f the prduct during 3 mnths since the prduct purchase; Free upgrade t new releases f the dwnladable materials included in the prduct during 3 mnths since the prduct purchase. If yu require supprt beynd f what is described abve, we will be happy t prvide it using resurces f ur cntract develpment team. Please cntact us fr details. Linux LPC17XX BSP Guide fr the 11/11 Release