wil42/ecomesh repository overview

⁠EcoMesh

Turnkey, offline, frozen environment for the 42 EcoMesh project (carbon-aware lifetime management for an unattended, battery-powered sensor mesh).

Everything is baked in and pinned, so students need zero setup and every graded run is reproducible across machines:

• Contiki-NG mesh firmware + msp430 / ARM / gcc toolchains
• pre-built headless Cooja / MSPSim emulator (cycle-accurate energy)
• procedural scenario generator (topology, hidden hardware quality, grid series)
• SCI carbon model (operational + embodied + stranded, ISO/IEC 21031)
• a fixed, vetted graded-seed pool: evaluate draws one at random and prints it, so a run is unpredictable yet reproducible

⁠Usage

ecomesh seeds                       # list the graded-seed pool
ecomesh evaluate                    # draw a graded seed, run end to end
ecomesh evaluate --seed 4242        # reproduce a specific run (hash check)

Run it with your working directory mounted:

docker run --rm -v "$PWD:/work" wil42/ecomesh:1.0 evaluate

Sub-commands: generate, simulate, carbon, policy, seeds, evaluate (ecomesh help).

⁠Notes

• Platforms: cooja (fast), sky / z1 (MSPSim, realistic energy). TSCH runs on z1.
• Image is amd64; on Apple Silicon it runs under emulation.
• Pin by tag 1.0 (or digest) for graded use, never latest.