Project

General

Profile

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.