Philips 7FF3FPW/75 Digital Photo Frame User Manual
Contents
1. 33 Table 6 10 Contents of the x86pci Directory EES RE iet Sek Rd tee Ede egg see Ee Sica dea ER ide es De ee duns 33 Table 6 1 i Contents ofthe appl Directory RR ed ae ER OE EE ee ER Ee Re ER ae Ge ede de ed RE RO RE OE Re 33 Table 6 12 Contents of the otgmsdemo Directory side Eie ees dies eeue o ndn cent ske Ede ae ee ee gee ens Ge ae Re De jun 33 Table 6 13 Contents of the tools Director YE KEER RS EES RR In cti ORE Dle ae BE Se tuba PE NER Re ge SN DE ee Ee RR Ke se ee 34 Table 6 14 Contents of the obJs Directory Ee EN ee dee oreet etre sat Ek ee ER ee See RGN ee ON RE wee RR ER ee ee ee oe V 34 The names of actual companies and products mentioned herein may be the trademarks of their respective owners All other names products and trademarks are the property of their respective owners UMIO0012 2 Koninklijke Philips Electronics N V 2003 All rights reserved User s Guide Rev 2 July 2003 5 of 34 Philips Semiconductors ISP 1362 Linux Stack User s Guide Introduction l l Purpose This document explains how to install configure and use the ISP1362 Linux stack 1 2 Scope This document is intended for the users of the ISP 1362 evaluation kit on Linux 1 3 Abbreviations DCD Device Controller Driver FSM Finite State Machine HCD Host Controller Driver IDP Integrated Development Platform OS Operating System OTG On The Go USB Universal Serial Bus 2 Concept 2 1 Overvie2. ISP1362 Evaluation Kit on Machine OTG cable Standard USB devices Standard USB devices Figure 4 3 OTG Stack Evaluation Setup The otgmsapp application is the OTG mass storage demo application using GTK Go to the ot gmsdemo directory and launch the application cd home 1362 0bjs otgmsapp This program will launch a new window Note this program will work only on machines that support GTK and Windows The Accelent IDP does not support this application The following is a snapshot of the application when a Mini A cable is connected to the OTG port after the application is launched The application shows the status of the OTG port activity HOST IDLE and DEVICE In the IDLE state the OTG disks of the local OTG device disk on which the application is running and the remote OTG device disk the connected OTG device are not visible UMIO0012 2 Koninklijke Philips Electronics N V 2003 All rights reserved User s Guide Rev 2 July 2003 23 of 34 Philips Semiconductors dd OTG Test Application fiie Status ISP1352 is used as ISP1362 Change Mode ISP1362 Change Mode IDLE HOST ISP1362 File Transfer Menu Source Disk Select Disk Local Disk not Available Ni DELETE coy MOVE Destination Disk Select Disk Remate Disk nat Available il DELETE Status pad plugged Mini B state BLIDLE pl
3. This section explains how to install the ISPI362 Linux stack Explanation on the installation or setting up of USB device specific software is beyond the scope of this document 3 1 3 1 Setting Up the Linux Kernel Install the Linux kernel source code in a directory This installation uses usr src 1linux otg lf you do not have the Linux kernel source code you can download it from http www kernel org UMIO012 2 Koninklijke Philips Electronics N V 2003 All rights reserved User s Guide Rev 2 July 2003 9 of 34 Philips Semiconductors ISP 1362 Linux Stack User s Guide 2 5 Copy the ISP1362 Linux stack 1551362 linux sw stack tar gz toa local directory This installation uses usr src linux otg Apply the OTG patch to the kernel t cd usr sro linux otg tar zxvt mnt odrom pl362 linux sw Stack tar gz patch p1 lt 1362 misc pci otg kernel patch pci Configure compile install and run the new kernel You can get information on how to configure compile and install the new kernel at http www tldp org HOWTO kernel HOWTO html While configuring the kernel enable the following options for the ISPI362 Linux stack a Code maturity level options b Loadable module support enable all options C Loop back device support in block devices d Any other USB options that need to be enabled Reboot the PC with the new kernel and the ISP1362 PCI evaluation kit 3 1 3 2 Setting Up the ISP 1362 Linux Sta
4. 2 User s Guide Konin Rev 2 July 2003 klijke Philips Electronics N V 2003 All rights reserved 24 of 34 Philips Semiconductors ISP 1362 Linux Stack User s Guide Figure 4 5 shows a snapshot of the application in the HOST state when a Mini B plug is connected to the OTG port In the HOST state both the local and remote OTG device disks are mounted and are available for operation You can select files from the source disk and transfer copy or move the files to the destination disk You can also select the source and destination disks to be local or remote Figure 4 6 shows the file selection menu for the source destination disks You can delete the files from the disk by selecting the file and pressing the Delete button on the keyboard The Status Pad window shows the status of the operation with appropriate messages The application transfers files from the source disk to the destination disk only If you want to transfer files the other way change the source disk from local to remote and the destination disk from remote to local Figure 4 7 shows a snapshot of the OTG application when a Mini A plug is inserted and the remote OTG device is the host dd ISP1362 SourceDisk File selection ET OK mnt localdisk _4 bootex log chf w133 zip linux qz Selection mnt localdisk linux gz state change amp HOST plugged Mini amp state A HOST state change amp HOST ISP1352 has gone into A Ho
5. ARM toolchain can be copied from the CD provided by the Accelent arm_toolchain tar bz2 Do not bother trying to build the tool chain from scratch The tool chain version 2 95 3 works very well Do not use any of the gcc 3x compilers yet they generate bad code for ARM in certain instances Usually the ARM toolchain should be unzipped in the root directory of the host PC using command UMI0012 _2 Koninklijke Philips Electronics N V 2003 All rights reserved User s Guide Rev 2 July 2003 15 of 34 Philips Semiconductors ISP 1362 Linux Stack User s Guide top mnt cdrom tools tool chain arm toolchaintar bz2 tcd tar jxvf arm toolchaintar bz2 Older versions of tar might not accept this then try using tar Ixvf arm toolchaintar bz2 Be careful about the root directory of the ARM cross compiler arm linux gcc will invoke cppO and ccl assuming they reside in certain directories relative to the compiler s root directory To be on the safe side unzip the ARM tool chain in the root directory Copy the utilities bin2bin foxfox mkfs jffs2 padkernel py from tools utils directory of Accelent CD to your execution path like maybe bin These tools are needed to prepare Linux kernel and root file system for loading into the target tcp mnt odrom rools utils bin cd bin chmod x bin2bin foxfox mkfs jffs2 padkernel py 3 3 2 10 Linux Kernel source The Linux kernel can be installed in to the PC host from the source cod
6. B devices UMIO012 2 Koninklijke Philips Electronics N V 2003 All rights reserved User s Guide Rev 2 July 2003 29 of 34 Philips Semiconductors ISP 1362 Linux Stack User s Guide 5 Configuration The ISP1362 Linux stack can be configured to work in different ways by using the static compilation time flags The Rules Make file in the root directory of the source code selects the global compilation flags The local compilation flags for the modules are selected in the Makefile of the corresponding module directory 5 1 Compilation Flags 5 1 1 Global Table 5 1 shows the compilation flags that are selected in the Rules Make file and their description Table 5 1 Global Compilation Flags Compilation Flag DCONFIG_USB_HCDC_OTG Configures the OTG mode e In the non OTG mode only the host stack is enabled without OTG functionality e Inthe OTG mode all the modules are enabled This compilation flag is for the ISPI 362 PXA250 kit hardware l6MB SIZE function entry traces entry traces as well as any important detail level traces global compilation flags CONFIG FUNC DEBUG and CONFIG DETAIL DEBUG Enables debugging for the Device Controller Driver The trace level depends on the global compilation flags CONFIG FUNC DEBUG and CONFIG DETAIL DEBUG global compilation flags CONFIG FUNC DEBUG and CONFIG DETAIL DEBUG compilation flags CONFIG FUNC DEBUG and CONFIG DETAIL DEBUG global compilation flags CONFIG FUNC
7. IDPs The ISPI362 Linux stack on Intel PXA250 based Accelent IDP platform has been tested with AccelLinux kernel version 2 4 18 Linux kernel versions 2 4 19 or above need a different kernel patch for OTG Therefore it is preferable to have Accelent IDP running on kernel version 2 4 18 The following figure shows the development environment for Intel PXA250 based Accelent IDP with ISP1362 evaluation kit Ethernet Cable PC Host Running Linux Serial Port Cable Accelent IDP Running Linux Figure 3 3 Development setup for Intel PXA250 Based Accelent IDP The following are the requirements for evaluating the ISP1362 stack on Accelent IDP e Two Intel PXA250 based Accelents IDPs e PC host running the Linux operating system e Installation CD for Accelent IDP 3 3 1 Setting Up the ISP1362 Add On Card The ISP1362 add on card can be configured in various modes of the ISP1362 the host only mode and the OTG mode The OTG mode is the default mode for the add on card as well as the ISP1362 Linux stack Make sure that the ISP1362 add on card is configured in the OTG mode before using the software For more information on hardware setup refer to the SP 362 OTG Add On Evaluation Kit with Intel PXA250 IDP document 3 3 2 Host PC Setup ISP1362 stack release contains setup files related to the Accelent IDP setup 3 3 2 8 Kernel Requirements The Linux kernel on the Host PC should support ncurses library 3 3 2 9 ARM Cross Compiler The
8. by printk from Accelent IDP A null modem cable is required to connect FFUART J5 port on Accelent IDP board and a COM port host PC Set Baud rate to 115200 data bits 8 Parity none Stop bits Flow control hardware 3 2 3 Accelent IDP Rev 04 Target Setup Follow the instructions given in the Quick Start Guide IDP for Intel PXA250 Applications Processor Linux OS document from the Accelent CD to set up the Accelent IDP UMIO0012 2 Koninklijke Philips Electronics N V 2003 All rights reserved User s Guide Rev 2 July 2003 13 of 34 Philips Semiconductors ISP 1362 Linux Stack User s Guide The boot loader boot bin from the accelent CD does not support ISPI362 add on card Use the boot loader from the ISP1 362 stack release home l362 AccelentlDP boot bin 2 To load the new kernel and root file system from the development environment copy the nk jffs flash bin from the earlier section as nk bin to the CompactFlash card and boot up the Accelent IDP Follow the instructions on the Quick Start Guide IDP for Intel PXA250 Applications Processor Linux O document for detailed loading booting instructions 3 Connect a CompactFlash card size gt 16MB through the PCMCIA to a CompactFlash adapter Log on to the Accelent IDP as root and execute the following command This is applicable for the demo environment setup only cd home 1362 0bjs imod This will make the initial setup for the Accelent IDP for ISP1362 L
9. following command on the host PC fdisk dev sd X TempData Where X could be a b o z mkdosfs I dev sd X 1 6 Unload and close the ISPI362 stack from the target system Now the target system is ready for use 4 Operating the ISP1362 Linux Stack This chapter explains how to run the ISP1 362 Linux stack after it has been successfully installed using the procedures explained in the previous chapter In the OTG configuration the ISP1 362 Linux stack will act as a e USB host on the standard USB port e USB mass storage device on the OTG port when connected to a standard USB host via a Mini B Standard B cable e USB OTG mass storage device on the OTG port when connected to other OTG devices For the limitations of the stack refer to the Release Notes ISP1362 Linux Stack document 4 1 ISP1362 PCI Evaluation Kit 4 1 1 Loading the Stack The ISP1362 Linux stack modules kernel as well as application are dynamically loaded and unloaded to the kernel Logon to the system as root go to the ISPI362 Linux source directory and use the script to load modules cd usr src linux otg 1362 source objs imod 2 If you execute the sbin 1smod command you will notice that the following modules are loaded msed pdc phei otg hal UMIO012 2 Koninklijke Philips Electronics N V 2003 All rights reserved User s Guide Rev 2 July 2003 19 of 34 Philips Semiconductors ISP 1362 Linux Stack User s Guide You shoul
10. has been tested with AccelLinux kernel version 2 4 18 Linux kernel versions 2 4 19 or above need a different kernel patch for OTG Therefore it is preferable to have Accelent IDP running on kernel version 2 4 18 The following figure shows the development environment for Intel PXA250 based Accelent IDP with the ISP1362 evaluation kit Ethernet Cable PC Host Running Linux Serial Port Cable Accelent IDP Running Linux Figure 3 2 Development setup for Intel PXA250 Based Accelent IDP The following are the requirements for evaluating the ISP1362 stack on Accelent IDP e Two Intel PXA250 based Accelents IDPs e PC host running the Linux operating system e Installation CD for Accelent IDP 3 2 1 Setting Up the ISP1362 Add On Card The ISP1362 add on card can be configured in various modes of the ISP1362 the host only mode and the OTG mode The OTG mode is the default mode for the add on card as well as the ISP1362 Linux stack Make sure that the ISP1362 add on card is configured in the OTG mode before using the software For more information on hardware setup refer to the ISP 362 OTG Add On Evaluation Kit with Intel PXA250 IDP document 3 2 2 Host PC Setup Keep the Intel PXA250 based Accelent IDP installation CD on the CDROM drive 3 2 2 3 Kernel Requirements The Linux kernel on the Host PC should support ncurses library 3 2 2 4 ARM Cross Compiler The ARM toolchain can be copied from the CD provided by the Accelent a
11. must be ported to the target platform This driver provides an interface to the ISP 1362 registers and buffers to the ISP1362 VO ports and interrupts and configures the ISP1362 based on the platform 2 5 2 Mass Storage Bridge As physical storage disk is specific to the product a mass storage bridge is needed Also as the mass storage disk is an emulator in the application space this layer provides an interface to the application module You need to port this layer to interface with the physical disk driver kernel application 3 Installation The ISP1362 evaluation boards are available in the following platforms e SPI362 PCI evaluation kit e SPI362 ISA evaluation kit e SPI362 add on card for Intel PXA250 based Accelent IDP The ISP1362 Linux stack currently supports the ISP1362 PCI evaluation kit and ISP1 362 add on card for Accelent IDP Support for other platforms will soon be added to the stack The same source code will work for all platforms by changing the compile time options The following diagram shows the evaluation kit setup example for the ISP1362 Linux stack UMIO012 2 Koninklijke Philips Electronics N V 2003 All rights reserved User s Guide Rev 2 July 2003 8 of 34 Philips Semiconductors ISP 1362 Linux Stack User s Guide ISP 1362 Evaluation Kit on Machine 2 ISP1362 Evaluation Kit on Machine OTG Cable PRINTER USB Perip
12. ob je J sync root Devboard ob js ls l mnt localdisk PugP RD HB 1 root root 4445414 Jan 1 00 12 cvent_1 11 1 4 exe root Deyboard obja splay d dav ush usbaudin mnt rmtdisk Peanutsz mpa raat Devboand ob js 3 root Deyboard ob je fotecmd o umount otecmd o OTG mass storage command utility fotecmd o OTG B device State Host A atecmd o OTG local disk mounted on none A tecmd ot OTG remote disk mounted on none root Devboard ob js otecmd o idle fotecmd a OTG mass storage command utility ush ct USB disconnect on device 9 OTG State Idle JUtecmd a OTG B device State Idle fotecmd at OTG local disk mounted on none fotecmd o OTG remote disk mounted on none root Devboard ob je otecmd o help otecmd o OTG mass storage command utility Usagre atecmd o host idle error mount umount help hast Change the ote state from Idle to Host idle Change the ote state from host to Idle errori Change the ote state from error to Idle mount Mount local and remote ote disks umount Unmount local and remote ote disks help Print this help information rootiteyboard obj i LIRL A tor help 115200 N Minicom 2 00 0 Online 00 15 Figure 4 9 OTG B closing the session after connected device data access Figure 4 8 Figure 4 9 Figure 4 10 UMIO012 2 Koninklijke Philips Electronics N V 2003 All rights reserved User s Guide Rev 2 July 2003 28 of 34 Philips Semicondu
13. stack directory ISP1362 OTG stack directory ISP1362 hardware access layer directory 6 2 host The host directory consists of files and directories related to the ISP1362 host stack The contents of this directory and their description are given in Table 6 2 Table 6 2 Contents of the host Directory FileName Deseription Makefile for the host stack ISP1362 Host Controller Driver directory 6 2 1 phci The phci directory consists of files related to the ISPI362 Host Controller Driver The following table shows the contents of this directory and their description Table 6 3 Contents of the phci Directory FileName Deseription Ss release host phci Makefile Makefile for the Host Controller Driver release host phoer usb pholse ISPI362 Host Controller Driver C source file releasc host pher usb phor h ISP1362 Host Controller Driver C header file 6 3 device The device directory consists of files related to the ISP1362 device stack Table 6 4 shows the contents of the device directory and their description UMIO012 2 Koninklijke Philips Electronics N V 2003 All rights reserved User s Guide Rev 2 July 2003 3l of 34 Philips Semiconductors ISP 1362 Linux Stack User s Guide Table 6 4 Contents of the device Directory FileName Deseripton sss pelease device Maketile Makefile for the device stack subdirectories release device pdc ISP1362 Device Controller Driver C source file ISP1362 Device Co
14. DEBUG and CONFIG DETAIL DEBUG 5 1 2 Host Controller Driver Table 5 2 shows the Host Controller Driver compilation flags that are selected in Makefile and their description Table 5 2 Host Controller Driver Compilation Flags Compilation Flag CONF LG USB PHCD EVEN 5CH Configures the ISP 1362 interrupt transfer event scheduling By enabling this flag the interrupt transfers are evenly scheduled over a period of 32 ms CONFIG USB PHCD PING PONG Configures the ISP1362 ping pong mechanism Use the ISPI362 ping pong mechanism for the bulk transfers to achieve maximum transfer per millisecond on the USB bus CONFIG PHCI MEM SLAB Use memory pool for the HCD endpoint descriptor and Transfer descriptor data structures UMIO012 2 Koninklijke Philips Electronics N V 2003 All rights reserved User s Guide Rev 2 July 2003 30 of 34 Philips Semiconductors ISP 1362 Linux Stack User s Guide 6 Inside the ISP 1362 Linux Stack The ISP1362 Linux stack release consists of two parts a Linux kernel OTG patch for kernel version 2 4 18 and the ISP1362 Linux stack source code The code is written in C This chapter explains the ISP1362 Linux stack source code organization 6 1 Top Level Directory The root directory consists of all the substack directories and the make files Table 6 1 shows the contents of this directory and their description Table 6 1 Top Level Directory Contents FileName Description ISP1362 device
15. ING WITHOUT LIMITATION DAMAGES FOR LOSS OF BUSINESS PROFITS BUSINESS INTERRUPTION LOSS OF BUSINESS INFORMATION OR OTHER PECUNIARY LOSS ARISING OUT OF THIS AGREEMENT OR THE USE OF OR INABILITY TO USE THE PRODUCT EVEN IF PHILIPS SEMICONDUCTORS HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES UMIO012 2 Koninklijke Philips Electronics N V 2003 All rights reserved User s Guide Rev 2 July 2003 2 of 34 Philips Semiconductors ISP 1362 Linux Stack User s Guide CONTENTS l INTRODUCTION sies esse 6 I 1 at is EE E E E A OO EE 6 No o UP 6 3 ABBREVIATION m de 6 2 CONCEP 9B EE EE Ed 6 EO 1 6 22 UP ARCHITECTURE sutor tnit uut UND AAA ON tat Na i IUE edd 6 23 Sc ee di EE 7 2 3 1 HOSESIUEE EE EE E MEUM EG EE M 7 2 3 2 Device SEUCK SEE EDE im EE NE N EN EN EE EE N N N OE DA 2 3 3 Scr o 8 24 PPPLICATION ie rd io 8 2 4 1 Mass Storage Disk Emulation ccsssssssssssssssssssssssssesssssssssssssssssssscsscsussscssssucsuccscsucsuccacsussaccacssssassacsassacsaseaeeaseasensenseneeneensees 8 2 4 2 OTG Applications OTG Mass Storage Demo OTG
16. Tools seen ee RR en ee ene Re Re ee ee ee ee 8 25 PORTING MOLLE M ED IE 8 2 5 1 Hardware Access Layer DriVeE seke dese irt ese eN Ee de ee EA es ea eke ee ee ee Re sevens 8 2 5 2 Mass Storage Bride Buses disce oe eie o RI ede apu tissime ir scie de ER ede PIER ees 8 3 INS TALLA FION EE EE OE N OE EE N N 8 AE oie IU ie N TEE ER AE EE 9 3 1 1 Setine Hitihe HE and OS es ee EE De Ee Ee Ee ee 9 3 1 2 Setting Up the ISP 1362 Evaluation Kit ssesse sesse see See Se ER SEER SERE SERE BABER ee ee ee ASe ER Se ge Se gee Se ER eek ee 9 3 1 3 Setting Up the SoftWare ese ee ee ene de bee eo ER eo ee ee ee ee ee Re oe ede GE 9 3 2 ISP1362 ADD ON CARD FOR INTEL PXA250 BASED ACCELENT IDP REV 04 see se se ese ee se ee ee se ee 2 Setting Up the dde Add On DUE ie een C nd mde ee eg atit ma eel ee Pare I 3 2 2 g 4 95 T lI 323 Accelent IDP Rev 04 Target SEM 13 3 3 SPI362 ADD ON CARD FOR INTEL PXA250 BASED ACCELENT IDP REV 02 ese see se see se ee se ee ee se ee 14 3 3 1 seting Up the ISP 1302 TP EG I5 5 32 BE Fe ie I5 3 3 3 les Iy IP ARTI EE E AAE EE N l 4 OPERATING THE ISP 1362 LINUX STACK esse sesse sesse ee esse se ee e
17. UMIO001I2 2 ISP 362 Linux Stack ly 2003 Semiconductors July User s Guide Rev 1 2 Revision History Version Date Description Author Jun 2003 e Additions for Accelent IDP platform Rev 04 Nov 2002 e Additions for Aaccelent IDP platform 1 0 Oc200 We welcome your feedback Send it to wired support philips com Philips Semiconductors Asia Product Innovation Centre Visit www semiconductors philips com buses usb or www flexiusb com PHILIPS Philips Semiconductors ISP 1362 Linux Stack User s Guide This is a legal agreement between you either an individual or an entity and Philips Semiconductors By accepting this product you indicate your agreement to the disclaimer specified as follows DISCLAIMER PRODUCT IS DEEMED ACCEPTED BY RECIPIENT THE PRODUCT IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW PHILIPS SEMICONDUCTORS FURTHER DISCLAIMS ALL WARRANTIES INCLUDING WITHOUT LIMITATION ANY IMPLIED WARRANTIES OF MERCHANT ABILITY FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT THE ENTIRE RISK ARISING OUT OF THE USE OR PERFORMANCE OF THE PRODUCT AND DOCUMENTATION REMAINS WITH THE RECIPIENT TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW IN NO EVENT SHALL PHILIPS SEMICONDUCTORS OR ITS SUPPLIERS BE LIABLE FOR ANY CONSEQUENTIAL INCIDENTAL DIRECT INDIRECT SPECIAL PUNITIVE OR OTHER DAMAGES WHATSOEVER INCLUD
18. able shows the contents of this directory and their description Table 6 11 Contents of the appl Directory FileName Description S 6 6 1 otgmsdemo The otgmsdemo directory consists of files related to the OTG mass storage GUI demo application Table 6 12 shows the contents of this directory and their description Table 6 12 Contents of the otgmsdemo Directory FileName Deseiption O J release appl otgmsdemo Makefile Makefile for the OTG mass storage demo application release appl otgmsdemo otgmsapp c SPI362 OTG mass storage demo application C source file release appl otgmsdemo otgmsapp h ISP1362 OTG mass storage demo application C header file UMIO012 2 Koninklijke Philips Electronics N V 2003 All rights reserved User s Guide Rev 2 July 2003 33 of 34 Philips Semiconductors 6 6 2 tools The tools directory consists of files related to the mass storage disk emulation The contents of this directory and their description are given in Table 6 13 Table 6 13 Contents of the tools Directory File Name Description release appl tools Makefile Makefile for the OTG command line tools application ISP 1362 Linux Stack User s Guide release appl tools otgtool h SPI362 OTG mass storage applications C header file release appl tools Makefile setup Makefile for the OTG environment setup application release appl tools otgemd c ISP1362 OTG mass storage command application C so
19. cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccceccces 31 6 e 2 0 Pl cede ifte Em 3l 5 2 HO iy aeneae LIC IM MI EA EE N RU EE 3l 6 2 1 jj 31 C DEI Pa E E E E E ee 3 6 3 1 32 6 3 2 VEINS a CREE 32 6 3 3 a dy AE NR RIP E A OO N ed 32 is OR EE EE EE N EE E EE OE N EE OE EE noes 32 o E 33 6 5 1 lese EE mire E EE EE EE ee 33 ME RE EE RE EE EE EE OE EE EE ER OE OE EE eee 33 6 6 1 OTIS CIAO cba E A cea EE 33 6 6 2 TOONS ee nc hates ee acc sea esses enc cao Ge ke 34 Ns EE EE 34 1 Be i ie MEE EE EE RE EE EE EE eG 34 UMIO0012 2 Koninklijke Philips Electronics N V 2003 All rights reserved User s Guide Rev 2 July 2003 4 of 34 Philips Semiconductors ISP 1362 Linux Stack User s Guide Figures Fisure 2 1 ISP 1362 Linux Stack Architecture esse EREGAS ER De Gee RA es AG EE Re D e rta RR Goede EE ENDE UD EG ee 7 Pisure so D ISP P362 ke Setup Example eise er ee me en EE EESE rene aiu eee ee uu ee eee eer ene ee Ee 9 Figure 3 2 Development setup for Intel PXA250 Based Accelent IDP ou se se se se eese Ge GR ee Re Ge Re Ge Ge Ge Re Se Ge Re AR tote lI Figure 3 3 Development setup for I
20. celent CD does not support ISPI362 add on card Use the boot loader from the ISP1362 stack release home l362 AccelentlDP boot bin 2 Toload the new kernel and root file system from the development environment copy the nk jffs flash bin from the earlier section as nk bin to the CompactFlash card and boot up the Accelent IDP Follow the instructions on the Quick Start Guide IDP for Intel PXA250 Applications Processor Linux OS document for detailed loading booting instructions 3 Logon to the Accelent IDP as root and execute the following command This is applicable for the demo environment setup only cd home 1362 0bjs t init setup This will make the initial setup for the Accelent IDP for ISP1362 Linux stack Note that you need to execute this script for the first time only Connect the Accelent IDP to the Linux host system as a mass storage device and perform the following on the host system 4 Initialize and load the ISP1362 stack on to the target system as mentioned in Section 4 2 and connect the Accelent IDP to the host Linux PC as a mass storage device UMIO0012 2 Koninklijke Philips Electronics N V 2003 All rights reserved User s Guide Rev 2 July 2003 18 of 34 Philips Semiconductors ISP 1362 Linux Stack User s Guide 5 Write the following in a temporary file say TempData and give the file as an input to the fdisk command P Ww The following values are made for an OTG mass storage disk of size 8MB Use the
21. ck UMIO0012 2 Go to the ISP1362 Linux software stack source top directory cd usr src linux otg 1362 source Edit the Rules Make file for any changes in the compilation rules The changes could be a The kernel source directory is different from the one specified above b Compile time flags see Section 5 1 If you want any configuration changes Make sure that PCT KIT hardware option is enabled Compile the ISP1362 Linux stack source code make clean all install Note If the compilation fails due to non existence of the glibconfig h file create a dummy file in the usr include directory Make the setup for the OTG mass storage demo environment cd appl tools tmake f Makefile setup otgsetup o Koninklijke Philips Electronics N V 2003 All rights reserved User s Guide Rev 2 July 2003 10 of 34 Philips Semiconductors ISP 1362 Linux Stack User s Guide 3 2 ISP1362 Add on Card for Intel PXA250 based Accelent IDP Rev 04 Accelent Systems developed the IDP Integrated Development Platform to speed up the embedded device development cycles Accelent IDP provides a feature rich cost effective development platform for embedded device application and product development The ISP1362 Linux stack and the Accelent IDP do not support two or more boards at the same time Therefore for the ISP1362 OTG evaluation you must have two Accelent IDPs The ISP1362 Linux stack on Intel PXA250 based Accelent IDP platform
22. ctors ISP 1362 Linux Stack User s Guide r Hips DE emic onauc tor 3 ior 1304 LINUX ta k Usel Jui ide File Edit Settings Help ranot Devboand ob je 3 raat Devboand aak AE raaot Devboand ob js ront Devboand ob js 3 rootiDeyboard ob js 3 ro iat Devbaanrd ob je otecmd o status fotecmd ot OTG mass storage command utility Jatecmd oa OTG B device State Peripheral A atecmd o OTG local disk mounted on none Jotecnd at OTG remote disk mounted on none root Devboard ob je fotecmd o mount local otecmd ot OTG mass storage command utility dev lonp on mnt localdisk type vfat rw A otecmd ot OTG E device State Idle fotecmd ot OTG local disk mounted on mnt localdisk otecmd of OTG remate disk mounted on none ront Devboand ob je ls 1 mnt localdisk aa ae OE EN root root 44454145 Jan 1 1980 cvsnt_i 11 1 4 exe ront Devboand ob je fotecmd o umount local otecmd ot OTG mass storage command utility _fotecmd nti UI B device State Idle otecmd o UI local disk mounted on none otecmd of OTG remote disk mounted on none ranot Devboand ob Je J fote e mnd o status atecmd o OTG mass storage command utility fotecmd ot OTG A device State Idle otecmd o OTG local disk mounted on none _fotgemd ai OTG remote disk mounted on none roat bevboand ob js J LIRL H tor help 115200 snl Minicom 2000 Inline 00 16 Figure 4 10 Operations with OTG A and
23. d User s Guide Rev 2 July 2003 1 of 34 Philips Semiconductors ISP 1362 Linux Stack User s Guide product specific Therefore this driver communicates with a mass storage bridge portable For more information on the device stack interface refer to API ISP1362 Device Stack 2 3 3 OTG Stack The OTG stack consists of the OTG driver This driver maintains the OTG software FSM and coordinates the host and device functionality switching It interfaces with OTG applications through the Linux file system For more information on this interface refer to API ISP 362 OTG Stack 2 4 Application Modules 2 4 1 Mass Storage Disk Emulation This module is an application module and emulates a physical disk It responds to a minimal set of SCSI II commands and uses a file system interface to store the physical disk data This is developed for the OTG mass storage demo purpose 2 4 2 OTG Applications OTG Mass Storage Demo OTG Tools There are two OTG applications e A GUl based application for PC evaluation kits only e A command line based application These applications are used to test the OTG mass storage functionality These are written for the demo 2 5 Porting Modules 2 5 1 Hardware Access Layer Driver The core modules of the ISPI362 Host Controller Driver Device Controller Driver and OTG driver communicate with the ISP 1362 hardware through this driver Since hardware access is mostly platform dependent this module
24. d also see the msdi sk application running as an application process when you list the current running processes ps 4 1 2 Unloading the Stack As root of the system go to the ISPI362 Linux source directory and use the script to unload module scd usr sro linux otg 1352 s80urce ob Jjs t rmod 2 If you execute the sbin lsmod command you should not see any of the following modules as loaded msed pdo phei otg hal Also you should not see the msdi sk application as a running process when you list the current running processes ps 4 2 ISP1362 Add on Card for Intel PXA250 based Accelent IDP Rev 04 4 2 1 Loading the Stack The ISP1362 Linux stack modules kernel as well as application are dynamically loaded and unloaded to the kernel Logon to the system as root go to the ISPI362 object directory and use the script to load modules cd home 1362 0bjs imod 2 If you execute the sbin 1smod command you will notice that the following modules are loaded mecd Di PRO OG Nal You should also see the msdi sk application running as an application process when you list the current running processes ps 4 2 2 Unloading the Stack As root of the system go to the ISP1 362 Linux object directory and use the script to unload module cd home 1362 0bjs rmod 2 If you execute the sbin 1smod command you should not see any of the following modules as loaded mecd DAE phe otg hal Also you should n
25. e provided by the Accelent CD Copy the source code linuxtar bz2 from Accelent CD to known directory example usr src vod usr sre ibrip2 od mnt odsom source linuxtar bz2 tar xiv tmy linux 2 4 18 rmk3 pxaZ asil usr src linux otg Copy the ISP1362 stack related source to the kernel directory isp1362 linux sw stack tar gz Apply the ISP1362 specific kernel patch otg kernel patch rev2 from the ISPI362 Linux stack release to kernel source fcd usr srco linux otg fLar zxvf 158pl1357 linux sw stack tar ggz patch p1 1362 misc accelent rev2 otg kernel patch rev2 3 3 2 1 I Root File System Root file system for the IDP is provided in the Accelent CD Copy the root file system rootfstar bz2 to the usr src linux otg directory rcp mnt odrom so urce roottfstar ba2 usr srco linux otg UMIO0012 2 Koninklijke Philips Electronics N V 2003 All rights reserved User s Guide Rev 2 July 2003 16 of 34 Philips Semiconductors ISP 1362 Linux Stack User s Guide 3 3 2 12 Linux Kernel Configuration Makefile Edit the Makefile of the kernel source usr src linux otg CROSS COMPILE path to the path of the cross compiler CROSS COMPILE pub usr bin arm linux The cross compile path usr include arm 2 95 3 depends on where the tool chain is installed and the version of the tool chain and from where the tool chain is downloaded Kernel Configuration sod usr sirc linux ot make pxa idp config make
26. ecmd ot OTG local disk mounted on none atecmd ot OTG remote disk mounted on none root Devboard objs ntecmd o host fotecmd o OTG mass storage command utility hub c USE new device connect on busti assigned device number 5 HIT State Host fotecmd oat OTG BE device State Hast otgcmd o OTG local disk mounted on none otecnd ot OTG remote disk mounted on none Pnot Devboanrd ob je atermd a mount J tecmd o OTG mass storage command utility vendor Philips APIC Attached Yes dev sdai on mnt rmtdisk type vfat nrw dev loop on mnt localdisk type vfat tru fotecmd o OTG B device State Host fotecmd ot OTG local disk mounted on mnt localdisk Jatecmd ot OTG remote disk mounted on mnt nmtdisk rPoot Devboand ob je ls 1 mnt localdisk Popot Devboanrd ob je ls 1 mnt nrmtdisk pusp xp 1 root root 204500 Jan 1 1980 Peanuts mps Pusp xp 1 root root 4645414 Hoy 158 2002 cvsnt_1 11 1 4 exe raagt bevboand obj J4 LIRL H for help 115200 can Minicom 2 000 Inline UI UF Figure 4 8 OTG B device accessing remote OTG mass storage device files UMIO012 2 Koninklijke Philips Electronics N V 2003 All rights reserved User s Guide Rev 2 July 2003 27 of 34 VNINDS Semiconductors File Edit settings Help rootiDe vboard ob j 3 root Deyboard ob je 3 root Devboard ob js 3 root Devboard ob js cp mnt nrmtdisk cvsnt 1 11 1 3 8 e mnt localdisk root Deyboard
27. ee eee ees ee ee ee see oe Ge Ge Ge Ge Ge ee ee 19 Ms ISPI367 PCLEVALUATION SET EE 19 4 1 1 EON di SIEK sie eto penitentie cuca ee IE RR Ro eg cen Seba ee a 19 4 1 2 DInogdins 48 SEI ouium IE EE EE ER A AE HE S ct dre M tto 20 4 2 ISP1362 ADD ON CARD FOR INTEL PXA250 BASED ACCELENT IDP REV 04 sesse se ese ge se gee ge 20 4 2 1 Ese DEd ORN ie s ARE EE 20 4 2 2 fea e egeo Metro ral ccc TII ER OE EE N 20 4 3 ISP1362 ADD ON CARD FOR INTEL PXA250 BASED ACCELENT IDP REV 02 se see sesse se ese see se gee ge 20 4 3 1 ele FAR TV de ERUNT T 20 4 3 2 boaan BEV drie EE es cueacststene Javed E HT E E E E tee secant 21 4 3 3 EG Hie SHOE eee dba ED PIPER mane Nen EN AE Re ME ua cM MEUM 21 4 3 4 LUI iM eo or RN N EE EE EO N 21 dad ISPLSSZ BIOST SPACIS EE EE EE Ee EE ER DE ee ee eee MM LM ee 21 45 ISPLS62 DEVIEE STAGE bE e miim Mq ee Gee eee er eee 22 q5 JSPISO2A OT SEEK ER ER GE IE REM MEME EE ME 23 UMIO0012 2 Koninklijke Philips Electronics N V 2003 All rights reserved User s Guide Rev 2 July 2003 3 of 34 Philips Semiconductors ISP 1362 Linux Stack User s Guide 5 CGONFIGURATION siese ese be oo es eo REESE Gee ee oe se oe Go de De NG ee ese oe oo dd oe Ge DUE 30 CU EEE Se LE TRO IN LE tmm 30 SE Eoo ME EE EE EO GO Ee 30 5 1 2 Ho Controller DVO eeraa N MEE MM ei 30 6 INSIDE THE ISP1362 LINUX STACK c
28. emu disk_emu h SCSI II mass storage disk emulation C header file 6 4 otg The otg directory consists of files related to the ISPI362 OTG Controller Driver The contents of the otg directory and their description are given in Table 6 8 UMIO012 2 Koninklijke Philips Electronics N V 2003 All rights reserved User s Guide Rev 2 July 2003 32 of 34 Philips Semiconductors ISP 1362 Linux Stack User s Guide Table 6 8 Contents of the otg Directory FileName Deseiption Makefile for the OTG Controller Driver ISP1362 OTG Controller Driver C source file ISPI 362 OTG Controller Driver interface C header file ISP1362 USB OTG software FSM C source file ISP1362 USB OTG software FSM C header file 6 5 hal The hal directory consists of files related to the ISPI362 platform porting hardware access directories and the interface header files The following table shows the contents of the na1 directory and their description Table 6 9 Contents of the hal Directory FileName Description 6 5 1 x86pci The x86pci directory consists of files related to the ISPI362 X86 PCI platform HAL porting files The following table shows the contents of this directory and their description Table 6 10 Contents of the x86pci Directory FileName Description 6 6 appl The appl directory consists of files and directories related to the ISPI362 mass storage demo applications The following t
29. es offices please e mail sales addresses www semiconductors philips com A complete list will be sent to you automatically You can also visit our website http www semiconductors philips com sales www semiconductors philips com Koninklijke Philips Electronics N V 2003 All rights reserved Reproduction in whole or in part is prohibited without the prior written consent of the copyright owner The infor mation presented in this document does not form part of any quota tion or contract is believed to be accurate and reliable and may be changed without notice No liability will be accepted by the publisher for any consequence of its use Publication thereof does not convey or imply any license under patent or other industrial or intellectual property rights PHILIPS
30. herals on Machine 2 PRINTER USB Peripherals on Machine MN i ad i i T EET MOUSE SPEAKERS na HOUE SPEAKERS Figure 3 1 ISPI362 Linux Setup Example 3 l ISP1362 PCI Evaluation Kit 3 1 1 Setting Up the PC and OS For one evaluation kit prepare one PC The ISP1362 Linux stack does not support two or more boards on one PC at the same time Therefore for the ISPI362 OTG evaluation you must have two PCs The ISP1362 Linux stack can run on any X86 CPU preferably Intel Pentium or above for the desktop environment The ISP1362 Linux stack on X86 PCI platform has been tested with Linux kernel version 2 4 20 on Red Hat distribution The stack should work with other distributions as well Linux kernel versions 2 4 2 or above need a different kernel patch for OTG Therefore it is preferable to have a PC running kernel version 2 4 20 3 1 2 Setting Up the ISP1362 Evaluation Kit The ISP1362 PCI evaluation kit can be configured in various modes of the ISP1362 the host only mode the peripheral only mode and the OTG mode The OTG mode is the default mode for the evaluation kit as well as the ISP1362 Linux stack Make sure that the ISPI362 evaluation kit is configured in the OTG mode before using the software If you want to use any other mode of the ISP1362 refer to ISP 362 PCI Evaluation Board User s Guide for the hardware setup and Section 5 1 1 for the software setup 3 1 3 Setting Up the Software
31. inux stack Note that you need to execute this script for the first time only Connect the Accelent IDP to the Linux host system as a mass storage device and perform the following steps on the host system 4 Initialize and load the ISP1362 stack on to the target system as outlined in Section 4 2 and connect the Accelent IDP to the host Linux PC as a mass storage device 5 Write the following in a temporary file say TempData and give the file as an input to the fdisk command P Ww The following values are made for an OTG mass storage disk of size 8 MB Use the following command on the host PC fdisk dev sd X TempData Where X could be a b c z mkdosfs I dev sd X 1 6 Unload and close the ISPI362 stack from the target system Now the target system is ready for use 3 3 ISP1362 Add on Card for Intel PXA250 based Accelent IDP Rev 02 Accelent Systems developed the IDP Integrated Development Platform to speed up the embedded device development cycles Accelent IDP provides a feature rich cost effective development platform for embedded device application and product development UMIO0012 2 Koninklijke Philips Electronics N V 2003 All rights reserved User s Guide Rev 2 July 2003 14 of 34 Philips Semiconductors ISP 1362 Linux Stack User s Guide The ISP1362 Linux stack and Accelent IDP does not support two or more boards at the same time Therefore for the ISP1362 OTG evaluation you must have two Accelent
32. ion To compile the kernel and create the final image to be downloaded into the IDP target use the command rcd usr sro linux otg make dep zImage modules modules install 1362 jffs rootfs jffs image As a result a number of files starting with nk will be created in the root Linux directory e nk jffs flash bin This image includes the kernel and root filesystem nk kernel flash bin This image is just the kernel image useful if you already have a good root fs image and just need to reflash the new kernel nk kernel bin This is an image that will be loaded into RAM from the card without flashing into ROM It s quite useful for debugging or preserving your flash image Whichever image you choose to use copy it to the PCMCIA card and rename it nk bin The card filename MUST be nk bin or the bootloader which is WinCE bootloader will ignore it 3 3 2 15 Serial Communication for Debug Output On the host PC running Linux minicon can be used to receive debug output generated by printk from Accelent IDP A null modem cable is required to connect FFUART 5 port on Accelent IDP board and a COM port host PC Set Baud rate to 15200 data bits 8 Parity none Stop bits Flow control hardware 3 3 3 Accelent IDP Setup Follow the instructions given in the Quick Start Guide IDP for Intel PXA250 Applications Processor Linux OS document from the Accelent CD to set up the Accelent IDP The boot loader boot bin from the ac
33. ith the connected device Explanation on setting of environment for various USB devices is beyond the scope of this document 4 5 ISP1362 Device Stack Once the ISP1362 modules are loaded you can connect the ISP1362 to any other PC USB host through the Mini B to Standard B cable The ISP1362 device will appear as a mass storage device removable disk The following figure shows the device stack evaluation setup ISP1362 Evaluation Kit on Machine UMIOO I2 2 User s Guide mao PC as Standard USB Host OTG Mini B to Standard B Cable Bae mm Figure 4 2 Device Stack Evaluation Setup Rev 2 July 2003 Koninklijke Philips Electronics N V 2003 All rights reserved 22 of 34 Philips Semiconductors ISP 1362 Linux Stack User s Guide When connected to another USB host with the ISP1362 as a device you can e See the mass storage as a removable disk capacity of 16 MB including the file system e See the contents of the disk e Read write the contents of the disk e Format the disk FATI6 EXT2 file systems e Partition the disk into smaller disks 4 6 ISP1362 OTG Stack To work with the OTG stack you need to run either the otg commands from the tools directory or OTG demo from the ot gmsdemo directory Figure 4 3 shows the OTG stack evaluation setup r ISPI362 Evaluation Kit on Machine 2
34. ntel PXA250 Based Accelent IDP sssssssssssersecscessssssersossssssasssessocscessasssessosscessasscensosscessasscees 15 Figure 4 Host Stack Evaluation Example Setup ooi ie esas epar vba Dane teme RR Eno ese BRE et Hohe ip Su No EE edi AG LO EG ae ee RSA Udo 22 Fisuire 4 2 Device Stack Evaluation SetuP ME 22 Piste 4 3 OTG Stack Evaluation Setup es Reed ee GE RE ae ee NE idee EREET RE ests KECE ER EDE ER eevee cer ee eee aes 23 Figure 4 4 OTG Mass Storage Application in the IDLE State Snapshot sesse se sesse se se se ee ee Se Se GR ee Se Ge ee Re ee Re Ge Ge Ge Re Se Ge ee Re 24 Figure 4 5 OTG Mass Storage Application in the HOST State Snapshot sesse se sesse se se see eee Ge Ge Se Ge Re Se Ge ee ee Se ee Ge Ge ee 24 Figure 4 6 OTG Application File Selection Snapshot se ee ee Se ee ee ee Re Se Ge Ge ee ee ee Se Ge ee ee Se Ge ee ee Se Ge ee ge 25 Figure 4 7 OTG Application as a Device SnapsloE sesse obs qus top RE Re ee ee Rev EG geed de ee Ge Re at ee Re de ee 26 Figure 4 8 OTG B device accessing remote OTG mass storage device files ee Re Se GR ee Ge GR ee Se Ge ee Re Se Ge Re Ge nennt 27 Figure 4 9 OTG B closing the session after connected device data access se se ee Re ee Re Se Ge ee Re Ge Ge ee Re Se ee Ge Ge ee 28 Figure 4 10 Operations with OTG A and B devices seine siese se ee ro pH rep eek dee Fe pen bees Re se RR Ne GE ee AR eo
35. ntroller Driver C header file ISP1362 USB protocol driver C source file 6 3 1 pdc The pac directory consists of files related to the ISP1362 Device Controller Driver and USB protocol driver The following table shows the contents of the pac directory and their description Table 6 5 Contents of the pdc Directory File Name sd Description 0 ISP1362 USB protocol driver C header file release device pdc pdc intf h ISP1362 Device Controller Driver USB protocol driver interface C header file 6 3 2 devmscd The devmscd directory consists of files related to the mass storage class driver the device side and the mass storage bridge Table 6 6 shows the contents of the devmscd directory and their description Table 6 6 Contents of the devmscd Directory FileName Desripton O O O OoOO release device devmscd msbridge h USB mass storage bridge to mass storage disk emulation interface C header file release device devmscd mscdbridge h USB mass storage class driver to mass storage bridge C header file 6 3 3 diskemu The diskemu directory consists of files related to the mass storage disk emulation Table 6 7 shows the contents of this directory and their description Table 6 7 Contents of the diskemu Directory FileName Deseription See release device diskemu Makerile Makefile for the disk emulator module release device diskemu disk_emu c SCSI II mass storage disk emulation C source file release device disk
36. of 34 Philips Semiconductors ISP 1362 Linux Stack User s Guide 2 3 Core Modules 2 3 1 Host Stack The host stack consists of the Host Controller Driver HCD module The driver is used for data transfer on the USB bus for the connected devices This driver can work in parallel with other HCDs OHCI HCD UHC HCD EHCI HCD present in the kernel This is a kernel module and the Linux OS has support for USB connected USB device class drivers and suitable applications Linux operating system Linux kernel a a a IE EE TRENDS EE ISP1362 stack core modules ISP1362 application modules 1 Linux kernel drivers EN SP1362 porting modules Figure 2 1 ISP1362 Linux Stack Architecture 2 3 2 Device Stack The device stack consists of the Device Controller Driver DCD the USB protocol driver and the mass storage class driver The DCD is responsible for data transfer over the USB bus The USB protocol driver responds to the standard USB protocol requests The mass storage class driver adds the mass storage functionality to the USB device and responds to the mass storage class commands and protocol The mass storage needs to interface with the physical mass storage device to perform its operations and the physical disk is customer platform specific and UMIO012 2 Koninklijke Philips Electronics N V 2003 All rights reserve
37. oldconfig Note For the make oldconfig step accept all the default options You should use capital letters N instead of n to disable an option otherwise some weird compile errors will occur make menuconfig While configuring the kernel enable the following options e Make the default RAM Disk size from the options of block device Default Ram disk size to 20480 We are going to use the RAM disk as mass storage disk space e Enable loopback device support from block device loopback device support e Enable SCSI support and SCSI disk support e Enable the USB usb support USB OTG support and the required USB Class drivers USB audio USB mass storage etc support 3 3 2 13 ISP1362 Configuration e Go to ISP1362 Linux Stack source directory vod fust sro limnux otg l123527580u rfce e Edit the Rules Make file for any changes in compilation rules The changes could be e The kernel source directory is different from the one specified earlier e Compile time flags Refer to Section 5 1 if you want any configuration changes Make sure that PXA250 KIT hardware option is enabled with PXA250 REV2 UMIO0012 2 Koninklijke Philips Electronics N V 2003 All rights reserved User s Guide Rev 2 July 2003 17 of 34 Philips Semiconductors ISP 1362 Linux Stack User s Guide e CROSS COMPILE path MS SIZE FLAG is set to 8MB SIZE because of limitation of Accelent board for Mass storage demo 3 3 2 14 OS Image Creat
38. ot see the msdisk application as a running process when you list the current running processes ps 4 3 ISP1362 Add on Card for Intel PXA250 based Accelent IDP Rev 02 4 3 1 Initializing the Stack After booting the Accelent IDP needs some initial setup for the ISP1362 stack to run The initialization is done by executing the initialization script cd home 1362 0bjs init stack UMI0012 _2 Koninklijke Philips Electronics N V 2003 All rights reserved User s Guide Rev 2 July 2003 20 of 34 Philips Semiconductors ISP 1362 Linux Stack User s Guide This script mounts the OTG mass storage disk data from Accelent IDP ROM to RAM 4 3 2 Loading the Stack The ISPI362 Linux stack modules kernel as well as application are dynamically loaded and unloaded to the kernel e Log on to the system as root go to the ISPI362 object directory and use the script to load modules cd home 1362 0bjs imod e If you execute the sbin 1smod command you will notice that the following modules are loaded med DOC pho Ong hel You should also see the msdisk application running as an application process when you list the current running processes ps 4 3 3 Unloading the Stack e As root of the system go to the ISP 362 Linux source directory and use the script to unload module cd home 1362 objs t rmod e If you execute the sbin 1smod command you should not see any of the following modules as loaded meca DAE phe o
39. ource for any changes e The kernel source directory is different from the one specified above e Compile time flags Refer to section 5 l If you want any configuration changes Make sure that PXA250 KIT hardware option is enabled with PXA250_REV4 e CROSS COMPILE path MS SIZE FLAG is set to 8MB SIZE because of limitation of Accelent board for Mass storage demo While configuring the kernel use menuconfig enable the following options USB core support USB OTG support USB Audio Support USB mass storage support USB pegasus USB CATC USB KAWTH Save the configuration and exit make dep zImage modules modules install jffs rootfs jffs image As a result a number of files starting with nk will be created in the root Linux directory e nk jffs flash bin This image includes the kernel and root filesystem nk kernel flash bin This image is just the kernel image useful if you already have a good root fs image and just need to reflash the new kernel e nk kernel bin This is an image that will be loaded into RAM from the card without flashing into ROM It s quite useful for debugging or preserving your flash image Whichever image you choose to use copy it to the PCMCIA card and rename it nk bin The card filename must be nk bin or the bootloader which is WinCE bootloader will ignore it 3 2 2 7 Serial Communication for Debug Output On the host PC running Linux minicon can be used to receive debug output generated
40. r the source code example usr src Accelent IDPRev4 and go to the directory cd usr src AccelentIDPRev4 ozip2 cd mnt cdrom Source kernel linux 2 4 18 tar bz2 tar xfv bzip2z med J mnt odrom 5ource kernel patohn 2 4 15 rmkJ7 bz2 patch p0 itgzip cd mmnt odrom Source kernel patch 2 4 18 rmk pxa3 gz patch pO gzip cd mnt cdrom Source kernel releasepatch 2 4 18 rmk7 pxa3 asi2 gz patch p0 tcd linux make pxa idp config make oldconfig ISP1362 stack release contains setup files related to Accelent IDP setup First copy the ISP1362 release files ispl362 linux sw stack tar gz to the current directory usr src AccelentIDPRev4 linux tart zxvf 158pl1352 linux sw stack bar gz patch p1 1362 misc accelent rev4 otg kernel patch rev4 cp mnt cdrom Images rootfs tar gz 3 2 2 6 Linux Kernel Compliation Makefile Edit the Makefile of the kernel source usr src AccelentIDPRev4 linux CROSS COMPILE path to the path of the cross compiler UMIO0012 2 Koninklijke Philips Electronics N V 2003 All rights reserved User s Guide Rev 2 July 2003 12 of 34 Philips Semiconductors ISP 1362 Linux Stack User s Guide CROSS COMPILE pub usr bin arm linux The cross compile path usr include arm 2 95 3 depends on where the tool chain is installed and the version of the tool chain and from where the tool chain is downloaded Similarly edit the Rules Make of ISPI362 source usr src AccelentIDPRev4 linux 1362 s
41. rm linux gcc2953 tar bz2 Don t bother trying to build the tool chain from scratch The toolchain version 2 95 3 works very well Don t use any of the gcc 3x compilers yet they generate bad code for ARM in certain instances Usually the ARM toolchain should be unzipped in the root directory of the host PC using command UMIO0012 2 Koninklijke Philips Electronics N V 2003 All rights reserved User s Guide Rev 2 July 2003 Il of 34 Philips Semiconductors ISP 1362 Linux Stack User s Guide op mnt odrom Toolsytool chaln arm linux goc2953 tar bz2 tcd tar jxvf arm linux gcc2953 tar bz2 Older versions of tar might not accept this then try using Har Ixvf arm linux gco2953 tar bz2 Be careful about the root directory of the ARM cross compiler arm linux gcc will invoke cppO and ccl assuming they reside in certain directories relative to the compiler s root directory To be on the safe side unzip the ARM tool chain in the root directory Copy the utilities bin2bin foxfox mkfs jffs2 padkernel py from Tools utils directory of Accelent CD to your execution path like maybe bin These tools are needed to prepare Linux kernel and root file system for loading into the target cp J mnt oedrom lools utils bin cd bin chmod x bin2bin foxfox mkfs jffs2 padkernel py 3 2 2 5 Linux Kernel source The Linux kernel can be installed in to the PC host from the source code provided by the Accelent CD Create a directory fo
42. rovides a list of ot gcmd o options and their description Table 4 1 OTG Command Line tool Options Option Description ooo connected to the host on the OTG port comes out of the bus host Loads OTG modules mount If the OTG device is the USB bus host on the OTG port and the connected device is a mass storage D dence mounes beh the oe OTG dence and ine remore OTG derce dek to the moune ponts umount If the local OTG device disk and the remote OTG device disk are mounted to the mount points pr tmowa bobteedetaa emm Current state of the OTG port and the OTG device disks mount status Prints help menu To operate the OTG mass storage device as a host connect the other OTG mass storage device through the OTG cable and execute the following on one of the targets otgcmd host This command will make the OTG mass storage device as a USB host on the executed target UMIO0I2 2 User s Guide Koninklijke Philips Electronics N V 2003 All rights reserved Rev 2 July 2003 26 of 34 Di ye Q am m DON d EO Q D P 4 5 l NIY T r1 ER rnilips semiconductors gt F 13042 LINUX E J3uide File Edit settings Help root Devboard ob js root Deyvboard ob js root Devboard ob js 3 root Devboard ob js r oot Devyboard ob js root Deyboard ob js 3 zatec nd o status fotecnd ot OTG mass storage command utility fotecmd o OTG B device State ldle fot
43. s ke ee VA GES Re RR RR koe Ge 29 Tables Table 4 OTG Command Line tool ODEIOS se Ee EE den AA Re bab eN Ke ee eva ERE FR due ee Ee Reen Re ge REO ek Oe 26 Table s i Global Compilation Plaas ese ERKEN EK EE NG ERK RUNE LG Re OR DR BAIN ge eN KO GE ERA ee ie 30 Table 5 2 Host Controller Driver Compilation Flags eee eee GR ee ee Se Se Ge ee Se Ge Gee Re Se Ge Gee Re tn Ge ee Re Se Ge ee ge 30 Table 6 I Top Level Directory Contents ss reticere torna oie SEN Ge eo be ke sus sees ee Ses AE BA bes Ese Se Ke GE e Res CERE Ge see se GR ese ke de Ee ERG 3l Table 6 2 Contents of the host Directo iy e T C 3l Table 6 3 Contents of the phai Directory Red RE osi EK ee Ge edv sioe Caso eN eu ee Ge Gee Oo Ge ER ees 3l Table 6 4 Contents of die device Directory eR M 32 Table 6 5 Contents of the pde DIPBCEOD ss ER Ee sansa Ese Es Gee en Rd ie le Ie GEREED Ee es EN ER Ee Ne ER se Ede aces ee 32 Table 6 6 Contents of the devmscd Directory iiio petto Rire eet Rede EN E Ee ge ede De oe Re iint EE gee EE REEN UE EUR DR Ee ese 32 Table 6 7 Contents of the diskemu Directory sasecscsssccscsczsseessscesszsssccese erae PRESS Re aaa Kees gekke ERG kes dee PARE HERR ae aatia 32 Table 6 8 Contents af the otg Directory ss EE dee Se DR ee be Re ee Se koe GO Re ee GE Ge ke es ER Ke ek AR Dee 33 Table 6 9 Contents of the hal DireetO Yi
44. st state Close Figure 4 6 OTG Application File Selection Snapshot UMIO012 2 Koninklijke Philips Electronics N V 2003 All rights reserved User s Guide Rev 2 July 2003 25 of 34 Philips Semiconductors ISP 1362 Linux Stack User s Guide 44 OTG Test Application x ISP1362 Status ISP1362 is used as A DEVICE ISP1362 Change Mode ISP1362 Change Mode IDLE HOST SP1382 File Transfer Menu Source Disk Destination Disk Select Disk COPY select Disk Local Disk not Available A Remote Disk not amp vailable MOVE DELETE DELETE Status pad plugged Mini B state B IDLE plugged Mini amp state amp IDLE state change amp IDLE plugged Mini A state A IDLE ISP1 i 362 trying to become OTG hast plugged Mini amp state amp HOST state change amp HOST plugged Mini A state state change amp HOST ISP1362 has gone into amp Hast state plugged Mini A state amp HOST plugged Mini amp state amp IDLE state change A_IDLE plugged Mini A state amp HOST state change amp HOST plugged Mini amp state amp DEVICE VICE state change DEVI Close Figure 4 7 OTG Application as a Device Snapshot Another way to use the OTG mass storage is by using the command line application in the tools directory To see the list of options supported by this command use the help option cd home 1362 0bjs otgemd o help The following table p
45. tg Had Also you should not see the msdisk application as a running process when you list the current running processes ps 4 3 4 Closing the ISP1362 Stack Before the Accelent IDP is shutdown you need to close the ISP1 362 stack to copy the OTG mass storage data changes in the RAM to the ROM To do so execute cd home 1362 0bjs tif CLOSES stack 4 4 ISP1362 Host Stack Working with the ISP1362 host stack is similar to working with any other Host Controller on Linux Once the ISP1362 stack modules are loaded you can work with any devices connected to the standard USB port of the ISP1362 evaluation kit assuming the kernel has drivers root file system has application and proper environment is set for the corresponding connected device A generic example on setting up the host stack evaluation is given in the following diagram UMIO0012 2 Koninklijke Philips Electronics N V 2003 All rights reserved User s Guide Rev 2 July 2003 21 of 34 Philips Semiconductors In Figure 4 1 the requirements for the connected devices to work are ISP 1362 Evaluation Kit on Machine MOUSE SPEAKERS PRINTER USB Peripherals on Machine ISP1362 Linux Stack User s Guide Figure 4 1 Host Stack Evaluation Example Setup e The Linux kernel has class drivers or drivers corresponding to the connected USB device enabled and loaded e The Linux OS has the appropriate application to work w
46. ugged Mini A state A IDLE state change amp IDLE OTG Test Application Philips Innovation Center APIC Philips Electronics Singapore Pte Ltd Close ISP1362 Linux Stack User s Guide Figure 4 4 OTG Mass Storage Application in the IDLE State Snapshot 44 OTG Test Application SP1362 Status ISP1362 is used as B HOST ISP1362 Change Mode IDLE HOST ISP1382 File Transfer Menu Source Disk Select Disk mntttocaldisk 4 DELETE Destination Disk COPY MOVE Select Disk mnt rmtdisk l DELETE Status pad plugged Mini B state BLIDLE state change B IDLE plugged Mini B state B IDLE ISP1362 has gone into B Idle state plugged Mini B state B DEVICE state change B DEVICE plugged Mini B state B IDLE state change B IDLE plugged Mini B state B IDLE ISP1362 trying to become OTG host plugged Mini B state B DEVICE state change B DEVICE plugged Mini B state B HOST state change B HOST plugged Mini B state B HOST state change B HOST ISP1362 has gone into B Host state Close Figure 4 5 OTG Mass Storage Application in the HOST State Snapshot The application has a provision to change the state from IDLE to HOST and HOST to IDLE In the HOST state both the local OTG device disk and the remote OTG device disk connected will be mounted and available for use UMIO0I2
47. urce file oe release appl tools otgsetup c ISP1362 OTG mass storage demo evaluation environment setup application C source file 6 7 objs The objs directory consists of files related to the compiled objects and scripts to load and unload the modules This directory initially consists of script files and once the compiled objects are installed the object files will also occupy this directory Table 6 14 Contents of the objs Directory File Name jDescipton S O release objs imod Script file to load OTG mass storage modules release objs rmod Script file to unload OTG mass storage modules 1 References UMIO0012 2 Universal Serial Bus Specification Rev 2 0 On The Go Supplement to the USB 2 0 Specification Rev 1 0 ISP1362 Single chip Universal Serial Bus On The Go controller datasheet ISP1362 PCI Evaluation Board User s Guide API ISP 1362 Host Stack API ISP 362 Device Stack API ISP 1362 OTG Stack Release Notes ISP 362 Linux Stack Quick Start Guide IDP for Intel PXA250 Applications Processor Linux OS Software User Guide IDP for Intel PXA250 Applications Processor Linux OS ISP1362 OTG Add On Evaluation Kit with Intel PXA250 IDP User s Guide Rev 2 July 2003 Koninklijke Philips Electronics N V 2003 All rights reserved 34 of 34 Philips Semiconductors Philips Semiconductors is a worldwide company with over 100 sales offices in more than 50 countries For a complete up to date list of our sal
48. w The ISP1362 is a single chip Universal Serial Bus USB On The Go OTG Controller integrated with the USB Host Controller and the USB Device Controller The ISP1362 Linux stack is the software for the ISP1362 evaluation kit that operates as an OTG mass storage device Using the ISP1362 Linux stack the ISP1362 can function as e A standard USB full speed mass storage device when connected to a PC running any OS e A USB full speed OTG mass storage device when connected to any OTG device e A USB host when connected to USB peripherals OTG and non OTG The ISP1362 Linux stack is a group of kernel and application modules arranged such that the code can be easily ported to any other platform running the Linux OS All the platform specific modules are made as separate modules Besides the ISP1362 Linux stack can be used as reference code to build OTG device firmware The ISP1362 Linux stack is distributed with the complete source code files 2 2 Stack Architecture Figure 2 1 shows the software model of the ISP1362 Linux stack The software stack consists of three modules shown in three colors e Core modules these modules are platform independent e Application demo modules e Porting modules these are platform specific or product specific modules that require porting The following subsections briefly explain each module UMIO0012 2 Koninklijke Philips Electronics N V 2003 All rights reserved User s Guide Rev 2 July 2003 6
Download Pdf Manuals
Related Search