Home

JetBox 8210 User Manual

1. 7 3 Software Specification Item Protocol Notes JetBox 5630 Boot Loader U boot Kernel 3 2 0 CHAP ICMP udhcp DHCP DHCP client server x syslogd X ARP PPP PAP TCP UDP NFS FS z X X X X X X X X X X X X X e2fsprogs Ext2 Ext3 file system utilities 1 42 i2c tools 12C 12C tools for Linux 3 1 0 mtd MTD JFFS2 utilities 1 1 0 microcom Serial port terminal 1 02 pciutils PCI utilities 3 1 9 setserial RS 232 serial port setting tool Korenix Appendix Item Protocol Notes JetBox 5630 usbmount USB automatically mounts USB mass storage 0 0 22 devices usbutils USB USB utilities 0 04 Network related SW package bridge utils Ethernet bridge utility 1 5 ethtool Ethernet configure tool 3 2 net snmp SNMP SNMP support package 5 7 1 v1 v2c v3 ntp NTP NTP utility 4 2 6p5 openssh SSH1 0 2 0 SSH support package 5 9p1 openssl SSL SSL support package 1 0 0g openvpn OpenVPN VPN tool 2 2 2 openswan IPsec Ipsec for Linux 2 6 37 pppd PPP PPP protocol for Linux 2 4 5 rp pppoe PPPoE PPPOE support package 3 1 0 pptp linux PPTP PPTP protocol for Linux 1 7 2 proftpd FTP FTP daemon 1 3 3g samba SMB Windows network support package 3 5 12 bind DNS DNS server 9 6 xl2tp L2TP L2TP protocol for Linux 1 2 7 mrouted DVMRP DVMRP multicast routing protocol 3 9 4 quagga OSPFv1 0 2 0 unicast routing protocol RIPv1 0 2 0 ng BGP4 ISIS wireless tools 802 11 Tools of WLAN card 29 Gcc C C PC Cross Compiler 4 5 3
2. Handle a single configuration line This may be specified multiple times for multiple lines This is just like a line in the config file This disables the default config file you must specify a c after the last C to have it read a config file too p lt controller port gt Start a controller session on the given TCP port P lt file gt set location of pid file n Don t detach from the controlling terminal d Don t detach and send debug I O to standard output u Disable UUCP locking b Do CISCO IOS baud rate negotiation instead of RFC2217 v print the program s version and exit LM Network Feature Korenix Example e Setup a TCP server with following operation parameter Serial port 1 TCP port 62001 Baud rate 9600 Data bits 8 Parity none Stop bit 1 Hardware flow control none State raw state timeout never timeout modem mode none For more information please see section 7 5 4 21 WiFi Configuration In JetBox5630 we have built in AWUSO36NEH wireless driver You can easily install and use it to connect Ethernet 4 21 1 Introduction AWUSO36NEH IEEE 802 11b g n Wireless USB adapter provides users to launch IEEE 802 11b g n wireless network at 150 Mbps in the 2 4GHz band which is also compatible with IEEE 802 11b g wireless devices at 54 Mbps You can configure AWUSO36NEH with ad hoc mode to connect to other 2 4GHz wireless computers or with Infrastructure m
3. arm arago linux gnueabi gcov coverage testing tool arm arago linux gnueabi gdb The GNU Debugger arm arago linux gnueabi gdbtui The GNU Debugger Text User Interface arm arago linux gnueabi gprof Display call graph profile data arm arago linux gnueabi ld Linker arm arago linux gnueabi nm Lists symbols from object files arm arago linux gnueabi objcopy Copies and translates object files arm arago linux gnueabi objdump Displays information about object files arm arago linux gnueabi ranlib Generates indexes to archives static libraries arm arago linux gnueabi readelf Displays information about ELF files arm arago linux gnueabi size Lists object file section sizes arm arago linux gnueabi strings Prints strings of printable characters from files usually object files arm arago linux gnueabi strip Removes symbols and sections from object files usually debugging information Korenix Programmer s Guide 6 2 Device API ioctl Name ioctl control device Library Standard C Library libc Ic Synopsis include lt sys ioctl h gt int ioctl nt d unsigned long request Description The ioctl system call 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 ar
4. Use ntpdate to update the system time ntpdate time stdtime gov tw Hhwclock W step time server 220 130 158 52 offset 2164914 665108 sec 06 02 51 56 crond 959 time disparity of 36082 minutes detected 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 3 5 Cron Daemon Schedule jobs Cron is a daemon to execute scheduled commands Cron wakes up every minute examining the etc crontab checking each command to see if it should be run in the current minute Crontab syntax A crontab file has five fields for specifying day date and time followed by the command to be run at that interval command to be executed ipe day of week 0 6 Sunday 0 monta IA q day OF month 1 Sil TUE house 0 29 Korenix System Feature Crontab example A line in crontab file like below removes the tmp files from tmp each day at 6 30 PM i30 1g ve m ow iw aa 3 6 Connect Peripherals While plug in a USB mass storage or a SD card use dmesg command can help showing USB storage device status through SCSI removable disk usb storage device scan status JetBox5630 support auto mount external storage just use mount command to check the mount point EC System Feature
5. Korenix As the picture shows the usb storage has been mounted on media usbO You can access your data in the media usbO folder To un mount the usb storage execute umount mount path For example issue umount media usbO can un mount the previous mounted directory NOTE To be able to unmount a device you have to close all the open files in it Type sync can help commits all pending writes which can then be removed in a safe way Korenix System Feature Chapter 4 Network Feature In this chapter we explain how to configure JetBox various communication functions 4 1 Telnet Service name telnetd Description A Telnet server Support command Default 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 Disabling the Telnet server Disable the daemon by typing in front of the first character of the row to comment out the netstat NOTE We also support telnet with IPv6 address Example telnet fe80 212 77ff fe50 1ba8 eth0 4 2 SSHD Service name Description A ssh server Config files etc sshd config etc ssh config letc ssh host dsa key letc ssh host dsa key pub letc ssh host ecdsa key letc ssh host ecdsa key pub etc ssh host key letc ssh host key pub letc ssh host rsa key etc ssh host rsa key pub Re generate sshd host keys The JetBox5630 comes with a set of default
6. Starting sshd OK etc init d S50sshd stop Stopping sshd OK Korenix System Feature You can start the service by adding the first argument start and stop the service by adding the first argument stop 3 3 Setting System Time The JetBox5630 has two time settings One is the system time and the other is the RTC Real Time Clock time kept by the JetBox5630 s hardware Use the date command to query the current system time or set a new system time COMO IRURE PL PO A A A RAR c Ree aN MM Month DD Date hhmm hour and minute Use hwclock to query the current RTC time Use the following command to set system time from hardware clock 11 11 30 02 GNT 2013 Pa k lon Nov 03 28 2013 0 00 cl bh Mon Nov i on Nov Setting the Time Manually 3 4 Adjust System Time If you only wish to synchronize your clock when the device boots up you can use ntpdate This may be appropriate for some devices which are frequently rebooted and only require infrequent synchronization Using ntpdate at boot time is also a good idea for devices that run ntpd The ntpd program changes the clock gradually whereas ntpdate sets the clock no matter how great the difference between a device s current clock setting and the correct time ESI System Feature Korenix 3 4 1 NTP Client The JetBox has a built in NTP Network Time Protocol client that is used to initialize a time request to a remote NTP server
7. glib 2 0 9 Appendix Korenix 7 4 Busybox command busybox V1 19 4 Linux command collection File Manager Editor t t 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 xargs execute a specified command on every item from standard input trest test file exist or not Korenix Appendix Archival Utilities unzip Extract files from ZIP archives System logging 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 pscan Simple network port scanner traceroute trace route tftp Trivial File Transfer Protocol client telnet Telnet client CS Appendix Korenix Others date print or set the system date and time kill killall Send specified signal to the specified process or process group For complete command usage and explanation please refer to following website http www busybox net downloads BusyBox html Korenix Appendix 7 5 Ser2net Manual Name ser2net Serial to network proxy Synopsis ser2net c configfile C configline p controlport n d b v P pidfile Description The ser2net daemon allows telnet and tcp sessions to be established with a unit s serial ports The pro
8. wan port is a RJ 45 SFP combo port It support 10 100 1000 Base TX and 100 Base FX 1000 Base SX When you use SFP interface you can change SFP speed to 100 1000 by using ethtool For example Default SFP Speed is 1000 a n re Port SELS B Medium SFP Speed 1000Mb s Duplex Full ELO Comuezole uti Port Setting Bores On Auto negotiation on Link detected Up To change SFP speed you need to reboot the system to make it effective Please make sure the spec of SFP matching with the SFP speed setting or exception conditions would happen Korenix Korenix Feature 5 4 Vconfig program name vconfig Description Create and remove VLAN devices on LAN port Usage Options interface name vlan id tag port id untag port id example vconfig add lan 2 tag 1 untag 2 3 vlan name Display Vlan Table Example e Adda vlan interface vconfig add lan 2 untag 2 3 encap Ethernet HWaddr 00 12 addr 192 168 10 1 Bcast 192 inet6 addr fe8 12 77ff fe50 4c UP BROADCAST RUNNI iG MULTICAST M RX packets ors 0 dropped 0 errors dropped 1 opcs 2 K1B bytes Link encap Ethernet HI iddr 00 12 77 50 BROADCAST MULT l air Mes tric l Du X bytes 0 e Delete a vlan interface vconfig rem lan 2 e Show all vlan interface vconfig show When you add a VLAN interface you can only see it by typing ifconfig a It will display with lan 2 To enable it issue ifcon
9. ETE 30 Sm er NR CONTE 30 SNMP saccus D a bete e 32 4 12 iud M 33 4 13 UPS nf 33 4 14 LEGES MR PT c 34 4 15 PPIP SENET 37 4 16 ATI c Am 38 4 17 api et M I 39 4 18 gu e X 40 4 19 Routing Zebra DAMON tien ia DN RNC 42 4 20 NO A AAA 44 4 21 WiFi CONFIGURATION Mie ii dd 45 21 L o A tt tttt tnter tanssin tsstttttstttEn net enns ennen nna 45 4 21 2 Configure with WpriV coconnnuononcnncnnnnnonoonnnnnnnncnnnonononnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnos 46 4 21 3 Configure with wpa_supplicant ss 47 4 22 WAU Gl rare T n 48 Chapter 5 ele dris 50 5 1 EM a c 50 5 2 Rate Limit Control ads 52 5 3 SFP and Copper COMIDO sacada nd dt 53 5 4 lolo ATP OP OU esse none ava e ede esos E Eaa d 54 5 5 RES M a e 55 5 6 Serial COMtG p e 55 Chapter 6 Programmer s Guin ii 56 6 1 To lchain Introduction MeL 56 6 1 1 Compiling Applications and Libraries 57 6 1 2 Tools Available in the Host Environment ss 57 6 2 Device API Sn ere non m 58 6 3 O A A A 59 6 4 Watch Dog TIME E tete ici 59 6 5 o eceaetaaaceaadd E 60 Chapter 7 PSI no o A E a a i 62 7 1 Firmware Upgrade oia td ma ne 62 7 2 USB Driver for GSM WG MS nenenuenmndeitennsnti enn 62 7 3 Software Specification sieste 63 7
10. arguments as if it had been invoked directly For more information download the step by step how to from Korenix website http www korenixembedded com support faqs vpn Or read OpenSwan Wiki http wiki openswan or 4 14 PPTP Client program name pptp Description A Point to Point potocol client Config file etc ppp options pptp etc ppp chap secrets Usage pptp hostname lt pptp options gt pppd options gt Or using pppd s pty option pppd pty pptp hostname nolaunchpppd lt pptp options gt Available pptp options phone lt number gt Pass number to remote host as phone number nolaunchpppd Do not launch pppd for use as a pppd pty quirks lt quirk gt Work around a buggy PPTP implementation Currently recognised values are BEZEQ ISRAEL only debug Run in foreground for debugging with gdb sync Enable Synchronous HDLC pppd must use it too EN Network Feature Korenix timeout lt secs gt Time to wait for reordered packets 0 01 to 10 secs nobuffer Disable packet buffering and reordering completely idle wait Time to wait before sending echo request max echo wait Time to wait before giving up on lack of reply logstring lt name gt Use name instead of anon in syslog messages localbind lt addr gt Bind to specified IP address instead of wildcard loglevel level Sets the debugging level O low 1 default 2 high PPTP establishes the client side of a V
11. firewall rules applied to the VPN virtual interface For more information download the step by step how to from Korenix website http www korenixembedded com support fags vpn 4 13 IPSec Service name ipsec Description A full featured IPSec VPN Config files letc ipsec conf Start file letc init d ipsec Start command letc init d ipsec start Stop command letc init d ipsec stop Default down ipsec setup showonly start stop restart ipsec setup status ipsec auto showonly asynchronous up connectionname ipsec auto showonly add delete replace down connectionname ipsec auto showonly route unroute connectionname ipsec auto showonly ready status rereadsecrets rereadgroups Korenix Network Feature ipsec auto showonly rereadcacerts rereadaacerts rereadocspcerts ipsec auto showonly rereadacerts rereadcrls rereadall ipsec auto showonly utc listpubkeys listcerts ipsec auto showonly utc listcacerts listaacerts listocspcerts ipsec auto showonly utc listacerts listgroups ipsec auto showonly utc listcrls listocsp listall ipsec auto showonly purgeocsp OpenSwan is an implementation of IPsec Protocol for Linux You can create a VPN using ipsec command ipsec invokes any of several utilities involved in controlling the IPsec encryption authentication system running the specified command with the specified
12. key and press the C key Caught signal 2 Attempting to exit gracefully Terminating on signal 15 Connect time 108 3 minutes Disconnecting at Wed Jun 9 01 35 23 2010 Chapter 5 Korenix Feature 5 1 Ethtool LAN switch port configuration tool ethtool ethtool version 3 2 IE htool DEVWAME ethtool q DEVNAME ethtool Q DEVNAME Ya QUEUE ID COS ID QUEUE ID DSCP ID ethtool p DEVNANE ethtool P DEVNAME pvid ethtool t DEVNAME 10110011000 halflfull onloff onloff onloff na rol 10011000 000 ethtool S DEVNAME 50 Korenix Feature Korenix Example Get port status ethtool lan 2 ose LSEUSE Medium Copper Speed 100Mb s Duplex Full Hilo Comurzalle Or Port Setting PONES qum Auto negotiation on Link detected Up Set port s flow control on ethtool s lan 2 flow on Posee SuEEEUIGIB Medium Copper Speed 100Mb s Duplex Full Flow Control on Port Setting POEs Gn Auto negotiation on Link detected Up Set port s auto negotiation off ethtool s lan 2 autoneg off IOI Sitslculs e Medium Copper Speed 100Mb s Duplex Full Loy Control quit Porte Seite imei Bores Om Auto negotiation off Link detected Up Set port s pvid to 2 F ethtool P lams on ano 2 Korenix Korenix Feature 5 2 Rate Limit Control Rate limiting is used to control the rate of traffic that is sent or received on a network interface For ingress rate limi
13. running Linux and install with the Jetbox5630 Toolchain We have confirmed that the following Linux distributions can be used to install the tool chain Ubuntu 10 4 Centos 6 3 Source Codes Linux Native Cross compiling Toolchains Toolchains ork Station A x86 binary ARM binary Target Platform The Toolchain will need about 750 MB of hard disk space on your Linux PC The Jetbox5630 toolchain is included in the Jetbox5630 SDK which can download from http www korenixembedded com The SDK can be extract at any directory for example your HOME directory You can extract the SDK with following command The README file will teach you how to install the Toolchain and application examples are in the example app directory EJ Programmer s Guide Korenix 6 1 1 Compiling Applications and Libraries To compile a simple C application just use the arm arago linux gnueabi gcc compiler 6 1 2 Tools Available in the Host Environment The following cross compiler tools are provided arm arago linux gnueabi ar Manage archives static libraries arm arago linux gnueabi as Assembler arm arago linux gnueabi c filt Demangle C and Java symbols arm arago linux gnueabi cpp C preprocessor arm arago linux gnueabi g C compiler arm arago linux gnueabi gcc C compiler arm arago linux gnueabi gcchug Shell script which is used to simplify the creation of bug reports
14. sshd host keys To re generate it remove them and restart the ssh daemon 4 name eto ssh hogt deea key ste sen host Cee key gio etc ssh host ecdsa key etc ssh host ecdsa key pub etc ssh host key etc ssh host key pub etc ssh host rsa key etc ssh host rsa key pub 4 etc init d S50sshd restart NOTE We also support ssh login with IPv6 address Example ssh fe80 212 77ff fe50 1ba8 eth0 Korenix Network Feature Service name proftpd Description A Highly configurable FTP server Config files letc proftpd conf Start file letc init d proftpd Start command letc init d proftpd start Stop command letc init d proftpd stop Support command Default down Enabling root login Edit the etc proftpd conf and add the following line then restart the FTP server 4 4 DNS To set up DNS client you need to edit two configuration files etc resolv conf etc hosts optional etc hosts The static table lookup for host names This is the first file that the Linux system reads to resolve the host name and IP address etc resolv conf DNS resolver configuration file This is the most important file that you need to edit when using DNS for the other programs For example 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 n
15. tcp port enable state Sets the port operation state Valid states are offto shut the TCP port down raw to enable the TCP port transfer all I O as is raw p to enable the TCP port input and device output without termios setting and te net to enable the TCP port is up run the telnet negotiation protocol on the port Configuration Configuration is accomplished through the file etc ser2net conf A file with another name or path may be specified using the c option or individual config lines may be specified with the C option This file consists of one or more entries with the following format TCP port state timeout device options or BANNER banner name gt lt banner text FIELDS TCP port Name or number of the TCP IP port to accept connections from for this device A port number may be of the form host port such as 127 0 0 1 2000 or localhost 2000 If this is specified it will only bind to the IP address specified for the port Otherwise it will bind to all the ports on the machine state Either raw or rawlp or telnet or off off disables the port from accepting e Appendix Korenix connections It can be turned on later from the control port raw enables the port and transfers all data as is between the port and the long raw p enables the port and transfers all input data to device device is open without any termios setting It allow to use dev IpX devices and printers connected
16. the Windows ini file format with sections named in square brackets and a number of variable value pairs within each section Here is a sample configuration file Jetc wvdial conf wvdial configuration file Dialer Defaults Phone 99 Stupid Mode 1 Init ATZ Init2 ATQO V1 E1 S020 amp C1 amp D2 FCLASS 0 Init3 AT CGDCONT 1 IP internet Modem Type Analog Modem Baud 115200 New PPPD yes Modem dev ttyUSB3 ISDN 0 Dial Command ATDT Username username Password password This example uses Init3 to setup APN as internet Changes with your apn and don t remove double quote For example in Taiwan we use internet as APN When wvdial is in Stupid Mode it does not attempt to interpret any prompts from the terminal server It starts pppd immediately after the modem connects Apparently there are ISP s that actually give you a login prompt but work only if you start PPP rather than logging in Phone customize to your country or provider for internet connection i e in Taiwan we use 99 Username Password change with your username and password if needed and set Stupid Mode to 0 Some providers don t use username and password you can just leave them blank Modem The location of the device that wvdial should use as your modem i e for Sierra MC8092 it uses dev ttyUSB3 LS Network Feature Korenix Connecting to the internet for the first time First Enter wvdial at the
17. to them te net enables the port and runs the telnet protocol on the port to set up telnet parameters This is most useful for using telnet timeout The time in seconds before the port will be disconnected if there is no activity on it A zero value disables this funciton device The name of the device to connect to This must be in the form of dev device device configuration options Sets operational parameters for the serial port Values may be separated by spaces or commas Options 300 1200 2400 4800 9600 19200 38400 57600 115200 set the various baud rates EVEN ODD NONE set the parity 1STOPBIT 2STOPBITS set the number of stop bits 7DATABITS 8DATABITS set the number of data bits XONXOFF turns on off XON XOFF support R7SCTS turns on off hardware flow control LOCALignores checks the modem control lines DCD DTR etc 7AWNGUP WHEN DONE lowers does not lower the modem control lines DCD DTR etc when the connection closes VOBREAK Disables automatic clearing of the break setting of the port rem ct allows remote control of the serial port parameters via RFC 2217 See the README for more info banner name displays the given banner when a user connects to the port banner name A name for the banner this may be used in the options of a port banner text The text to display as the banner This may contain normal C escape strings and it may also contain d for the device name Vp for the
18. 4 BUSVDOX Commande lustre puente Vu uen 65 7 5 sud MEM didas 68 7 6 CUSTOM S TVICR 72 Eg Overview Korenix Chapter 1 Overview One of the advantages of adopting Korenix JetBox series industrial computers is ready to use All these years Korenix is devoted to enhance usability and functions of embedded computers in industrial domain Korenix operating system provides device drivers protocol stacks system utilities supporting services and daemons to make system integration simple Besides Korenix also provides application development toolkits for users to build their own applications easily The stylish compact JetBox 5630Gf w series are industrial layer 3 VPN routers with Linux computing capability It is a gateway to connect different network groups such as Ethernet and serial control in a complex networking architecture and manage peripherals at the front end site With Gigabit Ethernet fiber connection and ability of network redundancy JetBox 5630Gf w series can be applied in crossroads or highway for flow control and traffic monitoring of remote transportation control Besides JetBox 5630Gf w series are designed with features of compact reliable and robust to adopt in various industrial vertical markets with hazardous environment such as transportation surveillance and environmental monitoring Applied Models JetBox 5630 series Note SW features might be different according to different products Korenix Over
19. DK requires approximately 750 MB of hard disk space on your PC The JetBox5630 SDK can be downloaded from Korenix web site To install the SDK it is simply a matter of extracting a tarball at the proper place ete M menes PA ATAR ATRAS tar jxvf jetbox5630 sdk 0 1 tgz C korenix sdk NOTE A e To install the Toolchain you must grant root permission e Toolchains used to not be relocatable You must install them in the location they were built for Install toolchain is simple just extract to the your directory with the command Next set up the PATH environment variable go to the korenix sdk jetbox5630 And type follow command to set up environment variable O ee e A A AU EE RCA ET 5630 SDK setup completed iPlease use command linux devkit environment setup to source environment Now you can build the program and run it on JetBox5630 Korenix Getting Start 2 3 2 Compiling Hello c If you have been compiling a program on X86 then you will find the only difference is the GCC command is start with arm arago linux gnueabi That is because we want to differentiate with the stand GCC compiler and the prefix also tell you it is for arm little endian platform program Below is a simple hello c program ZEN ioi x File Edit View Terminal Tabs Help 1 include lt stdio h gt 2 3 int main printf hello world n return 0 ceo ov un B pem 8 0 1 All The output executable file is the hel
20. EE Rene te 3 gll m e 5 Getting Statte PE 6 System logi Meen er iuta ttes TEA net 6 2 1 1 Serial Console en EE 6 2 1 2 Telnet Console nn A A A A A A 7 2 1 3 SSH CONS Ol 6 ns ina Te 8 Configure Ethernet Interface 9 2 2 1 Modifying Network Settings with the Serial Console 9 2 2 2 Static and Dynamic IP address nnne nnn 11 2 2 3 Modifying Network Settings over the Network 11 Test Program Developing Hello c ss 12 2 3 1 Installing the SDK Linux escape Od ont nine 13 2 3 2 Comipiling Hello 2 2 cr da e Ht ee ee de ee e 14 2 3 3 Uploading helloworld to JetBox5630 and Running the Program 14 System Feature REI 16 System VerslIOT iiec ee AAA 16 Enable Disable Daemons eene eene en enennetnnree ses erinnere ntes sese 16 Setting Systemi TIM iieri o ctetu eremo ree een eeu tme me dne ege repa eed edede nea ane 18 Adjust System Time iii 18 3 4 1 NTR CUTE iie o nee toni RE ee Solid 19 Cron Daemon Schedule jobs hs tan animent aan 19 Connect Pernia da nior ii eti A ns intel ere n dag v e Perdu 20 Network Fedt l e c doi e ped es be ia 22 O ce LA mass 22 SSD a tm RO nent E A 23 EDP mao tan Nina on Mens 24 B pos 24 PTA Si M Cae es dace ELLE 25 NAT em M HC P 27 Dailc p Service s reete Hai Te teni 28 PPPOE diete UU nde id 28 WES oec tE asta or Sd ntu s DT PD EI
21. Mini Howto ze Network Feature Korenix 4 6 NAT Network address translation NAT is the process of modifying network address information in datagram IP packet headers while in transit across a traffic routing device for the purpose of remapping one IP address space into another A basic NAT scenario The 2 interfaces concerned will be WAN and LAN WAN This will be the interface connected to the Internet LAN This interface will be connected to the private network NAT AN 192 168 10 10 LAN Internet H Ry 02168 10 E gt WAN mS 192 168 10 11 lt 192 168 10 12 Assuming that you have already configured your system to be able to connect to Internet run the following command to enable NAT iptables t nat A POSTROUTING o wan j MASQUERADE iptables A FORWARD i wan o lan m state state RELATED ESTABLISHED j ACCEPT iptables A FORWARD i lan o wan j ACCEPT NOTE If WAN interface use PPPOE to connect to ISP use pppO interface instead of WAN port To save current setting of iptables to a file use the following command Korenix Network Feature 4 7 Dail up Service Service name pppd Config files letc options etc pap secrets etc chap secrets Start command Stop command Support command pppd chat pppdump Default down PPP Point to Point Protocol is used to run IP Internet Protocol and other network proto
22. TCP port number and Ys for the serial port parameters eg 9600N81 of the given connection Blank lines and lines starting with are ignored Security ser2net uses the tcp wrappers interface to implement host based security See hosts access 5 for a description of the file setup Two daemons are used by ser2net ser2net is for the data ports and ser2net control is for the control ports Signals SIGHUP If ser2net receives a SIGHUP it will reread it configuration file and make the appropriate changes If an inuse port is changed or deleted the actual change will not occur until the port Korenix Appendix is disconnected Error Almost all error output goes to syslog not standard output Files etc ser2net conf See Also telnet 1 hosts access 5 Known Problems None Author Corey Minyard lt minyardO acm org gt 7 6 Customer Service Korenix Technology Co Ltd Business service sales korenixembedded com sales korenix com Customer service koreCARE korenix com Web Site http www korenixembedded com http www korenix com ES Appendix Korenix
23. ameserver command For example add the following line to etc resolv conf if the DNS server s IP address is 168 95 1 1 le Network Feature Korenix nameserver 4 5 IPTABLES program name iptables Description Administration tool for IPv4 packet filtering and NAT iptables AD chain rule specification options iptables RI chain rulenum rule specification options iptables D chain rulenum options iptables LFZ chain options iptables NX chain iptables E old chain name new chain name iptables P chain target options iptables h print this help information iptables is a user space application program on JetBox5630 that allows to configure the tables provided by the Linux kernel firewall implemented as different Netfilter modules and the chains and rules it stores Different kernel modules and programs are currently used for different protocols iptables applies to IPv4 ip6tables to IPv6 arptables to ARP and ebtables as a special for Ethernet frames A firewall using iptables is said to be a stateful firewall iptables splits the packet handling into three different tables each of which contain a number of chains The firewalling rules which we create are included within a particular chain The three tables are 1 filter used for packet filtering 2 nat used to provide packet modification capabilities NAT PAT and IP masquerading 3 mangle used for setting packet options and marking packet
24. ata from the TCP port or from the serial port Note that data monitoring is best effort if the controller port cannot keep up the data will be silently dropped A controller may only monitor one thing and a port may only be monitored by one controller monitor stop Stop the current monitor Korenix Appendix rem disconnect lt tcp port gt Disconnect the tcp connection on the port setporttimeout tcp port timeout Set the amount of time in seconds before the port connection will be shut down if no activity has been seen on the port setportconfig tcp port config Set the port configuration as in the device configuration in the etc ser2net conf file If conflicting options are specified the last option will be the one used Note that these will not change until the port is disconnected and connected again Options 300 1200 2400 4800 9600 19200 38400 57600 115200 set the various baud rates EVEN ODD NONE set the parity 1S7OPBIT 2STOPBITS set the number of stop bits 7DATABITS 8DATABITS set the number of data bits XONXOFF turns on off XON XOFF support JRTSCTS turns on off hardware flow control LOCAL ignores checks the modem control lines DCD DTR etc setportcontrol tcp port controls Modify dynamic port controls These do not stay between connections Controls are DTRHI DTRLO Turns on and off the DTR line R7SHI RTSLO Turns on and off the RTS line setportenable
25. cols over a serial link PPP can be used for direct serial connections using a null modem cable over a Telnet link and links established using a modem over a telephone line Usually pppd is called by other daemon like PPPoE PPTP and Wvdial 4 8 PPPoE Service name pppoe Description Point to Point Protocol over ethernet Config files etc ppp pppoe conf Start command Stop command Support command pppoe connect pppoe setup pppoe start pppoe stop pppoe status Default down 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 Network Feature Korenix You can just inpput pppoe setup to configure the PPPoE First you should obtain PPPOE username and password from your Internet provider Second filled in these parameters to pppoe setup dialog Ethernet Interface wan User name from your ISP Activate on demand No Primary DNS 168 95 1 1 Firewalling NONE pppoe setup Welcome to the Roaring Penguin PPPo some checks on your system to make sure the PPPOE properly Looks good Now pleas nter som USER NAME E client setup RIESE JL wall n client is installed aliae Jem e 3L p gt gt gt Enter your PPPoE user name default bxxxnxnx sympa
26. config file name You can specify other config file using the f options when starting the daemon e Check the log files for proper operation For example you can type less f var log zebra log to check the zebra log Keep in mind that you have to add the log file location to the respective daemon configuration file The administrator has two options to modify runtime configurations via the command line interface CLI 1 Preferred Use the integrated Zebra shell vtysh by typing vtysh vtysh expects its configuration to reside in etc vtysh conf 2 Telnet localhost port e g port 2601 connects to the ospfd Zebra uses ports from 2600 to 2607 for daemon connections Service zebra ripd ospfd bgpd Port 2601 2602 2604 2605 Example 1 Start zebra etc init d zebra start 2 Type vtysh to enter Zebra shell Hello this Copyright 1 s mode Korenix Network Feature 4 Display the current running config sh run JetBox5630 sh run figuration For all Zebra suppored command please refer http www zebra org zebra Command Index html HCommand 20Index 4 20 Ser2net program name ser2net Description ser2net is a Linux program which will connect a network to the serial port It could be like a bridge between the ethernet cable and the serial cable config file etc ser2net conf Usage c lt config file gt use a config file besides etc ser2net conf C config line
27. fig lan 2 up CIN Korenix Feature Korenix 5 5 LED Set program name let_set Description Control LED status Usage led_set g LED_NUM Set LED to Green led_set y LED NUM Set LED to Yellow led_set d LED_NUM Set LED to Off Example e Set LED 1 to green led_set g 1 e Set LED 1 to yellow led_set y 1 e Turn off LED 1 led set d 1 5 6 Serial Control JetBox5630 have on serial port that support RS232 RS422 RS485 4Wire The device name is dev ttyO2 program name serialctl Description Get Set Serial Port Configuration Usage serialctl g Get Serial Port Mode serialctl m 1 RS232 Mode serialctl m 2 RS422 Mode serialctl m 3 RS485 4 Wire Mode Example e Set serial port mode to RS232 serialctl m 1 e Get serial port status serialctl g Serial mode RS232 e Using microcom to test Remember to plug in RS232 lookback microcom D dev ttyO2 test test Korenix Korenix Feature Chapter 6 Programmer s Guide 6 1 Toolchain 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 Jetbox The cross compiling toolchain that comes with Jetbox5630 contains a suite of Korenix compilers and other tools as well as the libraries and headers that are necessary to compile applications for Jetbox5630 The build environment must be
28. g the SMB or CIFS protocol This is compatible with the LanManager protocol and can service LanManager clients These include MSCLIENT 3 0 for DOS Windows for Workgroups Windows 95 98 ME Windows NT Windows 2000 OS 2 DAVE for Macintosh and smbfs for Linux Example Edit Config File etc samba smb conf Samba configuration on a Linux or other UNIX machine is controlled by a single file etc smb conf This file determines which system resources you want to share with the outside world and what restrictions you wish to place on them E Network Feature Korenix 4 Global Settings global dos charset UTF 8 workgroup MYGROUP server string MYDATA max log size 50 security user encrypt passwords yes smb passwd file etc samba smbpasswd log file var log samba log smbd interfaces lam 192 108 10 100 2355 259 299 0 0 socket options TCP NODELAY SO RCVBUF 8192 SO SNDBUF 8192 4 Share Definitions tmp path tmp public yes read only no limi max HORS He max 1024 to minimum Windows limit 16384 ailed to load usr lib valid dat No such file or directory ting default valid table rocessing section tmp oaded services file OK FARNING lock directory var lock should have permissions WARNING state directory var lock should have permission WARNING cache directory var lock should have permission erver role ROLE STANDALONE Press enter to see a du
29. ging 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 program could be ioctl fd WDIOC KEEPALIVE sleep 10 The argument to the ioctl is ignored e Setting and getting the timeout To modify the watchdog timeout on the fly with the SETTIMEOUT ioctl driver has the WDIOF 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 Korenix Programmer s Guide int timeout 45 iioctl 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 octl fd WDIOC GE tim pre Ub 6 5 GPIO This section provides the usage information of GPIO Linux driver usage both in user and kernel space Driver Usage Kernel Level e Allocate memory to GPIO line can be achieved by doing gpio_request e Depending on the requirement set GPIO as input or output pin then set gpio value as high or low Setting the GPIO pin 30 as input EC Programmer s Guide Korenix User Space sysfs control e Enable GPIO sysfs support in kernel c
30. gram comes up normally as a daemon opens the TCP ports specified in the configuration file and waits for connections Once a connection occurs the program attempts to set up the connection and open the serial port If another user is already using the connection or serial port the connection is refused with an error message Options c config file Set the configuration file to one other than the default of etc ser2net conf C config line Handle a single configuration line This may be specified multiple times for multiple lines This is just like a line in the config file This disables the default config file you must specify a c after the last C to have it read a config file too n Stops the daemon from forking and detaching from the controlling terminal This is useful for running from init d Like n but also sends the system logs to standard output This is most useful for debugging purposes P pidfile If specified put the process id pid of ser2net in the pidfile replacing whatever was in that file previously A pidfile is not created by default you must specify this to create one Note also that this filename must be specific with the full path as ser2net will change directory to when it becomes a daemon when it u If UUCP locking is enabled this will disable the use of UUCP locks LXI Appendix Korenix Cisco IOS uses a different mechanism for specifying the baud rates than the mechanis
31. gument d must be an open file descriptor The third argument to ioctl is traditionally named char argp Most uses of ioctl however require the third argument to be a caddr_tor an int An ioctl reguest has encoded in it whether the argument is an in argument or out argument 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 Values If an error has occurred a value of 1 is returned and errno is set to indicate the error Please use the desktop Linux s man page for detailed documentation man ioctl js Programmer s Guide Korenix 6 3 RTC The device node is located at dev rtcO Jetbox supports Linux standard simple RTC control You must include linux rtc h 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 6 4 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 e Pin
32. irtual Private Network VPN using the Point to Point Tunneling Protocol PPTP Use this program to connect to an employer s PPTP based VPN or to certain cable and ADSL service providers Example The PPTP Server has the following information e The IP address of the server SSERVER e The authentication domain name SDOMAIN e The username you are to use SUSERNAME e The password you are to use SPASSWORD In the steps below substitute these values manually Edit the config file etc ppp options pptp client which sets options common to all tunnels iname SUSERNAME ipassword SPASSWORD irequire mppe Secrets for authentication debug ipty pptp SSERVER nolaunchpppd file etc ppp options pptp client The following picture is the success output with tunnel name test and server ip address 192 168 20 100 Korenix Network Feature hi IPCP IPCP If you are using a PPTP Server that does not require an authentication domain name omit the slashes as well as the domain name If you need to setup a PPTP server on Windows XP as a test target please see the following link 36 Network Feature Korenix 4 15 PPTP Server Service name Description A Point to Point potocol server Config files etc pptpd conf etc ppp chap secrets etc ppp options pptpd Start file etc init d pptpd Start command etc init d pptpd start Stop co
33. korenix JetBox 5630 Linux User Manual www korenix com Copyright Notice Copyright 2013 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 lg Overview Korenix Table of Content Chapter 1 Chapter 2 2 1 2 2 2 3 Chapter 3 3 1 3 2 3 3 3 4 3 5 3 6 Chapter 4 4 1 4 2 4 3 4 4 4 5 4 6 4 7 4 8 4 9 4 10 4 11 Copyright NOTICe HE 5 6 iet mtn irte Re rater en Ett ea Pt ETE EET 2 Acknowledgments ennn 6 ta ede ae rete EE ERST TERES EFI PRAES SERE as 2 Table of Content a5 edd ox SO Dea uii onus aiit Seton ond se iae Deu DUR
34. l deployment updates and peripherals The information in this chapter will be particularly useful when you need to run the same application on several JetBox units 3 1 System Version To determine the hardware capability of your JetBox and what kind of software functions are supported check the version numbers of your JetBox 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 JetBox5630 s back label To check the firmware version type Figure 3 1 Firmware version 3 2 Enable Disable Daemons The following daemons are enabled when the JetBox 5630 boots up for the first time Service name Description inetd internet daemons telnetd telnet daemon sshd secure shell daemon proftpd ftp daemon Type the command ps to list all processes currently running root root 4 root bin aga portmap dbus root root root root root root root root root root ud l n p var truni fudhcpc wan pid i wan root stenv sh bi lhastenv sh host usr lib lua usr lib lua root root root root proftpd ipting connection daemons status The etc init d directory is the repository for all available init scripts S0llogging Sl3portmap S20urandon 30alsa 30dbus S50p rof tpd S50sshd bgpd 4 Openvpa ospf pptpd rc local cK ICS rip udevstart x12tpd zebra etc init d S50sshd start
35. loworld 2 3 3 Uploading helloworld to JetBox5630 and Running the Program Use the following command to upload helloworld to the JetBox5630 via FTP Please refer to Chapter 3 3 to enable ftp server 1 From the PC type 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 binary ftp gt put helloworld i root server ftp 192 168 10 1 Connected to 192 168 10 1 192 168 10 1 i220 EMMA IT O Server Peon WAS i Insta Macio IEC 9 19 2 516 69 s 10 i Name 192 168 10 1 root root i331 Password required for root iPassword i230 User root logged in lu Getting Start Korenix tp gt binary system type is UNIX tp gt cd home R f 250 CWD command successful a 200 Type set to I f tp gt put helloworld helloworld remote helloworld ilocal 227 150 226 Opening Entering Passive Mode 1927 168 1 176 1976 BINARY mode data connection for helloworld Transfer complete 4455 bytes sent in 4 1e 05 secs 108658 54 Kbytes sec ftp gt bye 221 Goodbye 3 From the JetBox5630 console type chmod x helloworld it helloworld The word hello world will be printed on the screen firmware bin chmod a x hellow hell hello world sorld hello Korenix Getting Start Chapter 3 System Feature This chapter includes information about version contro
36. m described in RFC2217 This option sets the IOS version of setting the baud rates The default is RFC2217 s Prints the version of the program and exits p controlport Enables the control port and sets the TCP port to listen to for the control port A port number may be of the form host port such as 127 0 0 1 2000 or localhost 2000 If this is specified it will only bind to the IP address specified for the port Otherwise it will bind to all the addresses on the machine If the port number is zero that means that standard in out will be used for the only input output and only one port should be specified in the config This way it can be used from inetd Control Port The control port provides a simple interface for controlling the ports and viewing their status To accomplish this it has the following commands showport TCP port gt Show information about a port If no port is given all ports are displayed showshortport TCP port gt Show information about a port each port on one line If no port is given all ports are displayed This can produce very wide output help Display a short list and summary of commands exit Disconnect from the control port version Display the version of this program monitor type tcp port Display all the input for a given port on the calling control port Only one direction may be monitored at a time The type field may be tcp or term and specifies whether to monitor d
37. mmand etc init d pptpd stop Default down pptpd is the Poptop PPTP daemon which manages tunneled PPP connections encapsulated in GRE using the PPTP VPN protocol It may contain features like IP address management and TCP wrappers if compiled in Example option etc ppp options pptpd ilocalip 192 168 0 1 iremoteip 3L 912 LOS 0 6234 2518 192168007245 irequire mppe irequire mschap v2 Korenix Network Feature 4 16 L2TP Server Service name xl2tpd Description L2TP Layer 2 Tunneling Protocol Config files letc xl2tpd xl2tpd conf letc ppp chap secrets letc ppp options xl2tpd L2TP Layer 2 Tunneling Protocol is a tunneling protocol used for VPNs It uses the UDP port 1701 to communicate It doesn t have any encryption but we can encrypt the L2TP packets by using it with IPSec For theoretical information on L2TP you can visit its Wiki Example Edit the configuration file etc xl2tpd xl2tpd conf for LNS section for example a nd ip range 192 168 10 2 192 168 10 100 ieee ip 192 168 10 require chap yes require authentication yes pppopt file etc ppp options 12tp server xl2tpd length baie aO PPP debug yes For more information please refer to http linux die net man 5 xl2tpd conf EX Network Feature Korenix 4 17 L2TP Client Service name APAT ete Description L2TP Layer 2 Tunneling Protocol Config files letc xl2tpd xl2tpd conf letc ppp chap secrets letc ppp o
38. mp of your service definitions 0755 f s 075 is 075 for browsing to work 5 for browsing to work 5 for browsing to work global 20 MYDATA 192 168 10 100 255 255 255 0 petrambadloz sal max log si socket opti TCP NODELAY SO RCVBUF S192 SO SNDBUF 8192 path tmp read only guest ok Y Korenix Network Feature Smbpasswd Add user to access sharing folder First create a user in the local Use adduser command d for test Input samba user name and password and you can see the sharing folder 4 11 SNMP Service name snmpd Description SNMP Daemon Config files etc snmp snmpd conf Start command Stop command Support command snmpget snmpset Default down Net SNMP is a suite of applications used to implement SNMP v1 SNMP v2c and SNMP v3 using both IPv4 and IPv6 It supports RFC 1213 MIB II For more information read the following links about NET SNMP http www net snmp org wiki index php Tutorials EXA Network Feature Korenix 4 12 OpenVPN Service name openvpn Description A full featured SSL VPN Config files etc openvpn etc openvpn easy rsa OpenVPN is a full featured SSL VPN which implements OSI layer 2 or 3 secure network extension using the industry standard SSL TLS protocol supports flexible client authentication methods based on certificates smart cards and or username password credentials and allows user or group specific access control policies using
39. nge the IP address of LAN interface to 192 168 10 2 ifconfig lan lan Link encap Ethernet Hwaddr 00 12 77 50 04 CB inet addr 192 168 10 1 cas 92 168 10 255 LE 255 255 255 0 inet6 addr fes LAST MTU 1 Metric 1 O dropped 0 overrun frame 0 dropped 0 overruns arrier 0 512 94 9 KiB 192 168 10 2 lt encap Ethernet addr 192 168 1 f MULTICAST 9 dropped 0 overruns Sk dropped 0 overrun AO collision txqueuelen 512 RX bytes 217168 212 0 KiB TX bytes 97231 94 9 KiB Network Setting over the Network 2 3 Test Program Developing Hello c In this section we use the standard Hello programming example to illustrate how to develop a program for the JetBox5630 In general program development involves the following seven steps Step 1 Connect the JetBox5630 to a Linux PC Step 2 Install SDK on the Linux PC Step 3 Set the cross compiler and PATH environment variables a Getting Start Korenix Step 4 Code and compile the program Step 5 Download the program to the JetBox5630 via FTP Step 6 Debug the program e f bugs are found return to Step 4 e If no bugs are found continue with Step 7 Step 7 Back up the user directory distribute the program to additional JetBox5630 units if needed 2 3 1 Installing the SDK Linux The Linux Operating System must be pre installed in the PC before installing the JetBox5630 SDK Ubuntu core or compatible versions are recommended The S
40. ode to connect to a wireless AP or router for accessing to Internet AWUSO36NEH includes a convenient Utility for scanning available networks and saving preferred networks that users usually connected with Security encryption can also be configured by this utility AWUSO36NEH includes a convenient Utility for scanning available networks and saving preferred networks that users usually connected with Security encryption can also be configured by this utility Korenix Network Feature description Driver Name rtb370sta Driver file rt5370sta ko Config files etc Wireless RT2870STA RT2870STA dat Default Load driver on boot up 4 21 2 Configure with iwpriv Usage 1 iwpriv raO set parameters val Note Execute one iwpriv set command simultaneously 1 Config STA link with AP which is OPEN NONE Authentication Encryption iwpriv ra0 set NetworkType Infra iwpriv ra0 set AuthMode OPEN 4 iwpriv ra0 set EncrypType NONE VON see set SSIDS WAP Vs SSD iwpriv ra0 set NetworkType Infra iwpriv ra0 set AuthMode OPEN H 4 iwpriv ra0 set EncrypType WEP n iwpriv ra0 set Keyl AP s wep key f iwpriv ra0 set DefaultKeyID 1 iwpriv ra0 set SSID AP s SSID iwpriv ra0 set NetworkType Infra iwpriv ra0 set AuthMode SHARED iwpriv ra0 set EncrypType WEP iwpriv ra0 set Keyl AP s wep key iwpriv ra0 set DefaultKeyID 1 praia OS SiS SO mus ep SSID iwpriv ra0 set NetworkType Adhoc iwpriv ra0 se
41. onfiguration and build the kernel iDevice Drivers GPIO Support sys class gpio sysfs interface e Sysfs entries Export the particular GPIO pin for user control GPIO30 is taken as example iS echo 30 sys class gpio export NOTE GPIO s which are used already in the drivers can not be control from sysfs unless until driver export that particular pin e Run these commands for knowing what are the GPIO s already requested in the drivers r mount t debugfs debugfs sys kernel debug cat sys kernel debug gpio Korenix Programmer s Guide Chapter 7 Appendix 7 1 Firmware Upgrade Firmware upgrade can be done by the firmware up command 4 firmware up Usage f firmware file t firmware file tftp server y eigo o fs vel For example put the new firmware in a USB storage and plug in to JetBox5630 After it automatic mounted you can upgrade with the following command Where media usbO is the usb mounted directory and Jetbox5630 20140101 bin is the firmware name NOTE During firmware upgrading please do not power off device When upgrade complete the system will reboot automatically 7 2 USB Driver for GSM modems Some USB 3G modems use the driver USB SERIAL COPTION in linux kernel However not all user specified USB idProduct and idVendor are include in the driver For USB idProduct and idVendor not included in linux kernel v2 6 20 JetOS has other way to add it
42. ptions xl2tpd Example Edit the configuration file etc xl2tpd xl2tpd conf for LAC section for example pass ae ADE EI I RS TPR RS LESTER PS name korenix ns 102 168 10 2 pppoptfile etc ppp options xl2tp l2tp client ppp debug yes iname korenix password korenix etc init d x12tpd start echo c 12tp client gt var run xl2tpd 12tp control Point Pro 9 2 P t P etc init d x12tpd start lecho d 12tp client gt var run xl2tpd l2tp control Korenix Network Feature 4 18 L2TPv3 Service name Description L2TP was only ever designed to carry PPP traffic The new revision of the L2TP protcol known as L2TPv3 changes the protocol so that it can carry data frame formats other than PPP Each L2TPv3 session carries one data frame type which is agreed by both peers when the session is established and is effectively a virtual physical wire of that data link type It is often referred to as a pseudowire for that reason Many L2TP pseudowire types are already defined PPP ethernet VLAN HDLC Frame Relay and various ATM flavours Default 192 168 20 1 192 168 20 2 a T 192 168 10 100 T 192 168 1 77 L2TPv3 Tunnel 192 168 10 120 192 168 1 10 10 42 1 2 I2tpethO 10 42 1 1 route add net 192 168 1 0 netmask 255 255 255 0 gw 10 42 1 1 route add net 192 168 10 0 netmask 255 255 255 0 gw 10 42 1 2 Example Before to create L2TPv3 tunnel you first load I2tp eth and I2
43. root prompt to connect 4 wvdial ies WvDial Internet dialer version 1 61 i Cannot get information for serial port i Initializing modem gt Sending ATZ i Sending ATQO V1 El S0 0 C1 amp D2 FCLASS 0 i Sending AT CGDCONT 1 IP internet gt Modem initialized i Sending ATDT 994 i Waiting for carrier CONNECT 7200000 gt Carrier detected Starting PPP immediately gt jo o at Tus Jua amp 2547202 2010 Piel ot popece 1235 Using interface ppp0 ccs local IP acelresse 1155595221 151 remote IP address 10 64 64 64 primary DNS address 213 229 248 161 gt secondary DNS address 193 189 160 11 Testing the connection Use Ping to test the connection by querying the ISP s nameservers with a domain name eg www google com Open a terminal or terminal window and enter the ping command You should see replies like these E 2 eres AAA NARA mmm PING www google com 64 233 181 104 56 data bytes 64 bytes from 64 233 181 104 seq 0 tt1 45 time 359 476 ms 64 bytes from 64 233 181 104 seq 1 tt1 45 time 356 268 ms Korenix Network Feature 64 bytes from 64 233 181 104 seq 2 ttl 45 time 346 154 ms 64 bytes from 64 233 181 104 seq 3 ttl 45 time 336 108 ms www google com ping statistics 4 packets transmitted 4 packets received 0 packet loss round trip min avg max 336 108 349 501 359 476 ms Hanging UP Hang up with ctrl C hold down the Control
44. s for further filtering or routing The filter table is the default table for any rule It is where the bulk of the work in an iptables firewall occurs This table contains three chains Korenix Network Feature 1 INPUT used for traffic which is entering our system and belongs to an IP address which is on our local machine 2 OUTPUT used for traffic which originated on the local system otherwise known as the firewall 3 FORWARD used for traffic which is being routed between two network interfaces on our firewall There are three main targets for a rule within the filter table 1 ACCEPT allows the packet to be passed through the firewall without any noticeable interaction 2 DROP simply drops the packet as if it has never been in the system 3 REJECT drops the packet then sends a ICMP reply back to the client telling it why the connection failed Example Add rules The basic syntax of an iptables command is This would add a rule into the INPUT chain which matches any packet with a source address in the 192 168 20 0 subnet If a packet matches this criteria then it would use the ACCEPT target which simply allows the packet on through Remove rules To delete the first rule in the chain we would do List rules To list the rules we have on our system use Flush rules To flush drop all the rules we can use A more complete tutorial can be found at http www linode com wiki index php Netfilter IPTables
45. t AuthMode OPEN iwpriv ra0 set EncrypType NONE iwpriv ra0 set SSID Adhoc s SSID Ex Network Feature Korenix gt Turn off the wireless interface urity mode t id rity mode open d B m 4 21 3 Configure with wpa_supplicant wpa_supplicant is the IEEE 802 1X WPA component that is used in the client stations It implements key negotiation with a WPA Authenticator and it controls the roaming and IEEE 802 11 authentication association of the wireless driver In JetBox5630 if you want to configure wireless with WPA encryption We recommend youuse wpa_supplicant to set up Example We want to connect to a AP with WPA and TKIP encryption First we need to edit config file etc wpa_supplicant_ra0 conf Pea E mere AA A SER REAP RANE RANE ASE EMO network ssid KorenixAP2 key mgmt WPA EAP WPA PSK I 2 T jE8021X NON s pairwise TKIP group CCMP TKIP WEP104 WEP40 psk 1234567890 For more information please refer to http linux die net man 8 wpa supplicant http www freebsd org cgi man cgi query2wpa supplicant conf amp sektion 5 Korenix Network Feature 4 22 wvdial Connecting to the internet via wvdial wvdial is a Point to Point Protocol dialer it dials a modem and starts pppd in order to connect to the Internet When wvdial starts it first loads its configuration from etc wvdial conf wvdial conf The configuration file etc wvdial conf is the equivalent to
46. t Name or IP address Port Bel 192 168 10 11 22 Features Connection type Window C Raw Telnet C Rlogn SSH C Serial Appearance x Dahavio Load save or delete a stored session Translation Saved Sessions Selection Colours Connection Data Proxy Telnet Delete Rlogin I SSH Serial Default Settings Load Save Close window on exit C Always Never Only on clean exit Windows PuTTy setting 2 2 Configure Ethernet Interface JetBox s network setting can be modified with the serial console or over the network 2 2 1 Modifying Network Settings with the Serial Console In this section we use the serial console to modify JetBox s network settings e Change Network Configuration Follow the instructions given in a previous section to access JetBox s Console Utility via the serial Console port and then type vi etc network interfaces to edit network configuration file with vi editor Korenix Getting Start EN 7 113 115200 T File Edit Setup Control Window Help Configure Loopback auto lo wan lan iface lo inet loopback iface lan inet iface wan inet dhcp fetc network interfaces 1 12 8 Edit Network configuration file e Static and Dynamic IP address Static IP address As shown in below 4 fields must be modified address netmask broadcast and network The default IP addresses are 192 168 10 1 iface lan inet s
47. tatic address 192 168 10 1 netmask 255 255 255 0 broadcast 192 168 10 255 network 192 168 10 0 10 Getting Start Korenix Dynamic IP addresses By default the Jetbox is configured for static IP addresses on LAN port and dhcp on WAN interface To configure LAN port to request an IP address dynamically remove the original settings and add the following line Default setting for LAN port Default setting for WAN port iface lan inet static iface wan inet dhcp address 192 168 10 1 netmask 255 255 255 0 broadcast 192 168 10 255 network 192 168 10 0 Default Gateway When static IP Address setting is used add a default gateway is to set another keyword gateway For example iiface wan inet static address 192 168 1 2 netmask 255 255 255 0 broadcast 192 168 1 255 network 192 168 1 0 gateway 192 168 1 1 This will set default gateway to 192 168 1 1 on WAN port 2 2 2 Static and Dynamic IP address After the etc network interfaces file have been modified issue the following command to apply the network settings immediately 2 2 3 Modifying Network Settings over the Network Same the previous section IP settings can be modified over the network too There is another way to change the IP address without modifying the file etc network interfaces Korenix Getting Start but the new settings will not be saved to the flash disk For example type the command ifconfig lan 192 168 10 2 to cha
48. tico ca 7360011 hinet net INTERFACE gt gt gt Enter the Ethernet interface connected to the DSL modem default eth0 wan Do you want the link to come up on demand gt gt gt Enter the demand value default DNS iS nO or stay up continuously Pleas nter the IP address of your ISP s primary DNS server gt gt gt Enter the secondary DNS server address here PASSWORD gt gt gt Please enter your PPPoE password Then use the pppoe start command to start dial to connect network Korenix Network Feature 4 9 NFS program name mount Description A NFS client Usage mount t nfs o nolock NFS Server Address directory mount point Example A NFS server export it s root directory with IP address 192 168 1 10 want to mount to JetBox s mnt directory mount t nfs o nolock 192 168 1 10 root mnt NOTE Read the following links for more information about setting up a NFS server e http nfs sourceforge net nfs howto e http nfs sourceforge net nfs howto ar01s04 html 4 10 Samba Service name smbd Description Server to provide SMB CIFS services to clients Config files etc samba smb conf Start command etc init d samba start Stop command etc init d samba stop Default down smbd is the server daemon that provides file sharing and printing services to Windows clients The server provides filespace and printer services to clients usin
49. ting traffic that is less than or equal to the specified rate is received whereas traffic that exceeds the rate is dropped For egress rate limiting traffic that is less than or equal to the specified rate is sent whereas traffic that exceeds the rate is dropped You can program separate transmit Egress Rule and receive Ingress Rule rate limits at each port by ethtool ethtool e D ort rate limit ethtool E I limit ingress R type e Only 2 own Mult Mbps 1 no limit Default Example Set port 1 ingress rate is 20Mbps and ingress type is Broadcast Unknown Multicast i ethtool E lan 1 ingress 20 type 2 4 ethtool e lan 1 Rate ile Sibelius Ingress Rate 20 Mbps Ingress Type Broadcast Unknown Multicast Egress Rate 0 Mbps Packet type The packet types of the Ingress Rule listed here include Broadcast Only Broadcast Unknown Multicast Broadcast Unknown Multicast Unknown Unicast or All The packet types of the Egress Rule outgoing only support all packet types Ingress Rate Valid values are from 1Mbps 1000Mbps The step of the rate is 1 Mbps Default value of Ingress Rule is 10 Mbps Egress Rate Valid values are from 1Mbps 100Mbps The step of the rate is 1 Mbps And 100Mbps 1000Mbps The step of the rate is 10 Mbps Default value of Egress Rule is 0 Mbps O stands for disabling the rate control for the port EXE Korenix Feature Korenix 5 3 SFP and Copper Combo In JetBox5630
50. tp ip driver modprobe 12tp eth modprobe 12tp ip ion support L2TPy3 Used by Tainted P LN Network Feature Korenix Using sbin ip command to create L2TPv3 tunnel Site A 10 42 1 1 e sbin ip l2tp add tunnel tunnel id 3000 peer tunnel id 4000 encap udp local 192 168 20 1 remote 192 168 20 2 udp sport 5000 udp dport 6000 sbin ip 12tp add tunnel tunnel id 4000 peer tunnel id 3000 encap udp local 192 168 20 2 remote 192 168 20 1 udp sport 6000 udp dport 5000 session id 2000 peer session id 1000 Now the link should be usable Add static routes as needed to have data sent over the new link In Site A ping d 42 1 2 Korenix Network Feature route add net 192 sk 255 255 255 0 gw 10 42 1 2 Flags Metric Ref 5 0 0 O 0 0 0 Q O 0 Q wan sbin ip 12tp del tunnel tunnel id 3000 sbin ip 12tp del session tunnel id 3000 session_id 1000 Service name zebra Description Zebra is an advanced routing software package that provides TCP IP based routing protocols Config files etc zebra conf etc init d zebra etc init d zebra start Default down There are four routing daemons in use and there is one manager daemon e ospfd ripd bgpd e Zebra LXI Network Feature Korenix Configuration options e Each of the daemons has its own config file For example zebra s default config file name is etc zebra conf e The daemon name plus conf is the default
51. ven below Default IP address Netmask LAN 192 168 10 1 255 255 255 0 WAN DHCP 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 To connect to a hub or switch connected to your local LAN use a straight through Ethernet cable The default IP address and Netmask are shown above To login type the Login name and password as requested The default values as following Korenix Getting Start Login root Password none c Telnet 192 168 10 1 SoM uat SELS MCN D SN IN SX NUN UE NY http 00w korenixembedded com irmware 8 2 2013 18 22 14 53 46 Telnet console screen You can proceed with the configuration of JetBox s network settings when you reach the bash command shell Configuration instructions are given in the next section 2 1 3 SSH Console We also supports an SSH Console to offer users with better security options Click on the link putty to download PuTTy freeware and set up an SSH console for JetBox in a Windows environment The following figure shows an example of the configuration that is required le Getting Start Korenix iS PuTTY Configuration Category Session Basic options for your PuTTY session Logging M Specify the destination you want to connect to Terminal Keyboard Hos
52. view Chapter 2 Getting Start 2 1 System login Users can enter the JetBox Linux environment via the user name root and no password is required login root password none 2 1 1 Serial Console The serial console port gives users a convenient way of connecting to JetBox console utility This method is particularly useful when using JetBox 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 115200bps Parity None Data bits 8 Stop bits 1 Flow Control None Serial console port setting Once the connection is established the following windows will open ie Getting Start Korenix W COM30 115200baud Tera Term Y T File Edit Setup Control Window Resize Help INIT Entering runlevel 3 Welcome to the Korenix Embedded Linux development environment JetBox5630 login root llogin 1468 root login on tty00 HM u http www korenixembedded com Firmware 0 2 2013 10 22 14 53 46 Serial console screen To log in type the Login name and password as requested The default values as following Login root Password none 2 1 2 Telnet Console If you know IP addresses and netmasks then you can use Telnet to connect to JetBox The default IP address and Netmask for each port is gi

JetBox 8210 User Manual

Contents

Download Pdf Manuals

Related Search

Related Contents