User Manual ROM-3310 - download.advantech.com
Contents
1. i eet eee 50 5 4 2 Warranty ii Roe ade ead 50 5 4 8 Repairs under 50 5 4 4 Exclusions from 51 8 amp 8 P 51 5 5 1 Obtaining an 51 5 5 2 Returning the Product for 51 553 Service Charges iicet aate aab diea dandi dec nt d 52 5 5 4 Repair Report eerte nter 53 5 5 5 Custody of Products Submitted for Repair 53 5 5 6 Shipping Back to Customer 53 General Introduction This chapter gives background information on the ROM 3310 Sections include E Introduction m Specification 1 1 1 2 ROM 3310 User Manual Introduction ROM 3310 adopts Cortex 8 AM3352 1Ghz architecture as its SOC solution The main features of this platform are followed by RTX 2 0 standard with a heat sink less compact reliable amp great power management Therefore ROM 3310 platform is suitable for following applications M Industrial data collector And the main features of TI Cortex A8 processors are shown as following ARM Cortex A8 high performance processor single core 1GHz Support Parallel RGB 24bit TTL m TI AM3352 Cortex A8 Technology support low power consumption Capabilities of2. Eee Bo netcfg ethO Note IP address in above should be replaced according to user s the requirement For examples IP 172 21 128 251 in above is the DNS server s IP user should replace it with the correct DNS IP address 3 15 8 4 Date Time Configuration You can use the tool we provide to modify the system time Click on the Time Settings icon on the screen Then Advantech Date Time Settings utility will be started L Advantech Date Time Settings January 2015 gt 1 2 3 4 18 19 20 21 22 24 5 6 1 Jan 2015 06 08 37 S Figure 3 5 Date Time Settings After the time is adjusted please click OK button and the date will be saved Mean while the RTC time will be synchronized to the time you just set 35 ROM 3310 User Manual 3 15 8 5 Serial Tools We have five serial ports named ttyO1 ttyO4 And we provide a serial test tool to let it easily to validate the serial ports Advantech Serial TTY Port ttyOl R Baud Rate 115200 v he Data Y Parity 5 Y Stop Bas he 1 Y Flow None Y Send Figure 3 6 Serial Control 3 15 8 6 Matrix GUI User s Guide Overview When you boot up the target system Matrix GUI should be automatically started Matrix is an HTML 5 based application launcher created to highlight available appli cations and demos provided There are two forms of Matrix local and remo
3. 6 Table 2 2 SW10 Boot 6 Table 2 3 CN1803 MCU programming port 6 Table 2 4 CN1201 JTAG 7 Table 2 5 CN1202 Debug 7 ROM 3310 Board Block 8 Figure 2 1 ROM 3310 Block 8 3310 Board LOOKS ritieni ccelo I x neas tite 8 Test Tools cone ae dec i Podere 10 eu M m 10 USB TeSt 11 SD 11 SPI Nor Flash Test eiie RI RE 13 e 14 Table 3 1 ROM 3310 GPIO Default Setting 14 VOGA TOS Erenin 15 pearl 15 CANTES t m 17 125 17 ENE ETE 18 RS232 RS422 RS485 19 Watchdog Timer iii eerie 20 Test 21 Package 22 3 15 1 Pre built System 22 3 15 2 Source Code Package s eie aid 22 3 15 3 Set
4. Restore Defauits Cancel Apply Figure 3 3 HyperTerminal Settings for Serial Console Setup 3 15 8 Linux System Configuration and Use 3 15 8 1 Display Output Setting VGA Setting Please set environment in u boot as below setenv mmcargs run bootargs defaults setenv console console bootargs bootargs root mmcroot rootfstype mmcrootfstype 5 method video mode VGA_1024x768 60 LDB XGA is an example for the resolution of your LCD control You can input the actual resolution of your VGA screen here such as 800x600 1024x768 etc The system will accomplish the corresponding parameters automatically If the panel has problem to be activated you may need to check the panel datasheet to configure the panel related parameters The VGA video mode database is stored in linux 3 2 0 drivers video da8xx fb c You can add a new one for your support resoution static struct da8xx panel known lcd panels ROM 3310 User Manual 30 name INNOLUX_VGA_1024x768 60 width 1024 height 768 hfp 32 hbp 228 hsw 60 vfp 7 vbp 21 vsw 10 65000000 invert pxl clk 1 2r The definition of da8xx_panel in linux 3 2 0 drivers video da8xx fb c The name field is optional If you input this value it can be used in U Boot environ ment settings The refresh field is the screen refresh frame rate such as 60Hz 70Hz The resolution
5. mk uboot sh A script to build the u boot and copy the u boot to image folder after building cfg kernel sh A script to configure the kernel building setup quickly mk kernel sh A script to build the ulmage and copy the ulmage to image folder after building mksd linux sh A script to setup up a bootable SD card if users build their images 3 15 2 6 source This folder contains sub directories linux 3 2 0 psp04 06 00 11 and u boot 2013 01 01 psp06 00 00 00 They are the source codes of the Linux kernel and U boot Linux is OS that is including true multitasking virtual memory shared libraries demand loading shared copy on write executables proper memory management and multitask networking Linux is easily portable to most general purpose 32 bit architectures as long as they have a paged memory management unit PMMU and a port of the GNU C compiler gcc part of The GNU Compiler Collection GCC Linux has also been ported to a number of architectures without a PMMU although functionality is then obviously somewhat limited Linux has also been ported to itself The main sub directories under linux 3 2 0 are listed as following arch The items related to hardware platform most of them are for CPU block The setting information for block crypto The encryption technology that kernel supports Documentation The documentation for kernel drivers
6. Cortex A8 AM3352 1GHz Memory 512MB 512MB NAND Flash 4GB 4GB Nor Flash 4MB 4MB 24bit TTL Yes Yes USB 2 2 Giga LAN 1 1 125 1 1 I2C 1 1 GPIO 10 10 UART 5 5 CAN 2 2 SPI 1 1 Heat sink N A Optional Operation Temp 0 60 C 40 85 ROM 3310 User Manual ROM 3310 User Manual vi Contents Chapter Chapter Chapter 1 1 4 1 5 2 1 2 2 2 3 General Introduction 1 INTRODUCTION s 2 Product Features cie Idea RD e ox 2 Mechanical 3 1 3 1 DIMENSIONS mim ooi etr ottiene ecce 3 1 3 2 Heat Spreader Dimensions mm sese 3 Electrical Specifications 3 1 4 1 Power supply Voltage 3 Environmental Specifications 3 1 5 1 Operating 2 3 1 5 2 Operating Humidity 3 1 5 3 Storage temperature 1 1 1 22 41040 2 21 3 154 Storage Humidity icr rt eec ite crm nba ci ergo 3 H W Installation 5 Board gt iiio teinte dae qoi Bb RM Ra 6 21 1 Connector LIS rt 6 Table 2 1 External IO
7. The drivers for hardware firmware Some of firmware data for old hardware fs The file system the kernel supports include The header definition for the other programs used init The initial functions for kernel ipc Define the communication for each program of Linux O S kernel Define the Kernel process status schedule signal lib Some of libraries mm The data related the memory ROM 3310 User Manual 24 net The data related the network security The security setting sound The module related audio virt The data related the virtual machine There are plenty of documentations or materials available on Internet and also could be obtained from books and magazines you can easily find the answers for both Linux specific and general UNIX questions There are also various README files in source linux 3 2 0 psp04 06 00 11 Docu mentation you can find the kernel specified installations and notes for drivers You can refer to source linux 3 2 0 psp04 06 00 11 Documentation 00 INDEX for a list of the purpose of each README note 3 15 3 Set up Build Environment instructions in this guide are based on Ubuntu 12 04 LTS developing environment Please install the Ubuntu 12 04 LTS at your PC NB in advance When you obtain the ROM 3310 Linux source code package please refer to follow ing instructions to extract to your developing environmen
8. canconfig 0 stop gt dev null canconfig 0 bitrate 1000000 gt dev null canconfig 0 start gt dev nu canconfig canl stop gt dev null canconfig canl bitrate 1000000 gt dev null canconfig canl start gt dev nu candump 0 gt 0 1 6 candump 1 gt canl log 6 cansend 0 0 11 0 22 0x33 0x44 0x55 0x66 77 0x88 f cansend canl 11 0x22 0x33 0x44 0x55 0x66 0x77 0x88 cat can0 log interface can0 family 29 type 3 proto 1 4001 8 11 22 33 44 55 66 77 88 lt Ox i1S 14 22 33 44 55 66 77 99 cat canl log interface canl family 29 type 001 gt 8 11 22 33 44 55 66 77 88 901 8 14 22 33 44 55 66 77 99 je Su POLO If canO log and can1 log store receive data the same it CAN test PASS 3 10 125 Test MIC IN command as following 44100 is the sample rate amixer sset Right PGA Mixer Mic3R on gucee iee wan 1 44100 5 sue Audio out command as following aplay unit tests Advantech wav 17 ROM 3310 User Manual 3 11 LAN Test ROM 3310 sets DHCP as default network protocol ifconfig etho Link encap Ethernet HWaddr 78 A5 04 DD E4 9C ame acka 172 21 170 765 Boasts 17221 171 255 Mask 2552 P5 UP BROADCAST RUNNING ALLMULTI MULTICAST 5 1 5000 RX packets 16740 errors 0 dropped 0 overruns 0 frame 0 TX packets 1454 errors 0 dropped 0 overr
9. C 32 140 F or 40 85 C 40 185 F The operating temperature refers to the environmental temperature for the model 1 5 2 Operating Humidity Operating humidity 096 9096 relative humidity non condensing 1 5 3 Storage temperature Storage temperature 40 85 C 1 5 4 Storage Humidity Relative humidity 9596 60 3 ROM 3310 User Manual ROM 3310 User Manual H W Installation This chapter gives mechanical connector information on the ROM 3310 CPU Computer on Module Sections include m Connector Information B Mechanical Drawing 21 Board Connector The board has four connectors that allow you to configure your system to your appli cation LED140 LED1402 2 1 1 Connector List Table 2 1 External IO Connector Position Description SW10 Boot selection A CN1803 MCU programming port B CN1201 JTAG connector CN1202 Debug port D Table 2 2 SW10 Boot selection Jumper Mode Jumper Mode 1 ON SPI ROM 1 SD 2 2 Table 2 3 CN1803 programming port Pin Signal Pin Signal 1 JTAG VCC 2 SBWTDIO 3 SBWTCK 4 SBWTCK 5 GND ROM 3310 User Manual 6 Table 2 4 1201 JTAG connector Pin Signal Pin Signal 1 3 3V 2 3 3V 3 JTAG TMS 4 5 6 7 EMUO 8 RESETn 9 EMU1 10 GND Table 2 5 1202 Debug connector
10. helloworld in current directory 5 Runthe executable file helloworld on the ROM 3310 Insert the Linux system SD card to your developing computer cp helloworld media rootfs tool Note media rootfs is the mounted point of your Linux system SD card E Remove this SD card and insert it to ROM 3310 then open serial con sole On ROM 3310 platform type root Login On ROM 3310 platform type cd tool On ROM 3310 platform type helloworld Now you should be able to see Hello World shown on ROM 3310 39 ROM 3310 User Manual 3 15 9 2 Development of GUI Programs with QT Library With the development kit you can develop a qt based GUI program Follow these steps you can quickly convert your QT Project to a GUI application for ROM 3310 On your host PC set up QT Build Environment source usr local cross compiler linux devkit environment setup Build QT Instructions cd projectdir projectName pro make Run QT demo qtappName qws Note qws Parameter tell the QT Application to run as a server B 3 15 9 3 Demo program source code Serial Port Programming Please refer to lt BSP_PATH gt source demo uart It is an example of sending and receiving data via the serial port Receiving data W ctil read dev ceyol Sending data uart ctrl send dev ttyOl Before using your program of serial port please ensure that your serial port is in 232
11. 2 This operation may damage the data stored in USB flash disk Please make sure there is no critical data in the USB flash disk being used for this test If your U Disk size is small the seek value need to be small 3 4 SD Test 1 When booting from eMMC you would see only below directories 15 dev mmcblk dev mmcblkO0 dev mmcblk0bootO0 dev mmcblkObootl dev mmcblkOpl dev mmcblk0p2 2 Insert SD card to SD card slot SD1 and check your device again You should be able to see more directories dev mmcblk1 is the SD card storage SD Card have 2 partitions 1s dev mmcblk dev mmcblk0 dev mmcblkObootl dev mmcblkl dev mmcblk1p2 dev mmcblkObootO0 dev mmcblk0pi dev mmcblklpl dev mmcblk0p2 11 ROM 3310 User Manual 3 Erase and check ai Glew zero dew mine olka 11024 sesk 25llg 150 records aum 1 0 records out hexdump C dev mmcblkl s 25720832 16 01887800 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 4 Write and check echo n 0123456789ABCDEF dd of dev mmcblkl bs 1024 count 1 Seek 25118 0 1 records in 041 records out fhexdump C dev mmcblkl s 25720832 n 16 52 88 Sj Sio NS SS 44 4546 0123456789ABCDEF Note Please make sure parameter seek is equal to 25118 as indicated in red in above codes If you create the to wrong sector that E damage t
12. China July 2015 ROM 3310 User Manual ii Declaration of Conformity FCC Class A Note This equipment has been tested and found to comply with the limits for a Class A digital device pursuant to part 15 of the FCC Rules These limits are designed to provide reasonable protection against harmful interference when the equipment is operated in a commercial environment This equipment generates uses and can radiate radio frequency energy and if not installed and used in accordance with the instruction manual may cause harmful interference to radio communications Opera tion of this equipment in a residential area is likely to cause harmful interference in which case the user will be required to correct the interference at his own expense Safety Instructions 1 2 3 10 11 12 13 14 Read these safety instructions carefully Keep this User Manual for later reference Disconnect this equipment from any AC outlet before cleaning Use a damp cloth Do not use liquid or spray detergents for cleaning For plug in equipment the power outlet socket must be located near the equip ment and must be easily accessible Keep this equipment away from humidity Put this equipment on a reliable surface during installation Dropping it or letting it fall may cause damage The openings on the enclosure are for air convection Protect the equipment from overheating DO NOT COVER THE OPENINGS Make sure the voltage of the power
13. and peripheral module recommendations such as WiFi 3G BT Resolving customer concerns is Advantech s main target at this stage Since we all know that product evaluation is the key task in the planning period especially for performance and specification so we try to help our customers conduct all the necessary tests for their RISC COM Design stage When a product moves into the design stage Advantech will supply a design guide of the carrier board for reference The carrier board design guide provides pin defini tions of the COM connector with limitations and recommendations for carrier board design so customers can have a clear guideline to follow during their carrier board development Regarding different form factors Advantech offers a complete pin out check list for different form factors such as Q7 ULP and RTX2 0 so that customers can examine the carrier board signals and layout design accordingly In addition our team is able to assist customers to review the placement layout and schematics to ensure the carrier board design meets their full requirements For software develop ment Advantech RISC software team can assist customers to establish an environ ment for software development and evaluate the amount of time and resources needed If customers outsource software development to a 3rd party Advantech can also cooperate with the 3rd party and provide proficient consulting services With Advantech s professional support the
14. can be filled in the xres amp yres fields The pixel clock pixclock is equaled to 1012 Total horizontal line Total vertical line DCLK For example the total horizontal line is 1344 DCLK and total vertical number is 806 horizontal lines The DCLK frequency is 60 MHz Therefore we can get 1012 1344 806 60 15385 The margin values can be seen as front porch amp back porch The sync_len means pulse width The sync value indicates the sync polarity low or high struct da8xx_panel const charname 25 Full name lt vendor gt _ lt model gt unsigned shortwidth Width Width clock unsigned shortheight int hfp Horizontal front porch int hbp Horizontal back porch int hsw Horizontal Sync Pulse int vfp Vertical front porch int vbp Vertical back porch int VSW Vertical Sync Pulse unsigned intpxl clk Pixel clock unsigned charinvert pxl clk Invert Pixel 31 ROM 3310 User Manual Display Setting VGA Single out please set in u boot as below 1024x768 60 resolution setenv mmcargs run bootargs_defaults setenv console S con sole bootargs bootargs root mmcroot rootfstype mmc rootfstype method video_mode VGA_1024x768 60 800x600 40 resolution setenv mmcargs run bootargs_defaults setenv console S con sole bootargs bootargs root mmcroot rootfstype mmc rootfstype ip ip meth
15. cross region charge It is required to contact the local repair center before offering global repair service It is recommended to s end cards without accessories manuals cables etc Remove any unnecessary components from the card such as CPU DRAM and CF Card If you send all these parts back because you believe they may be part of the problem please note clearly that they are included Otherwise ADVANTECH is not responsible for any items not listed Make sure the Problem Description is enclosed European Customers that are located outside European Community are requested to use UPS as the forwarding company We strongly recommend adding a packing list to all shipments Please prepare a shipment invoice according to the following guide lines to decrease goods clearance time 51 ROM 3310 User Manual 5 5 3 1 Give a low value to the product on the invoice or additional charges will lev ied by customs that will be borne by the sender 2 Add information Invoice for customs purposes only with no commercial value on the shipment invoice 3 Show RMA numbers product serial numbers and warranty status on the ship ment invoice 4 Add information about Country of origin of goods In addition please attach an invoice with RMA number to the carton then write the RMA number on the outside of the carton and attach the packing slip to save han dling time Please also address the parts directly to the Service Department and
16. design process becomes much easier and product quality will be improved to meet their targets ROM 3310 User Manual 48 Integration stage This phase comprises of HW SW integration application development and periph eral module implementation Due to the lack of knowledge and experience on plat forms customers need to spend a certain amount of time on analyzing integration problems In addition peripheral module implementation has a lot to do with driver designs on carrier boards RISC platforms usually have less support for ready made drivers on the carrier board therefore the customer has to learn from trial and error and finally get the best solution with the least effort Advantech s team has years of experience in customer support and HW SW development knowledge Conse quently we can support customers with professional advice and information as well as shortening development time and enabling more effective product integration Validation stage After customer s ES sample is completed the next step is a series of verification steps In addition to verifying a product s functionality the related test of the product s efficiency is also an important part at this stage especially for RISC platforms As a supportive role Advantech primarily helps customers solve their problems in the testing process and will give suggestions and tips as well Through an efficient verifi cation process backed by our technical support customers a
17. etc init d vsftpd stop Note After start the ftp server You had to manually add user ftp root am335x adv adduser ftp root am335x adv 4 chown root root home ftp Then you can ftp the ROM 3310 using user ftp ssh Server When boot up the ROM 3310 the ssh service is already started by default You can run the following command on your host PC to login the ROM 3310 hostPCS sudo ssh root TARGET SYSTEM The service start command is root am335x adv etc init d dropbear start And the stop is root am335x adv etc init d dropbear stop telnet Server When boot up the ROM 3310 the telnet service is already started by default You can run the following command on your host PC to login the ROM 3310 hostPC sudo telnet TARGET SYSTEM IP The service start command is root am335x adv etc init d telnetd start And the stop is root am335x adv etc init d telnetd stop 33 ROM 3310 User Manual http Server We support an embedded web server name lighttpd and the matrix GUI is based on it The service start command is root am335x adv etc init d lighttpd start And the stop is root8am335x adv 4 etc init d lighttpd stop 3 15 8 3 Network configuration Configuration via UI You can get an IP address via DHCP also you can configure a static IP address for ROM 3310 Click on the Network Cfg icon on the screen Then Advantech NIC Configuration utility will be started Yo
18. function int i_dis WDIOS_DISABLECARD ioctl fd WDIOC SETOPTIONS amp i dis Enable the watchdog timer sample code if user want to enable the watchdog again before timeout when it is disabled call the following ioctl function int i en WDIOS ENABLECARD ioctl fd WDIOC SETOPTIONS amp i en Get the current timeout value get the current timeout value the driver used int timeout 0 ioctl fd WDIOC GETTIMEOUT amp timeout Please refer to lt BSP_PATH gt source demo watchdog folder to get more information 41 ROM 3310 User Manual GPIO Programming ROM 3310 has 8 gpios Please refer to BSP PATH gt source demo gpio Usage root am335x adv gpio 200 out 1 Note 200 means gpio0 and so 200 209 corresponds to gpio0 gpio9 out 2 means output 1 the value set to the corresponding gpio port Can Programming Please refer to lt BSP PATH gt source demo can test Note sending data sample code please refer to can write c Can receiving data sample c code please refer to can read c ROM 3310 User Manual 42 System Recovery This chapter introduces how to recover Linux operating system if it is damaged accidentally 4 1 System Recovery This section provides detail procedures of restoring the eMMC image You can do system recovery through below steps if you destroy onboard flash image by ac
19. the PC is on Disconnect power before making any configuration changes The sudden rush of power as you connect a jumper or install a card may damage sensitive elec tronic components Packing List Before installation please ensure the following items have been shipped B 1ROM 3310 RTX Module Optional Accessories Part No Description 1757002943 ADAPTER 100 240V 65W 19V 3 42A W O P 9NA0651217 9696MEG700E ROM EG70 A101 ASS Y SPI I2C Board For ROM DB5900 9696MEG520E ROM EG52 A101 ASS Y CODEC Board for ROM 3900 1700019077 M Cable USB A M M USB M 150cm OTG Device 1700019076 M Cable USB A F M USB M 10cm OTG Host SQF ISDS1 4G 82C SQF SD C6 SLC 4G 1CH 1700001524 Power Cord 3P UL 10A 125V 180cm 9696ED2000E ASS Y ROM ED20 DB A101 1 170203180A Power Cord 3P UK 2 5A 3A 250V 1 83M 1700001524 Power Cord 3P UL 10A 125V 180cm Development board Part No Description ROM DB3900 SWOOE Development carrier board for RTX Rev A1 For more information please refer to Advantech Baseboard Check List and Evalu ation Board Reference Schematic You can download Advantech Baseboard Check List and Evaluation Board Refer ence Schematic from http com advantech com ROM 3310 User Manual iv Ordering Information Model Number Description Commercial Grade Industrial grade Part No ROM 3310CS MCA1E ROM 3310WS MCA1E CPU Cortex A8 AM3352 1GHz
20. the past System Integrators SI were used to completing projects without outside assistance but now such working models have moved on Due to diverse market demands and intense competition cooperation for both upstream and downstream vertical inte gration has become a much more effective way to create competitive advantages As a result ARM based CPU modules were born out of this trend Concentrating all nec essary components on the CPU module and placing other parts on the carrier board in response to market requirements for specialization provides greater flexibility while retaining its low power consumption credentials Advantech has been involved in the industrial computer industry for many years and found that customers usually have the following questions when implementing modu lar designs General I O design capability Although customers possess the ability for vertical integration and have enough know how and core competitiveness in the professional application field the lack of expertise and experience in general power and I O design causes many challenges for them especially integrating CPU modules into their carrier board The acquisition of information Even if the individual client is able to obtain sufficient information to make the right decision for the specialized vertical application some customers encounter difficult problems dealing with platform design in general and communicating with CPU or chipset manufacturer
21. the sys tem and the users mnt Standard mount point for external file systems opt Typically contains extra and third party software proc A virtual file system containing information about system resources More information about the meaning of the files in proc is obtained by enter ing the command man proc in a terminal window The file proc txt discusses the virtual file system in detail root The administrative user s home directory Mind the difference between the root directory and root the home directory of the root user sbin Programs for use by the system and the system administrator sys Linux sys file system 23 ROM 3310 User Manual tmp Temporary space for use by the system cleaned upon reboot so doesn t use this for saving any work usr Programs libraries documentation etc for all user related programs var Storage for all variable files and temporary files created by users such as log files the mail queue the print spooler area space for temporary stor age of files downloaded from the Internet unit tests just for sample test tools 3 15 2 5 scripts Some scripts provided by Advantech will help you configure system or build the images more quickly Please check them as follows setenv sh A script to setup the developing environment quickly cfg uboot sh A script to configure the u boot building setup quickly
22. ttyO4 OK Writing helloworld Reading helloworld gt TX RX Signal pass UART RS485 Testing PASS Close uart dev ttyOl OK Close uart dev ttyO4 OK Note UART1 Jump RSB485 mode you can refer the detail jump information E from ROM DB3900 what a develop board of Advantech EJ Watchdog Timer Test Executing AutoRun WTD fcd unit tests AutoRun_WTD 15 Get the timeout value from driver timeout 60 seconds Now we set the timeout value to 10 seconds Get the timeout value from driver again timeout 10 seconds Setting succeeded and watchdog is enabled Feed the watchdog every 15 seconds Feed watchdog After reboot user will see the follow the boot messages SPL 201 5501 50 9154 32 Seo 28 2014 11339320 usb hdrc ConfigData 0xde UTMI 8 dyn FIFOs bulk combine bulk pui 116 0 Rx HB 1IS0O Ix SoftConn usb hdrc MHDRC RTL version 2 0 usb hdrc setup fifo mode 4 usb hdrc 28 31 max ep 16384 16384 memory SB Peripheral mode controller at 47401000 using PIO O usb hdrc ConfigData 0xde UTMI 8 dyn FIFOs bulk combine bulk AHB 10 50 558 8 0 1 ROM 3310 User Manual 20 3 14 RGB Test Execute the following commands to run the Photo demo application on ROM 3310 ee cests AutoRun RGB test framebuffer Pleas nter the test result y Pass n Fail Fra
23. 0 UU UU UU 308 UU UG UU VU vw VIA WU 40 49 502 50 UU 59 60 703 UU 15 ROM 3310 User Manual The 0x2d0x2d is the PMIC address So you can try below command to know 2 bus is work or not i Zech y i No size specified using byte data access 1 2 4 5 6 7 8 9 e cl S 012345678 9abcdef 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 105 OG OG OG OG OG OG OG OG OG OG OG OG OG OG 20 41 Od 3d 00 05 2e 00 05 00 00 00 00 00 00 00 00 S03 OG Os Gi OG Wel OG OG OL OG OG OG OG OG OG Sio TG BE Oe po 40 35 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 6 50 16 02 00 00 00 00 00 00 00 00 00 00 00 00 00 00 p rr EE 60 00 00 00 00 00 00 00 00 00 00 222227 70 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 80 01 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 90 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 20 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 bO 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ROM 3310 User Manual 16 3 9 CAN Test 1 Check CAN network device 15 sys class net 0 canl 0 lo 2 Test CAN device Connect CANO amp 1
24. 00 GPIO CHIP GPIOO gpio200 GPIO 3 GPIO1 gpio201 GPIO 4 GPIO2 gpio202 GPIO 5 GPIO3 gpio203 GPIO 6 GPIO4 gpio204 GPIO 7 GPIO5 gpio205 GPIO 8 GPIO6 gpio206 GPIO 9 GPIO7 gpio207 GPIO 10 GPIO8 gpio208 GPIO 11 GPIO9 gpio209 GPIO 12 sys class gpio You can use ls to list all GPIO devices and you should also see GPIO ports in above table Example of testing GPIO Set gpio200 echo in gt gpio200 direction cat gpio200 direction in Set gpio201 GPO out echo out gt gpio201 direction cat gpio201 direction out Set gpio201 GPO value 1 echo 1 gt gpio201 value Get gpio200 value cat gpio200 value 1 As you see in above procedure and we set gpio 200 as gpio 201 as GPO once we send data out from gpio 201 it should be able to receive the same data from gpio 200 ROM 3310 User Manual 14 3 7 3 8 VGA Test Testing through gst launch for default single display 1 cd unit_tests AutoRun_lvds sh 2 Then can see the video demo on the default display screen A AD ANTECH SS I2C Test There is one I2C buses in ROM 3310 ls sys class i2c dev aL 2 gil i2cdetect 1 12 11 126 2 adapter AE adapter Please try below command to know if there is any device connected to i2c bus 1 r Oo i 2 2 amp 3 8 GA eb 00 105 UU 2
25. 3 ms 64 bytes from 192 168 0 12 seq 2 ttl 128 time 0 300 ms i172 L17 20 192 pine 3 packets transmitted 3 packets received 0 packet loss Note target computer Client firewall need close ROM 3310 User Manual 18 3 12 RS232 RS422 RS485 Test As you can see below there are 5 UART supported by ROM 3310 dev ttyOO is reserved for ROM 3310 debug port ROM 3310 CN1202 the rest UART ports could be applied by user Test RSB232 ad wart AutoRun uart232 test 5232 175232 mumders 4 dev ttyOl PASS dev ttyO2 PASS dev ttyO3 PASS dev ttyO4 PASS RS232 Test Pass Note UART1 support RSB232 RSB422 RSB485 test rsb3232 mode please jump rsb232 mode you can refer the detail jump information from ROM 083900 what a develop board of Advantech UART1 Test RSB422 unit_tests AutoRun_uart422 p dev ttyol T Open uart dev ttyOl PASS Writing hello world Reading hello world gt TX RX Signal pass UART RS422 Testing PASS Note UART1 Jump RSB422 mode you can refer the detail jump information ROM DB3900 what develop board of Advantech E 19 ROM 3310 User Manual 3 13 UART1 Test RSB485 fcd unit_tests AutoRun_uart485 p dev ttyOl dev tty04 t 6 Open uart dev ttyO1l OK Open uart dev
26. 422 485 mode User can reference the uart demo source code to develop the uart application Watchdog Programming ROM 3310 support hardware watchdog the watchdog is follow posix standards The valid timeout value is from 1 to 6553 seconds if the timeout value to set is not in this scope driver will set timeout value to default value 60 seconds Sample C code include lt stdio h gt include lt stdlib h gt include lt fcntl h gt include lt signal h gt include linux watchdog h ROM 3310 User Manual 40 int fd int main int argc const char argv int timeout 10 open watchdog device the watchdog device node is dev watch dog fd open dev watchdog O WRONLY set timeout to 10 seconds when set timeout value the watchdog driver will enable the watchdog automatically ioctl fd WDIOC SETTIMEOUT amp timeout while 1 feed the watchdog every 5 seconds when call this funtion to feed watchdog the watchdog will reset its internal timer so it doesn t trigger the board reset If do not feed the watchdog more than 10 seconds the watchdog will timeout and the board will reset ioctl fd WDIOC KEEPALIVE NULL sleep 5 close fd Here are some other APIs for watchdog Disable the watchdog timer sample code if user want to disable the watchdog before timeout call the following ioctl
27. ECH design or manufacturing customers will be charged US 60 or US 120 for in warranty or out of warranty repair analysis reports respectively Custody of Products Submitted for Repair ADVANTECH will retain custody of a product submitted for repair for one month while it is waiting for return of a signed or payment A R If the customer fails to respond within such period ADVANTECH will close the case automatically ADVAN TECH will take reasonable measures to stay in proper contact with the customer dur ing this one month period Shipping Back to Customer The forwarding company for RMA returns from ADVANTECH to customers is selected by ADVANTECH Per customer requirement other express services can be adopted such as UPS FedEx and etc The customer must bear the extra costs of such alternative shipment If you require any special arrangements please indicate this when shipping the product to us 53 ROM 3310 User Manual AD ANTECH Enabling an Intelligent Planet www advantech com Please verify specifications before quoting This guide is intended for reference purposes only All product specifications are subject to change without notice No part of this publication may be reproduced in any form or by any means electronic photocopying recording or otherwise without prior written permis sion of the publisher All brand and product names are trademarks or registered trademarks of their respective companies Ad
28. I O expansion UART 5 24bit TTL USB Host USB Gigabit Ethernet SD GPIO 10 2 1 SPI 1 125 CAN with 3 3V level 2 Supports Linux Kernel 3 2 0 Support working temperature 0 60 C amp 40 85 C Product Features Form factor RTX 2 0 Processor System CPU Cortex 8 AM3352 1Ghz Technology DDR3 800 MHz Capacity On board DDR3 512MB emory 4GB for O S and 4MB NOR Flash for ADV Flash Loader Graphic 24bit TTL Parallel RGB VGA Transceiver RTL8211 Ethernet Speed 1 x 10 100 1000 Mbps Watch Dog Timer HW WDT MSP430G2202 time out 1 6553s default 60s SDIO 4 bit STD SD Serial Port 5 x UART 1 x 5485 4 x RS232 SPI 1x SPI IO CAN 2 x CAN 2 0B GPIO 10 x GPIO I2C 1 125 1 125 USB 1 x USB 2 0 host amp 1 x USB 2 0 0 5 Linux Kernel V 3 2 0 Dimensions WxLxT 68 x 68 mm x 2mm Power DC In 5 24V Operational 85 C Temperature Environment Operating 0 0 i idi i Humidity 0 90 relative humidity non condensing Certifications Level Class 1 3 Mechanical Specifications 1 3 1 Dimensions mm RTX 68mm W 68mm D 2mm T 1 3 2 Heat Spreader Dimensions mm 68mm 68mm D x W Heat sink for option 1 4 Electrical Specifications 1 4 4 Power supply Voltage Voltage requirements 5 24V DC In 1 5 Environmental Specifications 1 5 1 Operating temperature Operating temperature 0 60
29. Pin Signal Pin Signal 1 3 3V 2 COMO TX 3 COMO RX 4 GND SW2 Boot select Location on carrier board ROM DB3900 ROM 3310 default boot from module e MMC flash so please set carrier board SW2 110 The detail please refer to rom db3900 manual BOOT_SEL2 BOOT_SEL1 BOOT SELOW Boot Source GND GND GND Carrier SATA GND GND Float Carrier SD card GND Float GND Carrier eMMC Flash GND Float Float Carrier SPI Float GND GND Module device NAND NOR vendor specific Remote boot GBE serial Float GND Float vendor specific Float Float GND Module eMMC Float Float Float Module SPI 7 ROM 3310 User Manual 2 2 ROM 3310 Board Block Diagram Below is the block diagram of ROM 3310 armor can RTX CONN RTX CONN C GIGA LAN 2211 RTC POWER E 1GHz RTX CONN B UARTO Console JTAG 2 wires Figure 2 1 ROM 3310 Block Diagram 2 3 ROM 3310 Board Looks ROM 3310 User Manual 8 Software Functionality This chapter details the software programs on the ROM 3310 plat form 3 1 Test Tools All test tools must be verified on ROM 3310 Evaluation kit please prepare required test fixtures before verifying each specified I O If you have any problem to get the test fixture please contact your Advantech contact window for help Note 3 2 eMMC Test 1 Erase and check Boot Linux System input root amp no password
30. User Manual ROM 3310 RISC base RTX 2 0 module TI Cortex A8 AM3352 1Ghz AD ANTECH Enabling an Intelligent Planet Copyright The documentation and the software included with this product are copyrighted 2015 by Advantech Co Ltd All rights are reserved Advantech Co Ltd reserves the right to make improvements in the products described in this manual at any time without notice No part of this manual may be reproduced copied translated or transmitted in any form or by any means without the prior written permission of Advantech Co Ltd Information provided in this manual is intended to be accurate and reliable How ever Advantech Co Ltd assumes no responsibility for its use nor for any infringe ments of the rights of third parties which may result from its use Acknowledgements ARM is trademarks of ARM Corporation is trademarks of TI Corporation All other product names or trademarks are properties of their respective owners Product Warranty 2 years Advantech warrants to you the original purchaser that each of its products will be free from defects in materials and workmanship for two years from the date of pur chase This warranty does not apply to any products which have been repaired or altered by persons other than repair personnel authorized by Advantech or which have been subject to misuse abuse accident or improper installation Advantech assumes no liability under the terms of this warranty a
31. advantech c register i2c bus 1 am335x 12 0 boardinfo ARRAY SIZE am335x i2c0 boardinfo Please refer to former Chapter 3 15 4 2 to rebuild the kernel with RTC driver Seiko Instruments S 35390A after completing above steps Note Ifyou cannot find the driver for your device from the list please contact E your hardware vender ROM 3310 User Manual 28 3 15 6 3 15 6 1 Create a Linux System Boot Media ROM 3310 supports boot from SD card or onboard flash This section will guide you how to build an image for ROM 3310 Linux system boot media The storages devices name as following Device Name SD caed dev mmcbIkO eMMC dev mmcblk1 Create a Linux System SD Card From Source Code Package You are able to find the pre built image from Advantech website Please follow below steps to create a SD card for boot up Copy 3310LIVxxxx_yyyy mm dd tar gz package to your root Open Terminal on Ubuntu 12 04 LTS sudo su Change to root authority Input your password cd root xzvf 3310LIVxxxx_yyyy mm dd tar gz Unzip files Insert one SD card to your developing computer Check the SD card location like dev sdb 3310LIVxxxx_yyyy mm dd scripts mksd linux sh dev sdb Type Start to copy files wait until it shows Done Sea Then insert the Linux system SD card to ROM 3310 it will boot up with Linux envi ronment Boot f
32. antech com gt lt http www advantech com ePlatform gt For technical support and service please visit our support website at lt http support advantech com tw support gt 1 Visit the Advantech web site at www advantech com support where you can find the latest information about the product 2 Contact your distributor sales representative or Advantech s customer Service center for technical support if you need additional assistance Please have the following information ready before you call Product name and serial number Description of your peripheral attachments Description of your software operating system version application software etc Acomplete description of the problem The exact wording of any error messages Global Service Policy Warranty Policy Below is the warranty policy of Advantech products Warranty Period Advantech branded off the shelf products and 3rd party off the shelf products used to assemble Advantech Configure to Order products are entitled to a 2 years complete and prompt global warranty service Product defect in design materials and work manship are covered from the date of shipment All customized products will by default carry a 15 months regional warranty service The actual product warranty terms and conditions may vary based on sales contract All 3rd party products purchased separately will be covered by the original manufac turer s warranty and ti
33. are root file system BSP or other develop tools for cus tomers It helps customers to easy develop their carrier board and differentiate their embedded products and applications Full Range of RISC Product Offerings Comprehensive Document Support Design Assistance Service Advantech provides check list for engineer for easy check their schematics and also review service based on customer carrier board schematics Those services are pre ventative and help to catch design errors before they happen It helps to save a lot of time and costs with regard to developing carrier boards E Schematic Review W Placement and Layout Review Debugging Assistance Services General Special Reference Design Database ROM 3310 User Manual 46 Thermal Solution Services In order to provide quicker and more flexible solutions for customer s thermal designs Advantech provides thermal solution services including modularized thermal solutions and customized thermal solutions Standard Thermal Solutions Customized Thermal Solutions Embedded Software Services Supports driver software integration or customized firmware root file system and Linux image Customer can save lot of time and focus on their core development Embedded Linux Android OS B Advantech boot loader Customization With the spread of industrial computing a whole range of new applications have been developed resulting in a fundamental change in the IPC industry In
34. cident Copy 3310LIVxxxx_yyyy mm dd tar gz package to your root Open Terminal on Ubuntu 12 04 LTS sudo su Change to root authority Input your password cd root tar xvf 3310LIVxxxx_yyyy mm dd tar gz Unzip files Insert one SD card to your developing computer Check the SD card location like dev sdb Please wait until dump disk is done On ROM 3310 platform type cd mk_inand On ROM 3310 platform type mkinand linux sh dev mmcblk1 On ROM 3310 platform type y Start to copy files wait until it shows Done Power off and remove this SD card ONOaARWN gt gt e ROM 3310 User Manual 44 Advantech Services This chapter introduces Advan tech design in serviceability tech nical support and warranty policy for ROM 5420 evaluation kit 5 1 RISC Design in Services Product Design Services Schematic Review S W Package Evaluation Layout Review Booting Firmware Standard Thermal Solutions Carrier Board Design Guide Test image Board Support Package BSP Linux Kernel Driver Root file System Too Chain Functional Test Utilities Advantech RISC Design in Services help customers to reduce the time and work involved with designing new carrier boards We handle the complexities of technical research and greatly minimize the development risk associated with carrier boards Easy Development Advantech has support firmw
35. dd if dev zero of dev mmcblkO bs 1024 count 1 seek 25118 il 1 s cexetewerols rO records Gut hexdump C dev mmcblk0 s 1887800 00 00 00 00 00 00 2 Write and check 5 0 0 0 eine a IASG OABC DER eek 25118 l recorde in 1 records out hexdump C dev mmcb1k0 s 1307000 30 31 S2 33 34 35 0123456789ABCDEF B ROM 3310 User Manual 25720852 16 00 00 00 00 00 00 00 00 00 00 dd of dev mmcb1k0 bs 1024 count 1 25720852 16 56 37 38 39 41 42 45 44 45 46 Insert SD Card if insert SD Card the eMMC NAND Flash is mmcblk1 10 3 3 USB Test 1 Insert USB flash disk then assure it is in ROM 3310 device list 2 Erase and check dd if dev zero of dev sda bs 1024 count 1 seek 25118 10 records iim 1 0 records out hexdump dev sdb 25720832 16 1887800 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 3 Write and check echo n 0123456789ABCDEF dd of dev sda bs 1024 count 1 seek 25118 OFF records 041 records out hexdump C dev sda 25720832 n 16 ise S0 Si S2 33 34 35 36 37 Se 99 Gil 2 as wa ws AG 0123456789ABCDEF Note 1 TIAM3352 has the limitation on USB device collection we recom the follow brands Logitech 120 Lenovo K5819 LXH EKB 10YA 1800 Dell MS111 P Microsoft Wired board 200 Model 1406 and so on
36. e flood earthquake etc Product updates upgrades and tests upon the request of customers who without warranty Repair Process Obtaining an RMA Number All returns from customers must be authorized with an ADVANTECH RMA Return Merchandise Authorization number Any returns of defective units or parts without valid RMA numbers will not be accepted they will be returned to the customer at the customer s cost without prior notice An RMA number is only an authorization for returning a product it is not an approval for repair or replacement When requesting an RMA number please access ADVAN TECH s web site http erma ADVANTECH com tw with an authorized user ID and password You must fill out basic product and customer information and describe the problems encountered in detail in Problem D escription Vague entries such as does not work and failure are not acceptable If you are uncertain about the cause of the problem please contact ADVANTECH s Application Engineers AE They may be able to find a solution that does not require sending the product for repair The serial number of the whole set is required if only a key defective part is returned for repair Otherwise the case will be regarded as out of warranty Returning the Product for Repair Its possible customers can save time and meet end user requirements by returning defective products to an y authorized ADVANTECH repair facility without an extra
37. e to learn more detail about it ROM 3310 User Manual 26 3 15 5 Source Code Modification This section will guide you how to use the Linux source code You will see some examples of using BSP source code in this section 3 15 5 1 Add a Driver to Kernel by menuconfig You can add a driver to kernel by menuconfig Here is an example to guide you how to add a RTC driver Seiko Instruments S 35390A to Linux kernel Please refer to the following steps Open Terminal on Ubuntu 12 04 LTS sudo su Change to root authority Input user password Change directory to BSP s scripts folder setenv sh To configure the developing environment automatically cfg_kernel sh menuconfig Then you will see a GUI screen Linux Kernel Configuration as below Linux arm 3 0 35 Kernel Configuration Arrow keys navigate the menu lt Enter gt selects submenus gt Highlighted letters are hotkeys Pressing lt gt includes lt N gt excludes lt gt modularizes features Press lt Esc gt lt Esc gt to exit lt gt for Help lt gt for Search built in excluded M module lt gt module capable MTS TEASE support gt Enable the block layer gt System Type gt Bus support gt Kernel Features gt Boot options gt CPU Power Management gt Floating point emulation gt Userspace binary formats gt Figure 3 1 Linux Kernel Configuration 27 ROM 3310 Use
38. een rotation for Qt application Please export the Environments export QWS_DISPLAY Transformed Rot90 or run directly run exmaple qws display Transformed Rot270 3 15 8 8 Add a Startup items when boot Remove a Startup items 1 update rc d n f r lt root gt lt basename gt remove basename is your service script name eg update rc d f matrix gui 2 0 remove 2 Add a Startup items Firstly You must ensure that the service script is exists then run the flowing command update rc d n r lt root gt s lt basename gt start stop NN runlvl runlvI start stop when system start shutdown the basename will run automatically NN 0 99 runlvl ROM3310 run level is 5 default eg update rc d networking start 40 5 Then you can find the S40networking in rc5 d directory 3 15 8 9 Package online install OPKG Package Manager Opkg is a lightweight package management system It is written in C and resembles apt dpkg yum in operation It is intended for use on embedded Linux devices and is used in this capacity in the OpenEmbedded and OpenWrt projects Advantech Embedded Linux for ROM 3310 has built in OPKG package manager with this tool you can install most of the required software online and manage them such as uninstall upgrades and so on Installation New Software package If you want to install a software which is not exist in the current OS you should follow the steps below 1 Update the online soft
39. fferent from any existing folders at that location 2 Create a desktop file based on the parameters discussed below It is recom mended the name of the desktop file match the name of the newly created folder No white spaces can be used for the desktop filename The desktop file parameters should be set depending on if you want to add a new application or a new directory to Matrix The Type field must be set according to your decision The desktop file must have the desktop suffix 3 Update the Icon field in the desktop to refer to any existing Icon in the usr share matrix gui 2 0 directory or subdirectories You can also add a new 96x96 png image and place it into your newly created folder 4 Optionally for applications you can add a HTML file that contains the application description in your newly created directory If you add a description page then update the X Matrix Description field in the desktop file 5 Refresh Matrix using the application Refresh Matrix located in the Settings submenu Blank template icons for Matrix can be found here http gforge ti com gf download frsrelease 712 5167 blank icons 1 1 tar gz The desktop file is based on standard specified at the URL http standards freedesktop org desktop entry spec latest Additional fields were added that are unique for Matrix Format for each parameter lt Field gt lt Value gt The fields and values are case sensitive 37 ROM 3310 User Manual 3 15 8 7 Scr
40. he system ROM 3310 User Manual 12 3 5 SPI Nor Flash Test Hee eests AutoRun_spi sh HHEEHHEERHEEEEHEEEEHEE SPI Test for 335 the spi falsh info mtd type MTD NORFLASH mtd flags mtd size mtd erasesize mtd writesize mtd oobsize 0 regions 0 1 Erased 4096 bytes Copied 4096 bytes OOOOOOO 0001000 MTD CAP NORFLASH 4194304 4096 4M 4K from address 0x00030000 in f from address 0x00030000 in f IEJL JE 4b EAE MEME JEJEIEIE JEJGIEJE JEJEJDIE QEJEJEJE ash ash to temp img AE AE E AE AE AE FE AE AE IEEE SPI mtdblock0 Read 1 PASS DE 1 0 records in 1 0 records out 0000000 0000 0000 0001000 Copied 4096 bytes Copied 4096 bytes 0000000 0000 0000 0000 0000 0000 0000 0000 0000 from zero img to address 0 00030000 from address 0x00030000 in flash to 0000 0000 0000 0000 0000 0000 in flash temp img 0001000 HEHEHE SPI mtdblockO Write 0 PASS HTH HHT HH HH EHH EEE gt OPI Test all PASS I Finish SPI all blocks Test PASS Note ROM3310CS MCA1E default support 5 UART amp 1 x SPI 13 ROM 3310 User Manual 3 6 GPIO Test Table 3 1 ROM 3310 GPIO Default Setting ROM DB3900 Linux OS sys class gpio ROM DB39
41. mark the package Attn RMA Service Department All products must be returned in properly packed ESD material or anti static bags ADVANTECH reserves the right to return unrepaired items at the customer s cost if inappropriately packed Besides that Door to Door transportation such as speed post is recommended for delivery otherwise the sender should bear additional charges such as clearance fees if Air Cargo is adopted Should cases fail ADVANTECH will take full responsibility for the product and transportation charges If the items are not DOA but fail within warranty the sender will bear the freight charges For out of warranty cases customers must cover the cost and take care of both outward and inward transportation Service Charges The product is excluded from warranty if WB product is repaired after expiry of the warranty period B The productis tested or calibrated after expiry of the warranty period and a No Problem Found NPF result is obtained The product though repaired within the warranty period has been misused abused or subjected to unauthorized disassembly modification placed in an unsuitable physical or operating environment improperly maintained by the cus tomer or failure caused which ADVANTECH is not responsible whether by acci dent or other cause Such conditions will be determined by ADVANTECH at its sole unfettered discretion m The product is damaged beyond repair due to nat
42. me Buffer Test Pass Then you can see the White Red Blue Green Black color on the default display screen 21 ROM 3310 User Manual ROM 3310 platform is an embedded system with Linux kernel 3 2 0 inside It tains all system required shell commands and drivers ready for ROM 3310 platform We do not offer IDE developing environment in ROM 3310 BSP users can evaluate and develop under Ubuntu 12 04LTS environment There are three major boot components for Linux u boot img ulmage and File System The u boot bin is for initializing peripheral hardware parameters the ulm age is the Linux kernel image and the File System is for Linux O S used It will not be able to boot into Linux environment successfully if one of above two files is missing from booting media SD card onboard flash The purpose of this chapter is to introduce software development of ROM 3310 to you so that you can develop your own application s efficiently ROM 3310 is designed for supporting Linux host only so you may fail developing your AP on Windows Android host PC For now the official supported host version is Ubuntu 12 04 LTS host PC in any other version may have compatibility issue In this case we strongly recommend to have Ubuntu 12 04 LTS installed to your host PC before start ROM 3310 evaluation development 3 15 Package Content We would offer you two different kinds of Linux package for ROM 3310 O
43. me period and shall not exceed one year of coverage through Advantech Repairs under Warranty It is possible to obtain a replacement Cross Shipment during the first 30 days of the purchase thru your original ADVANTECH supplier to arrange DOA replacement if the products were purchased directly from ADVANTECH and the product is DOA Dead on Arrival The DOA Cross Shipment excludes any shipping damage cus tomized and or build to order products For those products which are not DOA the return fee to an authorized ADVANTECH repair facility will be at the customers expense The shipping fee for reconstructive products from ADVANTECH back to customers sites will be at ADVANTECH s expense ROM 3310 User Manual 50 5 4 4 Exclusions from Warranty 5 5 5 5 1 5 5 2 The product is excluded from warranty if The product has been found to be defective after expiry of the warranty period Warranty has been voided by removal or alternation of product or part identifica tion labels The product has been misused abused or subjected to unauthorized disas sembly modification placed in an unsuitable physical or operating environment improperly maintained by the customer or failure caused which ADVANTECH is not responsible whether by accident or other cause Such conditions will be determined by ADVANTECH at its sole unfettered discretion The product is damaged beyond repair due to a natural disaster such as a light ing strik
44. ne is pre built system image for system recovery another is source code package BSP 3 15 1 Pre built System Image You are able to find the pre built image 3310LIVxxxx_yyyy mm dd tar gz from ROM 3310 evaluation kit DVD image downloaded from Advantech website ROM 3310 supports booting from SD card so you can extract the image to SD card then dump the image file to onboard eMMC to complete system recovery 3 15 2 Source Code Package ROM 3310 source code package BSP contains cross compiler Linux source code Uboot source code root file system and some scripts used in OS development Some of above components are developed by Advantech and the others are devel oped by open source community ROM 3310 source code package is composed of six main folders cross compiler document image package scripts and source Note ROM 3310 source code package BSP is Advantech s Intellectual Property If you need to access this package please contact your amp j Advantech support window cross compiler document image package scripts source ROM 3310 User Manual 22 The description of ROM3310 package contents Folder name Description cross_compiler This folder contains source code for cross compiler document This folder contains user guide image This folder contains the ulmage u boot img image rootfs This folder contains Linux root file system This folder contains source code provided by TI witho
45. nical support difficulties and that can reduce the uncertainties of product development too Advantech s professional software team also focuses on providing a complete Board Support Package and assists customers to build up a software development environment for their RISC platforms Advantech RISC design in services helps customers overcome their problems to achieve the most important goal of faster time to market through a streamlined RISC Design in services Along with our multi stage development process which includes planning design integration and validation Advantech s RISC design in service provides comprehen sive support to the following different phases Planning stage Before deciding to adopt Advantech RISC COM customers must go through a com plete survey process including product features specification and compatibility test ing with software So Advantech offers a RISC Customer Solution Board CSB as an evaluation tool for carrier boards which are simultaneously designed when devel oping RISC COMs In the planning stage customers can use this evaluation board to assess RISC modules and test peripheral hardware What s more Advantech pro vides standard software Board Support Package BSP for RISC COM so that cus tomers can define their product s specifications as well as verifying I O and performance at the same time We not only offer hardware planning and technology consulting but also software evaluation
46. od video mode VGA 800 6000860 1360x768 60 resolution setenv mmcargs bootargs defaults setenv console con sole bootargs S bootargs root mmcroot rootfstype mmc rootfstype ip ip method video mode VGA 1360x768Q60 3 15 8 2 Service Configuration ROM 3310 has built five common network services tftp service ftp service ssh ser vice telnet service and http service ftp Server When boot up the ROM 3310 the tftp service is already started by default and the tftp server s working directory is tftpboot You need execute chmod 777 tftpboot on ROM 3310 to let the tftp server work Then user can tftp to ROM 3310 by tftp client in host PC Use command to get and put file like this 5 tftp TARGET SYSTEM IP tftp gt get filel tftp put file2 Note Command get file1 is to download file1 from tftp server File file1 must existunder the directory tftoboot on ROM 3310 Command put file2 is to upload file2 to tftp server If put file2 success file2 will be put to directory tftpboot on ROM 3310 The service start command is root8am335x adv etc init d tftpd start And the stop is root8am335x adv 4 etc init d tftpd stop ROM 3310 User Manual 32 ftp Server The ftp server on ROM 3310 is vsftpd and you should manually start it using flowing command root am335x adv etc init d vsftpd start While the stoping command is root am335x adv 4
47. p Linux kernel 3 15 4 1 Build u boot Image Advantech has written script to build the u boot quickly You can build u boot image by follow below steps 1 8 Open Terminal Ubuntu 12 04 LTS sudo su Change to root authority Input user password Change directory to BSP s scripts folder cd root 335XLBVxxxx_yyyy mm dd scripts setenv sh To configure the developing environment automatically cfg_uboot sh am335x_rom3310 To set the u boot configuration automatically mk_uboot sh Start to build the u boot Then you can see u boot img is being built and located in image 3 15 4 2 Build Linux Kernel Image Advantech offer you a script to build the ulmage quickly You can build ulmage by follow below steps 1 8 Open Terminal Ubuntu 12 04 LTS sudo su Change to root authority Input user password Change directory to BSP s scripts folder cd root 335XLBVxxxx yyyy mm dd scripts setenv sh To configure the developing environment automatically cfg_kernel sh am335x rom3310 defconfig To set the ulmage configuration automatically mk_kernel sh Start to build the ulmage Then you can see ulmage is being built and located in image 3 15 4 3 Build Log You can find the build log from folder 335XLBVxxxx_yyyy mm dd If you got any error message when building Linux kernel it is suggested to look into the log fil
48. r Manual Select Device Drivers Real Time Clock you will see an option Seiko Instru ments 5 35390 on the list Choose this option then exit and save your configuration Real Time Clock Arrow keys navigate the menu lt Enter gt selects submenus gt Highlighted letters are hotkeys Pressing lt gt includes lt N gt excludes lt gt modularizes features Press lt Esc gt lt Esc gt to exit lt gt for Help lt gt for Search Legend built in excluded lt M gt module lt gt module capable Xicor Intersil X1205 Philips PCF8563 Epson RTC8564 Philips PCF8583 ST M41T62 65 M41T80 81 82 83 84 85 87 TI BQ32000 v Ramtron FM3130 Epson RX 8581 Epson RX 80255A NB EM Microelectronic EM3027 Micro Crystal RTC ABBA VV v 1 1 1 1 1 1 1 1 1 lt Exit gt lt Help gt Figure 3 2 Selecting Seiko Instruments S 35390A Change directory to source linux 3 2 0 psp04 06 00 11 arch arm mach omap2 edit the board rom3310 h and board advantech c Please add below codes to source linux 3 2 0 psp04 06 00 11 arch arm mach omap2 board rom331 h srar surnet 126 loeo sto me 1260 board initoara 4 I2C BOARD INFO s35390a 0x30 Please add below codes to source linux 3 2 0 psp04 06 00 11 arch arm mach omap2 board
49. re able to optimize their applications with less fuss Furthermore Advantech s team can provide professional consulting services about further testing and equipment usage so customers can find the right tools to efficiently identify and solve problems to further enhance their products quality and performance Contact Information Below is the contact information for Advantech customer service Region Country Contact Information America 1 888 576 9688 Brazil 0800 770 5355 Mexico 01 800 467 2415 Europe Toll Free 00800 2426 8080 Singapore amp SAP 65 64421000 Malaysia 1800 88 1809 Australia Toll Free 1300 308 531 China Toll Free 800 810 0345 800 810 8389 Sales advantech com cn India Toll Free 1 800 425 5071 Japan Toll Free 0800 500 1055 Korea Toll Free 080 363 9494 080 363 9495 Taiwan Toll Free 0800 777 111 Russia Toll Free 8 800 555 01 50 On the other hand you can reach our service team through below website our tech nical support engineer will provide quick response once the form is filled out http www advantech com tw contact default aspx page contact form2 amp sub Technical Support 49 ROM 3310 User Manual 5 3 5 4 5 4 1 5 4 2 5 4 3 Technical Support and Assistance For more information about this and other Advantech products please visit our web site at lt http www adv
50. rom Onboard Flash If you ve already had a Linux system SD card you can refer following steps to copy the content to onboard flash and then boot from onboard flash Advantech also pro vide you a script mkinand linux sh to speed up the process of installing system image to onboard flash Refer to Chapter 3 25 1 to make a Linux system SD card Insert this Linux system SD card to ROM DB3900 and connect serial console On ROM 3310 platform type root Login On ROM 3310 platform type cd mk_inand ROM 3310 platform type mkinand linux sh dev mmcblk1 ROM 3310 platform type y Start to copy files wait until it shows Done Power off and remove this SD card SD Then you can boot from onboard flash without SD 29 ROM 3310 User Manual 3 15 7 Debug Message ROM 3310 can connect to a host PC Linux or Windows by using console cable and debug port adapter In order to communicate with host PC serial communication pro gram such as HyperTerminal Putty is must require Below is the detail instruction of how to set up serial console a HyperTerminal on a Windows host 1 Connect ROM 3310 to your Windows PC by using serial cable debug port adapter and console cable 2 Open HyperTerminal on your Windows PC and select the settings as shown in Figure 3 6 3 Press POWER key to power up the board The bootloader prompt is displayed on the terminal screen COM1 Properties 283
51. s thereby increasing carrier board design difficulties and risk as well as seriously impacting on Time to market and lost market opportunities Software development and modification Compared to x86 architectures RISC architectures use simpler instruction sets therefore the software support for x86 platforms cannot be used on RISC platforms System integrators need to develop software for their system and do the hardware and software integration themselves Unlike x86 platforms RISC platforms have less support for Board Support Packages BSP and drivers as well Even though driver support is provided Sls still have to make a lot of effort to integrate it into the system core Moreover the BSP provided by CPU manufacturers are usually for carrier board design so it s difficult for Sls to have an environment for software develop ment 47 ROM 3310 User Manual In view of this Advantech proposed the concept of Streamlined Design in Support Services for RISC based Computer On Modules COM With a dedicated profes sional design in services team Advantech actively participates in carrier board design and problem solving Our services not only enable customers to effectively distribute their resources but also reduce R amp D manpower cost and hardware investment By virtue of a close interactive relationship with leading original manufacturers of CPUs and chipsets such as ARM TI and Freescale Advantech helps solve commu nication and tech
52. s a consequence of such events Because of Advantech s high quality control standards and rigorous testing most of our customers never need to use our repair service If an Advantech product is defec tive it will be repaired or replaced at no charge during the warranty period For out of warranty repairs you will be billed according to the cost of replacement materials service time and freight Please consult your dealer for more details If you think you have a defective product follow these steps 1 Collect all the information about the problem encountered For example CPU speed Advantech products used other hardware and software used etc Note anything abnormal and list any onscreen messages you get when the problem OCCUIS 2 Call your dealer and describe the problem Please have your manual product and any helpful information readily available 3 f your product is diagnosed as defective obtain an RMA return merchandize authorization number from your dealer This allows us to process your return more quickly 4 Carefully pack the defective product a fully completed Repair and Replacement Order Card and a photocopy proof of purchase date such as your sales receipt in a shippable container A product returned without proof of the purchase date is not eligible for warranty service 5 Write the RMA number visibly on the outside of the package and ship it prepaid to your dealer Part No 2006331000 Edition 1 Printed in
53. source is correct before connecting the equipment to the power outlet Position the power cord so that people cannot step on it Do not place anything over the power cord All cautions and warnings on the equipment should be noted If the equipment is not used for a long time disconnect it from the power source to avoid damage by transient overvoltage Never pour any liquid into an opening This may cause fire or electrical shock Never open the equipment For safety reasons the equipment should be opened only by qualified service personnel If one of the following situations arises get the equipment checked by service personnel The power cord or plug is damaged Liquid has penetrated into the equipment The equipment has been exposed to moisture i The equipment does not work well or you cannot get it to work according to the user s manual B The equipment has been dropped and damaged B The equipment has obvious signs of breakage DISCLAIMER This set of instructions is given according to IEC 704 1 Advantech disclaims all responsibility for the accuracy of any statements contained herein iii ROM 3310 User Manual Safety Precaution Static Electricity Follow these simple precautions to protect yourself from harm and the products from damage B To avoid electrical shock always disconnect the power from your PC chassis before you work on it Don t touch any components on the CPU card or other cards while
54. t 1 335XLBVxxxx_yyyy mm dd bin package to root Start your Terminal on Ubuntu 12 04 LTS sudo su Change to root authority Input user password root chmod a x 335XLBVxxxx_yyyy mm dd bin 335XLBVxxxx_yyyy mm dd bin Input yes Then you can see folder 335XLBVxxxx_yyyy mm dd on root 1D OD O4 de DE Note is the version number yyyy is the year mm is mouth dd is the day E For example 335XLBV1010_2015 03 01 Advantech offer you a script to setup the developing environment quickly You refer following steps to setup your developing environment Open Terminal on Ubuntu 12 04 LTS sudo su Change to root authority Input user password root 335XLBVxxxx_yyyy mm dd scripts setenv sh To configure the developing environment automatically Then you can start to code the source code build images or compile applica tions This script is used to configure the developing environment quickly It will configure the folder paths for system and you can also add modify the setenv sh by yourself if you have added changed the folders and paths 25 ROM 3310 User Manual Note You have to run source setenv sh every time once you open new E Terminal utility Note Itis suggested to change to root authority to use the source code 3 15 4 Build Instructions This section will guide you how to build the u boot am
55. te Matrix All of the example applications and demos are available using either the local or remote version Matrix comes as a 6x4 matrix of icons or as a 4x3 matrix depending on the display resolution The launcher for Matrix is just a simple QT application that displays a Webkit base browser that points to the URL http localhost 80 ROM 3310 User Manual Enabling an Intelligent Advantech App launcher p1 Ethernet Serial Tool e About System Time Settings Figure 3 7 Matrix 36 Launching and Stopping Matrix If the Matrix GUI does not start with the system you can manually start the program by the following command 485355 adv e rola 2 0 start If you want the Matrix to start with the system by default please run the following command on ROM 3310 root am335x adv ep ete init d matrix gui 2 0 ete res d SoTmMaLELR gul 24 0 When you want to cancel the default startup just remove the S97matrix gui 2 0 file For more information on the use of Matrix please refer to the following website http processors wiki ti com index php Matrix Users Guide Adding Matrix Application Below are step by step instructions for Adding a New Application Directory to Matrix 1 Create a new folder on your target file system at usr share matrix gui 2 0 apps The name should be somewhat descriptive representation of the application or directory The folder name must be di
56. u can do some configuration of NIC Advantech NIC Configuration LAN1 STATIC 172 21 73 164 MASK 255 255 255 0 GW 172 21 73 253 DNS 172 21 128 251 Refresh OK Figure 3 4 IP Configuration Configuration via Ul As a choice you can also do the network configuration by console using telnet Run the following command on ROM 3310 Get IP by DHCP root8am335x adv 4 etc init d dhcpc eth0 start If you want to reserve the setting after rebooting the device set as below root8am335x adv echo etc init d dhcpc eth0 start gt etc adv d netcfg ethO Set static IP Stop the DHCP process root8am335x adv 4 etc init d dhcpc ethO stop ROM 3310 User Manual 34 Set the static IP as below root am335x adv sbin ifconfig ethO 172 21 73 191 netmask 255 255 255 root am335x adv root am335x adv resolv conf 15er dames SISSE C one Ene AGS PS netmask 2555255 5255 0 root am335x adv root am335x adv resolv conf HE sbim route ackl ow 172221 575542593 echo memeeewer 172 21 128 251 gt E sbin route add default gw ethl 172 21 128 251 gt If you want to reserve the setting after rebooting the device set as below MeoEdamssox echo V sbum i seem eth 179 21 79 191 netmask 255 255 255 02 add default Gw 172 21 73 253 mewneserwes 172 21 129 251
57. uns 0 carrier 0 collisions 0 txqueuelen 1000 RX bytes 1935525 1 8 MiB TX bytes 198083 193 4 KiB l Link encap Local Loopback ame acklesil27 0 0 1 Maske 2550 10 UP LOOPBACK RUNNING MTU 16436 Metric 1 RX packets 130 errors 0 dropped 0 overruns 0 frame 0 TX packets 130 errors 0 dropped 0 overruns 0 carrier 0 collisions 0 txqueuelen 0 ROK INFESSI2S499 229 3 IDX 2524999 229 3 Kim If you would like to config IP manually please use below command ifconfig ethO xxx xxx xxx xxx up Here is a real case for your reference The hosts ROM 3310 IP is 192 168 0 10 the target A desktop computer IP is 192 168 0 12 etc init d netplugd stop ifconfig ethO down wLEComEig Stad 1002 160 0 10 ifconfig ethO etho Link encap Ethernet HWaddr 78 A5 04 DD E4 9C mere aclelegi 92 163 010 Beasts 172 1008 0258 Magis 255 2559 255 0 UP BROADCAST RUNNING ALLMULTI MULTICAST wg 1 500 RX packets 16740 errors 0 dropped 0 overruns 0 frame 0 TX packets 1454 errors 0 dropped 0 overruns 0 carrier 0 collisions 0 txqueuelen 1000 RX bytes 1935525 1 8 MiB TX bytes 198083 193 4 KiB The target computer Client IP address is 192 168 0 12 so we can use below com mand to see if we can get any response from the client poing 192 168 1 1 PING 192516950412 192 168 0 12 3 56 ceca bytes 64 bytes from 192 168 0 12 seq 0 ttl 128 time 7 417 ms 64 bytes from 192 168 0 12 seq 1 ttl 128 time 0 20
58. up Build Environment 0 2204 25 3 15 4 Build Instructions ri ettet 26 3 15 5 Source Code 27 Figure 3 1 Linux Kernel Configuration 27 Figure 3 2 Selecting Seiko Instruments 5 35390 28 3 15 6 Create a Linux System Boot Media 29 vii ROM 3310 User Manual Chapter 4 4 1 Chapter 5 5 5 ROM 3310 User Manual 3 15 7 Debug Message ttt t lr de ee d dde 30 Figure 3 3 HyperTerminal Settings for Serial Console Setup 30 3 15 8 Linux System Configuration and Use 30 Figure 3 4 IP 34 Figure 3 5 Date Time 35 Figure 3 6 Serial Control 2 36 Figure 3 7 ate 36 3 15 9 Development Guide and Reference 39 System Recovery 43 System eate desde edente jee 44 Advantech Services 45 RISC Design in Services nnne nn 46 Contact irae E 49 Technical Support and 50 Global Service Polly E a 50 5 4 1 Warranty
59. ural disaster such as a light ing strike flood earthquake etc Product updates and tests upon the request of customers who are without war ranty If a product has been repaired by ADVANTECH and within three months after such a repair the product requires another repair for the same problem ADVANTECH will do this repair free of charge However such free repairs do not apply to products which have been misused abused or subjected to unauthorized disassembly modification placed in an unsuitable physical or operating environment improperly maintained by the customer or failure caused which ADVANTECH is not responsible whether by accident or other cause Please contact your nearest regional service center for detail service quotation Before we start out of warranty repairs we will send you a pro forma invoice P I with the repair charges When you remit the funds please reference the P I number listed under Our Ref ADVANTECH reserves the right to deny repair services to customers that do not return the DOA unit or sign the P I Meanwhile ADVANTECH will scrap defective products without prior notice if customers do not return the signed P I within 3 months ROM 3310 User Manual 52 5 5 4 5 5 5 5 5 6 Repair Report ADVANTECH returns each product with a Repair Report which shows the result of the repair A Repair Analysis Report is also provided to customers upon request If the defect is not caused by ADVANT
60. ut any package ae modification This folder contains scripts for configure system and compile scripts images automatically source This folder contains source code owned by Advantech 3 15 2 1 cross_compiler You can use the cross compiler toolchain to compile the ulmage and related applica tions gcc version is 4 7 3 20130226 3 15 2 2 document User guide of how to setup up the environment of development 3 15 2 3 image This folder includes ulmage amp u boot img 3 15 2 4 image rootfs Linux adopts Hierarchical File System HFS image rootfs is the Linux file system in highest level of the tree structure image rootfs is just like the trunk of the tree Its sub directories are the branches and the files in these directories are the leaves of the tree image rootfs contains all subdirectories and files used in the file system that s why it is called the root of the whole file system The main folders in rootfs are listed as follows bin Common programs shared by the system the system administrator and the users dev Contains references to all the CPU peripheral hardware which are represented as files with special properties etc Most important system configuration files are in etc this directory con tains data similar to those in the Control Panel in Windows home Home directories of the common users lib Library files includes files for all kinds of programs needed by
61. vantech Co Ltd 2015
62. ware source root am335x adv update 2 Search whether the software source server has the software you need root am335x adv list grep package Note Package is the keywords of the software name for example you want to search ftp server the package should ftp EJ 3 Find the full name of the software you need in the search result list And install it by following command root am335x adv install packagename ROM 3310 User Manual 38 More about OPKG More about use and development of OPKG Please refer to the project website of OPKG https code google com p opkg 3 15 9 Development Guide and Reference 3 15 9 1 Development of C C Programs This section will guide you how to write a sample application Hello World You can refer to following steps 1 Open Terminal on Ubuntu 12 04 LTS and Change to root hostPC sudo Input user password 2 Create the develop environment using flowing command source usr local cross compiler linux devkit environment setup cd root 3310LBVxxxx yyyy mm dd source mkdir helloworld cd helloworld gedit hellowrold c 3 Edit the helloworld c with the following source code include lt stdio h gt void main printf Hello World Nn Save the and exit 4 Compile helloworld c using flowing command SCC SCFLAGS helloworld helloworld c Then you can see
Download Pdf Manuals
Related Search