Moxa Technologies UC-7110 manual

UC-71 10 Series User ’ s Manual www .moxa.com/product Second Edition, July 2005 Moxa Technologies Co., Ltd. Tel: +886-2-8919-1230 Fax: +886-2-8919-1231 Web: www.moxa.com MOXA Technical Support World wide: support@moxa.com.tw The Americas support@ moxa.com[...]

UC-7110 Series User’s Manual The software d escribed in t his manual is furnished u nder a license a greement and m ay be used only in accordance with the term s of that agreement. Copyright Notice Copyright © 2005 Moxa Technologies Co., Ltd. All rights reserved. Reproducti on without perm ission is pr ohibited. Trademarks MOXA is a re gistered [...]

Table of Contents Chapter 1 Introduction .................................................................................................. 1-1 Overview.................................................................................................................................. 1-2 Package Ch ecklis t ...........................................[...]

Configuring Dial-in/ Dial-out Ser vice ...................................................................................... 4-8 Dial-out Service ............................................................................................................ 4-8 Dial-in Service ..........................................................................[...]

1 1 Chapter 1 Introduction The MOXA UC-7110 Seri es of RISC-based Communication Platforms features t wo RS-232/422/ 485 serial ports, and d ual 10/10 0 Mbps Ether net ports, m aking these pr oducts ideal for embedde d OS appli cations. This chapter covers the following topics:  Overview  Package Checklist  Product Features  Product Spec[...]

UC-7110 Series User’s Manual Introduction 1-2 Overview The UC-7110 Series of RISC-based Comm uni cation Platforms are ideal for your em bedded applications. UC-7110 c omes with tw o RS-232/ 422/485 se rial ports an d dual 10/1 00 Mbps Ethernet LAN ports to provide users with a versatile communication platform. UC-7110 uses the ARM9 166 Mhz RISC C[...]

UC-7110 Series User’s Manual Introduction 1-3 Product Specifications Hardware Specificat ions (UC-7110-LX) CPU ARM9-based 32-bit RISC CPU, 166 Mh z RAM 16 MB (12 MB of user programmable space) Flash 8 MB (4 MB of user programmable space) LAN Auto-sensi ng 10/100 Mbps x 2 LAN Protecti on Built-in 1.5 KV magnetic isolation Serial Ports The two RS-2[...]

UC-7110 Series User’s Manual Introduction 1-4 Software Specifications (UC-7110-LX) Kernel µ Clinux Ke rnel 2. 4.22 Prot ocol S tack A R P, I C M P, I P V 4 , T C P, U D P, F T P, T e l n e t , N T P, S N M P V 1 , HTTP , PPP , CHAP , P AP , NFS JFFS2 File System User Directory (Read / W rite) ROMFS Kernel, Root File System (Read Only) Sash (V1. [...]

UC-7110 Series User’s Manual Introduction 1-5 Hardware Block Diagram S3C2500 ARM940T 166MHz 8MB Flash 16MB SDRAM PHY PHY LAN1 LAN2 RTC MOXA MU150 MOXA MU150 Port 1 Port 2 Power Circuit Appearance P1 P2 TX RX P1 P2 TX RX Ready V+ RESET 12-48V LAN1 RS-232/422/485 LAN2 UC-71 10 Universal Communicator Ethernet x 2 (10/100BaseTx) RS-232 Console T ermi[...]

UC-7110 Series User’s Manual Introduction 1-6 Dimensions P1 P2 TX RX P1 P2 TX RX Ready V+ RESET 12-48V LAN1 RS-232/422/485 LAN2 UC-71 10 Universal Communicator 6 (0.24) 12.5 (0.49) 25 (0.98) 4 (0.16) 7 (0.28) 26 (1.02) 77 (3.03) 47.3 (1.56) 21.3 (0.8) 1 1 1 (4.31) 88 (3.46) 100 (4.18) unit = mm (inch)[...]

UC-7110 Series User’s Manual Introduction 1-7 Installing UC-7110 P1 P2 TX RX P1 P2 TX RX Ready V+ 12-48V LAN1 LAN2 UC-71 10 Universal Communicator RESET RS-232/422/485 T op-End View Bottom-End View DB9 (male) Serial Ports DIN-Rail screw hole W allmount screw hole Nameplate View RJ45 10/100 Mbps Ethernet Ports Reset Button T erminal Block Power In[...]

UC-7110 Series User’s Manual Introduction 1-8 LED Indicators The followin g table explains t he functio n of the five L ED indicators located on UC -7110’s t op panel. LED Name LED Color LED Function Ready Green Power is on a nd functio ning norm ally. Green Serial port 1/2 is transmitting data. P1/P2 (Tx) Off Serial port 1/2 is not transmittin[...]

UC-7110 Series User’s Manual Introduction 1-9 Connecting the Power Connect the “live-wire” end of the 12-48 VDC power adaptor to UC-7110’s terminal block. If the power is properly supplied, the “Ready” LED will sh ow a solid green color after a 25 to 30 second delay. Grounding UC-7110 Grounding and w ire routing help s limit the effects[...]

UC-7110 Series User’s Manual Introduction 1-10 The 10/100 Mbp s Ethernet L AN 1 and LAN 2 ports use 8 -pin RJ45 co nnectors. Pin outs for the se ports are gi ven in the following diagram. 8-pin RJ45 1 8 100 Mbps indicator 10 Mbps indicator Pin Signal 1 ETx+ 2 ETx- 3 ERx+ 4 --- 5 --- 6 ERx- 7 --- 8 --- Connecting to a Serial Device Connect the ser[...]

UC-7110 Series User’s Manual Introduction 1-11 Additional Functions Reset Button Press the “RESET” button contin uously for more than 5 seconds to l oad the factory default configuration. After loading the factory default, the system will reboot automatically. The System Ready LED will be blinking for the first 5 second s. We recommend that y[...]

UC-7110 Series User’s Manual Introduction 1-12 Real Time Clock UC-7110’s real time clock is powered by a lith iu m battery. We strongly recommend that you do not replace the lithium battery without t he help of M oxa’s support team. If the battery needs to be changed, contact the Moxa R MA service team for RMA service. ATTENTION The battery m[...]

2 2 Chapter 2 Getting Started In this chapter, we explain the basic procedure for gettin g UC-7110 connected . This chapter covers the following topics:  Powering on UC-7110  Connecting UC-7110 to a PC  Configuring the Ethernet Interface  Developing Your Applications ¾ Installing the UC-7110 Tool Chain ¾ Compiling Hello.c ¾ Uploading[...]

UC-7110 Series User’s Manual Getting Started 2-2 Powering on UC-7110 Connect the SG wire to the Shielded Con tact located on the uppe r left corn er of the UC -7110, an d then power on UC-7110 b y connecting the power adaptor. It takes about 16 seco nds for the system to boot up. Once the system is ready, th e Ready LED will light up. ATTENTION A[...]

UC-7110 Series User’s Manual Getting Started 2-3 Telnet If you know at least one of the two IP addre sses and netm asks, then you can use Telnet to connect to UC-7110’s console . Default IP Address Default Netmask LAN 1 192.168.3.127 255.255.255.0 LAN 2 192.168.4.127 255.255.255.0 Telnet can be used locally by using a cross-over Ethernet ca ble[...]

UC-7110 Series User’s Manual Getting Started 2-4 Configuring the Ethernet Interface In this section we use the seri al console to e xplain how to modify UC-7110’s netw ork setti ngs. 1. Change direct ories by issui ng the comm and cd /mnt/etc . 2. Type the com mand vi rc to use VI Editor to edit the configuration file. The IP addresses for UC-7[...]

UC-7110 Series User’s Manual Getting Started 2-5 3. You may also configure UC-7110 to r equest IP addresses from a DHCP server. In this case, use the sharp si gn (#) to com ment out o ne or both “i fconfig” li nes, and then delete the sharp sign in front of the “dhcpcd” lines, as sh ow n below. Note that UC-7110 will send out DHCP broadca[...]

UC-7110 Series User’s Manual Getting Started 2-6 Developing Your Applications Step 1: Connect UC-7110 to a Linux PC. Step 2: Install Tool C hain (G NU Cross Com piler & uC libc). Step 3: Configure cr oss compil er and uCli bc environm ent variables. Step 4: Code & com pile y our progra m. Step 5: Download prog ram to UC-7110 via FTP or NF[...]

UC-7110 Series User’s Manual Getting Started 2-7 Compiling Hello.c The Tool Chai n path is: PATH=/usr/local/arm-elf/bin:$PATH The UC-7110 CD includes se veral exampl e programs. We use Hello.c to illustrate how to compile and run a pplications. Issue the following co mmands from your PC to compile Hello.c: # cd /tmp/ # mkdir example # cp –r /mn[...]

UC-7110 Series User’s Manual Getting Started 2-8 Uploading “Hello” to UC-7110 To use FTP to upload hello to UC-7110, issue the followi ng commands from the PC side: #ftp 192.168.3.127 ftp> cd /home ftp> bin ftp> put ./hello ftp> quit #telnet 192.168.3.127[...]

UC-7110 Series User’s Manual Getting Started 2-9 Running “Hello” on UC-7110 To run the “ Hello” program issue the follo wing comm ands from t he UC-7110 si de: # chmod 755 hello #./hello The words “Hello World” will be printed on the screen. ATTENTION Be sure to calculate the amount of Flash Mem ory used by t he User File System in th[...]

UC-7110 Series User’s Manual Getting Started 2-10 Make File Example Code The following Makefile file exam ple codes are copie d from the Hello exam ple from UC-7110’s CD-ROM. # Generated automatically from Makefile.in by configure. # $Id: Makefile.in,v 1.59 2002/03/24 22:20:19 jnelson Exp $ .SUFFIXES: .SUFFIXES: .o .c .PHONY: clean mrclean dist[...]

UC-7110 Series User’s Manual Getting Started 2-11 ATTENTION There is anot her exam ple that involves modifyi ng the Makefile. If the targ et source code file is tcps1.c , then users should m odify at least 4 places to replace hello with tcps1 . Copy the Hello example’s Makefile to your source code target directory, and then modify it to work wi[...]

3 3 Chapter 3 Software Package This chapter includ es information about th e software that is used with UC-7110 Series products. This chapter covers the following topics:  UC-7110 Software Architecture  UC-7110 Software Package[...]

UC-7110 Series User’s Manual Software Package 3-2 UC-7110 Software Architecture The pre-installed µClinux Operatin g System used by UC-7110 follows the standard µClinux architecture, making programs th at follow the POSIX standard easily ported to UC-7110 by using the GNU Tool Chain pr ovided by www. uClinux.org . I n addit ion to the Sta ndard[...]

UC-7110 Series User’s Manual Software Package 3-3 and uses JFFS2 for the User Directory. The partition sizes are hard coded into the kernel binary. You must rebuild the kernel to change the partition sizes. The flash memory map is shown in the following table. Flash Conte xt Flash Address Size Access control Boot loader 0 – 0x 3ffff 256 K Read [...]

UC-7110 Series User’s Manual Software Package 3-4 Although JFFS2 is a journaling file system, this does not preclude the loss of data. The file system will remain in a consistent state acros s power failu res, and will always be m ountable. However, if the board is powered down during a write, then the incomplete write will be rolled back on the [...]

UC-7110 Series User’s Manual Software Package 3-5 bin dev busybox boa bf backupfs downramdi sk upramdis k ttyS0 tty3 tty2 tty1 tty0 rom1 rom0 ptypf ptype ptypd ptypc ptypb ptypa ptyp9 ptyp8 ptyp7 ptyp6 ptyp5 ptyp4 ptyp3 ptyp2 ptyp1 ptyp0 ppp pio rtc ram1 ram0 null kmem mem cua0 console tty [...]

4 4 Chapter 4 Configuring UC-7110 In this chapte r, we descri be how to c onfigure UC -7110 Seri es products. The following topics are covered in this chapter:  Enabling and Disabling Daemons  Adding a Web Page  IPTABLES  NAT  Configuring Dial-in/Dial-out Service  Configuring PPPoE  How to mount a remote NFS Server  Upgradin[...]

UC-7110 Series User’s Manual Configuring UC-7110 4-2 Enabling and Disabling Daemons The following daem ons are enabled whe n UC-7110 b oots up for the first time. y SNMP Age nt daemon: snmpd y Telnet Server / Client daemon: telnetd y Internet Daemons: inetd y FTP Server / Client daemon: ftpd y WWW Server daemon: boa ATTENTION How to enable/disabl[...]

UC-7110 Series User’s Manual Configuring UC-7110 4-3 Adding a Web Page Default Home Page address: /home/httpd/index.html You may change the default ho me page directory by editing the web server’s con figuration file, located at: /home/httpd/boa.conf Type the following co mmand to edit the boa.con f file: /mnt/home/httpd>vi boa.conf To add y[...]

UC-7110 Series User’s Manual Configuring UC-7110 4-4 OUTPUT chain — produces local packets sub-tables Source NAT (SNAT) — changes the first source packet IP address Destination NAT (DNAT) — changes the first destination packet IP a ddress MASQUERA DE — a special form for SNAT. If one host ca n connect to the Internet, then other computers[...]

UC-7110 Series User’s Manual Configuring UC-7110 4-5 UC-7110 s upports the following sub-modul es. Be sure to use the m odule that matches your application. ip_conntrack ipt_ MARK ipt_ah ip t_state ip_conntrack_ftp ip t_MASQUERADE ipt_esp ipt_tcpmss ipt_conntrack_irc ipt_ MIRROT ipt_length ipt_tos ip_nat_ftp ipt_ REDIRECT ipt_limit ipt_ttl ip_nat[...]

UC-7110 Series User’s Manual Configuring UC-7110 4-6 NOTE IPTABLES plays the role of packet filtering or NAT. Take care when setting up the IPTABLES rules. If the rules are not corre ct, remote hosts that connect via a LAN or PPP may be denied access. We recommend using the Se rial Console to set up the IPTABLES. Click on the following links for [...]

UC-7110 Series User’s Manual Configuring UC-7110 4-7 Append or delete rules: Usage: # iptables [-t table] [-AI] [INPUT, OUTPUT, FORWARD] [-io interface] [-p tcp, udp, icmp, all] [-s IP/network] [--sport ports] [-d IP/network] [--dport ports] –j [ACCEPT. DROP] -A: Append one or m ore rules to the end of the selected chain. -I: Insert one o r mor[...]

UC-7110 Series User’s Manual Configuring UC-7110 4-8 the module ipt _MASQUER ADE): UC-71 10 PC1 (Linux or Windows) IP/Netmask: Gateway: 192.168.3.100/24 192.168.3.127 PC2 (Linux or Windows) IP/Netmask: Gateway: 192.168.4.100/24 192.168.4.127 LAN1 LAN2 LAN1:eth0 192.168.3.127/24 LAN2:eth1 192.168.4.127/24 NA T Area / Private IP 1. #echo 1 > /pr[...]

UC-7110 Series User’s Manual Configuring UC-7110 4-9 ATTENTION If dial out fails, the pppd connection will be blo cked, and the user will need to shut down th e pppd, and re-dial. Since the return value is always OK (regardless of wh ether or not th e connection is blocked), the AP must be set up to check the network status to d etermine if the c[...]

UC-7110 Series User’s Manual Configuring UC-7110 4-10 1. First, the NFS serve r must open an export dir ectory and allow access to the IP address. Edit the file “/etc/exports” on yo ur Linux PC, and then run the NFS daemon. The follow ing example gives one possibility (refer to the NFS-HOWTO document at http://nfs.sourceforge.ne t/nfs-h owto/[...]

UC-7110 Series User’s Manual Configuring UC-7110 4-11 ftp> bin ftp> get uc7110-1.x.x.bin And then use the upkernel com mand to u pgrade the ke rnel and root file system . /ramdisk>upkernel uc7110-1.3.11.bin /ramdisk>reboot Upgrading the User Directory UC-7110 uses ROMFS (ROM File System), which is pre-set to READ only, for the kernel [...]

UC-7110 Series User’s Manual Configuring UC-7110 4-12 To enable t he RAM disk, use the com mands give n below: />upramdisk />cd ramdisk Use the built-in FTP client to download the usrdisk-1.x.x.dsk file from the PC. /ramdisk>ftp <destination PC’s IP> Login Name: xxxx Login Password: xxxx ftp> bin ftp> get usrdisk-1.x.x.dsk [...]

UC-7110 Series User’s Manual Configuring UC-7110 4-13 User Directory Backup — UC-7110 to PC To enable the RAM disk , follow the co mmands given below: />upramdisk />cd ramdisk And then use the backupfs comm and to backup the file system . /ramdisk>backupfs /ramdisk/usrdisk-backup The file system will be bac ked up, and y ou can use ftp[...]

UC-7110 Series User’s Manual Configuring UC-7110 4-14 Loading Factory Defaults The easiest way to “Load F actory Def ault” is with “Upgrade User directory.” Refer to the previous section “How to Upgrade User Directory” fo r an intr oduction. Mirroring the Application Program and Configuration For some applications, you may need to “[...]

5 5 Chapter 5 UC-7110 Device API In this chapter, we discuss the De vice API for the UC -7110 Series. We introduce the APIs for the following functions:  RTC (Real Time Clock)  Buzzer  UART Interface[...]

UC-7110 Series User’s Manual UC-7110 Device API 5-2 RTC (Real Time Clock) The device node is located at /dev/rtc . UC-711 0 supports µCli nux standar d simple RT C control. Y ou must incl ude <linux/rtc.h> to use t hese functions . 1. Function: RTC_RD_TIME int ioctl(fd, RTC_RD_TIME, struct rtc_time *time); Description: Reads time informati[...]

6 6 Chapter 6 UC Finder UC-7110 comes with a UC Finder utility, which has the sole purpose of searching the LAN or intranet for U C-7110 units. For most of ap plications, i t’s not easy t o rememb er the IP addr esses of Universal Communicators connected to the LAN. This is es pecially true for som e problem solving and testin g in the field. The[...]

UC-7110 Series User’s Manual UC Finder 6-2 Windows UC Finder The following steps descri be how to install UC Fi nder on a Windows PC. 1. Double click on the UC Finder installation program, Setup.exe , to start t he installation. 2. When the Wel come to the UC Finder Setup Wizard window opens, click on Next to continue. 3. Check the Create a deskt[...]

UC-7110 Series User’s Manual UC Finder 6-3 4. Check the Launch UC Finder chec kbox to use UC Finde r immediately after the installation has finished, a nd then click on Next to complete the installation. 5. When the UC Finder window opens, click on Broadcast Search to search for all Universal Communicators connected to the L AN.[...]

UC-7110 Series User’s Manual UC Finder 6-4 6. The Searching window will show the Uni versal Communicators that have been located. You can click on Stop as soon a s the Uni versal Comm unicator you are looking for is list ed. 7. When the search is complete, the Broa dcast Search window closes, a nd the Model , MAC Address , and I P Address of all [...]

UC-7110 Series User’s Manual UC Finder 6-5 Linux ucfinder To use the Linux ucfinder utility, copy ucfinder from the CD-ROM to your Linux PC, and then use the command g iven below to start ucfinder. The ucfinder utility will automatically bro adcast a message over your LAN n etwork to find the IP address of all UC’s connected to the LAN. #./ucfi[...]

A A Appendix A System Commands busybox (V0.60.4): µClinux normal command utility collection File manager cp copy file ls list file ln make symbolic link file mount mount and c heck fil e system rm delete file chmod change file ow ner & group & user sync sync file system; save system file buffer to hardware mv move file pwd display active f[...]

UC-7110 Series User’s Manual System Commands A-2 Network ping ping to test network route routing t able manage r netstat displa y network status ifconfig set network IP address tracerout trace route tftp tftp protocol telnet user interface to TELNET protocol ftp file transfer protoc ol iptables-restore restore iptables configuration file to netwo[...]

B B Appendix B SNMP Agent with MIB II & RS-232 Like Group UC-7110 has a built-in SNMP (Simple Network Management Pro tocol) agent that supp orts RFC1317 RS-232 lik e group and RFC 1213 MIB-II. The follow ing table lists the variable implem entation fo r UC-7110. The full SNMP object ID of UC-7110 is .iso.3.6.1 .4.1.8691 .9.7.1 .1.0 . Note: UC-7[...]

UC-7110 Series User’s Manual SNMP Agent with MIB II & RS-232 Like Group B-2 ip MIB tcp MIB udp MIB ipForwarding ipDefaultTTL ipInReceives ipInHdrError s ipInAddrEr rors ipForwDatagrams ipInUnknownPr otos ipInDiscards ipInDelivers ipOutRequests ipOutDiscards ipOutNoRoutes ipReasmT im eout ipReasmReqds ipReasmFails ipFragOKs ipFragFails ipFragC[...]

UC-7110 Series User’s Manual SNMP Agent with MIB II & RS-232 Like Group B-3 snmp MIB snmpInPkts snmpOutPkts snmpInBadV ersions snmpInBa dComm unityNam es snmpInBa dCommunit yUses snmpInASNPa rseErrs snmpInT ooBigs snmpInNoSuc hNames snmpInBadV alues snmpInReadOnlys snmpInGenErrs snmpInT otalReqV ars snmpInT o talSetV ars snmpInGetRequests snm[...]

C C Appendix C FAQ for UC-7110 FAQ 1 Why can I only use vfork( ),a nd am unable to use fork( ) ? Answer 1 uClinux only suppor ts vfork( ). It does no t support f ork( ). No te that when u sing vfork( ), the parent process will hang un til the son process calls an exec group API, or exits. FAQ 2 When us ing a pthread gr oup API, wh y can’t I u se [...]

UC-7110 Series User’s Manual FAQ for UC-7110 C-2 FAQ 5 How do I compress a n applic ation pro gram? Answer 5 UC7110’s kernel suppo rts ZFLAT format files. This means that when you compile the program, you can add the com press optio n to reduce the size of the binary file. Doing so will reduce the required flash sp ace on the user disk. The dis[...]

D D Appendix D Service Information This appen dix shows y ou how to co ntact Moxa for info rmation abo ut this and other pro ducts, and how to repo rt problems. In this appendix, we cover th e following topics.  MOXA Internet Services  Problem Report Form  Product Return Procedure[...]

UC-7110 Series User’s Manual Service Information D-2 MOXA Internet Services Customer satisfaction is our num b er one concern, and to ensure that customers receive the full benefit of our products, Moxa Internet Services has bee n set up to provide technical s upport, dri ver updates, product infor mation, and user’s manual upd ates. The follow[...]

UC-7110 Series User’s Manual Service Information D-3 Problem Report Form MOXA UC-71 10 Series Customer name: Comp any: T el: Fax: Email: Date: 1. Moxa Product:  UC-711 0 2. Serial Number: ___________ ______ Problem Desc ription: Please describe the sym ptoms of the problem as clearly as possible, incl uding any error messages you see. A clearl[...]

UC-7110 Series User’s Manual Service Information D-4 Product Return Procedure For product repair, exc hange, o r refund, the customer m ust:  Provide e vidence of origi nal purchase.  Obtain a Product Return Agreement (PRA) from the sales representative or dealer.  Fill out the Problem Report Form (PRF). Include as much detail as possibl[...]