JetBox 8100 User Manual_Linux_1.0
Contents
1. cece eee cent eects eee nm 35 Figure 5 8 Makefile example NENNEN NENNEN NENNEN ENNEN anos 36 Figure 6 1 JetView discovery AANEREN 37 Figure 7 1 Plug USB CD ROM into USB port sssssssse e 38 Figure 7 2 Insert Recovery CD into the USB CD ROM 39 Figure 7 3 Start Recovery Procedure 0 ceceeeeeceeeeee eee ee eee et ee eeeeeen seen en eaeeeeeeeeeeaes 39 Figure 7 4 Format damage Operation System Disk 40 Figure 7 5 Recover Embedded Linux operation system 40 Figure 7 6 Complete Recovery Procedure mee 41 8 3 Customer Service vire ep Contact Us Korenix Technologies Co Ltd 9F No 100 1 Ming Chuan Rd Shing Tien City Taipei Taiwan Tel 886 2 82193000 Fax 886 2 82193300 Business service sales korenix com Customer service koreCARE korenix com Web Site http www korenix com JetBox 8100 User Manaual_Linux_1 02. goahead WWW Server daemon JetBox 8100 User Manaual Linux 1 0 Type the command ps to list all processes currently running 192 168 in x r etc dropbear rsa host key r etc dropbear rsa host key Figure 3 2 daemons status To run a private daemon you can add a init file to etc init d folder as follows cd etc init d vi 99 your daemon init Jetbox8100 cd etc init d EL Jetbox8100 etc init d vi 99 your daemon init Figure 3 3 add init file Next use vi to open your application program We use the example program example program test daemon and put it to run in the background root test daemon 99_your_daemon init Figure 3 4 test release example program Change the file mode so it can be executed chmod a x 99 your daemon init JetBox 8100 User Manaual Linux 1 0 korenix Figure 3 5 change file mode JetBox 8100 User Manaual Linux 1 0 korenix 3 3 Adjusting the System Time 3 3 1 Setting the Time Manually The JetBox8100 has two time settings One is the system time and the other is the RTC Real Time Clock time kept by the JetBox 8100 s hardware Use the date command to query the current system time or set a new system time date MMDDhhmmYYYY MM Month DD Date hhmm hour and minute YYYY Year Use the following command to set the RTC time Use hwclock to query the current RTC time or set a new RTC time Use the following command
3. 3 Updating the Time Automatically 21 3 4 Connecting Peripherals USB Mass Storage 22 Chapter 4 Managing Communications eere 23 4 1 Telnet CaSO itin ao oa CHR RR D VR Qa E Donde 23 4 2 FIP CaSO T seu pa niiae 24 E an LE 25 4 4 Web Service goahead 26 GEELEN eegener 27 JetBox 8100 User Manual_Linux_1 0 korenix 4 6 Dial up Service PPP EE 28 AT TT 28 E 29 AD Open VPN ennemis sereine tees die 29 Chapter 5 Programmer s Guide ss 30 5 1 Partition Table c 30 5 2 Linux Tool Chain Introduction esses 30 5 2 1 Compiling Applications and Libraries 31 5 2 2 Tools Available in the Host Environment 32 5 3 Device Meo 32 5 4 RTC Real Time Clock eeeeeeeeeeeeeee eere nennen 33 5 5 WDT Watch Dog Timer ss 34 20 D ART sin R P 35 5 7 Make File Examiple eerie rodea nant noon uar rho Yann pande u See 36 Chapter o VIN nd ra ane 37 6 1 OV e E 37 6 2 JetView for JetBox 8100 4 oneri ter en aedi Saee x b Fee a or eo reds 37 Chapter 7 Recovery CD ios ron EO CHAR EUER ORO OU PVNDK GRE CE VXRE NF EPR RE CPP FEN ane 38 re OVERVIEW eer esas 38 7 2 Booting with Recovery CD esse 38 7 2 1 Pluggin
4. May 2006 extZfs check if mount No such file or directory while determining whether dev hda2 is mounted Recovery dev hda2z Format dev hdal mke2fs 1 39 29 May 2006 lext2fs_check_if_mount No such file or directory while determining whether dev hdai is mounted Recovery dev hdai Probing devices to guess BIOS drives This may take a long time Figure 7 4 Format damage Operation System Disk 18042 AUX port at 0x60 0x64 irg 12 18042 KBD port at Ox60 0x64 irq 1 8250 16550 driver Revision 1 90 76 ports IRQ sharing enabled ttuSO at I 0 Ox3f8 irq 4 is a 16450 ttuS1 at 1 0 Ox2f8 irq 3 is a 16450 io scheduler noop registered io scheduler anticipatory registered io scheduler deadline registered io scheduler cfq registered RAMDISK driver initialized 16 RAM disks of 128000K size 1024 blocksize Intel R PRO 1000 Network Driver version 5 6 10 1 k2 NAPI Copyright c 1999 2004 Intel Corporation ms83820 c National Semiconductor DP83820 10 100 1000 driver Uniform Multi Platform E IDE driver Revision 7 00alpha2 ide Assuming 33MHz system bus speed for PIO modes override with idebus xx PIIX3 IDE controller at PCI slot 0000 00 01 1 PIIX3 chipset revision 9 PIIX3 not 100 native mode will probe irqs later ideO BM DMA at OxcO000 0xcO07 BIOS settings hda DMA hdb pio idei BM DMA at OxcOO08 OxcOOf BIOS settings hdc DMA hdd pio hda UBOX HARDDISK ATA DISK drive ideO at Ox1f0 0x1f7 0x3f6 on irq 14 hdc UBOX CD ROM A
5. established using a modem over a telephone line Modem PPP access is almost identical to connecting directly to a network through JetBox 8100 s Ethernet port Since PPP is a peer to peer system Program name pppd Description Config files etc options etc pap secrets etc chap secrets Init file Support command pppd chat pppdump Default down Table 4 8 pppd service path 4 7 PPPoE Point to Point Protocol over Ethernet is a network protocol for encapsulating Poing to Point Protocol PPP frames inside Ethernet frames It is used mainly with ADSL services where individual users connect to the ADSL transceiver over Ethernet Program name pppoe Description Config files letc ppp pppoe conf Init file Support command pppoe connect pppoe setup pppoe start pppoe stop pppoe status Default down Table 4 9 PPPoE service path JetBox 8100 User Manaual_Linux_1 0 4 8 SNMP korenix JetBox 8100 has built in SNMP V1 V2C Simple Network Management Protocol agent software It supports RFC 1213 MIB II The following snmp file path Program name snmpd Description Config files etc snmp snmpd conf Init file Support command snmpd Default up 4 9 Open VPN Table 4 10 SNMP file path OpenVPN is a full featured SSL VPN which implements OSI layer 2 or 3 secure network extension using the industry standard SSL TLS protocol sup
6. example To compile the program go to the helloworld subdirectory and issue the following commands cd example helloworld make You should receive the following response i tmp example helloworld Figure 2 13 Compile example file main c The output executable file is the test 2 4 3 Uploading test to JetBox 8100 and Running the Program Use the following command to upload test to the JetBox 8100 via FTP 1 From the PC type JetBox 8100 User Manaual_Linux_1 0 ftp XXX XXX XXX XXX 2 Use bin command to set the transfer mode to Binary mode and the put command to initiate the file transfer ftp gt bin ftp gt put test ftp 192 168 10 7 Connected to 192 168 10 7 192 168 10 7 220 jetbox8100 FTP server GNU inetutils 1 5 ready Name 192 168 10 7 jim root 331 Password required for root Password 230 User root logged in Remote system type is UNIX Using binary mode to transfer files ftp gt put test local test remote 5 7 Entering Passive de 192 168 10 7 196 208 150 Opening BINARY n data connection for test 226 Transfer complete 6227 bytes sent in 7 7e 05 secs 7 9e 04 Kbytes sec ftp gt exit 221 Goodbye Figure 2 14 upload test to JetBox 8100 3 From the JetBox 8100 type chmod x test test The word Helloworld will be printed on the screen telnet 192 168 10 7 Trying 192 168 10 7 Connected to 192 168 10 7 Escape character is A Jetbox
7. is returned and errno is set appropriately Use the desktop Linux s man page for detailed documentation man ioctl 5 4 RTC Real Time Clock The device node is located at dev rtc Jetbox supports Linux standard simple RTC control You must include lt linux rtc h gt 1 Function RTC RD TIME int ioctl fd RTC RD TIME struct rtc time time Description read time information from RTC It will return the value on argument 3 2 Function RTC SET TIME int ioctl fd RTC SET TIME struct rtc time time Description set RTC time Argument 3 will be passed to RTC For more information please see example rtc rtc txt JetBox 8100 User Manaual Linux 1 0 Ww 24 It korenix 5 5 WDT Watch Dog Timer A Watchdog Timer WDT is a hardware circuit that can reset the computer system in case of a software fault You probably knew that already The Watchdog Driver has one basic role to talk to the card and send signals to it so it doesn t reset your computer at least during normal operation The ioctl API 1 Pinging the watchdog using an ioctl WDIOC KEEPALIVE This ioctl does exactly the same thing as a write to the watchdog device so the main loop in the above program could be replaced with while 1 ioctl fd WDIOC KEEPALIVE 0 sleep 10 the argument to the ioctl is ignored 2 Setting and getting the timeout To modify the watchdog timeout on the fly with the SETTIMEOUT ioctl driver has the WDI
8. often Figure 3 8 System Time update automatically Save the shell script using any file name E g fixtime How to run the shell script automatically when the system boots up Copy the example shell script fixtime to directory etc init d and then use chmod 755 fixtime to change the shell script mode Next use vi editor to edit the file etc inittab Add the following line to the bottom of the file respawn etc init d fixtime Reboot jetbox8100 to take effect JetBox 8100 User Manaual_Linux_1 0 3 4 Connecting Peripherals USB Mass Storage The JetBox 8100 disable PNP plug n play function to prevent un expected device mounted Once plug in USB mass storage use dmesg to scan USB storage device CAN Jethox8186 usb 1 2 usb 1 2 iscsi3 tt dmesg configuration tt ish storage device found usb storage Vendor Type device sdb Write Protect is off Mode 23 66 08 assuming drive cache sdb Model Direct fcc Sense device Write Protect is off Mode Se 23 00 0A assuming drive cache SCSI emulation for waiting for device to 1880448 512 byte hdur sectors 1000448 5 new high speed USB device using ehci_hcd and address 5 chosen from 1 choice USB Mass Storage devices at 5 settle before USB DISK Pro scanning Rev PMAP ANSI SCSI 512 MB revision eu write through byte hdwr sectors 512 MB ou write through ib 1 eM JA RL sdb1 a GE KH HHP Vendor T
9. to query the system time hwclock w Write current system time to RTC The following figure illustrates how to update thesystem time and set the RTC time Figure 3 6 Setting the Time Manually JetBox 8100 User Manaual_Linux_1 0 korenix 3 3 2 NTP Client The JetBox 8100 has a built in NTP Network Time Protocol client that is used to initialize a time request to a remote NTP server Use ntpdate to update the system time ntpdate time stdtime gov tw hwclock w Figure 3 7 NTP client request Visit http www ntp org for more information about NTP and NTP server addresses NOTE Before using the NTP client utility check your IP and DNS settings to make sure that an Internet connection is available Refer to Chapter 2 for instructions on how to configure the Ethernet interface and see Chapter 4 for DNS setting information JetBox 8100 User Manaual_Linux_1 0 korenix 3 3 3 Updating the Time Automatically In this subsection we show how to use a shell script to update the time automatically Example shell script to update the system time periodically bin sh ntpdate time stdtime gov tw You can use the time server s ip address or domain name directly If you use domain name you must enable the domain client on the system by updating etc resolv conf file hwclock w sleep 100 Updates every 100 seconds The min time is 100 seconds Change 100 to a larger number to update RTC less
10. 6 192 168 1199 295 255 255 0 v0 07 Figure 6 1 Jetview discovery JetBox 8100 User Manaual Linux 1 0 37 korenix Chapter 7 Recovery CD 7 1 Overview In some severe circumstances such as when a run time image is corrupted it may be necessary to start your device from a bootable CD Korenix provides a bootable CD to rescue damaged JetBox 8100 Embedded Linux operation system 7 2 Booting with Recovery CD 7 2 1 Plugging USB CD ROM into USB port Before use Recovery CD User should power off JetBox8100 first Plugging USB CD ROM into USB port JetBox 8100 Figure 7 1 Plug USB CD ROM into USB port 38 JetBox 8100 User Manaual Linux 1 0 korenix Insert Recovery CD into the USB CD ROM Figure 7 2 Insert Recovery CD into the USB CD ROM 7 2 2 Auto Run Recovery Procedure The Recovery CD runs recovery procedure after type recovery password Korenix as following step ES Password required 3 3 3 3 3 3 3 Password for recovery is korenix Figure 7 3 Start Recovery Procedure JetBox 8100 User Manaual Linux 1 0 39 NET Registered protocol family 1 NET Registered protocol family 17 ACPI wakeup devices supports 50 5 Autodetecting RAID arrays autorun autorun DONE Compressed image found at block O UFS Mounted root ext2 filesystem readonly Freeing unused kernel memory 192k freed SIOCSIFADDR No such device Found HDD at dev hda Format dev hda2 mke2fs 1 39 29
11. 6 Setting the Time Manually ececeeee ee ee eect ee eee ee eens neta ea eeeaeeeeeeeeeees 19 Figure 3 7 NTP client request ciii NR ENER NEEN ER ANAR ARARA ENER REESEN nnn NK NEEN 20 Figure 3 8 System Time update automatically cece cece eect eee eee eee teeta eeeaeeeees 21 Figure 3 9 usb storage device scan status 0 cece cence eee e eee ee eee eee e anne ee eee 22 Table 4 1 telnet file path gd REN KEREN N E SEN ives rade ENNER aii entit 23 Table 4 2 FTP daemon path ss 24 Figure 4 3 Enable FTP server sisi 24 Figure 4 4 Disable FTP server eiecerunt mina prre REENEN NKEN NG 24 Figure 4 5 nameserver sienne ENKE dence EEN deed Oda Gnas seed dunes en bi NU ET even SEENEN NES den 25 Table 4 6 goahead webserver path 26 Figure 4 7 Default html page ss 27 Table 4 8 pppd service path ss 28 Table 4 9 PPPoE service path 28 Table 4 10 SNMP file path 0 0 00 ccc cece cece cee cee eee ee II Ier 29 Table 4 11 openvpn file path 29 JetBox 8100 User Manaual_Linux_1 0 korenix Table 5 1 Partition table sisi reete e ced SEENEN he ete d ee nen NENG 30 Figure 5 2 mount toolChain s ssus suisses avenant 31 Figure 5 3 add toolchain file path sss ee 31 Figure 5 4 Korenix toolchain gcc version 31 Figure 5 5 complier C application sssssesssssse rrr rnr rer 31 Table 5 6 cross compiler tools 32 Figure 5 7 UART baudrate setting
12. 8100 login root Password root Jetbox8100 cd root root Jetbox8100 Is test root Jetbox8100 c root Jetbox8100 mod a x test h root Jetbox8100 test helloworld Figure 2 15 run test example file JetBox 8100 User Manaual_Linux_1 0 korenix Chapter 3 Managing Embedded Linux This chapter includes information about version control deployment updates and peripherals The information in this chapter will be particularly useful when you need to run the same application on several JetBox 8100 units 3 1 System Version Information To determine the hardware capability of your JetBox 8100 and what kind of software functions are supported check the version numbers of your JetBox 8100 s hardware kernel and user file system Contact Korenix to determine the hardware version You will need the Production S N Serial number which is located on the JetBox 8100 s bottom label To check the firmware version type cat etc sysversion c Telnet 192 168 10 1 root Jetbox8180 cat etc sysuersion v1 6 6 root Jethox8166 i Figure 3 1 Firmware version 3 2 Enabling and Disabling Daemons The following daemons are enabled when the JetBox 8100 boots up for the first time snmpd SNMP Agent daemon telnetd Telnet Server Client daemon inetd Internet Daemons EDO ocn FTP Server Client daemon sshd Secure Shell Server daemon
13. OF_SETTIMEOUT flag set in their option field The argument is an integer representing the timeout in seconds The driver returns the real timeout used in the same variable and this timeout might differ from the requested one due to limitation of the hardware int timeout 45 ioctl fd WDIOC_SETTIMEOUT amp timeout printf The timeout was set to d seconds n timeout Starting with the Linux 2 4 18 kernel it is possible to query the current timeout using the GETTIMEOUT ioctl JetBox 8100 User Manaual_Linux_1 0 korenix ioctl fd WDIOC_GETTIMEOUT amp timeout printf The timeout was is d seconds timeout For more information please see example watchdog wdt_test2 c 5 6 UART The JetBox tty device node is located at dev ttySO dev ttyS1 ttySO is mapped to COM1 and ttyS1 is mapped to COM2 Example to set the baudrate int fd BAUDRATE struct termios newtio oldtio fd open TTYDEVICE O RDWR O NOCTTY J if fd lt 0 exit 1 tcgetattr fd amp oldtio save current serial port settings bzero amp newtio sizeof newtio clear struct for new port settings BAUDRATE B57600 cfsetispeed amp newtio BAUDRATE cfsetospeed amp newtio BAUDRATE Figure 5 7 UART baudrate setting For more information see Linux s man page for detailed documentation man cfsetispeed JetBox 8100 User Manaual_Linux_1 0 korenix 5 7 Make File Example The following Makefile file example codes
14. R File Edit View Call Transfer Help D DE Jetbox8100 login root Password root amp Jetbox98100 cd root Jetbox8100 ls WindowskPStart wayv root Jetbox8100 t root Jetbox8100 Figure 2 3 Serial console screen JetBox 8100 User Manaual_Linux_1 0 korenix To log in type the Login name and password as requested The default values as following Login root Password none 2 2 2 Telnet Console If you know IP addresses and netmasks then you can use Telnet to connect to JetBox 8100 The default IP address and Netmask for each port is given below Default IP address Netmask LAN 192 168 10 1 255 255 255 0 Table 2 4 Default IP address and Netmask Use a cross over Ethernet Cable to connect directly from your PC to JetBox 8100 You should first modify your PC s IP address and netmask so that your PC is on the same subnet as JetBox 8100 To connect to a hub or switch connected to your local LAN use a straight through Ethernet cable The default IP address and netmasks are shown above To login type the Login name and password as requested The default values as following Login root Password none c Telnet 192 168 1 199 etbox8188 login root Password Jethox8186 m Figure 2 5 Telnet console screen You can proceed with the configuration of JetBox 8100 s network settings when you reach the bash command shell Configuration instructions are given in the next
15. TAPI CD DUD ROM drive idei at 0x170 0x177 0x376 on irg 15 Figure 7 5 Booting Embedded Linux operation system with Recovery CD JetBox 8100 User Manaual Linux 1 0 korenix ACPI supports 50 35 md Autodetecting RAID arrays autorun autorun DONE Compressed image found at block G UFS Mounted root Cext2 filesystem readonly Freeing unused kernel memory 192k freed SIOCSIFADDR No such device Found HDD at dev hda Format deuv hdaz mke fs 1 39 29 May 2006 ext fs_check_if_ mount No such file or directory while determining whether deu hdaz is mounted Recovery dev hdaz Format dev hdai mkeefs 1 39 29 May 2006 ext fs_check_if_ mount No such file or directory while determining whether edev hdai is mounted Recovery deuv hda il Probing devices to guess BIOS drives This may take a long time Recovery dev hda il Successfully Recoverytt remove your CDROM and reboot Have a KORENIX dayt Se Press ENTER to reboot Figure 7 6 Complete Recovery Procedure JetBox 8100 User Manaual_Linux_1 0 korenix Chapter 8 Appendix 8 1 System Commands busybox V1 8 2 Linux command collection File Manager cp copy file Is list file In make symbolic link file mount mount and check file system rm delete file chmod change file owner amp group amp user chown change file owner chgrp change file group sync Sync fi
16. al Linux 1 0 korenix 8 2 Chart Index Table 1 1 Hardware spechicaiions sess 2 Table 1 2 Software specifications 3 Figure 2 1 Power connector location sssssssssssss mme 4 Table 2 2 Serial console port setting ssssssssse m 5 Figure 2 3 Serial console screen 5 Table 2 4 Default IP address andNetmaek 6 Figure 2 5 Telnet console screen iii 6 Figure 2 6 Windows PuTTy setting 7 Figure 2 7 JetView setting cece cece ener HH eee eene 8 Figure 2 8 Edit Network configuration file sess HM 9 Figure 2 9 Static IP address setting 10 Figure 2 10 Dynamic IP address settmg eens eee eeeee teeta eeeeeeeenaneeeees 10 Figure 2 11 Restart Network setting sess 11 Figure 2 12 Network Setting over the Network 12 Figure 2 13 Compile example file main c sess 14 Figure 2 14 upload test to JetBox 8100 15 Figure 2 15 run test example nie cc cececee eee e eee e eee tees meme 15 Table 3 1 Firmware version cree eene erreur hen nnb R Ra hy nia Er at adn de 16 Figure 3 2 daemons Status eere cer nn a EE ee En ads dedo a NEEN Era dite 17 Figure 3 3 add Init flle dee ee feo eratac tee tee end uet iA E o ER Mens 17 Figure 3 4 test release example program 17 Figure 3 5 change file mode sms 18 Figure 3
17. are copied from the example on Jetbox8100 s CD ROM export TOOLCHAIN opt korenix gcc 4 1 1 glibc 2 3 6 i686 korenix linux gnu bin export PATH S TOOLCHAIN S PATH export CROSS COMPILE i686 korenix linux gnu CC i686 korenix linux gnu gcc CPP i686 korenix linux gnu gcc SOURCES example c OBJS SOURCES c 0 all example example S OBJS CC o LDFLAGS S LIBS clean rm f OBJS example core gdb Figure 5 8 Makefile example JetBox 8100 User Manaual Linux 1 0 korenix Chapter 6 JetView 6 1 Overview The JetView is a device management utility which support various device management features such as device recovery firmware and boot loader upgrade configuration backup and restore system event log listing basic system IP address modify Currently JetView only applied on the JetNet managed device and JetBox 8100 series with different version it may support different product line and you can find the latest firmware in the Korenix web site http www korenix com or get the help from Korenix Customer Support Korecare korenix com 6 2 JetView for JetBox 8100 We can discovery change IP address of JetBox 8100 and reboot JetBox 8100 through JetView FF set View v1 3 DER File IP Setting Configuration File Firmware BootLoader Log Diagnose Help 4 Signal Off All Interfaces v No Model Mac Address IP Address Netmask Version Status 1 JetBox8100 100 12 77 50 01 0
18. conf For example type the command ifconfig ethO 192 168 10 2 to change the IP address of LAN interface to 192 168 1 2 JetBox 8100 User Manaual_Linux_1 0 korenix c Telnet 192 168 1 Jetbox8188 login root Password Jethbox8108 ifconfig eth eth Link encap Ethernet HWaddr 88 12 77 58 01 66 inet addr 192 168 1 208 Bcast 192 168 1 255 Mask 255 2 UP BROADCAST RUNNING MULTICAST MIU 1599 Metric 1 errors dropped overruns frane 8 487 errors 8 dropped overruns carrier collisio H txqueue Len 1888 RK butes 498093 486 4 KiB TX bytes 162568 188 1 KiB Interrupt 11 Base addr 7 Bac 608 Jetbhox8188 ifconfig eth 192 168 1 218 Figure 2 12 Network Setting over the Network JetBox 8100 User Manaual Linux 1 0 korenix 2 4 Test Program Developing Hello c In this section we use the standard Hello programming example to illustrate how to develop a program for the JetBox 8100 In general program development involves the following seven steps Step 1 Connect the JetBox8100 to a Linux PC Step 2 Install Tool Chain GNU Cross Compiler amp glibc Step 3 Set the cross compiler and glibc environment variables Step 4 Code and compile the program Step 5 Download the program to the JetBox 8100 Via FTP or NFS Step 6 Debug the program If bugs are found return to Step 4 f no bugs are found continue with Step 7 Step 7 Back up the user directory distribute the progra
19. e before you use ntpdate time nist goc to update the system time you will need to add the DNS server address to the file Ask your network administrator which DNS server address you should use The DNS server s IP address is specified with the nameserver command For example add the following line to letc resolv conf if the DNS servers IP address is 168 95 1 1 nameserver 168 95 1 1 of 192 168 10 1 81x8 Connection Edit View Window Option Help cd Figure 4 5 nameserver letc nsswitch conf This file defines the sequence to resolve the IP address by using etc hosts file or etc resolv conf JetBox 8100 User Manaual Linux 1 0 korenix 4 4 Web Service goahead The GoAhead WebServer is an open standard web server that is compliant with all necessary standards to be an effective embedded web server Program name webs Description Config files etc server pem letc certs cacert pem letc certs cakey pem Iweb index html Init file letc init d 52 httpd init Support command Default up Table 4 6 goahead webserver path The GoAhead web server s main configuration file is etc init d 52_httpd init with the default homepage located at web lindex html Save your own homepage to the following directory Iweb Before you modify the homepage use a browser such as Microsoft Internet Explore or Mozilla Firefox from your PC to test if the goahead Web Server is working Type the LAN IP addres
20. elnet 192 168 1 199 H network configuration ROUTE 192 168 160 52 IOSTNAME Jetbox81800 ETMASK 255 255 255 6 Figure 2 9 Static IP address setting Dynamic IP addresses By default the Jetbox8100 is configured for static IP addresses To configure LAN ports to request an IP address dynamically just change DHCP_CLIENT 0 to DHCP_CLIENT 1 c Telnet 192 168 1 128 lox d network configuration DHCP_CLI ENT 1 IPADDR 192 168 1 199 DEFAULT ROUTE 192 168 10 52 OSTNRME Jetbox8108 NETMRSK 255 27 Figure 2 10 Dynamic IP address setting 2 3 1 3 Static and Dynamic IP address After the boot settings of the LAN interface have been modified issue the following command to activate the LAN settings immediately etc init d 10_networking init JetBox 8100 User Manaual Linux 1 0 korenix c Telnet 192 168 1 199 Jethox8108 login root Password H8 cd etc init d Jethox81 etc init d ls Jetbox8188 etc init d H 16_network init Start networking Killall udhcpc no process killed SIOCDELRT No such process SIOCADDRT Network is unreachable etbox8108 etc init d H Figure 2 11 Restart Network setting NOTE After changing the IP settings run the 10 networing init script to activate the new IP address 2 3 2 Modifying Network Settings over the Network IP settings can be activated over the network but the new settings will not be saved to the flash disk without modifying the file etc network
21. enix toolchain gcc version you can use the Linux man utility to obtain help on many of the utilities provided by the tool chain For example to get help on the i686 korenix linux gnu gcc compiler issue the command man i686 korenix linux gnu gcc Figure 5 4 korenix toolchain gcc version 5 2 1 Compiling Applications and Libraries To compile a simple C application just use the compiler instead of the regular compiler Hi686 korenix linux gnu gcc o outfile g 02 souce code c i686 korenix linux gnu strip s outfile Figure 5 5 compiler C application JetBox 8100 User Manaual Linux 1 0 korenix 5 2 2 Tools Available in the Host Environment The following cross compiler tools are provided i686 korenix linux gnu ar Manage archives static libraries i686 korenix linux gnu as Assembler i686 korenix linux gnu c C compiler i686 korenix linux gnu cpp C preprocessor i686 korenix linux gnu g C compiler i686 korenix linux gnu gcc C compiler i686 korenix linux gnu gprof Display call graph profile data i686 korenix linux gnu ld Linker i686 korenix linux gnu nm Lists symbols from object files i686 korenix linux gnu objcopy Copies and translates object files i686 korenix linux gnu objdump Displays information about object files i686 korenix linux gnu ranlib Generates indexes to archives static libraries i686 korenix
22. ftpget Retrieve a remote file via FTP ftpput Store a remote file via FTP nslookup Tool to query Internet name servers pscan Simple network port scanner traceroute Utility to trace the route of IP packets wget Utility for non interactive download of files from HTTP and FTP servers udhcpc DHCP client route routing table manager netstat display network status Ifconfig set ip address and configure network interfaces tracerout trace route JetBox 8100 User Manaual Linux 1 0 korenix tftp Trivial File Transfer Protocol client telnet Telnet client ftp FTP client Others dmesg dump kernel log message stty stty is used to change and print terminal line settings zcat dump gz file context mknod make device node free display system memory usage date print or set the system date and time env run a program in a modified environment clear clear the terminal screen reboot reboot power off on the server halt halt the server du estimate file space usage hostname show system s host name aplay aplay is a command line audio file player for the ALSA sound card driver amixer Command line audio mixer for the ALSA sound card driver kill killall Send specified signal to the specified process or process group For complete command usage and explanation please reference http www busybox net downloads BusyBox html JetBox 8100 User Manau
23. g USB CD ROM into USB port 38 7 2 2 Auto Run Recovery Procedure eee 39 Chapter 8 ADBEndIXc eee nee 42 8 1 System Conimands E 42 8 2 Chart d EE 45 CN 46 JetBox 8100 User Manaual Linux 1 0 korenix Chapter 1 Overview The Linux operating system that is pre installed in the Jetbox8100 follows the standard Linux architecture making it easy to accept programs that follow the POSIX standard Program porting is done with the GNU Tool Chain provided by Korenix In addition to Standard POSIX APIs device drivers for the USB storage buzzer and Network controls and UART are also included in the Linux OS The Operating System device drivers and the software you develop for your own application can all be stored in JetBox 8100 s Compact Flash card 1 1 Introduction The advantage of adopting Korenix JetBox series is ready to use Korenix is devoted to improve the usability of embedded computer in industrial domain Besides operating system XP Embedded WinCE Linux Korenix provides device drivers protocol stacks system utilities supporting services and daemons in one Compact Flash card to make system integration simple Further Korenix provides application development toolkits for users to build up their own applications easily JetBox 8100 is a high performance compact and rugged embedded computer All in one device with small volume fanless design and a capability to withs
24. i Table of RE iii Chapter 1 Overview em 1 7 T IntFOOU C IIOT ooo rem ERR mn mcmama 1 1 2 Hardware Specifications 2 1 3 Software Specifications eoesenin potet tton aano reu Su Pea kp nk anna ches 3 Chapter 2 Getting Started ss ss 4 2 1 Powering on JetBox 8100 sens 4 2 2 Connecting JetBox 8100 to a PC 5 2 2 1 Serial Console iori rain rtr tnr rx Rev iri i do ioni ni 5 2 2 2 Telnet COnsOlB uiis rita or b E QR HA EE VIS Puck FUE DH RD 6 2 2 3 SSH COnSO B iso green geegent 7 2 2 4 JetView Console oio nent 8 2 3 Configuring the Ethernet Interface 9 2 3 1 Modifying Network Settings with the Serial Console 9 2 3 2 Modifying Network Settings over the Network 11 2 4 Test Program Developing Hello c 13 2 4 1 Installing the Tool Chain Linux 13 2 4 2 Compiling Hello Eeer rr rior rra orti hx mrt tb orna Ph rae ri EkE 14 2 4 3 Uploading test to JetBox 8100 and Running the Program mena dns 14 Chapter 3 Managing Embedded Linux S 16 3 1 System Version Information 16 3 2 Enabling and Disabling Daemons 16 3 3 1 Setting the Time Manually eese 19 232 NTP Client q 20 3 3
25. i l bin login Disabling the Telnet server Disable the daemon by typing in front of the first character of the row to comment out the line JetBox 8100 User Manaual Linux 1 0 korenix 4 2 FTP daemon To enable or disable the FTP daemon you need to edit the file letc init d 51 ftpd init Program name ftpd Description Config files Init file letc init d 51 ftpd init Support command ftp Default up Table 4 2 FTP daemon path Enabling the FTP daemon The following example shows the default content of the file letc init d 51 ftpd init The default is to enable the Telnet server d Putty _ x 1 bin sh echo initial FTPO sbin ftpd D 5Si_ftpd init 1 4 25 Figure 4 3 Enable FTP server Disabling the FTP server Disable the daemon by typing in front of the first character of the row to comment out the third line bin sh echo initial FTPD sbin ftpd D Figure 4 4 Disable FTP server JetBox 8100 User Manaual_Linux_1 0 korenix 4 3 DNS The JetBox 8100 supports DNS client but not DNS server To set up DNS client you need to edit three configuration files letc hosts letc resolv conf letc nsswitch conf letc hosts This is the first file that the Linux system reads to resolve the host name and IP address letc resolv conf This is the most important file that you need to edit when using DNS for the other programs For exampl
26. korenix JetBox 8100 User Manual Embedded Linux korenix Copyright 2007 Korenix Technology Co Ltd All rights reserved Reproduction without permission is prohibited Customer Service KoreCARE korenix com JetBox 8100 User Manual Linux 1 0 korenix Copyright Notice Copyright 2007 Korenix Technology Co Ltd All rights reserved Reproduction without permission is prohibited Information provided in this manual is intended to be accurate and reliable However the original manufacturer assumes no responsibility for its use or for any infringements upon the rights of third parties that may result from its use The material in this document is for product information only and is subject to change without notice While reasonable efforts have been made in the preparation of this document to assure its accuracy Korenix assumes no liabilities resulting from errors or omissions in this document or from the use of the information contained herein Korenix reserves the right to make changes in the product design without notice to its users Acknowledgments Korenix is a registered trademark of Korenix Technology Co Ltd All other trademarks or registered marks in the manual belong to their respective manufacturers JetBox 8100 User Manaual Linux 1 0 korenix Table of Contents JetBox 8100 User Manual Embedded Linux eere i edendo C dini ii Acknowledgments norme i
27. le system let system file buffer be saved to hardware mv move file pwd display now file directly df list now file system space mkdir make new directory rmdir delete directory Editor vi text editor cat dump file context zcat compress or expand files grep search string on file cut get string on file find find file where are there more dump file by one page test test file exist or not sleep sleep seconds echo Echo string awk Pattern scanning and processing language diff compare two files or directories sed perform text transformations on a file or input from a pipeline JetBox 8100 User Manaual Linux 1 0 korenix xargs execute a specified command on every item from standard input Archival Utilities bzip2 bunzip2 Compress Uncompress bzip FILE cpio Extract or list files from a cpio archive gzip gunzip Compress Uncompress FILE with maximum compression tar Create extract or list files from a tar file unzip Extract files from ZIP archives System logging syslogd Utility used to record logs of all the significant events klogd Utility which intercepts and logs all messages from the Linux kernel and sends to the syslogd logger Utility to send arbitrary text messages to the system log Network ping ping to test network arp Manipulate the system ARP cache arping Ping host by ARP packets
28. linux gnu readelf Displays information about ELF files i686 korenix linux gnu size Lists object file section sizes i686 korenix linux gnu strings Prints strings of printable characters from files usually object files i686 korenix linux gnu strip Removes symbols and sections from object files usually debugging information Table 5 6 cross compiler tools 5 3 Device API SYNOPSIS include lt sys ioctl h gt int ioctl int d int request DESCRIPTION The ioctl function manipulates the underlying device parameters of special files In particular many operating characteristics of character special files e g terminals may be controlled with ioctl requests The argument d must be an open file descriptor The second argument is a device dependent request code The third JetBox 8100 User Manaual_Linux_1 0 korenix argument is an untyped pointer to memory It s traditionally char argp from the days before void was valid C and will be so named for this discussion An ioctl request has encoded in it whether the argument is an in parameter or out parameter and the size of the argument argp in bytes Macros and defines used in specifying an ioctl request are located in the file lt sys ioctl h gt RETURN VALUE Usually on success zero is returned A few ioctl requests use the return value as an output parameter and return a nonnegative value on success On error 1
29. m to additional JetBox 8100 units if needed 2 4 1 Installing the Tool Chain Linux The Linux Operating System must be pre installed in the PC before installing the JetBox 8100 GNU Tool Chain Fedora core or compatible versions are recommended The Tool Chain requires approximately 203 MB of hard disk space on your PC The JetBox 8100 Tool Chain software is located on the JetBox 8100 CD To install the Tool Chain insert the CD into your PC and then issue the following commands mount dev cdrom mnt cdrom Star jxvf mnt cdrom toolchain jetbox8100 toolchain tar bz2 C Ps To install the toolchain you must grant root permission The Tool Chain will be installed automatically on your Linux PC within a few minutes Before compiling the program be sure to set the JetBox 8100 User Manaual_Linux_1 0 korenix following path first since the Tool Chain files including the compiler link library and include files are located in this directory PATH opt Korenix gcc 4 1 1 glibc 2 3 6 i686 korenix linux gnu b in PATH Setting the path allows you to run the compiler from any directory 2 4 2 Compiling Hello c The JetBox 8100 CD contains several example programs Here we use Hello c as an example to show you how to compile and run your applications Type the following commands from your PC to copy the files used for this example from the CD to your computer s hard drive cd tmp mkdir example cp r mnt cdrom example tmp
30. ouse One PS 2 Port to support PS 2 Mouse and PS 2 Keyboard RTC Battery backup external RTC Reset Button One Power Button One Power ON OFF Button LED Indicator PWR 1 HDD 1 ACT 1 LINK 1 Powe Input 12VDC 24VDC Power 15W Max Consumption Mounting DIN Rail Construction Sheet metal case Dimensions 120 0mm D 44 2mm W 123 0mm H Operating 5 F 158 F 15C 70 C 5 to 95 RH w o Temperature HD Storage 4 F 176 F 20 C 80 C 5 to 95 RH w o Temperature HD Net Weight 0 7 kg EMC CE FCC class A Table 1 1 Hardware specifications JetBox 8100 User Manaual_Linux_1 0 korenix 1 3 Software Specifications Model JetBox 8100 L LM Boot Loader Grub Kernel Linux 2 6 18 Protocol Stack ARP PPP CHAP IPv4 ICMP TCP UDP DHCP FTP SNMP HTTP NTP NFS SMTP SSH2 0 SSL Telnet PPPoE OpenVPN File System NFS Ext2 Ext3 VFAT FAT OS shell command Bash Busybox Linux normal command utility collection Utilities tinylogin Login and user manager utility telnet telnet client program ftp FTP client program msmtp email client scp Secure file transfer Client Program Daemons pppd dial in out over serial port daemon snmpd snmpd agent daemon telnetd telnet server daemon inetd TCP server manager program ftpd ftp server daemon goahead web server daemon dro
31. pbear secure shell server openvpn Open Source SSL VPN solution openssl open SSL Linux Tool Chain Gcc 4 1 1 GNU project C and C Compiler Glibc v2 3 6 GNU C library JetBox 8100 User Manaual_Linux_1 0 Table 1 2 Software specifications korenix Chapter 2 Getting Started 2 1 Powering on JetBox 8100 Connect the power line wire to the Terminal block located in the down side of JetBox 8100 and power on it It takes about 10 to 20 seconds for the system to boot up ON z d ACT Pwr JetBox g4 00 Power Input 12VDC 24VDC Figure 2 1 Power connector location 4 JetBox 8100 User Manaual Linux 1 0 korenix 2 2 Connecting JetBox 8100 to a PC There are two ways to connect JetBox 8100 to a PC through the serial Console port or via Telnet over the network 2 2 1 Serial Console The serial console port gives users a convenient way of connecting to JetBox 8100 s console utility This method is particularly useful when using JetBox 8100 for the first time The signal is transmitted over a direct serial connection so you do not need to know either of JetBox s IP address in order to connect to the serial console utility Use the serial console port settings shown below Baud rate 9600bps Parity None Data bits 8 Stop bits 1 Flow Control None Table 2 2 Serial console port setting Once the connection is established the following windows will open Serial HyperTerminal DE
32. ports flexible client authentication methods based on certificates smart cards and or username password credentials and allows user or group specific access control policies using firewall rules applied to the VPN virtual interface Program name openvpn Description Config files etc openvpn sample scripts etc openvpn sample config files etc openvpn sample keys Init file zs Support command openvpn Default down JetBox 8100 User Manaual Linux 1 0 Table 4 11 openvpn file path korenix Chapter 5 Programmer s Guide 5 1 Partition Table The Storage has been split into three partitions To change the partitions you need to manually fdisk it Partition Size Contents dev hda 10MB Bootloader amp amp Kernel Idev hda2 100MB Rootfs Idev hda3 1890MB Not in use Table 5 1 Partition table Note 1 The device name could be dev sdb due to the master slave setting on your Jetbox device 2 The size of third partition variable according to different storage type 5 2 Linux Tool Chain Introduction To ensure that an application will be able to run correctly when installed on Jetbox you must ensure that it is compiled and linked to the same libraries that will be present on the Jetbox8100 The host tool chain that comes with Jetbox8100 contains a suite of Korenix compilers and other tools as well as the libraries and headers that are necessary
33. s in the browser s address box to open the homepage Visit http goahead com products webserver specifications aspx for more information about GoAhead JetBox 8100 User Manaual Linux 1 0 korenix Ji Korenix Industrial PoE switch industrial embedded computer industrial ethernet switch Microsoft Internet Explorer fe fei File Edit View Favorites Tools Help Qe gt EN e Search she Favorites A 6 3 6 2 33 Address a http 192 168 10 index html ES us koreni jal Comput aan IX Your Industrial Computing amp Networking Partner Sitemap Home Home ite ore Products Support Solutions News amp Events Where to Buy ContactUs Sitemap Korenix s Green About Korenix Promise Quality amp Assurance Global Sales amp Services Major Award amp Key Patent Target Markets Product Lines We Create Value for You Korenix the pioneer of industrial grade network device is dedicated to offer exceptional network equipment that i is user friendly cost effective and most importantly measures up to customers expectation Korenix core competitiveness is our know how and openness toward innovation and we work extensively with our business alliances to establish a mutual and trustworthy relationship We bring you easier faster and customize services with our cutting edge and reliable technology With Korenix your network solution is always satisfied and never compromised The Korenix Wa
34. section JetBox 8100 User Manaual Linux 1 0 korenix 2 2 3 SSH Console JetBox 8100 supports an SSH Console to offer users with better security options Click on the link http www chiark greenend org uk 7Esgtatham putty to download PuT Ty freeware to set up an SSH console for JetBox 8100 ina Windows environment The following figure shows a exmple of the configuration that is required iS Pal TY Configuration Category Session Basic options for your PuTTY session I ST Specify the destination you want to connect to Bae Host Name or IP address Port Keyboard Bel 192 169 10 4 22 Features Connection type Window OBaw O Ielet ORlogin SSH Serial ee Load save or delete a stored session aviour Translation Saved Sessions Selection JetBox 8100 Console Setting Colours Default Settings Connection JetBox 8100 Console Settir Data Proxy Telnet Rlogin SSH Serial Close window on exit O 4lways Never Only on clean exit bs J Figure 2 6 Windows PuTTy setting JetBox 8100 User Manaual_Linux_1 0 7 korenix 2 2 4 JetView Console The JetView is a device management utility which support various device management features such as device recovery firmware and boot loader upgrade configuration backup and restore system event log listing basic system IP address modify Install JetView to your PC from user manual CD which associated with JetBox 8100 Yo
35. tand a wide range of temperatures is suitable for industrial severe environment It is equipped with AMD Geode L X800 processor and 256MB SDRAM 512MB optional and supports XP Embedded Linux and WinCE5 0 to meet requirements of industrial PC applications For better expansibility it carries 2 USB ports 1 RS 232 ports and 1 RS 232 422 485 ports for versatile peripheral and interfaces and one Compact Flash slot for system integration It also supports VGA up to 1280 1024 and audio to give users much flexibility in industrial applications In addition it is equipped with 1 RJ 45 ports and supports daemons and web server to accommodate to the network communication environment today With complete software solution and excellent hardware design JetBox8100 is the best choice of industrial communication computer JetBox 8100 User Manaual Linux 1 0 korenix 1 2 Hardware Specifications Model JetBox 8100 Processor AMD Geode LX800 500MHz Chipset AMD Geode CS5536 System Memory SDRAM 256 MB Max 512MB Optional VGA Up to 64MB sharing system memory Ethernet Controller Realtek RTL 8100C 10 100Based TX RJ45 connector 1 Compact Flash slot Type Il Compact Flash slot 1 Hard Driver Disk 2 5 HDD IDE slot 1 Serial Port COM1 RS232 COM2 RS232 RS422 RS485 JP2 BIOS select USB Two USB2 0 Compliant universal serial bus port Audio MIC input connector Earphone connector Keyboard M
36. to compile applications for Jetbox8100 The host environment must be running Linux to install the Jetbox8100 GNU Tool Chain We have confirmed that the following Linux distributions can be used to install the tool chain Redhat 9 0 Fedora core 7 The Tool Chain will need about 200 MB of hard disk space on your Linux PC The Jetbox8100 Tool Chain is located on the Jetbox8100 CD To install the Tool Chain insert the CD into your PC and then issue the following commands JetBox 8100 User Manaual Linux 1 0 korenix mount dev cdrom mnt cdrom tar jxvf mnt cdrom toolchain jetbox8100 toolchain tar bz2 C Figure 5 2 mount toolchain Wait for a few minutes while the Tool Chain is extract on your Linux PC Once the host environment has been installed add the directory opt korenix gcc 4 1 1 glibc 2 3 6 i686 korenix linux gnu bin to your path and optionally the directory lopt korenix gcc 4 1 1 glibc 2 3 6 1686 korenix linux gnu man to your manual path You can do this temporarily for the current login session by issuing the following commands export PATH opt korenix gcc 4 1 1 glibc 2 3 6 i686 korenix linux gnu bin S PATH export MANPATH opt korenix gcc 4 1 1 glibc 2 3 6 i686 korenix linux gnu man Figure 5 3 add toolchain file path Alternatively you can add the same commands to HOME bash profile to cause it to take effect for all login sessions initiated by this user To obtain help on Kor
37. u may download update JetView from Korenix Website The following figure shows a example of the configuration A detView ei 3 File IP Zeng Configuration File Firmware BootLosder Log Diagnose Help BDiscovery SignslOM All Interfaces Mac Address IP Address Netmask ktBox100 00 12 77 50 01 06 192 168 1 199 255 255 2550 Figure 2 7 JetView setting 8 JetBox 8100 User Manaual Linux 1 0 korenix 2 3 Configuring the Ethernet Interface JetBox 8100 s network setting can be modified with the serial Console or online over the network 2 3 1 Modifying Network Settings with the Serial Console In this section we use the serial console to modify JetBox 8100 s network settings 2 3 1 1 Change Network Configuration Follow the instructions given in a previous section to access JetBox 8100 s Console Utility via the serial Console port and then type vi letc network conf to edit network configuration file with vi editor cx Telnet 192 168 1 199 network configuration DHCP CLIENT 8 IPADDR 192 168 1 199 DEFAULT_ROUTE 192 168 18 52 HOS TNAME Jet box8180 NETMASK 255 255 255 8 network conf 1 8 12 Figure 2 8 Edit Network configuration file 2 3 1 2 Static and Dynamic IP address Static IP address As shown below 4 network addresses must be modified DHCP CLIENT IPADDR DEFAULT ROUTE and NETMASK The default IP addresses are 192 168 10 1 JetBox 8100 User Manaual Linux 1 0 korenix cx T
38. y 4 flat networked organization as well as effectiveness and flexibility in decision making characterize the Korenix Way in operation Equal opportunities and openness towards people and new ideas are also key elements we want to nourish Korenix is straightforward when dealing with customers and suppliers anid always looks for innovative ways of creating and introducing products and solutions to the market We pel h a clear vision m Done e TUE Figure 4 7 Default html page 4 5 IPTABLES IPTABLES is an administrative tool for setting up maintaining and inspecting the Linux kernel s IP packet filter rule tables Several different tables are defined with each table containing built in chains and user defined chains Each chain is a list of rules that apply to a certain type of packet Each rule specifies what to do with a matching packet A rule such as a jump to a user defined chain in the same table is called a target Since JetBoc 8100 has one network interface it supports Filter table of IPTABLES Filter Table includes three chains INPUT chain OUTPUT chain FORWARD chain NOTE Jetbox8100 does NOT support IPV6 and ipchains JetBox 8100 User Manaual Linux 1 0 korenix 4 6 Dial up Service PPP PPP Point to Point Protocol is used to run IP Internet Protocol and other network protocols over a serial link PPP can be used for direct serial connections using a null modem cable over a Telnet link and links
39. ype device fittached s removable disk sdb Attached scsi generic Model Direct ficcess sde 2884 512 Write Protect is off 23 94 06 HA assuming drive cache device sdc Write si sqU type H USB DISK Pro Rev PMAP ANSI SCSI CL MB revision byte hdwr sectors Mode Sense write through 2886 512 byte hdur sectors off Mode Sense 23 94 06 8A assuming drive cache lt i MB Protect is write through disk sgi sdc a Attached scsi removable Attached device scan complete sd 3 0 1 isb storage Jet box8108 scsi generic type Figure 3 9 usb storage device scan status Type mount dev sdb1 into JetBox 8100 mnt The usb storage device will be mounted Type umount mnt before disconnected usb storage device JetBox 8100 User Manaual_Linux_1 0 korenix Chapter 4 Managing Communications In this chapter we explain how to configure JetBox 8100 s various communication functions 4 1 Telnet daemon To enable or disable the Telnet server you first need to edit the file letc inetd conf Program name telnetd Description Config files letc inetd conf Init file letc init d 5O inetd init Support command telnet Default up Table 4 1 telnet file path Enabling the Telnet server The following example shows the default content of the file etc inetd conf The default is to enable the Telnet server telnet stream tcp nowait root usr sbin telnetd telnetd
Download Pdf Manuals
Related Search