Documentation and tutorials

Products

• Linux Systems On Module:
  • armhf (Cortex A5): RoadRunner | Acqua
  • armel (Arm9): Aria | Arietta | Netus
• Linux Single Board Computers:
  • armhf (Cortex A53): CM3 Home | CM3 panel
  • armel (Arm9): Fox G20 | Fox LX832 | Terra
• Dev kits: RoadRunner Berta D2 | Acqua Berta A5 | Aria Berta board
• Radio modules: Yarm

Getting started

• DevKit: Berta D2 | Berta A5 | Berta G25
• Boards: Arietta | CM3 Home | Yarm dev | FOX LX, Terra

MicroSD binaries download

• Images for: RoadRunner | Acqua | Aria | Arietta | Fox G20

Linux from scratch

• Linux Kernel 4.9.124
• Debian Wheezy 8.x
• Debian Stretch 9.x
• Boot loader
  • RoadRunner
  • Acqua, Aria, Arietta, Terra
  • FOX G20, Netus
• Distro upgrade from Debian Jessie 8 to Stretch 9
• Write on QuadSPI memory with SAM-BA
• How to format a microSD
• How to backup a Linux microSD

Pinouts

• Roadrunner | Acqua | Aria | Arietta
• Netus | FOX G20 | Terra | FOX LX
• Yarm | Yarm dev
• How to recognize the Acme systems board models

Peripherals

• NAND test for Acqua board
• How to use the SPI ports
• How to use the I2C ports
• How to use the SERIAL ports
• How to use the ADC lines
• How to use the PWM lines
• How to use the GPIO lines
• How to use the 1-WIRE bus
• How to use the Watchdog
• Using ethernet from user space

How to design application boards

• Circuitry sections: Ethernet, TFT, USB,MicroSD, PWM,ADC, Serial, GPIO, Power supply, Long-lasting battery

Other articles

• Third party documentation
• How to use systemd for applications start
• Device tree compiler
• Get the access to the board through: SSH | SCP | Debug port | Web
• Prepare the microSD for the final application
• Aria G25 wiring examples
• How to supply power to the Arietta G25
• Arietta G25 wirings
• How to read the Arietta on-board button
• WIFI-2 - OEM WiFi USB module
• WiFi USB dongle
• Bluetooth: Using USB bluetooth adapters
• Using the Atmel AT24MAC402 on Acqua A5
• Interfacing the 8-channel A/D converter IC Texas ADC128S052
• Experiments with X
• XTERM-01 - 2.8 inch TFT display with resistive touch for Arietta G25
• RGB ledpanel with Arietta G25
• 16x2 alphanumeric LCD and four push-button on Arietta G25

Linux system how-tos

• Set the system date & time
• Set the keyboard configuration
• Set the speed and duplex settings of eth
• Get the IP address from DHCP manually
• Discover the IP address assigned by DHCP
• Disable the system logs
• Deleting the cache of package files to save space
• USB memories automount
• uSD partition resize

Linux applications

• Network Time Servers (NTP)
• FTP server
• Install Bonjour on your PC to easily discovery your Linux board
• PPP over GPRS or HSPA link
• Using Minicom the serial terminal emulator
• Remote control using Python, OSC and TouchOSC App
• How to install the MQTT Mosquitto server
• SQLite installing and test
• Video streaming with ffmpeg
• Connecting to a Remote Serial Port over TCP/IP

Programming examples

•  NEW   Installing Node-RED on RoadRunner
• Hello world example in: Python | C | C++ | NodeJS | Java | PHP | Perl | Shell | Lua | YaBasic
• Write a simple HTTP server in Python
• Control a blinking led via Web
• Install the ARM cross compiler toolchain on your Linux Ubuntu PC
• Compiling a Linux Device driver
• Running a CGI written in C

Command line pills

Check the Linux Kernel version: uname -r
Check the Debian version: cat /etc/debian_version
Check the IP address: ifconfig
Set the hostname: echo "myboardname" > /etc/hostname
Read the microSD serial number: cat /sys/class/mmc_host/mmc?/mmc?:*/serial
Check the incoming interrups: watch -n 1 -d cat /proc/interrupts
Check command line used to start the Linux Kernel: cat /proc/cmdline
List the driver built in the Kernel image: cat /lib/modules/$(uname -r)/modules.builtin
Display disk partitions: fdisk -l
Create and delete partitions: fdisk /dev/sda
Format the first partition on an USB key as fat: mkfs -t msdos /dev/sda1 (apt-get install dosfstools)
Format the second partition on an USB key as ext4: mkfs -t ext4 /dev/sda2

Authors

Sergio Tanzilli
System designer, software developer and company co-founder
tanzilli@acmesystems.it
Webpages: https://www.acmesystems.it and http://www.tanzolab.it
Github repository: https://github.com/tanzilli and https://github.com/acmesystems

Ing. Roberto Asquini
Hardware designer, manufactoring engineer, firmware developer and company co-founder
asquini@acmesystems.it
Github repository: https://github.com/asquini

Guido Ottaviani
Hardware designer, firmware developer, technical writer and robotics specialist
guido@guiott.com
Webpage: http://www.guiott.com
Github repository: https://github.com/guiott

Troubleshooting

• Perl error on locales
• RTC time lost
• To many interrupts from debug port rx line
• Boot fails with the DPI interface plugged
• Swapon failed: Function not implemented
• Command: shutdown -h now doesn't work
• The pin TXD /dev/ttyS3 doesn't work
• FOX board G20 troubleshootings
• Emdebian Grip
• Serial ports input overrun
• Using an ADSL Vodafone Station apt-get doesn't work
• Detaching the ethernet cable for a while the LAN doesn't go up automatically when plugged again
• Calibrating delay loop... message after some errors on the debug port

Obsolete articles

• AbLib Python library
• Using the GPRS section on Terra board
• Gadget Serial Driver on the USB device port
• Datalogic Barcode Scanner
• Power supply to the USB port on Terra board
• Installing Tornado
• Control a led remotely using Tornado web server
• Install web2py Web Framework
• AcmePins library
• Create mini WiFi Webapp server
• Use pyGSM to manage SMS
• Sample Application with Angular.js
• MySQL server installing and test
• MySQL client API in C, Python and PHP
• Access to MySQL Server using MySQL Query browser
• Video streaming over IP
• WebCam: Time-laps video