www.vscom.de OnRISCOnRISCOnRISC UserUserUser Manual Manual Manual Edition:Edition: July July 2021 2021 Vision Systems GmbH Tel: +49 40 528 401 0 Fax: +49 40 528 401 99 Web: www.visionsystems.de Support: faq.visionsystems.de The software described in this manual is furnished under a license agreement and may be used only in accordance with the terms of that agreement. Copyright Notice Copyright © 2009-2021 Vision Systems. All rights reserved. Reproduction without permission is prohibited. Trademarks VScom is a registered trademark of Vision Systems GmbH. All other trademarks and brands are property of their rightful owners. Disclaimer Vision Systems reserves the right to make changes and improvements to its product without pro- viding notice. Vision Systems provides this document “as is”, without warranty of any kind, either expressed or implied, including, but not limited to, its particular purpose. Vision Systems reserves the right to make improvements and/or changes to this manual, or to the products and/or the programs described in this manual, at any time. Information provided in this manual is intended to be accurate and reliable. However, Vision Systems assumes no responsibility for its use, or for any infringements on the rights of third parties that may result from its use. This product might include unintentional technical or typographical errors. Changes are period- ically made to the information herein to correct such errors, and these changes are incorporated into new editions of the publication. July 2021 OnRISC User Manual 2 Contents Contents 1. Introduction 9 1.1. OnRISC Family.......................................9 1.2. How to Read the Manual?.................................9 2. Getting Started 13 2.1. Connect to OnRISC via Serial Link............................ 13 2.2. Terminal Type....................................... 13 2.3. Configure Network..................................... 14 2.3.1. Legacy Configuration............................... 14 2.3.2. Configuration via systemd-networkd....................... 15 3. Supported Linux Distributions 16 3.1. Debian............................................ 16 3.2. Buildroot.......................................... 16 3.3. Yocto............................................ 16 3.4. OpenWrt.......................................... 17 3.5. Distribution Choice..................................... 17 4. Software Configuration 18 4.1. Init System......................................... 18 4.2. Boot Device Sequence................................... 18 4.2.1. Booting from SD/microSD-card.......................... 18 4.2.2. Booting from NAND................................ 18 4.2.3. Booting from USB................................. 20 4.3. Swapping and Logging................................... 20 4.4. Activating and Deactivating Services........................... 20 4.5. System Image........................................ 21 4.5.1. Program Overview................................. 21 5. Network Services and Tools Provided by OnRISC 22 5.1. LAN Configuration..................................... 22 5.1.1. Baltos........................................ 22 5.2. WLAN Configuration................................... 24 5.2.1. Regulatory Domains................................ 24 5.2.2. Managed Wireless Network (Wpa_supplicant)................. 24 5.2.3. Ad-hoc Wireless Network............................. 24 5.2.4. Supported WLAN Hardware........................... 26 5.3. GSM Support........................................ 27 5.3.1. PPP......................................... 27 5.3.2. ModemManager.................................. 28 5.3.3. Connect Modem On Startup........................... 29 5.3.4. Controlling a Modem with Python........................ 30 5.4. Remote VPN Access with viaVPN............................ 30 5.5. GPS............................................. 31 5.5.1. GPS Device Setup................................. 31 5.5.2. Reading Raw GPS Data.............................. 31 5.5.3. gpsd......................................... 31 5.6. SSH............................................. 32 July 2021 OnRISC User Manual 3 Contents 5.7. RFC2217.......................................... 32 5.8. Socketcand......................................... 33 5.9. GPIO over Modbus/TCP................................. 33 6. Software Development 37 6.1. Environment........................................ 37 6.1.1. Compile your software directly on the OnRISC................. 37 6.1.2. Cross-compile your software on the PC..................... 37 6.2. Linux Kernel........................................ 39 6.2.1. Getting Source Code................................ 39 6.2.2. Install Kernel Modules............................... 39 6.2.3. Creating Kernel *.deb Package from Binary Files................ 39 6.2.4. Creating a Standard Kernel *.deb Package................... 40 6.3. Bootloader......................................... 41 6.3.1. U-Boot....................................... 41 6.3.2. Barebox....................................... 41 6.4. Other Programming Languages Than C/C++...................... 42 6.5. Recommended Books.................................... 42 7. OnRISC Hardware API 43 7.1. libonrisc........................................... 43 7.2. Digital I/O......................................... 44 7.2.1. Baltos iR 5221/3220................................ 44 7.2.2. Baltos 1080..................................... 44 7.3. mPCIe On/Off Switching................................. 45 7.4. Serial Interfaces....................................... 45 7.4.1. RS422/RS485 and GND Connection....................... 45 7.4.2. RS Mode Switching................................ 46 7.4.3. FTDI Based UARTs................................ 46 7.4.4. 16C750 Based UARTs............................... 46 7.5. CAN............................................. 50 7.5.1. CAN Interface Configuration........................... 50 7.5.2. CAN Usage Examples............................... 50 7.5.3. CANopen...................................... 50 7.5.4. J1939........................................ 50 7.6. I²C.............................................. 51 7.7. Watchdog Timer...................................... 51 7.8. Read Hardware Parameters like MAC Address, Serial Number etc........... 53 7.9. Built-in Touchscreen Calibration (VS-860 Only)..................... 53 8. Debian BSPs 54 8.1. ELBE............................................ 54 8.2. vsdebootstrap........................................ 54 9. Buildroot 54 9.1. Build Host Requirements................................. 55 9.2. Downloading........................................ 55 9.3. BSP Structure....................................... 55 9.4. Building the Image..................................... 56 July 2021 OnRISC User Manual 4 Contents 9.5. Copying the Created Image to the System........................ 56 9.5.1. SD/microSD-card................................. 56 9.5.2. NAND........................................ 57 9.6. Customizing the Image................................... 58 9.7. Compiling Your Own Software.............................. 58 9.8. Setup SSH Server...................................... 60 9.9. Getting Help........................................ 60 10.Yocto 61 10.1. Downloading........................................ 61 10.2. Build Configuration.................................... 61 10.3. Meta-baltos Structure................................... 62 11.OpenWrt 63 11.1. BSP Structure....................................... 63 11.2. Initial Setup......................................... 63 11.3. Accessing Web Interface.................................. 63 11.4. Installing OpenWrt to NAND............................... 63 12.IoT 65 12.1. IoT Related Protocols................................... 65 12.1.1. MQTT....................................... 65 12.2. IoT Programming: Node-RED.............................. 68 A. Debian Maintenance Notes 71 A.1. Debian Package Management............................... 71 B. onrisctool 72 B.1. Configure Serial Interfaces................................. 72 B.2. Configuring Digital I/O.................................. 72 B.3. Configuring LEDs..................................... 73 B.4. Get EEPROM Info..................................... 74 B.5. Setting LAN MACs from EEPROM........................... 74 B.6. Controlling mPCIe Slot.................................. 74 C. hwtest-qt 75 C.1. Controller Area Network Test............................... 75 C.2. UART Test......................................... 75 C.3. Network Test........................................ 75 C.4. RTC Test.......................................... 75 C.5. WLAN Test......................................... 75 C.6. Bluetooth Test....................................... 76 C.7. Disk Test.......................................... 76 C.8. Touch Test......................................... 76 C.9. Button Test......................................... 76 C.10.Audio Test......................................... 76 C.11.Modem Test......................................... 76 D. Managing System Images 77 D.1. Flashing System Images.................................. 77 D.1.1. Windows...................................... 77 July 2021 OnRISC User Manual 5 Contents D.1.2. Linux........................................ 78 D.2. Working with Partitions.................................. 78 E. Frequently Asked Questions (FAQ) 79 F. Licensing Information 80 F.1. GNU GENERAL PUBLIC LICENSE.........................