These entries cover the shared board/base-image layer that Frothy seeds at boot.
Pins and Constants
$led_builtin, $a0, $boot_button, and board-specific pins` (base image)
Layer: base image
Behavior: Board metadata seeds named pins and board constants into the base
image so code can refer to hardware by stable names instead of raw integers.
Example:
gpio.mode: $led_builtin, 1
adc.read: $a0
Timing and GPIO Primitives
millis, ms, gpio.mode, gpio.write, gpio.read (base image)
Layer: base image
Behavior: The primitive timing and GPIO surface: read uptime, sleep for a
duration, configure a pin, write a pin, and read a pin.
Example:
millis:
gpio.mode: $led_builtin, 1
gpio.write: $led_builtin, 1
gpio.read: $led_builtin
ms: 75
Base-Library Helpers
gpio.high, gpio.low, gpio.toggle (board library)
Layer: board library
Behavior: Frothy-native helper words layered on top of the raw GPIO primitives
to make everyday board interaction readable.
Example:
gpio.mode: $led_builtin, 1
gpio.toggle: $led_builtin
blink (board library)
Layer: board library
Behavior: Tiny timing helper baked into the base image for board-library work. blink drives a pin for a count and wait interval.
Example:
blink: $led_builtin, 3, 75
LED and ADC Helpers
led.on, led.off, led.toggle, led.blink (board library)
Layer: board library
Behavior: Convenience words for the board’s default LED wiring.
Example:
led.on:
led.blink: 3, 75
adc.read, adc.percent (base image / board library)
Layer: base image
Behavior: Raw ADC input plus the Frothy-native percentage helper layered on top
of it.
Example:
adc.read: $a0
adc.percent: $a0