A model is used to apply consistent configuration to multiple devices.
- Open the navigation menu.
- Select the Models item.
- Double-click the desired model.
- If no models exist, use the
button to create one.
- If no models exist, use the
The model editor page consists of seven sections, each configuring a different aspect of a model.
The Live Data and Logging sections will be hidden from view if those settings are disabled in the General section.
- Name
- Identifies the model across the platform.
- Description
- Stores notes about the model.
- Type
- Identifies the type of device used with this model.
- Different types have unique options and features.
- Correct setup of this setting is essential for the platform to communicate with devices.
- OEM
- The OEM organization the model is used by.
- Enable Live Data
- Enable/Disable all settings in the Live Data section.
- Disabling live data stops the device from sending live data to dashboards.
- Enable Logging
- Enable/Disable all settings in the Logging section.
- Disabling logging stops devices from uploading log data.
- Product Image
- Visually identifies the model on the platform.
- Use the
button to add an existing .dbc
or.sym
file. - Use the
button to create a CAN database from scratch. - Use the
button to update the configuration settings of the selected CAN database. - Use the
button to download the CAN database as a .sym
file. - Use the
button to edit the CAN database messages and enums.
Set up commands for controlling devices on dashboards.
- Each command has a human-readable name and an MQTT topic.
- The name is used when setting up dashboard widgets.
- The topic value is sent to the device.
Configure live data broadcasts.
These settings are not enforced by Spoke Zone.
The values configured in the model editor are sent to all the devices of this model. It is the responsibility of the device software to correctly handle these settings.
- CAN Data Publish Frequency
- Sets the seconds between each live broadcast of CAN data.
- Lower values will result in higher data costs.
- Location Publish Frequency
- Sets the seconds between each broadcast of location data.
- Lower values will result in higher data costs.
- Event Capture Before Period
- Devices can upload data that occurs immediately before an alert trigger.
- This setting sets how many seconds of data should be included.
- Higher values will result in higher data costs, and require more available storage space on the device.
- Event Capture After Period
- Devices can upload data that occurs immediately after an alert trigger.
- This setting controls how many seconds of data should be included.
- Higher values will result in higher data costs, and require more available storage space on the device.
Configure data logging on a device.
These settings are not enforced by Spoke Zone.
The values configured in the model editor are sent to all the devices of this model. It is the responsibility of the device software to correctly handle these settings.
- Log Upload Period
- Sets the frequency (in minutes) at which data files are sent to the platform.
- Max Log Size
- Sets the maximum data file size in megabytes.
- Log Rotations
- Sets the maximum number of files to retain on the device during internet connectivity issues.
- Upload Schedule
- Allows defining a regular upload schedule for devices.
- Devices only upload on selected days.
- UTC Time
- Sets the time of day for the regularly scheduled upload in UTC timezone.
- Log Data Frequency
- Sets the frequency (in seconds) at which CAN data is recorded in the log data files.
- Lower values will result in higher data costs.
- Log GPS Frequency
- Sets the frequency (in seconds) at which location data is recorded in the GPS data files.
- Lower values will result in higher data costs.
Upload various documentation files associated with this model.
Create modules for managing OTA releases for devices.
The number of modules is restricted based on the model type.