Skip to content

Hardware and Ports

Configure Aether Hub ports, board mappings, manual pins, and hardware configs for Sense and Act nodes.

Hardware configuration maps visual nodes to physical board pins. Aether Workshop supports standard port mappings for Aether Hub and board-specific mappings, plus manual analog/digital pin assignments.

Aether Hub port map

  • Assign a sensor or actuator to a physical connector.
  • Switch between Aether Hub, Arduino, ESP-32, or ESP8266 targets.
  • Override automatic ports for custom wiring.
  • Diagnose compile or runtime behavior caused by pin mismatches.

Aether Hub and Arduino AVR defaults:

PortPins
PORT 12, 3
PORT 24, 5
PORT 36, 7
PORT 48, 9
PORT 510, 11
PORT 612, 13

ESP32 defaults:

PortPins
PORT 122, 23
PORT 221, 19
PORT 317, 16
PORT 434, 35
PORT 532, 33
PORT 625, 26
  1. Select a Sense or Act node.
  2. Choose an available standard port.
  3. If the wiring is custom, switch to manual pin mode.
  4. Choose analog pins such as A0 through A6, or digital pins such as D2 through D12.
  5. Verify generated code before uploading.

Sense inputs are configured independently. Act outputs are deduplicated by component type in the hardware config store so repeated output components can share or reuse output configuration patterns.

  • Manual digital pins are displayed as D2, D3, and so on, but code generation normalizes them to numeric Arduino pins.
  • Some sensors require multiple pins or dependencies. Check the component’s pin requirements and dependency tab.
  • The source currently notes a maintenance issue where output config creation receives a node ID but does not persist it. Treat node-level output wiring carefully when using repeated output components of the same type.

Can I change the board after building the graph? Yes, but re-check port mappings because default pins can change by board.

Why is a port unavailable? Another component may already use it, or the component may only be compatible with certain port shapes.

Should I use manual pins for Aether Hub? Prefer standard ports. Use manual pins for custom boards, prototypes, or unusual wiring.