Artila Matrix-513 User manual

Matrix-513
Linux ARM9 Industry Box Computer
User Guide
Version 1.0.1
Copyright © Artila Electronics Co., Ltd. All Rights Reserved.

Table of Contents
1. Introduction................................................................................................................ 1
1.1 Packing List......................................................................................................................... 1
1.2 Optional Accessory............................................................................................................. 1
2. Layout......................................................................................................................... 2
3. Pin Assignment and Definition.................................................................................. 3
3.1 Reset Button ....................................................................................................................... 3
3.2 Power LED.......................................................................................................................... 3
3.3 Ready LED.......................................................................................................................... 3
3.4 Link / Act LED ..................................................................................................................... 3
3.5 Serial Port LED ................................................................................................................... 3
3.6 Ethernet Port....................................................................................................................... 3
3.7 Serial Port (DB9 Male)........................................................................................................ 3
3.8 Serial Console Port............................................................................................................. 4
3.9 Digital I/O Port..................................................................................................................... 4
3.10 Factory Default Settings...................................................................................................... 4
3.11 Power on and System Boot up ........................................................................................... 5
3.12 Inittab and Run Levels ........................................................................................................ 5
3.13 Default Started Service....................................................................................................... 5
3.14 Network Settings................................................................................................................. 6
3.15 File System ......................................................................................................................... 6
3.16 Devices List......................................................................................................................... 7
3.17 Utility Software.................................................................................................................... 7
3.18 Mounting USB Device by udev........................................................................................... 8
3.19 Web Page Directory............................................................................................................ 8
3.20 Adjust the System Time...................................................................................................... 8
3.21 SSH Console....................................................................................................................... 9

3.22 Welcome Message ............................................................................................................. 9
3.23 Putty Console Software ...................................................................................................... 9
3.24 ipkg Package Software Management................................................................................. 9
3.25 Install GNU Toolchain....................................................................................................... 10
3.26 Getting Started with the Hello Program ............................................................................ 10
3.27 Auto Start Program on Boot.............................................................................................. 11
4. Artila Utility Software................................................................................................12
4.1 update............................................................................................................................... 12
4.2 setuart............................................................................................................................... 12
4.3 version............................................................................................................................... 12
4.4 gpioctl................................................................................................................................ 13
5. Loader Menu..............................................................................................................14
6. Frequently Asked Question......................................................................................15
6.1 Forgot Password............................................................................................................... 15
6.2 Forgot the IP Address....................................................................................................... 15
6.3 System Fail to Boot........................................................................................................... 15
7. System Recovery ......................................................................................................16
7.1 Update Image.................................................................................................................... 16
7.2 Make Filesystem............................................................................................................... 16
7.3 Recovery Env.................................................................................................................... 16
7.4 Show Info.......................................................................................................................... 16
7.5 Reboot............................................................................................................................... 16
7.6 Update Image Starts......................................................................................................... 17
7.7 Update Image Completes ................................................................................................. 17
7.8 Make Files System Starts ................................................................................................. 17
8. Appendix....................................................................................................................18
8.1 Utility Collection................................................................................................................. 18
8.2 ipkg Software Package Management............................................................................... 18
8.3 Loading wireless driver process........................................................................................ 20
8.4 Set WiFi Client to connect to the MobilePhone ................................................................ 21

Matrix-513 User Manual
3
8.5 Set 3G mode connection .................................................................................................. 23
8.6 Update and build-up GCC environment............................................................................ 24
8.7 WiFi and 3G Assembling .................................................................................................. 25
8.7.1 Open top shell................................................................................................................... 25
8.7.2 Add on 3G module and antenna....................................................................................... 25
8.7.3 Finish 3G and wifi module assembling. ............................................................................ 26

Matrix-513 User Guide
‧1‧
1. Introduction
Matrix-513 is an ARM9-based Linux ready industrial computer. The key features are as follow:
Atmel AT91SAM9G45 400MHz w/MMU
32-KByte Data Cache and 32-KByte Instruction Cache
128MB DDR2 RAM, 256MB NAND Flash on board
Two 10/100 Mbps Ethernet
Two USB 2.0 high speed (480 Mbps) Host ports, one USB device port
Multimedia Card Interface for Micro SD memory card
Four RS-232 / 422 / 485 ports
One full size and one half size miniPCIe card socket (USB bus only)
Two isolated (2500 Vrms) digital input
One relay (30VDC @1A) form A or B output (jumper select)
Ready for wireless LAN and 3G miniPCIe module (USB bus)
9 to 48VDC power input
Pre-installed Standard Linux 2.6.38 kernel and file system
GNU tool chain available on Artila FTP
Optional DIN RAIL mounting adaptor
1.1 Packing List
Matrix-513 Box Computer
Wall mount bracket
1.2 Optional Accessory
CBL-F10M9-20 (91-0P9M9-001): Console Cable (10Pin Header to DB9 Male, 20cm)
DK-35A (36-DK35A-000): DIN RAIL Mounting Kit
Pigtail-WiFi-1001-20 (91-CST16-001): IPEX to RP-SMA Female Coaxial Cable, 20cm
Pigtail-3G-1001-20 (91-CST17-001): IPEX to SMA Female Coaxial Cable, 20cm
Ant-WiFi-1001 (91-CRF38-001): 5dBi External WiFi Antenna
Ant-3G-1001 (91-CRF37-001): 5dBi External 2G / 3G Antenna
M-9001 (ZA-CAR00-004): 802.11b/g/n USB Half-size miniPCIe Card, Ralink RT5390U, 1T2R
M-9011 (CM5000): Full-size miniPCIe 2G / 3G Card, with SIM Socket
PWR-12V-1A (31-62100-000): 110~240VAC to 12VDC 1A Power Adapter

Matrix-513 User Guide
‧2‧
Reset
Power
+ -
LAN 1
LAN 2
USB
USB-C
DIO
Remove the cap to install ANT
2. Layout

Matrix-513 User Guide
‧3‧
3. Pin Assignment and Definition
3.1 Reset Button
Press the “Reset” button to activate the hardware reset. You should only use this function if the
software does not function properly.
3.2 Power LED
The Power LED will show solid green if power is properly applied.
3.3 Ready LED
The Ready LED will show solid green if Matrix-513 complete system boot up. If Ready LED is off
during system boot up, please check if power input is correct. Turn off the power and restart
Matrix-513 again. If Ready LED is still off, please contact the manufacture for technical support.
3.4 Link / Act LED
When Ethernet port are connected to the network, Link/Act will show solid green and if there is traffic is
the Ethernet port, this LED will flash.
3.5 Serial Port LED
These eight dual color LEDs indicate the data traffic at the serial ports. When RXD line is high then
Green light is ON and when TXD line is high, Yellow light is ON.
3.6 Ethernet Port
Pin No.
Signal
1
ETx+
2
ETx-
3
ERx+
6
ERx-
3.7 Serial Port (DB9 Male)
Pin No.
RS-232
RS-422
RS-485
1
DCD*
TXD-
-
2
RXD
TXD+
-
3
TXD
RXD+
DATA+
4
DTR*
RXD-
DATA-
5
GND
GND
GND
6
DSR*
-
-
7
RTS
-
-
8
CTS
-
-
9
-
-
-
Port 1~4
Note: * Port 2 only

Matrix-513 User Guide
‧4‧
3.8 Serial Console Port
Serial console port is located inside the box at CON1. You need to use console cable (91-0P9M9-001)
to access it.
Serial Console RS-232
1
N/C
2
N/C
3
RXD
4
N/C
5
TXD
6
N/C
7
N/C
8
N/C
9
GND
10
N/C
To use the serial console port, you need to open the metal case of Matrix-513 and the console
connector is near the reset button and LEDs. Use any terminal software such as hyper terminal and
configure the setting as follow:
Baud Rate: 115200
Data bits: 8
Parity: N
Stop bit: 1
Terminal type: VT100
3.9 Digital I/O Port
1
DO Out
2
DO Com
3
DI 1
4
DI 2
5
DI Com
3.10 Factory Default Settings
LAN 1 IP Address: 192.168.2.127
LAN 2 IP Address: 192.168.3.127
Login: root or guest (telnet guest only)
Password: root or guest (telnet guest only)
Serial Console Port:
Baud rate: 115200
Data format: 8 Bits, No Parity, 1 Stop bit (N,8,1)
Flow Control: None
Terminal type: VT100
1
9
2
10
1
2
3
4
5

Matrix-513 User Guide
‧5‧
3.11 Power on and System Boot up
Once system is correctly power on, it will start boot Linux kernel and mount file system. You can use
Ethernet and telnet to login. Once kernel loaded, it will find /sbin/init and execute it. The
initialization configuration is at /etc/inittab.Once boot up, you can use telnet to login.
3.12 Inittab and Run Levels
Inittab contains information of system initialization. The system initialization script /etc/rcS.d runs first
then the run level 5 /etc/rc5.d. Linux uses run level for system setup and the default run level is
number 5. Please refer to introduction to linux (http://tille.garrels.be/training/tldp/) for information
about run level.
Following is the run levels setting:
Run level 0: halt
Run level 1 is single user (login and service are disabled)
Run level 2~5 are multiple users
Run level 6 is reboot
Please refer to loader menu section for selection of run level.
3.13 Default Started Service
1. amgrd (Artila broadcast search daemon)
2. ssh (secured shell) with sftp
3. syslog/klogd (system and kernel log)
4. telnet server (disable root with /etc/securetty)
5. ftp server (vsftp)
6. web server (lighttpd)
7. Ready LED (debug LED for internal use)

Matrix-513 User Guide
‧6‧
3.14 Network Settings
Use vi editing tool to edit the /etc/network/interfaces for network setting. The Wireless LAN
configuration file is located at:
/etc/Wireless/RT5370STA/RT5370STA.dat
Modify the file for the wireless LAN settings. Please refer to the RT5370_WIFI_Setup
Matrix-513 supports USB WLAN adaptor (Ralink RT2571 and RT5370sta). You can enable the driver
module (rt5370sta) by adding rt5370sta in:
/etc/modules
3.15 File System

Matrix-513 User Guide
‧7‧
The NAND Flash memory of Matrix-513 contains Boot loader (uBoot), Linux Kernel, Root File System
and user disk (\home). The file system and disk space are shown as follow:
3.16 Devices List
The supported devices are shown at /dev directory. Following list are most popular ones:
1. ttyS0: serial console port
2. ttyS1 to ttyS4: serial port 1 to port 4
3. sda to sdb: USB flash disk
4. ttyUSB0 to ttyUSB1: USB RS-232 adaptor (usbserial.ko)
5. gpio: General Purpose digital I/O
6. ttyACM0 and ttyACM1: USB Modem (CDC compliant)
7. spi0, spi1: SPI bus controller
8. mmc: SD driver
9. rtc0: m41t81 real time clock device (default)
10. rtc1: rs5c372a real time clock device (M-501 compatible)
3.17 Utility Software
Matrix-513 Linux includes busybox utility collection and Artila utility software and there are placed at:
/sbin
/bin
/usr/bin
/use/sbin
Please refer to Appendix for the utility collection list.

Matrix-513 User Guide
‧8‧
3.18 Mounting USB Device by udev
Matrix-513 supports udev which can automatically load the device driver when plugging your USB
device.
3.19 Web Page Directory
The web pages are placed at /usr/www and the /etc/lighttpd.conf contains the lighttpd web server
settings. The home page name should be index.html.
3.20 Adjust the System Time
To adjust the RTC time, you can follow the command:
date MMDDhhmmYYYY
where
MM=Month (01~12)
DD=Date (01~31)
hh=Hour
mm=minutes
YYYY= Year

Matrix-513 User Guide
‧9‧
hwclock –w
To write the date information to RTC.
User can also use NTP client utility on Artila FTP to adjust the RTC time.
ntpclient [time server ip]
3.21 SSH Console
Matrix-513 supports SSH. If you use Linux computer, you can use SSH command to login Matrix-513.
The configuration of SSH and key are located at /etc/ssh.
The key generation program is available at /usr/bin.
3.22 Welcome Message
To modify the welcome message, user can use text edit to modify the /etc/motd.
3.23 Putty Console Software
For Windows user, you can download the putty software at
http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html to use SSH to login Matrix.
3.24 ipkg Package Software Management
ipkg is a light software package utility. It can be used to install, upgrade and remove the software
package for Matrix-513.Currently user can use ipkg to install the software package from Artila FTP.
You can find the configuration at ipkg.conf.
When Matrix-513 is connected to network and issue command:
ipkg update
To update the package list and use
ipkg install
To install software package and
ipkg remove
To remove software

Matrix-513 User Guide
‧10‧
ipkg list
To list available software
ipkg list_installed
To list software installed
Please refer to Appendix for more about ipkg.
3.25 Install GNU Toolchain
Find a PC with Linux OS installed as followed:
Fedore 7, ubuntu 7.04, OpenSUSE 10.2, Mandriva 2008, Debian 5.0, Centos (RedHat) 5 and above.
Login as a root user then copy the arm-linux-4.3.2.tar.gz to root directory of PC. Under root directory,
type following command to install the Matrix-513 Toolchain:
#tar -xvfj arm-linux-4.3.3.tar.bz2
The toolchain file name are:
arm-linux-gnueabi-gcc
arm-linux-gnueabi-g++
arm-linux-gnueabi-strip
Version: gcc 4.3.3, glibc 2.9, binutils 2.18
For Windows user, please download the toolchain from CodeSourcery at
http://www.codesourcery.com/sgpp/lite/arm/portal/package4547/public/arm-none-linux-gnueabi/arm-2
009q1-203-arm-none-linux-gnueabi.exe
The toolchain file name are:
arm-none-linux-gnueabi-gcc
arm-none-linux-gnueabi-g++
arm-none-linux-gnueabi-strip
Version: gcc 4.3.3, glibc 2.8, binutils 2.19
3.26 Getting Started with the Hello Program
There are many example programs on Artila FTP. To compile the sample you can use the Make file
and type:
make
To compile and link the library. Once done, use ftp command
ftp 192.168.2.127
Then login with password. Use bin command to set transfer mode to binary
ftp>bin
To transfer the execution file to Matrix-513 user disk (/home/guest) and use
chmod +x file.o

Matrix-513 User Guide
‧11‧
To change it to execution mode and
./file.o
to run the program.
3.27 Auto Start Program on Boot
To start a program on boot, you can use /etc/rc.local.
For example to use vi to edit rc.local
hello &
exit 0
Hello will be executed after system boot up. rc.local has the similar function as /etc/rc in Matrix-513.

Matrix-513 User Guide
‧12‧
4. Artila Utility Software
The introduction of Artila utility software as follow:
4.1 update
Update loader, environment file and kernel image. Type update--help to find the command usage.
Update can only operate under supervisor mode (password: root). Please use command su and login
as root.
4.2 setuart
Configure serial port setting. An example show as followed to configure port 1 as RS-485 interface
with baud rate 921600.
4.3 version
Find out the version of OS.

Matrix-513 User Guide
‧13‧
4.4 gpioctl
The gpio can be configured by gpioctl and the usage is as shown followed.

Matrix-513 User Guide
‧14‧
5. Loader Menu
Loader menu helps user to select the run level of system boot up. User need to use serial console to
enter loader menu. Please configure the serial port of terminal as follow:
Baud Rate: 115200
Data bits: 8
Parity: N
Stop bit: 1
Flow Control: None
Terminal type: VT100
Once power up Matrix-513, please repeatedly keying “@” and you will see the loader menu appear as
follow:
If you miss the timing, please power on again the Matrix-513 and do it again. Select U will prompt the
run level selection message. Run level 0 is halt, run level 1 is single user (disable login and service).
Run level 2~5 are multiple users and run level 6 is reboot. To view the run level configuration, please
check:
/etc/inittab