No description
  • Python 31.8%
  • HTML 24.6%
  • CSS 17.2%
  • JavaScript 13.3%
  • C++ 6.1%
  • Other 6.9%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
yuuhikaze 5a33e4d946 chore: rename scratch directory from tmp to scratch
Backups skip any directory named tmp, which hid scripts, models and renders kept there.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Q7bU4L6CT4kCNscqby4RBD
2026-11-16 06:12:15 -05:00
.tern refactor: rename the project to Bulwark 2026-11-13 12:21:54 -05:00
camera feat: navigation camera firmware, stream on the control page and laptop vision scripts 2026-11-13 17:04:51 -05:00
checks feat: camera pod on the head for a XIAO ESP32S3 Sense navigation camera 2026-11-13 16:45:09 -05:00
docs chore: rename scratch directory from tmp to scratch 2026-11-16 06:12:15 -05:00
docs-html chore: rename scratch directory from tmp to scratch 2026-11-16 06:12:15 -05:00
firmware feat: navigation camera firmware, stream on the control page and laptop vision scripts 2026-11-13 17:04:51 -05:00
print/presets feat: zezame body, legs, head and turret assembly with statics and leg checks 2026-11-06 17:56:44 -05:00
scripts chore: rename scratch directory from tmp to scratch 2026-11-16 06:12:15 -05:00
src feat: oval mech eye with the OLED and the navigation camera side by side 2026-11-13 17:54:10 -05:00
vision feat: navigation camera firmware, stream on the control page and laptop vision scripts 2026-11-13 17:04:51 -05:00
.gitignore chore: rename scratch directory from tmp to scratch 2026-11-16 06:12:15 -05:00
flake.lock chore: pin tern to the v2.1.0 release tag 2026-11-13 12:21:54 -05:00
flake.nix feat: navigation camera firmware, stream on the control page and laptop vision scripts 2026-11-13 17:04:51 -05:00
README.md feat: oval mech eye with the OLED and the navigation camera side by side 2026-11-13 17:54:10 -05:00

Bulwark

Printable quadruped that carries the fire-extinguisher turret on its back. It is a heavier relative of Sesame, rebuilt around 25 kg·cm standard servos so it can walk with the full turret (about 2.9 kg in all).

Each leg has two joints, hip and knee, that swing in the walking direction, with the knees pointing backward like Spot's. The body houses the four hip servos, a 2S LiPo in a tunnel along the floor, and an electronics tray (ESP32-S2 Mini, PCA9685 servo driver, 5 V buck). The mech head carries an OLED face and the camera in an oval eye barrel. Pauldrons over the hips, armoured thighs with a knee guard and a piston, and roller hooves give it a heavy look; a light band round the flanks and the rear, and accent rings at the joints, give it a Tron one. Apart from the servos, every part snaps, presses or slides into place.

A navigation camera beside the OLED in the head's oval eye streams its picture over WiFi; scripts on a laptop detect people in it and steer Bulwark to follow them.

The turret sits on the lid, held at its four tank tabs by snap clips. While it sprays, the turret tells Bulwark over WiFi to stand still.

Overview X-ray
Bulwark with the turret Bulwark in x-ray, showing the servos, battery and electronics

The models are parametric build123d/cadgen scripts. Print target: Bambu Lab P1S, 0.6 mm nozzle, PLA (dark body, a light accent filament). The ESP32-S2 firmware lives in firmware/.

Documentation

The documentation index links every guide:

  • Hardware — printed parts, purchased parts, screws and tools
  • Printing — plates, slicer settings and print orientation
  • Wiring — power, servo driver, controller, face and lights
  • Assembly — step-by-step 3D guide from the tray to the turret
  • Glossary — every part and feature by name, in colour
  • Calibration and use — servo trims, first steps, web control, the turret API and the camera
  • Design notes — kinematics, loads, stability and assumed dimensions
  • Development — models, checks, slicing, guide renders, firmware and docs

Repository layout

src/                 Part models (one decorated model per script) and the assembly
src/lib/             Parameters, placements (frames), features and purchased-part stand-ins
src/plates/          Print plates (3MF)
src/guide/           Assembly-guide scenes and glossary figures
checks/              Leg collision sweep and statics (CoM, tip-over, joint torque)
scripts/             Build, slice, guide-render, mesh and viewer helpers
print/presets/       OrcaSlicer presets (P1S 0.6, PLA)
firmware/            ESP32-S2 firmware (PlatformIO)
camera/              Navigation camera firmware, XIAO ESP32S3 Sense (PlatformIO)
vision/              Laptop-side vision: stream, person following, preview with keyboard driving
docs/                Documentation source (Markdown); docs/img holds generated images
docs-html/           Compiled HTML (generated by tern)
STEP/, 3MF/, gcode/  Generated outputs (git-ignored)

Quick start

The following commands rebuild every model, check the legs and the statics, slice the plates and render the guide images:

scripts/build.sh
(source scripts/env.sh && "${CADGEN[@]}" python checks/interference.py)
(source scripts/env.sh && "${CADGEN[@]}" python checks/stability.py)
scripts/slice.sh
scripts/guide.sh

The firmware builds and flashes with PlatformIO:

nix develop path:. --command pio run -d firmware -t upload
nix develop path:. --command pio run -d camera -t upload

The vision scripts run on a laptop joined to Bulwark's access point; this one follows the nearest person:

nix develop path:.#vision --command python vision/follow.py

scripts/view.sh starts cadgen's CAD viewer and prints links to the guide scenes, the plates and the assembly, where the eight joint sliders pose the legs (hip_fl … knee_rr, offsets from the standing pose).

Documentation build

The documentation (this README and docs/) compiles to docs-html/ with:

nix develop path:. --command tern

Attribution