Skip to content

Glossary

TermMeaning
Smart HexLocal MCU, sensors, OLED, and interfaces serving one hex location
Base BoardMain controller and board-wide power, mapping, and coordination component
Playable PiecesPassive roads, settlements, cities, robber, and land tiles
Display UnitRaspberry Pi and screen presenting the public web application
Mobile Web AppPrivate player controller on an existing phone
Sensor ownershipAssignment of each sensed physical position to exactly one local sensor
Global roadBoard-wide road-position ID independent of hex wiring
Global intersectionBoard-wide building-position ID independent of local sensor numbering
Resistor IDIdentity inferred from a piece's passive resistor and accepted measurement range
Reference resistorKnown divider resistor on the sensing side, currently 10kΩ in the concept
ADCAnalog-to-digital converter measuring a voltage as a digital reading
DebounceFiltering contact transitions until a stable state is observed
CalibrationMeasuring known pieces to establish useful classification ranges
Chain enumerationSequentially identifying hexes through directed CHAIN eligibility signals
Runtime addressI²C address assigned to a hex during startup, distinct from its global board positions
I²CShared clock/data communication bus using SCL and SDA
Local OLED busSeparate connection between a hex MCU and its own display
Physical board stateWhat the hardware observes, including unknown or unavailable positions
Game stateAuthoritative rules-level state, including resources, turn, and expected pieces
ReconciliationComparison of expected game layout against physical observations
Board eventStable physical observation expressed using global positions
Domain eventAccepted game-level outcome produced by rules processing
Hex ManagerMain-controller subsystem responsible for device communication and lifecycle
Semantic display commandInstruction such as set number or highlight, leaving pixel rendering to the hex
BootloaderSmall program responsible for entering or starting application firmware and potentially updating it
IAPIn-application programming; the eventual firmware-update mechanism still needs investigation
CRCCyclic redundancy check, used to detect accidental data corruption
BOMBill of materials listing parts and quantities
Kiosk modeBrowser setup focused on displaying one application on the public screen

See system architecture for these terms in context.