Cubespace GSE App CLI

The GSE App provides functionality used for configuration management
and firmware / bootloader updates of ADCS nodes.

The GSE App is running as a strictly confined snap, which means that
by default it does not have any access to external USB peripherals or
the correct permissions to configure them (even with sudo).

Note: You still need to run gse-app-cli as sudo, as once the snap
container grants you access, normal permission requirements still hold.

Enabling USB-serial support
---------------------------

1. Enable hotplugging support.

sudo snap set system experimental.hotplug=true

2. List the available serial devices.

sudo snap interface serial-port

name: serial-port
summary: allows accessing a specific serial port
documentation: https://snapcraft.io/docs/serial-port-interface
plugs:
- gse-app-cli
slots:
- snapd:ttl232r-3v3 (allows accessing a specific serial port)

3. Connect the interface to grant the snap access to your port.

sudo snap connect gse-app-cli:serial-port core:ttl232r-3v3

4. Run the command you wish.

sudo gse-app-cli rombl erase --uart --port /dev/ttyUSB0

Enabling CAN support
--------------------

1. Enable the network configuration interface for your snap.

sudo snap connect gse-app-cli:network-control

2. Enable CAN bus access for your snap.

sudo snap connect gse-app-cli:can-bus

3. Run the command you wish.

sudo gse-app-cli rombl erase --can --pcan can0

If you run into any issues, please contact support@cubespace.co.za.