Configuration

Your Habitat device is configured by Open Culture for your hardware. Over the API you can read its full configuration — including the port map — but the layout itself (pumps, valve types, syringe sizes, and which reservoir sits on which port) is set on the device, not changed over the API.

Read your device's configuration

curl http://mistyforest.local:8000/config

Returns the full configuration snapshot: device identity, each pump, and each pump's port map. GET /config/schema returns the JSON Schema describing every field.

Python

from openculture import HabitatClient

with HabitatClient("http://mistyforest.local:8000") as h:
    config = h.config.get_config()     # full snapshot
    schema = h.config.get_schema()     # JSON Schema for the config

The port map

Within the snapshot, each pump carries a port_map — how its rotary-valve ports map to what's physically connected. Every port has:

Field	Meaning
`port`	Valve port number (`1`–`N`).
`role`	What's on the port: `media`, `chip`, `waste`, or `air`.
`label`	Human-readable name (e.g. `Growth Media`).
`reagent_id`	For a `media` port — the reagent/solution in that reservoir.
`chip_id`	For a `chip` port — the chip instance connected there.

Fluidic operations select their source and destination by role or port number — a dispense, for example, draws from a media port and delivers to a chip port.

Changing assignments (moving a chip, swapping a reagent) is done on the device's built-in screen, or with help from Open Culture.