Charter 02 · sense · programme assignment

Sun Chaser

Directional Light Mapper

Measure where the brightest available light comes from.

Difficulty
★★☆
Prefix
sc
Zone
greenhouse-1
Type
light-node
Device
sc-01
Build time
8 hours

Mission

Build this

Two shaded photoresistors form a differential light sensor and turn a servo toward the brighter side.

One kit, one team repository.

Borrowed parts are labelled below and have a fallback. The assigned device ID is fixed; sensing and behaviour decisions remain yours.

Bill of materials

Parts

SourcePartFallback
● kitPhotoresistors ×2
● kit10 kΩ resistors ×2
● kitSG90 servo

Disconnect USB before rewiring. Motors, the relay, and the servo need appropriate power and a shared ground. Never drive an actuator from the ESP32 3V3 pin.

Assembly

Build in evidence-producing steps

  1. Prove the connection first. Flash the unmodified first-message example with this charter’s zone, device type, and device ID.

    done when: sc-01 is alive on the developer view.

  2. Bench-test one input. Read the sensor or control in Serial Monitor before publishing or moving an actuator.

    done when: repeated physical conditions produce repeatable raw readings.

  3. Publish one registered measurement. Use the exact measurement and unit below.

    done when: the reading appears without a reject.

  4. Add the physical response. Keep spine.loop() running and avoid blocking delays.

    done when: repeated movement does not interrupt publishing or reset the board.

  5. Run the investigation. Collect the planned trials before tuning the final logic.

    done when: the build log contains observations, method, and a limitation.

Contract

Your topics

TopicUnitSuggested interval
garden/greenhouse-1/light-node/sc-01/light-levelpercent30 s
garden/greenhouse-1/light-node/sc-01/light-directionenumon change

Read another team

garden/greenhouse-1/climate-node/gm-01/temperature

Physical behaviour

Alive

Turn left or right; rest at centre when the readings are balanced.

Your call: Design the shade separating the sensors and define what counts as balanced.

Engineering evidence

Measure hysteresis and repeatability rather than claiming the photoresistors report calibrated lux.

  1. Record both raw ADC readings under five orientations.
  2. Repeat the orientation sequence three times.
  3. Choose a deadband that prevents servo chatter.

If you are fast: Track the brightest direction over a full day and compare it with greenhouse geometry.

Acceptance

Ready when all six are true

  • The registered device is alive and publishing its required topics.
  • The reject feed is clear after the final firmware starts.
  • The device reads at least one declared cross-team topic.
  • A physical output responds to real data without blocking MQTT.
  • The build log contains method, evidence, uncertainty, and a known limitation.
  • The enclosure exposes no unsafe wiring and the device ID can be scanned.

Backbone now

Live status

Updates from the same public event stream

Checking sc-01…