www.vscom.deOnRISCOnRISCOnRISCOnRISCOnRISCOnRISCOnRISCOnRISCOnRISCOnRISCOnRISCOnRISCOnRISCOnRISCOnRISCOnRISCOnRISCOnRISCOnRISCOnRISCOnRISCOnRISCOnRISC
1 IntroductionOnRISC Model Alekto Alekto LAN AlenaCPU ARM9 32-bit RISC CPU,166MHzARM9 32-bit RISC CPU,166MHzARM9 32-bit RISC CPU,166MHzRAM 64MB SDRAM
1 IntroductionOnRISC Model VS-860 Alekto 2CPU AM3517 (ARM Cortex-A8) AM335x (ARM Cortex-A8)RAM 256MB DDR2 256MB DDR2Flash Memory on Board N.A. N.A.Ser
2 Getting Started2. Getting Started2.1. Connect to OnRISC via Serial LinkConnect the OnRISC to the serial port of your PC and start a terminal softwar
2 Getting Started2.3. Configure NetworkNow you can configure network interfaces by editing /etc/network/interfaces. The IP addressesfor eth0, eth1 and w
2 Getting Started3. execute /etc/init.d/networking restart2.4. Start Programming2.4.1. KS8695 based DevicesConnect to the OnRISC either via serial lin
2 Getting Starteduser@debian:~/examples$ makegcc -O0 -g3 -Wall ioctls.c -o ioctlsgcc -O0 -g3 -Wall ioctls2.c -o ioctls2gcc -O0 -g3 -Wall rawsrv.c -o r
3 Software Configuration3. Software ConfigurationThe OnRISC comes with a preinstalled Debian GNU/Linux on ARM5operating system. The com-plete system ima
3 Software Configuration3.1.2. OMAP3 based DevicesThe system images for OMAP3 based devices have two partitions:1. FAT partition having files need to in
3 Software Configuration3.3. Activating and Deactivating ServicesSome services will be started as daemons at system startup and hence reduce the amount
3 Software ConfigurationKERNEL=="rtc0", SYMLINK+="rtc"KERNEL=="i2c-0", SYMLINK+="i2c"3.5. Time ZoneThe default
The software described in this manual is furnished under a license agreement and may be usedonly in accordance with the terms of that agreement.Copyri
3 Software Configuration– netcat– socat– Samba client and server– Apache2 web server– Courier mail server– NTP client and server– sredird RFC2217 serve
3 Software Configuration3.7.5. SambaSamba18is an Open Source/Free Software suite that has, since 1992, provided file and print ser-vices to all manner o
3 Software Configuration4. cp /etc/apache2/sites-available/default /etc/apache2/sites-available/ssl5. ln -s /etc/apache2/sites-available/ssl /etc/apach
3 Software ConfigurationConfiguration Client For client configuration edit /etc/ntp.conf as follows:### client:/etc/ntp.conf ###############driftfile /va
3 Software Configuration3.7.10. Connecting to X-WindowThe xdm manager23lets you connect to the X-Server. Following configuration issues should beconside
4 Network Services and Tools Provided by OnRISC4. Network Services and Tools Provided by OnRISCThe OnRISC can be accessed via Ethernet for remote usag
4 Network Services and Tools Provided by OnRISCwpa_supplicant -iwlan0 -c/etc/wpa_supplicant.conf -dd -DwextFurther information about configuring the WL
4 Network Services and Tools Provided by OnRISCTo activate a GSM connection configure proper PIN and APN. After that uncomment auto ppp0and restart net
4 Network Services and Tools Provided by OnRISC1. select “Join a Personal Area Network”2. search for the OnRISC3. select it and try to connect. Enter
4 Network Services and Tools Provided by OnRISCFor further information see:man vsftpd4.7. RFC2217Internal serial interfaces of the OnRISC can be made
ContentsContents1. Introduction 91.1. OnRISC Family . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91.2. How to Read th
4 Network Services and Tools Provided by OnRISC4.8. Socketcandsocketcand is a daemon that provides access to CAN interfaces on a machine via a network
5 Software Development5. Software Development5.1. Environment5.1.1. Compile your software directly on the OnRISCYou can start programming directly on
5 Software DevelopmentOMAP3 based Devices Debian 7.0 will be supplied with OMAP3 based devices. It is based onan arm-linux-gnueabihf 4.7 toolchain. To
5 Software Development5.2. Linux Kernel5.2.1. From Subversion Repository or Archive (old kernels)The OnRISC uses 2.6 series Linux kernel. The source c
5 Software DevelopmentFigure 2: Kernel Configuration Menu5.2.2. From Buildroot RepositorySince kernel version 3.0 there are no more Subversion reposito
5 Software Development4. execute nc -l -p 5000 > /var/zImage this will start Netcat listening on the port 50005. on your development host execute n
5 Software Development5.3. Programming Examples RepositorySome programming examples were prepared to show/test the abilities of OnRISC hardware. Thela
5 Software Development– mount -t cifs -o username=user //192.168.254.253/onrisc /home/user/onrisc_examples– enter password– exit– cd onrisc_examplesNo
5 Software Developmenthost> mkdir insight-arm; cd insight-armhost> ../src/configure --target=arm-linux --program-prefix=arm-linux-host> makeh
6 OnRISC Hardware API6. OnRISC Hardware APIKS8695 based Devices Such hardware as digital I/O, buzzer, serial interfaces will be controlledvia IOCTL co
Contents4.9.1. Samba . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304.9.2. NFS . . . . . . . . . . . . . . . . . .
6 OnRISC Hardware API• GPIO_CMD_GET_CTRL/GPIO_CMD_SET_CTRL - set/get data direction register value• GPIO_CMD_GET_IRQMASK/GPIO_CMD_SET_IRQMASK - set/ge
6 OnRISC Hardware APIGroup nr. Pins0 0-31 4-52 6-7Table 4: Digital I/O Groups6.2. Buzzer for KS8695 based DevicesThe OnRISC provides a buzzer for acou
6 OnRISC Hardware API6.4. Serial Interfaces6.4.1. KS8695 based DevicesRS232/422/485 mode switching The serial ports can operate in one of the three mo
6 OnRISC Hardware APIRS485 receive control There are two modes to handle own transmitted messages in 2-wiremode:• with echo (EPLD_RS485_RTS_ECHO, EPLD
6 OnRISC Hardware API50 i f ( r e t < 0)51 {52 p er r o r ( " is p ee d " ) ;53 return − 1;54 }55 r e t = c f s e t o s p e e d (&s e
6 OnRISC Hardware API6.4.2. OMAP3 based DevicesSerial interfaces on OMAP3 devices use FTDI USB-to-serial converter chips (FT2232D). Both portsappear i
6 OnRISC Hardware API6.5. CANSocketCAN provides access to CAN controller on all CAN capable OnRISC devices49(refer toTable 1). SocketCAN50is a set of
6 OnRISC Hardware API6.6. I2CI2C54(Inter-Integrated Circuit) is a multi-master serial computer bus. In the OnRISC integratedI2C controller is already
6 OnRISC Hardware APIFigure 4: Watchdog Timer Support6.9. Read Hardware Parameters like MAC Address, Serial Number etc.6.9.1. KS8695 based DevicesSuch
6 OnRISC Hardware API6.10. Change Screen Resolution (Alekto 2 Only)Alekto 2 supports tree resolutions:• 640x480• 800x600• 1024x768 (default)The resolu
Contents8.8. View Board Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598.9. Hardware Test . . . . . . . . . . . . .
7 /proc-Extensions for the KS8695 based Devices7. /proc-Extensions for the KS8695 based DevicesIn the /proc/vscom directory reside several files to man
8 BIOS for KS8695 based Devices8. BIOS for KS8695 based DevicesBIOS (Basic Input Output System) lets you configure your OnRISC e.g. configure how to boo
8 BIOS for KS8695 based Devices8.1. System ConsoleChoosing this menu item, you’ll get to the system console. To return to the main menu press’Ctrl+D’
8 BIOS for KS8695 based Devices8.3. Configure Network SharesHere you can configure a Windows share (SMB) to boot from (see Figure 9). To use this featur
8 BIOS for KS8695 based Devices8.4. Configure Network ParameterHere you can configure the network parameters (see Figure 10). You can choose between get
8 BIOS for KS8695 based Devices8.5. Configure Miscellaneous ParameterFollowing parameters can be set up here (see Figure 11):• Date• Time• Start-Timeou
8 BIOS for KS8695 based Devices8.6. Edit BootscriptThe bootscript can be edited here (see Figure 12):Figure 12: BIOS: Edit BootscriptMay 2014 OnRISC U
8 BIOS for KS8695 based Devices8.7. BIOS UpdateBIOS update can be done either via serial connection or via network connection58.(a) Update prompt (b)
8 BIOS for KS8695 based DevicesUpdate procedure via network connection Push the reset button till the WLAN LED is on.Send the appropriate *.b64 file vi
8 BIOS for KS8695 based Devices8.8. View Board InformationShows some board information (see Figure 17)Figure 17: BIOS: View Board Information8.9. Hard
ContentsC.10.WLAN Button Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80C.11.All-in-one Test for Alena . . . . . . . .
9 Debian Installation9. Debian InstallationThe installation of the Debian 5.0.3 Lenny60will be described in this section. The installationinstructions
9 Debian Installation(a) Shared Folder Properties(b) Boot Image FilesFigure 18: Windows Share9.2. Starting Debian InstallerExit BIOS and save changes
9 Debian InstallationFigure 20: Low Memory Mode9.3. Choosing CD-ROMDebian Installer will try to find a device driver for your USB CD-ROM. This could fa
9 Debian Installationnames.Figure 23: Network configurationIn the case of network installation you’ll be asked to configure package mirror as in Figures
9 Debian Installation9.6. Partition DisksAfter scanning your target storage media, you’ll be asked to continue with partitioning (see Figure26). Answe
9 Debian InstallationFigure 28: Partitioning SchemeFigure 29: Partition Table TypeFigure 30: Partition TableMay 2014 OnRISC User Manual 65
9 Debian Installation9.7. Setting PasswordsAfter partitioning the disks and setting up the clock, you’ll be asked to set a password for ’root’and crea
9 Debian Installation9.11. Finish the InstallationDue to the lack of the official support by Debian there is no boot loader (see Figure 32). Afterreboot
10 Buildroot10. BuildrootBuildroot62is a set of Makefiles and patches that allows you to easily generate a cross-compilationtoolchain, a root filesystem
10 Buildroot10.3. Copying the Created Image to the SystemOpenNetCom You can copy the newly created image via RedBoot and console. This will require as
List of FiguresList of Figures1. Compilation example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152. Kernel Configuration
10 Buildroot10.5. Compiling Your Own SoftwareThere are following ways on how to get your software to be build and installed on the system usingBuildro
A Debian Maintenance NotesA. Debian Maintenance NotesA.1. Debian Package ManagementDebian uses following utilities for the package management66:• dpkg
A Debian Maintenance NotesA.2. Keep a Track on Disk UsageTo get the list of all installed packages with its installed sizes execute:dpkg-query -W -f’$
B onrisctool.pyB. onrisctool.pyOnRISC configuration utility provides following features to configure OMAP3 based devices:• configure serial interfaces (R
B onrisctool.pyB.2. Configure OTG/CFastBoth VS-860 and Alekto2 use USB OTG port in two modes: OTG and CFast. The mode can beswitched both via jumper an
B onrisctool.pyB.5. Get EEPROM Infoonrisctool.py shows hardware related data like MACs, serial number etc. stored in EEPROM ifcalled without parameter
C hwtestC. hwtestThe test utility for the OnRISC hardware is provided in both BIOS and preconfigured Debiansystem images and consists of the following
C hwtest--cfg <file name> configuration file--cycles <number> number of test cycles. Default: infinite--size <bytes> test file size in b
C hwtestTX ↔ RXRX ↔ TXRTS ↔ CTS, RICTS, RI ↔ RTSDTR ↔ DSR, CDDSR, CD ↔ DTRGND ↔ GNDTable 10: Serial Test Cable Wiring1 CD2 TXD3 RXD4 DTR5 GND6 DSR7 RT
C hwtestThe I/O pins must be connected with each other for the IO test (using 4,7k resistors for example)(see Table 11). The optical isolated input ch
List of TablesList of Tables1. OnRISC Products Based on ARM9 KS8695 SoC . . . . . . . . . . . . . . . . . . . . 102. OnRISC Products Based on OMAP3 So
C hwtesthwtest --cycles=1 --i2c --testrtcexecutes the RTC test onlyhwtest --cycles=1 --i2c --testlcdexecutes the LCD test onlyC.7. EPLD TestEach UART
C hwtestC.11. All-in-one Test for AlenaIt is possible to test all serial ports, CAN and GPIO without reattaching the cables. Followingcomponents will
C hwtestC.12. Build Noteshwtest can be built either with GNU make or CMake. Both Makefile and CMakeLists.txt aresupplied. The command line parameter p
D hwtest-qtD. hwtest-qtHwtest-qt provides various hardware tests in both console and graphical environment. To get GUIstart ghwtest-qt instead of hwte
D hwtest-qtD.6. Bluetooth TestBluetooth test needs an active Bluetooth device like headset, Bluetooth dongle etc. to find duringthe scan.hwtest-qt -qws
E Managing System ImagesE. Managing System ImagesSystem images provide 1:1 copy of the Debian OS installed on a CF/microSD card. The image hasthe size
E Managing System ImagesFigure 37: Win32 Disk ImagerE.1.1. Burn System Image to CF/microSD Card1. Insert CF/microSD card in your card reader and execu
E Managing System ImagesE.1.2. Make An Image From CF/microSD Cardvsimgtool drive_name image.binwhere drive_name is the name showed by vsimgtool --list
F EclipseF. EclipseF.1. Installation NotesEclipse is an open source community whose projects are focused on building an extensible develop-ment platfo
F EclipseF.2. DebuggingAssuming your OnRISC has IP address 192.168.1.66. Start your ioctls executable on the OnRISCwith following command:gdbserver :9
1 Introduction1. Introduction1.1. OnRISC FamilyThe OnRISC is an ARM-based RISC industrial embedded computer family. The great variety ofinterfaces lik
F EclipseFigure 39: Eclipse debug: Debugger tabFigure 40: Eclipse debug: Commands tabMay 2014 OnRISC User Manual 90
H Frequently Asked Questions (FAQ)G. Cross-Compiler ToolsName Descriptionar Creates and updates static library filesas Assemblerg++ C++ compilercpp C p
Index/proc-extentions, 50ABI, 31AbiWord, 24Apache, 21APN, 26apt, 71BIOS, 51Bluetooth, 27buzzer, 41CAN, 46can0, 46CDT, 88CMake, 32courier, 22cross-comp
Indexsocat, 20SocketCAN, 46SSH, 28SSL, 21Subclipse, 88Subversion, 33swap, 17, 19syslog, 17telnet, 28TERM, 12TIOCGEPLD, 42TIOCSEPLD, 42udev, 18Universa
Comentarios a estos manuales