System Input » History » Version 2
Adam Klama, 06/21/2026 03:20 PM
| 1 | 1 | Adam Klama | # System Input |
|---|---|---|---|
| 2 | |||
| 3 | ## Overview |
||
| 4 | A **System Input** exposes an **internal system value** — a quantity produced by the |
||
| 5 | controller itself rather than measured on a wire. **Which** value it reads is chosen |
||
| 6 | by the **pin**, which acts as a selector. Available values are: |
||
| 7 | |||
| 8 | - **Battery voltage** — the supply/battery voltage at the controller. |
||
| 9 | - **Ignition status** — whether ignition is on. |
||
| 10 | - **5 V measurement** — the controller's internal 5 V rail reading. |
||
| 11 | |||
| 12 | Use it to bring one of these into your configuration so other IO can reference it |
||
| 13 | by alias. |
||
| 14 | |||
| 15 | ## Prerequisites & hardware |
||
| 16 | - **None to wire.** A System Input reads an internal value, so there is no sensor |
||
| 17 | and no source input. |
||
| 18 | - You only need to choose **which** system value to read — done by the pin/selector |
||
| 19 | (see below). |
||
| 20 | |||
| 21 | ## Add it in the app |
||
| 22 | 1. Add a new input and choose **System Input** as the type. |
||
| 23 | 2. Choose the **pin / selector** — this picks which system value the input reports |
||
| 24 | (Battery voltage, Ignition status, or 5 V measurement). |
||
| 25 | 3. Give it a clear **alias** (e.g. the name of the value you selected). |
||
| 26 | |||
| 27 | ## Settings reference |
||
| 28 | This input has **no type-specific settings**. Which system value is read is chosen |
||
| 29 | by the **pin / selector**, not by any field on the input. |
||
| 30 | |||
| 31 | ## Common settings |
||
| 32 | System Input also uses the shared settings — alias and pin. Here the |
||
| 33 | **pin** is the selector that picks the system value. See |
||
| 34 | 2 | Adam Klama | [Common IO Settings](Common_IO_Settings). |
| 35 | 1 | Adam Klama | |
| 36 | ## Example — low-battery warning |
||
| 37 | 1. Type **System Input**, selector **Battery voltage**, alias `Battery V`. |
||
| 38 | 2 | Adam Klama | 2. Feed `Battery V` into a [Compare Input](Compare_Input) set to |
| 39 | 1 | Adam Klama | `LessThan 11500` (mV) to flag a low battery. |
| 40 | |||
| 41 | ## Troubleshooting |
||
| 42 | - **Reads an unexpected quantity:** the **selector** is set to a different system |
||
| 43 | value — reselect Battery voltage / Ignition status / 5 V measurement. |
||
| 44 | - **Other IO don't see it:** check they reference the correct **alias**. |
||
| 45 | |||
| 46 | ## Related |
||
| 47 | 2 | Adam Klama | - [Virtual Input](Virtual_Input) — an externally-written value with no hardware. |
| 48 | - [Constant Value Input](Constant_Value_Input) — a fixed configured value. |