See Roboy Plexus readthedocs for full documentation.

Prerequisites

Install dependencies

sudo apt install gcc-arm-linux-gnueabihf g++-arm-linux-gnueabihf

Download and install Intel SoC FPGA Embedded Development Suite (Standard Edition).
Configure the environment using the embedded_command_shell.sh script

~/intelFPGA/17.0/embedded/embedded_command_shell.sh

Usage

Launch ROS node on FPGA

ssh root@192.168.240.240
~/.roboy_plexus roboy3.yaml

look for Gandalf Data Limited in the following command output in order to find out FPGA's IP, substitute 192.168.0.255 by your network broadcast address
```
sudo nmap -nsP 192.168.0.255/24
```
if ssh doesn't work, connect the FPGA board to the PC via the USB port (use the one on the ethernet side of FPGA board) and connect to the serial monitor with
```
screen /dev/ttyUSB0 115200
```
if the board was rebooted and the ethernet network interface doesn't work try
```
ifup eth0
```
make sure the PC and FPGA know where to look for ROS, i.e. ROS_MASTER_URI and ROS_IP are set (usually in the ~/.bashrc)
if catkin_make fails, set up FPGA dev environment by calling
```
~/intelFPGA/17.1/embedded/embedded_command_shell.sh
```

Status of the motors is published under the rostopic roboy/middleware/MotorState

rostopic echo /roboy/middleware/MotorState

check for available rostopic and services:
```
rostopic list
rosservice list
```
type definitions for msgs and srvs are in roboy_communication/middleware or on https://github.com/Roboy/roboy_communication/tree/roboy3/middleware

The control commands are set by publishing ROS messages under /roboy/middleware/MotorCommand:

rostopic pub /roboy/middleware/MotorCommand roboy_middleware_msgs/MotorCommand "global_id: [0,1]
  	setPoints: [0,0]"

(Optional) Configure motor mode by calling ROS service /roboy/middleware/MotorConfig

available control modes:
- 0: ENCODER0_POSITION: position controller using encoder0
- 1: ENCODER1_POSITION: position controller using encoder1
- 2: DISPLACEMENT: position controller using displacement
- 3: DIRECT_PWM: directly controlling the pwm value of the motor

Start the GUI and load the roboy_control_center plugin (select the roboy3.yaml file on first start):

rqt

Daemon

You can find the daemon in scripts/automaticRoboyPlexusLauncherDaemon, execute the following commands for installing the daemon on the fpga:

sudo mv automaticRoboyPlexusLauncherDaemon /etc/init.d/
echo "/etc/init.d/automaticRoboyPlexusLauncherDaemon start" >> ~/.bashrc
sudo ln -s /home/root/roboy_plexus /usr/local/bin/roboy_plexus

Edit the file /lib/systemd/system/serial-getty@.service and replace the line:

ExecStart=-/sbin/agetty --keep-baud 115200,38400,9600 %I $TERM

with auto-login:

ExecStart=-/sbin/agetty --autologin root --keep-baud 115200,38400,9600 %I $TERM

This will auto-login root when the fpga boots and the daemon is started via the bashrc entry.

Roboy/roboy_plexus

Prerequisites

Usage

Daemon