This is the software interface for the Autokit suite. It is a container that runs a web server that exposes Autokit functionality.
npm install autokitThis is the software interface for the Autokit suite. It is a container that runs a web server that exposes Autokit functionality.
This repository also a node library that can be used to control the autokit from a node application, without needing the container. It does not include details about the hardware, or assembly. Please refer to the parent repo for links to all relevant documentation here
The Autokit software interface is designed to take into account that the Autokit is a suite of hardware which may be added to or substituted. The Autokit interface aims to provide a simple generalized interface despite potentially different hardware being used.
Currently, the Autokit software interface supports:
- flashing (control over the DUT's SD card/flashing medium, or via usbboot)
- power on / off
- controlling the network connection of the DUT, via a wifi hotspot or ethernet connection sharing
- capturing video output of the DUT
- sending/recieving serial to/from the DUT
The interface is divided into features, which are the pieces of functionality the kit can perform. Each feature can have multiple possible implementations, which represent potentially different hardware being used to achieve that functionality.
An implementation can be added so the kit can support a new piece of hardware, but the class used to create that implementation must have the same interface as the rest of the implementations that implement that feature.
Push this container onto an Autokit host. This will start a web server on port 80 of the container.
| Environment variable | Values |
|----------------------|---------------------------------------------------------------|
| POWER | { autokitRelay } default: autokitRelay |
| SD_MUX | { linuxAut, linux-gmbh, testbot-sd-mux } default: linuxAut |
| NETWORK | { linuxNetwork } default: linuxNetwork |
| USB_BOOT_PORT |
| SERIAL | { ftdi } default: ftdi |
If the host device is a balena device, this will mean that the server will be reachable at https://, assuming that the public URL of that device is enabled.
If you ssh into the host device, you can use localhost as the
``sh`
curl -X POST
Can be used to power the DUT on
`sh`
curl -X POST
Can be used to power off the DUT
The Autokit can share a wireless internet connection to the DUT using:
`sh`
curl -X POST
This will create an access point with the credentials: ssid: autokit-wifi and psk: autokit-wifi-psk by default. Credentials can be set by posting a JSON object instead:
`sh`
curl -X POST
A wired ethernet connection can be provided via:
`sh`
curl -X POST
You can upload an image to a permanent volume using the /uploadImage endpoint, e.g.:
`sh
~ $ curl 192.168.2.20/uploadImage -F "image=@
{"status":true,"metadata":{"fieldname":"image","originalname":"balena-cloud-my-first-fleet-raspberrypi4-64-2.106.2-v14.3.0.img","encoding":"7bit","mimetype":"application/octet-stream","destination":"/data","filename":"2d5a597b3ffa28555de51f5026e1e89b","path":"/data/2d5a597b3ffa28555de51f5026e1e89b","size":952107008}}
`
You'll get as a response the metadata and upload path that can be used in the flashing step below.
Flashing can be performed using:
`sh`
curl -X POST
This requires the image to be on the autokit - this can be achieved through sending it over rsync.
Note that the image must be accessible from the autokit container. One way of achieving this is putting it into a volume. In the app demonstrated in this repo, there is a core_storage volume. You can find the path to this volume from the host via:
`sh`
ssh
and then using the output of that command with this:
`sh`
rsync -ar -vvv --whole-file --progress -e "ssh
The above instructions assume your host device is a balena device connected to balena cloud.
To start video capture from the DUT
`sh`
curl -X POST
This will commence capturing until a stop command is sent:
`sh`
curl -X POST
Which will send a .tar.gz archive of all captured frames as jpeg images.
To open a serial connection to th DUT
`sh`
curl -X POST
To write a string to the DUT over serial
`sh`
curl -X POST
To close the serial connection
`sh``
curl -X POST
This will return the response from the DUT, if any.
Posting to the teardown endpoint will tear down cleanly whatever has been setup on the kit - for example it will de activate any created network hotspots.