BalanceBot: this is a full Copper demo robot

with:

• a physical robot implementation
• a simulation implementation
• a resimulation demoing the deterministic replay
• a log export

To run the simulation

$ cd examples/cu_rp_balancebot
$ cargo run --release

See the UI help for the navigation.

To run the resimulation

(you need at least a log in logs for example from a simulation run).

$ cd examples/cu_rp_balancebot
$ cargo run --bin balancebot-resim --release

It will recreate the logs from only the inputs of the previous run in logs/balancebot_resim*.copper.

To run on the real robot

You will need to cross compile for Arm:

cargo build --target armv7-unknown-linux-musleabihf --release --no-default-features

Be sure you save your log string index:

cp -rv ../../target/armv7-unknown-linux-musleabihf/release/cu29_log_index .  # or anywhere you want

Deploy on the target:

scp ../../target/armv7-unknown-linux-musleabihf/release/balancebot copperconfig.ron copper7:copper/  # change to match your target

To export logs

$ cd examples/cu_rp_balancebot
$ cargo run --bin balancebot-logreader --release

Justfile commands

• just balancebot-dump-text-logs — extract human-readable logs from logs/balance.copper into ../../target/debug/cu29_log_index/strings.bin.
• just balancebot-fsck — integrity check of logs/balance.copper.
• just balancebot-set-pwm-permissions — fix PWM sysfs permissions on the target (requires appropriate privileges).
• just dag-logstats — generate logstats and open an annotated DAG SVG for the current copperconfig.ron.