Roadrunner technical documentation
Follow the sequence illustrated on this image to turn-on your board:
Pay attention with the RoadRunner orientation to avoid electrical damages
You can use one of following microSD:
Probably this is already the default position
The serial terminal setings are 115200.N,8,1 with no flow control
From the Acme Systems eShop two USB to serial converters are available. You can use any other one but pay attention about the electrical signal levels that must be at 3.3 Volt to avoid board damage.
If you are using a ROADRUNNER-Q0 that has no quadSPI on-board or a ROADRUNNER-Q16/64/128 without the at91boostrap stored on it you need to connect the PA30/CD pin on J3 to GND to boot up the board.
If you are using a ready-to-use microSD, it is configured to get the IP address from your DHCP server
The LAN circuitry is powered-off by default. The line that controls the PHY power-on is wired to the jumper J15. You can also use a normal I/O line from the RoadRunner to TP11 to control the power state of the PHY in order to reduce power consumption when the ETH interface is not needed.
By default the RoadRunner starts running RomBOOT a first level bootloader stored in the internal MPU ROM. This program at power on sends this message to the debug port:
then it looks for a second level bootloader called at91bootstrap. This program usually is stored by default on the QuadSPI and it starts sending this message to the debug port:
AT91Bootstrap 3.9.1 ...
If a bootable microSD is present the following messages will appear:
SD/MMC: Image: Read file zImage to 0x22000000 MMC: ADMA supported SD: Card Capacity: High or Extended SD: Specification Version 3.0X SD/MMC: dt blob: Read file acme-roadrunner.dtb to 0x21000000 Booting zImage ...... Using device tree in place at 0x21000000 Starting linux kernel ..., machid: 0xffffffff Booting Linux on physical CPU 0x0 Linux version 4.9.40 (ant9000@chomp) (gcc version 4.9.4 (Linaro GCC 4.9-2017.01) ) #1 Tue Oct 2 15:02:27 CEST 2018
The Linux Kernel image boot messages will follow.
The file zImage (compressed Linux Kernel image) and acme-roadrunner.dtb device tree blob file must be saved on the first FAT16 or FAT32 partition on the microSD.
After the kernel boot there is a second EXT4 partition present on the microSD with the rootfs contents (Linux system and application programms) that will be loaded and run.
Debian GNU/Linux 10 roadrunner ttyS0 roadrunner login:
Now you can login as:
Login: acme Password: acmesystems
By default the SSHD daemon is installed on the Linux Debian Buster microSD.
sudo ifconfig eth0
to check the IP assigned by your DHCP to the board:
eth0: flags=4163<UP,BROADCAST,RUNNING,MULTICAST> mtu 1500 inet 192.168.1.129 netmask 255.255.255.0 broadcast 192.168.1.255 inet6 fe80::243f:8eff:fe10:548e prefixlen 64 scopeid 0x20<link> ether 26:3f:8e:10:54:8e txqueuelen 1000 (Ethernet) RX packets 150749 bytes 15841329 (15.1 MiB) RX errors 0 dropped 7529 overruns 0 frame 0 TX packets 97 bytes 7395 (7.2 KiB) TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0 device interrupt 27 base 0x8000
Then get access from a remote Linux terminal using this command:
The password are always:
Login: acme Password: acmesystems
If you have more than one Roadrunner on your LAN the first thing to do is to change the MAC address of your board. Unfortunately the Roadrunner doesn't have a MAC address chip as like as the Acqua A5 board so you have to set it on the microSD or use a MAC address chip on your application carrier
The mac address of eth0 is save on this file:
By default the access as root from ssh is disabled on Debian Buster 10. To enable it define a password for the root user:
then edit with nano thie sshf_config file:
sudo nano /etc/ssh/sshd_config
and change this line:
then re-launch sshd
sudo systemctl restart sshd
Basically the RoadRunner is a normal Linux Board so all the tutorials available on internet about Linux and Debian Linux distributions could be used also on this board.
From the Debian repository all the packages available for the ARMHF architecure should be working also an RoadRunner without any problem.
To install new packages the command is typically:
sudo apt update sudo apt install [package-name]
A RoadRunner related list of articles is avalable from this link:
To know the electrical details about the Berta D2 board read the schematic available here in pdf format:
The purpose of the BOOTOFF push-button is to prevent the access of the QuadSPI from the CPU at power on. In this way the RomBOOT bootloader, instead of booting the second level bootloader (at91bootstrap), will enable the USB device port in order to be able to re-program the QuadSPI contents from a connected Linux box running SAM-BA utiity. Hold down the BOOTOFF push-button while pressing the RESET button and release the RESET button first and the BOOTOFF button 1 second later. The RomBOOT message will appear on the debug port and the USB device port will go up to receive command from SAM-BA.
Read the article to know more on how to re-write the RoadRunner QuadSPI.
The J13 pads of the Berta D2 board are used to measure the RoadRunner module power consumption. Those pads are in parallel with a 0.1 Ohm resistor so that if you put a voltmeter on J13, every mV measured corresponds to 10 mA of current consumption @ 3.3 Volt. A summary of the power consumption of the module in several running states is reported here: RoadRunner Power Consumption
The J1 jumper is to select the desired state of the 5V to 3.3V switching buck regulator.
Closing +5V - EN3V pins the regulator's ENABLE signal is tied to 5V so it will remains always on regardless of the state of the RoadRunner shutdown line.
Closing SHDN - EN3V pins the regulator's ENABLE signal is tied to the RoadRunner shutdown line so, typing this command shutdown -h now, the main 3.3V regulator will power off.
In this state to wake up the RoadRunner you need to put the WKUP line (J3.1) momentarily at GND with a pushbutton or with a wire.
It is also possible to go in shutdown and wake up after an event on a I/O line or with a Real Time Clock timeout.
For example in order to restart the board at a predefined time after the shutdown you can issue the following command immediately before the "shutdown -h now" or "poweroff" command
echo "+30" > /sys/class/rtc/rtc0/wakealarm
During the shutdown time with the J1 jumper in the bottom position the BertaD2 will consume zero from the external power and the supercap will maintain the backup zone with Real Time Clock and the logic to wakeup from external events.
You can measure the current consumption in backup mode on the VBAT_SC and VBAT pads shown below.
Those pads are in parallel with a 1000 Ohm resistor so 1 mV measured corresponds to 1 uA (microampere) of current consumption from the backup power source (in the Berta D2 there is a supercapacitor as backup power source).