Artila Matrix 522 User manual

Matrix522 UserGuide
Introduction:
Matrix522 isanARM9-basedLinuxreadyindustrialcomputer.Thekey
featuresareasfollow:
1. ARM926EJ-SARMThumbProcessor400MHzw/MMU
2. 32-KByteData Cacheand 32-KByteInstructionCache
3. 64MBSDRAM, 128MBNAND Flashonboard
4. Two10/100 MbpsEthernet
5. TwoUSB2.0fullspeed(12Mbps)HostPorts,oneUSBdevice port
6. MultimediaCardInterface forMicroSDmemorycard
7. Two3-in-1RS-232/422/485ports
8. Two2500 VrmsfullyisolatedCAN 2.0A/2.0Bports
9. 21 programmableDigitalI/Oport
10. 9to40VDCpowerinput
11. Pre-installedStandardLinux2.6.29OS
12. GNUtoolchainavailableinArtilaCD
13. SupportSocketCAN andCANopenLibrary
14. OptionalDINRAILmountingadaptor
Matrix522Layout
PackingList
1. Matrix522 BoxComputer
2. Wallmountbracket
3. ArtilaCD
OptionalAccessory:
1. Consolecable:CB-DB2CON-100
2. Serialcable: CB-DB9FDB9M-100
3. DK-35A:DINRAILMounting Kit
25
12.5
4
167.5
5.9
104
Reset
Button
Version1.1
40
1
10

PinAssignmentand Definition
PinNo. Function PinNo. Function
1 DIO0 14 DIO13
2 DIO1 15 DIO14
3 DIO2 16 DIO15
4 DIO3 17 DIO16
5 DIO4 18 DIO17
6 DIO5 19 DIO18
7 DIO6 20 DIO19
8 DIO7 21 DIO20
9 DIO8 22 GND
10 DIO9 23 GND
11 DIO10 24 VCC3
12 DIO11 25 VCC5
13 DIO12
Note:
1. VCC3:3.3VDCoutput
2. VCC5:5VDCoutput
3. GND:DigitalGround
ResetButton
Press the Reset”buttontoactivatethehardwarereset.
Youshouldonlyusethisfunctionifthesoftwaredoes
notfunctionproperly.
PowerLED
ThePowerLEDwill showsolidgreenifpoweris
properlyapplied
ReadyLED
TheReadyLEDwill showsolidgreenifMatrix522
completesystembootup.IfReadyLEDisoffduring
systembootup,pleasecheckifpowerinputiscorrect.
Turn offthepowerand restartMatrix522again. If
ReadyLEDisstilloff, pleasecontactthemanufacture
fortechnicalsupport.
Link/ActLED
WhenEthernet portareconnectedtothenetwork,Link/
Actwill showsolidgreenandifthereistrafficinthe
Ethernet,thisLEDwillflash.
Serial/CANPortLED
ThedualcolorLEDs indicatethedatatrafficat the
serialbusandCAN bus.WhenRXD lineishighthen
GreenlightisON andwhenTXD lineishigh,Yellow
lightisON.
Ethernet Port
SerialPorts:
Port1~2:3-in-1SoftwareConfigurable
RS-232/422/485
NOTE:OnlyPort2hasfullmodemsignals
DSR,DTR, DCD
DigitalI/OPort(DB25Female)
SerialConsolePort:
SerialconsoleportislocatedinsidetheboxatCON1. You
needtouseconsolecable(CBL-F10M9-20) toaccess it
Tousetheserialconsoleport,youneedtoopenthemetal
caseofMatrix-522andtheCON1connectorisnearthe
resetbuttonandLEDs.Usercanalsoredirecttheserial
consoleporttoanyoneof theserialportbycommand /
setconsole.Pleaseusesetconsole —helpfortheusage.
1
9
2
10
Serial ConsoleRS-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
SerialPort (DB9 Male)
PinNo. 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 --- ——
Port1~2
CANPort (DB9 Male)
Matrix-522featurestwo2500 VrmsfullyisolatedCAN
ports.A120OhmterminatorisappliedbetweenCAN_H
andCAN_LthatcanbedisabledbyremovingjumperJ7
andJ8.AshieldinggroundisavailableatPin3of theDB9
connector.

InittabandRun levels:
Inittabcontainsinformationof systeminitialization.The
systeminitializationscript /etc/rcS.d runsfirstthentherun
level5 /etc/rc5.dMatrix-522usesrunlevelforsystemsetup
andthedefaultrunlevelisnumber5.Pleasereferto
introductiontolinux(http://tille.garrels.be/training/tldp/) for
informationaboutrunlevel. Followingistherunlevels
setting:
Runlevel0:halt
Runlevel1issingleuser(loginandservice aredisabled)
Runlevel2~5aremultipleusers
Runlevel6isreboot.
Pleaserefertoloadermenusectionforselectionof runlevel
PoweronandSystembootup
Once Matrix-522iscorrectlypoweron,itwillstartbootLinux
kernelandmountfilesystem. YoucanuseEthernetandtelnet
andloginMatrix-522.Once kernel loaded,itwillfind /sbin/
init and executeit.Theinitializationconfigurationisat /etc/
inittab.Once bootup,youcanusetelnet tologinMatrix-522.
FactoryDefaultSettings
LAN 1IPAddress:192.168.2.127
LAN 2IPAddress:192.168.3.127
Login:rootorguest(telnetguestonly)
Password:rootorguest(telnet guestonly)
SerialConsolePort:
Baud rate:115200
Dataformat:8Bits,NoParity, 1Stopbit (N,8,1)
FlowControl:None
Terminaltype:VT100 NetworkSettings
Use vi editing tooltoedit the /etc/network/interfaces fornetwork
setting. Thedefaultsetting isstaticIP192.168.2.127. Matrix-522
alsosupportsWireless LAN.Use
wireless_essidXXX
wireless_keyYYY
ToaddSSIDandWEPkeyifnecessary. XXX isSSIDand YYY
isWEPKey
Matrix-522supportspopularUSBWLAN adaptor. Please
contactArtilaforthemostupdatedriversupport.
File System
The128MBNAND FlashmemoryofMatrix-522containsBoot
loader(uBoot), LinuxKernel,RootFileSystemanduserdisk
(\home).Thefilesystemanddiskspace areshownasfollow
Defaultstartedservice
1. amgrd (Artilabroadcastsearchdaemon)
2. ssh(securedshell)withsftp
3. syslog/klogd (systemandkernel log)
4. telnetserver(disablerootwith /etc/securetty)
5. ftpserver(vsftp)
6. webserver(lighttpd)
7. ReadyLED(debug LEDforinternaluse)
Insertkernelmodule
Toinsertkernel modulewhilesystembootup,pleaseuse vi to
edit /etc/modules toaddmoduletoloade.g.
rt73usb
ToloadtheUSBWLANadaptor.

UtilitySoftware:
Matrix522 includesbusyboxutilitycollectionand Artilautility
softwareandthereareplacedat:
/sbin
/bin
/usr/bin
/use/sbin
PleaserefertoAppendixfortheutilitycollectionlist
Deviceslist
Thesupporteddevicesareshownat/devdirectory. Following
listaremostpopularones:
1. ttyS0:serialconsoleport
2. ttyS1tottyS2:serialport1toport2
3. sdatosdb:USBflashdisk
4. ttyUSB0tottyUSB1:USBRS-232 adaptor(fdti_sio.ko)
5. rtc:Real TimeClock
6. gpio:GeneralPurposedigitalI/O
7. ttyACM0andttyACM1:USBModem(CDCcompliant)
8. mmc:SDdriver
Note:can0and can1arenetworkdevicesunder SocketCAN
WelcomeMessage
Tomodifythewelcomemessage, usercanusetexteditto
modifythe/etc/motd.
Adjustthesystemtime
ToadjusttheRTCtime,youcanfollowthecommand
dateMMDDhhmmYYYY
where
MM=Month(01~12)
DD=Date (01~31)
hh=Hour
mm=minutes
YYYY= Year
hwclock w
TowritethedateinformationtoRTC
UsercanalsouseNTPclientutilityinArtilaCDtoadjustthe
RTCtime.
ntpclient[timeserverip]
SSHConsole
Matrix522 supportsSSH. IfyouuseLinuxcomputer,youcan
useSSHcommandtologinMatrix522.Theconfigurationof
SSHandkeyarelocatedat
/etc/ssh
Thekeygenerationprogramisavailableat /usr/bin
PuttyConsoleSoftware
ForWindowsuser, youcandownloadtheputtysoftwareat
http://www.chiark.greenend.org.uk/~sgtatham/putty/
download.htmltouseSSHtologinMatrix-522
ipkgpackagesoftwaremanagement
ipkgisalightsoftwarepackageutility. Itcanbeusedto
install,upgradeand removethesoftwarepackageforMatrix-
522.Currentlyusercanuseipkg toinstallthesoftware
packagefromArtilaFTP.Youcanfind theconfigurationat
ipkg.conf
WhenMatrix-522isconnectedtonetworkand issuecommand
ipkgupdate
Toupdatethepackagelistanduse
ipkginstall
toinstallsoftwarepackageand
ipkgremove
toremovesoftware
ipkglist
tolistavailablesoftware
ipkglist_installed
tolistsoftwareinstalled
PleaserefertoAppendixformoreabout ipkg
MountingExternalStorageMemory
Tofindoutthedevice nameof theexternalmemorydevice
whichplug intoMatrix522,youcanusethecommand
dmesg|grepsd
dmesg|grepmmc
Tofindoutthedevice type(sda,sdbormmc)
Anduse
mount/dev/sda1
mount/dev/mmc
tomounttheUSBdiskorSD cardand folderislocal at
media/sda1 or /mnt/sda1
WebPageDirectory
Thewebpagesareplacedat /usr/www andthe
/etc/lighttpd.conf containsthelighttpdwebserversettings.The
homepagenameshouldbe index.html

SocketCAN:
Matrix522 supportsSocketCAN whichimplementsastandard
networkinterface forCANprotocolsforLinux.Unlikeother
CAN implementationforLinuxbasedoncharacterdevices,
SocketCAN usesBerkeleysocketAPI,theLinux networkstack
andimplementsCAN device driversasnetworkinterfaces.
TheCAN socketAPIhasbeendesignedassimilaraspossible
totheTCP/IPprotocolstoallowprogrammers, familiarwith
networkprogramming,toeasilylearnhowtouseCAN sockets.
Pleaserefertothedocument:
\Example\CanBus\socketcan\socketCAN.txt
inArtila CDfortheSocketCAN API.
libsocketcan:
Thelibsocketcanlibraryallowsyoutocontrolsomebasic
functionsinsocketcanfromuserspace.Pleasereferto:
\Example\CanBus\libsocketcan
Fortheexamplesprogramforlibsocketcan
ConfigureCAN:
ToconfigureCANdevice, youcanuseutilityprograms:
/canconfig
/candump
/canecho
/cansend
/cansequnce
Usercanalsouse ip commandtoconfigureCAN e.g.
/iplinksetcan0down
/iplinksetcan0typecanbitrate250000
/iplinksetcan0up
/ip detailslinkshow can0
Thebootup CANbit ratesetting isat /etc/can_config
Format:[canport]:[bit rate]
0:250000
1:250000
Bit rate:10K~1M
CANOpen:
TheArtilaCDalsoincludesCanFestival3open
source forCANOpen.Pleasereferto
\example\CanBus\canfestival
and http://www.canfestival.org forCanfestival

Install GNUToolChain
Find aPCwithLinux OSinstalledasfollowed:
Fedore7, ubuntu7.04, OpenSUSE10.2, Mandriva2008,
Debian5.0,Centos(RedHat)5andabove.
Loginasarootuserthencopythearm-linux-4.3.2.tar.gztoroot
directoryof PC. Underrootdirectory, typefollowingcommand
toinstalltheMatrix522ToolChain
#tar-xvfjarm-linux-4.3.3.tar.bz2
Thetoolchainfilenameare
arm-linux-gnueabi-gcc
arm-linux-gnueabi-g++
arm-linux-gnueabi-strip
Version:gcc 4.3.3,glibc2.9, binutils2.18
ForWindowsuser,pleasedownloadthetoolchainfrom
CodeSourceryat
http://www.codesourcery.com/sgpp/lite/arm/portal/
package4547/public/arm-none-linux-gnueabi/arm-2009q1-203-
arm-none-linux-gnueabi.exe
Thetoolchainfilenameare
arm-none-linux-gnueabi-gcc
arm-none-linux-gnueabi-g++
arm-none-linux-gnueabi-strip
Version:gcc 4.3.3,glibc2.8, binutils2.19
GettingstartedwiththeHelloprogram
TherearemanyexampleprogramsinArtila CD.Tocompilethe
sampleyoucanusetheMakefileandtype
make
Tocompileand linkthelibrary. Once done, useftpcommand
ftp192.168.2.127
Thenloginwithpassword. Usebincommandtosettransfer
modetobinary
ftp>bin
totransfertheexecutionfiletoMatrix504 userdisk(/home/
guest)and use
chmod+xfile.o
Tochangeittoexecutionmodeand
./file.o
toruntheprogram
Autostartprogramonboot:
Tostartaprogramonboot, youcanuse /etc/rc.local
Forexampletouse vi toedit rc.local
hello&
exit0
Hellowill beexecutedaftersystembootup.rc.local hasthe
similarfunctionas /etc/rc inMatrix-522
ArtilaUtilitySoftware:
Theintroductionof Artilautilitysoftwareasfollow:
1. update :updateloader,environmentfileand kernel image.
Type update help tofindthecommandusage
Updatecanonlyoperatedundersupervisormode(password:
root).Pleaseusecommand su andloginasroot
3. version: findouttheversionof OS.
2. setuart: configureserialportsetting.Anexampleshowas
followedtoconfigureport1asRS-485 interface withbaudrate
921600. 4. gpioctl: Thegpiocanbeconfiguredby gpioctl and the
usageisasshownfollowed.
3. setconsole: UnlikeMatrix-510whichsharestheserial
consoleportwiththeserialport3, Matrix-522usesdedicated
pinsforserialconsole(debug port). setconsole command
allowsusertoredirect theserialconsoleporttoanyoneof the
fourserialportof Matrix-522.Thereforeusercanavoid
openingthemetalcasetoaccess theserialconsole.

FrequentlyAskedQuestion
1. Forgotpassword:
Ifyouforgotthepasswordforlogin, pleaseuseserialconsoleand
userunlevel1tobootsystem. Usepasswdtochangethepassword
setting.
2. ForgottheIPaddress
IfyouforgottheMatrix-522IPaddress, youcanusetheJava
ManageravailableinArtilaCDtosearchtheIPaddress of Matrix-
522
OruseserialconsoleporttofindouttheIPaddress by
#ifconfig
LoaderMenu
Loadermenuhelpsusertoselecttherunlevelofsystemboot
up.Userneedtouseserialconsoletoenterloadermenu.
Pleaseconfiguretheserialportof terminalasfollow:
Baud Rate:115200
Databits:8
Parity:N
Stopbit: 1
FlowControl:None
Terminaltype:VT100
Once powerupM-518,pleaserepeatedlykeying @”and
youwill see theloadermenuappearasfollow:
Ifyoumiss thetiming, pleasepoweronagaintheMatrix-522
anddoitagain.SelectUwill prompttherunlevelselection
message.Run level0ishalt, runlevel1issingleuser
(disableloginandservice ).Runlevel2~5aremultiple
usersand runlevel6isreboot. Toviewtherunlevel
configuration,pleasecheck
/etc/inittab 3. Systemfailtoboot
Ifyoumess up therootfilesystemandmakethesystemfailtoboot,
Matrix-522willautomaticallyswitchtobootfromDataflashfile
systemandaconsolemenuwillshowup atconsoleporttohelpuser
performsystemrecovery. SystemRecoverySection willtellyou
howtorecoverthesystem.

SystemRecovery
IfNAND Flashfilesystemdoesfail, DataFlashfilesystem
will automaticallybootup andaConsoleMenuatconsole
portwillappearasfollow:
1. UpdateImage: thisoptioncanrecovertheloader, kernel
andfilesystembyusinganUSBdisk.TheUSBdisk
containstheimagesfileswiththepathasfollow:
Loader: m522/m522.alf
Kernel: m522/m522K
Filesystem: m522/m522R
ThefilesareavailableinArtilaCD.PleaseprepareanUSB
diskandcopytheimagefilestoitbeforechoosngthisoption.
2. MakeFilesystem: thisoptionisusedtocreatecustomized
filesystem. Beforeusing thisfunction,youneedtocopythe
folderof mkimage522 intheArtilaCDtoanUSBdisk.This
functionwillcreateanewfilesystemimageforusersand
theycanuseittoduplicatethecustomizedfilesystemtoother
Matrix-522.
3. RecoveryEnv.:Theoptionwill recovertheenvironment
filesasdefaultsetting.Usethisfunctiononlywhenthe
NAND filesystemcrash.
4. ShowInfo:Showtheversioninformationof Matix-522
5. Reboot: ReboottheNAND flashfilesystem.
UpdateImageStarts
UpdateImageCompletes
MakeFilesSystemStarts
Note:
1. UseArrowkeysup and downtoselectionthefunctions
2. UseArrowkeysleftandrighttogotohigherorlowerlevels
ofmenuscreen
3. Toforce systemgointoDataFlashbooting,repeatedly
keying !”(Shift+1)rightafterMatrix-522poweron.

UtilityCollection
1. busyboxv1.14.2-tinyutilitycollection
2. sysvinitv2.86-standard Linux initialization
3. util-linux-mount/umountv2.12r-supportlongfilename
4. sshv4.6p1–supportsftpserver
5. usbutilsv0.7–USBidprogram
6. lighttpdv1.7-webserver
7. wgetv1.9.1–usedinipkgsoftware
8. iptablesv1.3.8–IProuting
9. ipkgv.0.99.163–softwarepackagemanagement
10. procpsv3.2.7–supportwebminprocess management
11. vsftpd v2.0.5–ftpserver
12. bashv3.2-GNUshell
13. wireless_toolsv29–wireless LAN utility
14. ppp v2.4.3-pppdialuputility
15. psmicsv22.2–procpssupplement
16. Canutils4.0.6
17. artilautilityv.1.1–handyutilityaddedbyArtila
Youcanfind moreutilityatArtilaMatrix-504CDanduse
ipkgtoinstalltheutility.
Appendix
ipkgsoftwarepackagemanagement
Matrix-522uses ipkg tomanagethesoftwareinstallation, upgradeand
removal.Artilawill continuouslyadd thekernelmoduleandutilityat
ourftpserver,usercaninstallthesesoftwarefromArtila’sftpserver.In
additionusercanalsosetup yourftpservertoupdatethesoftwareyou
want.ToinstalltheutilityfromArtila ftp,pleaseuse vi toedit the /etc/
ipkg.conf
src/gzarm ftp://ftp:[e-mail]/AT9G20/Artila-CD/Linux/Utility
src/gzkernel ftp://ftp:[e-mail]/AT9G20/Artila-CD/Linux/
modules
YoucanalsocopytheUtilityandmodulefolderfromArtilaCDtoa
USBdisk,thenuseUSBdisktoinstallthesoftwarebychangingthe
ipkg.conf
src/gzusb_arm ftp://root:root@127.0.0.1/media/sda1/Utility
src/gzusb_kernel ftp://root:root@127.0.0.1/media/sda1/modules
MakesuretheUSBdiskiscorrectlymounted, nowusecommand
ipkgupdate
toupdatethepackagelistanduse
ipkginstallwebmin
Toinstallwebmin. Webminisaweb-basedinterface tosystem
administration.Tostartwebmin, goto /etc/webmin and type
startwebmin
Thenyoucanusebrowsertovisit Matrix-522port10000
Remembertousecommand
depmod a/lib/modules/2.6.29.4/modules.dep
Toupdatethedependencylistifnewkernel module
wereadded.
ThewebminforMatrix-522providesfollowingmodules:
1. Webmin:webminconfiguration
2. System: systemboot, processandlogmanagement
3. Server:ApacheandSSHserverconfiguration
4. Network:networkconfiguration
5. Hardware: RTCsetting
6. Others:Filemanager,uploadand download

Martin-Kollar-Strasse 9
D-81829 München
Tel: [phone]
Fax: [phone]
[email protected]
Justus-von-Liebig-Ring 7-9
D-25451 Quickborn
Tel: [phone]
Fax: [phone]
[email protected]
Gentsesteenweg 1154-C22
Chaussée de Gand 1154-C22
B-1082 Brussel / Bruxelles
Tel: [phone]
Fax: [phone]
[email protected]
Elektrostraat 17
NL-7483 PG Haaksbergen
Tel: [phone]
Fax: [phone]
[email protected]
St. Mary’s House, Church Lane
Carlton Le Moorland
Lincoln LN5 9HS
Tel: [phone]
Fax: [phone]
[email protected]
Warwitzstrasse 9
A-5020 Salzburg
Tel: [phone]
Fax: [phone]
[email protected]
Nørregade 15
DK-9240 Nibe
Tel: [phone]
Fax: [phone]
[email protected]
Germany Germany
BelgiumThe Netherlands
United Kingdom
Austria
Denmark
For more information: www.texim-europe.com
Partner in Electronic Components & Supply Chain Solutions