Sunray firmware is an alternative Firmware (experimental) for...
| Platform | Hardware required |
|---|---|
| Ardumower | Ardumower kit mowing and gear motors, PCB 1.3, Adafruit Grand Central M4 (or Arduino Due) and ArduSimple RTK kit |
| Alfred | Alfred robot with Alfred RTK conversion kit (tiny Linux computer, IO-board, ArduSimple RTK kit, base antenna etc.) |
The robot mower uses RTK to localize itself (without a perimeter wire)
How does it work?
| Platform | Compilation |
|---|---|
| Ardumower | The complete Sunray firmware and software drivers are compiled for a specific MCU (Due/M4) |
| Alfred | Sunray firmware is compiled for Linux. Additionally, a tiny serial robot driver is compiled for the specific Alfred MCU (STM32). The Linux Sunray firmware will communicate with this serial robot driver to control motors, read sensors etc. |
| Simulator | The complete Sunray firmware and simulated hardware is compiled for Linux. |
All software and hardware, software and motor components are designed and optimized as a whole, if you try to replace or exclude some component not as designed, you risk to damage your hardware with the software
http://wiki.ardumower.de/index.php?title=Ardumower_Sunray
https://www.youtube.com/watch?v=yDcmS5zdj90
WARNING: Do not use the master version (via download button), that is 'code we work on' and it may be unstable - use one release version instead (click on 'releases' link below)!
https://github.com/Ardumower/Sunray/releases
NOTE: Below steps are only required if you want to compile a custom version of the 'Sunray for Alfred' firmware. The code for all steps will require a Linux system (either the Alfred, a Raspberry PI or some PC).
Run this on your Alfred Linux terminal:
## clone repository ##
cd ~
git clone https://github.com/Ardumower/Sunray.git
## compile sunray (NOTE: 'make' will always copy config.h in current makefile folder into Sunray source folder) ##
cd ~/Sunray/alfred/build
rm -Rf *
cmake ..
make
## install new sunray executable ##
sudo systemctl stop sunray
cp sunray ~/sunray_install/
sudo systemctl start sunray
## update repository ##
cd ~/Sunray
git pull
## compile sunray (NOTE: 'make' will always copy config.h in current makefile folder into Sunray source folder) ##
cd ~/Sunray/alfred/build
make
## install new sunray executable ##
sudo systemctl stop sunray
cp sunray ~/sunray_install/
sudo systemctl start sunray
NOTE: This step is only required if you want to compile a custom version of the Alfred MCU firmware. The Alfred MCU firmware can be compiled using Arduino compiler on the Alfred. The compiled Alfred MCU firmware will then be flashed to the Alfred MCU using OpenOCD.
cd sunray_install
sudo ./flash.sh
- Choose 'Install Arduino IDE' (this step may not be required for Alfred SD card images)
- Choose 'Build+Flash NGP firmware (Sunray-compatible)'
Before running above commands, install required libs:
sudo apt-get -y install cmake
sudo apt-get -y install libbluetooth-dev
How to use more robust Bit-bangling-based instead ARM-based I2C driver on a Raspberry PI (OS Lite 64 bit, Debian Bullseye)
The Raspberry CPU-based I2C driver has certain issues (e.g. missing clock stretching for BNO055, missing SCL recovery in noisy environment etc.) You can switch from the Raspberry ARM-I2C-driver to a more robust software-based driver (aka 'bit-bangling') like this:
- Run 'sudo raspi-config' and disable the ARM I2C driver
- Run 'sudo nano /boot/config.txt' and add this line to activate the software-based I2C driver: dtoverlay=i2c-gpio,bus=1,i2c_gpio_sda=2,i2c_gpio_scl=3
- Reboot ('sudo reboot')
- Verify the I2C bus is working (e.g. a MPU 6050 IMU should be detected at address 69): sudo i2cdetect -y 1
OpenOCD is used to flash the Alfred MCU firmware via GPIO interface (SWD emulation). Run this in your 'pi' home folder. The compiled binary ('openocd') can be found in folder 'src'. The binary will be called by the flash script ('~/sunray_install/flash.sh') to flash the Alfred MCU firmware.
sudo apt-get -y install libtool
git clone --recursive https://github.com/lupyuen/openocd-spi
cd openocd-spi
git remote add zorvalt https://github.com/Zorvalt/openocd-spi/
git pull zorvalt fix-multiple-gcc-10-errors
./boostrap
./configure --disable-internal-libjaylink --enable-sysfsgpio
make
Please note that the OpenOCD config ('~/sunray_install/config_files/openocd/swd-pi.ocd') has to be adjusted as the GPIO pins have different numbers:
# SWD banana-pi wiring:
# CON1-P18 SWDIO GPIO-10 (raspi GPIO24)
# CON1-P22 SWCLK GPIO-47 (raspi GPIO25)
# CON1-P16 SRST2 GPIO-11 (raspi GPIO23) -- main MCU
# CON1-P24 SRST1 GPIO-20 (raspi GPIO8) -- perim MCU
sysfsgpio_swdio_num 24
sysfsgpio_swclk_num 25
sysfsgpio_srst_num 23
NOTE: This step is only required if you don't use the Alfred Linux SD card image.
echo "----bluetooth devices----"
hcitool dev
# configure bluetooth BLE module
echo "----BLE config----"
echo 12 > /sys/kernel/debug/bluetooth/hci0/conn_min_interval # 24 6
echo 20 > /sys/kernel/debug/bluetooth/hci0/conn_max_interval # 40 6
echo 1 > /sys/kernel/debug/bluetooth/hci0/conn_latency # 0 1
btmgmt -i hci0 power off
btmgmt -i hci0 le on
btmgmt -i hci0 bredr off
btmgmt -i hci0 connectable on
btmgmt -i hci0 name "alfred"
btmgmt -i hci0 advertising on
btmgmt -i hci0 power on
The simulator will simulate an Ardumower/Alfred on a Linux computer. It uses the same firmware with simulator drivers for all robot hardware (motors, bumper, GPS, etc.). It will also simulate all network-based interfaces (HTTP, MQTT etc.) and support phone connections via Bluetooth BLE (see section above how to configure BLE module on Linux).
Run this on your Linux terminal:
## clone repository ##
cd ~
git clone https://github.com/Ardumower/Sunray.git
Now edit the file alfred/config.h and uncomment only the simulation driver:
//#define DRV_SERIAL_ROBOT 1 // for Alfred
//#define DRV_ARDUMOWER 1 // keep this for Ardumower
#define DRV_SIM_ROBOT 1 // simulation
Finally, compile and run the simulator:
cd ~/Sunray/alfred/build
rm -Rf *
cmake ..
make
sudo ./sunray
When uploading a map, simulator will set the robot position to the uploaded docking point. Using the Sunray App, you can simulate sensors like this:
| Keyboard key | Sensor simulation |
|---|---|
| o | Trigger robot obstacle sensor (bumper etc.) |
| r | Trigger robot rain sensor |
| l | Trigger robot battery low |
If you restart the Linux sunray process, it might be possible that the HTTP port is still not cleared from a previous session. A quick check before running the process will solve this:
echo "----waiting for TCP connections to be closed from previous sessions----"
echo "Waiting TCP port 80 to be closed..."
for _ in `seq 1 30`; do
RES=$(netstat -ant | grep -w 80)
if [ -z "$RES" ]; then
break
fi
echo $RES
sleep 2.0
done;