Korenix JetBox 8100, JetBox 8100-L, JetBox 8100-LM User Manual

JetBox 8100 User Manual_Linux_1.1

JetBox 8100 User Manual

Embedded Linux

Korenix Technology Co., Ltd.

Reproduction without permission is prohibited.

Customer Service: KoreCARE@korenix.com

V1.1

tBox 8100 User Manaual_Linux_1.

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.

iii

JetBox 8100 User Manual_Linux_1.1

Table of Contents

JetBox 8100 User Manual Embedded Linux .................................................. i

Acknowledgments .............................................................................................ii

Table of Contents .............................................................................................. iii

Chapter 1 Overview .......................................................................................... 1

1.1 Introduction .................................................................................. 1

1.2 Hardware Specifications ............................................................. 2

1.3 Software Specifications .............................................................. 3

Chapter 2 Getting Started ................................................................................ 4

2.1 Powering on JetBox 8100 ........................................................... 4

2.2 Connecting JetBox 8100 to a PC ............................................... 5

2.2.1 Serial Console ..................................................................... 5

2.2.2 Telnet Console ..................................................................... 6

2.2.3 SSH Console ........................................................................ 7

2.2.4 JetView Console .................................................................. 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.c ............................................................... 14

2.4.3 Uploading “test” to JetBox 8100 and Running the

Program ............................................................................... 14

Chapter 3 Managing Embedded Linux ......................................................... 16

3.1 System Version Information ...................................................... 16

3.2 Enabling and Disabling Daemons ............................................ 16

3.3.1 Setting the Time Manually ................................................ 19

3.3.2 NTP Client ........................................................................... 20

3.3.3 Updating the Time Automatically .................................... 21

3.4 Connecting Peripherals- USB Mass Storage .......................... 22

Chapter 4 Managing Communications ......................................................... 23

4.1 Telnet daemon ............................................................................. 23

4.2 FTP daemon ................................................................................. 24

4.3 DNS ............................................................................................... 25

4.4 Web Service- goahead ............................................................... 26

4.5 IPTABLES

..................................................................................... 27

tBox 8100 User Manaual_Linux_1.

4.6 Dial-up Service-PPP ................................................................... 28

4.7 PPPoE ........................................................................................... 28

4.8 SNMP ............................................................................................ 29

4.9 Open VPN ..................................................................................... 29

Chapter 5 Programmer’s Guide ..................................................................... 30

5.1 Partition Table ............................................................................. 30

5.2 Linux Tool Chain Introduction .................................................. 30

5.2.1 Compiling Applications and Libraries ............................ 31

5.2.2 Tools Available in the Host Environment ....................... 32

5.3 Device API .................................................................................... 32

5.4 RTC (Real Time Clock) ............................................................... 33

5.5 WDT (Watch Dog Timer) ............................................................. 34

5.6 UART ............................................................................................ 35

5.7 Make File Example ...................................................................... 36

Chapter 6 JetView ............................................................................................ 37

6.1 Overview ...................................................................................... 37

6.2 JetView for JetBox 8100 ............................................................ 37

Chapter 7 Recovery CD ................................................................................... 38

7.1 Overview ...................................................................................... 38

7.2 Booting with Recovery CD ........................................................ 38

7.2.1 Plugging USB CD-ROM into USB port ............................ 38

7.2.2 Auto-Run Recovery Procedure ........................................ 39

Chapter 8 Appendix ......................................................................................... 42

8.1 System Commands .................................................................... 42

8.2 Chart Index .................................................................................. 45

8.3 Customer Service ....................................................................... 46

JetBox 8100 User Manaual_Linux_1.1

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 withstand a wide range of temperatures is suitable for industrial severe environment. It is equipped with AMD Geode LX800 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.1

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 II 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/Mouse

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 Consumption

15W Max.

Mounting

DIN Rail

Construction

Sheet metal case

Dimensions

120.0mm(D)* 44.2mm(W)*123.0mm(H)

Operating Temperature

5℉~158℉(-15℃ ~ 70℃), 5 to 95% RH(w/o HD)

Storage Temperature

-4℉~176℉(-20℃ ~ 80℃), 5 to 95% RH(w/o HD)

Net Weight

0.7 kg

EMC

CE/FCC class A

Table 1-1 Hardware specifications

JetBox 8100 User Manaual_Linux_1.1

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

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

dropbear

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

Table 1-2 Software specifications

JetBox 8100 User Manaual_Linux_1.1

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.

Figure 2-1 Power connector location

Power Input

12VDC~24VDC

JetBox 8100 User Manaual_Linux_1.1

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.

Figure 2-3 Serial console screen

JetBox 8100 User Manaual_Linux_1.1

To log in, type the Login name and password as requested. The default values as following. Login: root Password: none

Notice 1: In the JetBox 8100, COM1 (RS232) is reserved for serial console and

COM2 (RS-232/422/485, JP2, BIOS select) is reserved for Modbus Gateway (Optional

SW).

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:

Password: none

Figure 2-5 Telnet console screen

JetBox 8100 User Manaual_Linux_1.1

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 section.

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

PuTTy(freeware) to set up an SSH console for JetBox 8100 in a Windows environment. The following figure shows a exmple of the configuration that is required.

Figure 2-6 Windows PuTTy setting

JetBox 8100 User Manaual_Linux_1.1

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 (You may download update JetView from Korenix Website). The following figure shows a example of the configuration.

Figure 2-7 JetView setting

JetBox 8100 User Manaual_Linux_1.1

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 /etc/network.conf' to edit network configuration file with vi editor.

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:

JetBox 8100 User Manaual_Linux_1.1

DHCP_CLIENT, IPADDR, DEFAULT_ROUTE and NETMASK. The default IP addresses are 192.168.10.1.

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.

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.1

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.conf. For example, type the command #ifconfig eth0 192.168.10.2 to change the IP address of LAN interface to 192.168.1.2.

+ 35 hidden pages

Korenix JetBox 8100, JetBox 8100-L, JetBox 8100-LM User Manual

Specifications and Main Features

Frequently Asked Questions

User Manual