Settings — Modules & Devices
The Modules page configures the integration providers that connect YachtAware to external devices and services — camera systems, access controllers, MQTT brokers, and more. Each module can be enabled or disabled, has configuration fields, shows its imported devices, and provides a device discovery workflow to sync changes from the provider.
Page Layout
All modules are listed as collapsible accordion rows. Modules whose provider binary/service is not running appear separately as Offline entries.
Collapsed Row Chips
| Chip | Shown when |
|---|---|
| Enabled | Module is enabled |
| Disabled | Module is disabled |
| N devices | Module has at least one associated device |
| N issues | Module has unresolved configuration issues |
Expanded Module — Tabs & Toolbar
Settings Tab
| Control | Permission | Description |
|---|---|---|
| Enabled toggle | module:enable |
Enables or disables the module |
| Configuration fields | module:update |
Schema-driven fields specific to this module; disabled when module is off or permission is absent |
Imported Devices Tab
Lists all devices imported by this module. Only shown when the module has at least one associated device.
Toolbar Buttons (top-right of the tab bar)
| Button / Label | Condition | Permission | Description |
|---|---|---|---|
| Scan for Devices | Always | device:discover |
Triggers a provider scan; disabled during an active scan |
| Evaluating Device Changes… | Scan in progress | — | Disabled indicator |
| Device Changes Detected (N), Review and Apply? | Changes found | — | Opens the Device Discovery Dialog |
| Devices Up-to-Date | No changes | — | Green checkmark indicator |
| Apply Config | Unsaved config changes | module:update |
Validates and saves the module configuration |
Device Discovery Dialog
Opened when pending device changes are found after a scan. Five tabs (each visible only when its category has entries):
| Tab | Content |
|---|---|
| Added | New devices in the provider not yet in YachtAware |
| Updated | Existing devices with changed properties |
| Removed | Devices no longer present in the provider; per-item delete toggle |
| Duplicates | Conflicting device identifiers; these are excluded from the apply operation |
| Relations | Relationship changes between devices |
Clicking Apply sends the approved changeset to the API. Devices with duplicate conflicts are automatically excluded.
Offline Modules
Modules listed in server configuration whose provider service is not running appear as read-only entries with an Offline chip. No enable/disable, configuration editing, or scanning is available.
Permissions
| Action | Permission |
|---|---|
| Enable/disable a module | module:enable |
| Edit module configuration | module:update |
| Scan for devices | device:discover |