Add Larod

.cargo/config.toml

@@ -0,0 +1,5 @@
+[build]
+target = "aarch64-unknown-linux-gnu"
+
+[target.aarch64-unknown-linux-gnu]
+runner = ["/workspaces/acap-rs/remote-test.sh"]

README.md

@@ -43,6 +43,20 @@ Important workflows are documented in the [Makefile](./Makefile) and can now be
 Development environments outside containers are more difficult to reproduce and maintain.
 Should it nonetheless be of interest, one procedure is documented in [this workflow](.github/workflows/on-host-workflow.yml).
 
+## Testing
+Some items in this workspace rely on libraries or hardware on Axis cameras. This makes testing difficult since these tests cannot run on an arbitrary x86_64 host. Below are some steps to enable running unit test on device.
+
+1. Connect an Axis camera to your network and ensure it is accessible.
+2. The user will likely need to be `root`, such that the Axis camera file system is writable.
+3. Set the `CARGO_TEST_CAMERA` environment variable to the user and IP of the camera with the format `user@ip`
+4. Set up an identity based SSH connection to the camera.
+  1. Create an ID via `ssh-keygen`
+  2. Copy the id to the device via `ssh-copy-id`
+
+Now, via the [remote-test.sh](remote-test.sh) script, and the `runner = ["/workspaces/acap-rs/remote-test.sh"]` line in the .cargo/config.toml, tests with the `aarch64-unknown-linux-gnu` target triplet will automatically be copied to the remote camera and executed there. Run these tests via `cargo test --target aarch64-unknown-linux-gnu`.
+
+If you want to run tests locally, just make sure you clear the `CARGO_TEST_CAMERA` environment variable via `unset CARGO_TEST_CAMERA`.
+
 ## Example applications
 
 Below is the list of examples available in the repository.

remote-test.sh

@@ -0,0 +1,10 @@
+#!/bin/sh
+set -e
+if [[ -z "${CARGO_TEST_CAMERA}" ]]; then
+    f=`basename $1`
+    scp "$1" $CARGO_TEST_CAMERA:.
+    # echo $f
+    ssh $CARGO_TEST_CAMERA "chmod +x /root/$f" 
+    ssh $CARGO_TEST_CAMERA "/root/$f"
+    # ^ note: may need to change this line, see https://stackoverflow.com/q/9379400
+fi