| usertc | Integer 1 or 0 | Enable or disable real time clock support. This requires a DSL1307 I2C RTC module to be connected to your Pi. |
| timezone | String | Specifies the timezone the system should operate in. This is only of relevance if the RTC is enabled. See the timezones list for a full list of valid timezone strings. |
| master | Integer 1 or 0 | Defines whether the application should run in master or slave mode. This setting is ignored in single node environments. |
| waitforboot | Integer 1 or 0 | Defines whether the software should wait on the boot screen for other devices to initialise. Not relevant to single instance installations. |
| warnings | Integer 1 or 0 | Defines whether warnings are enabled. Warnings may be generated for a number of reasons, such as a speed limit exceeded or a speed camera found. Some warnings present in the software cannot be generated in a single node environment (such as handbrake left on) as there is no method to provide the status of the associated devices. |
| deviceid | Integer | Defines the unique Device ID of the SDC instance. Only used in multi node environments where certain messages may be targeted at a specific device such as asking a device change its currently displayed page. |
| shellupdatelocalpath | String | Specifies an absolute path (e.g. c:) of the location on the SD card where the software resides so that when upgrades are performed they are placed in the correct location. If not specified, the default is c:\ |
| wifi | Integer 1 or 0 | Enable or disable WIFI support. If WIFI is enabled, then you must enter the relevant SSID and Passphrase information into the config.txt file on the SD card. |
| debugmode | Integer 1 or 0 | Defaults to 0 (off). Any set of gauges on any page can be given the “debug” attribute. This means they will only be displayed when the system is put into debug mode. As well as a configuration file setting, debug mode can be enabled via a touch action making it possible to dynamically show or hide debug gauges. |
| upgradeip | String, format 192.168.1.123:8000 | This is the IP address and port of a web server that contains an updated application image. Used for upgrading the software over WIFI without needing to remove the SD card. For further details on this see the software upgrades section |
| throttleratehz | Integer | Specifies a maximum rate in messages per second that the system should try and extract from the data source (the Speeduino serial connection). This setting defaults to zero which means “go as fast as possible”. On an arduino Mega, you would typically achieve around 20-25hz while running (equivalent of “throttleratehz=25”). However, on a faster processor such as a teensy you will likely be able to extract data at a much higher rate (within the limits of the 115,000bps serial baud rate). This setting may be required for Teensy or STM32 devices if the higher available data rates cause your Raspberry Pi to require too much message processing time. Note that one Speeduino serial message maps to multiple canbus messages, and therefore it is recommended that a canbus SDC instance receiving bridged data from another SDC device should set the throttle to unlimited to avoid losing data (set the throttleratehz=0 or remove it from the ini file altogether). |
| maxthrottleratehz | Integer | Enables the maximum throttle rate to be overridden. Internally SDC has a hard coded maximum throttle rate of 45hz. This means that the maximum rate at which messages can be extracted from a serial connection is 45 messages per second. This limit exists to protect the Raspberry Pi from being flooded with too much data. However, if you want to experiment with higher rates then this limit can be increased with this setting. Note that rates higher than 25hz will require an STM32 or Teensy based speeduino, since the Mega based devices are limited to around 25hz anyway. |
| speedsource | string | Specifies the name of the attribute that you wish to use as the speed source for capabilities such as speed camera detection. Whichever attribute you specify in this field will be copied into the “speedmph” attribute. For example if you specify “speedsource=vss” and have a speed sensor connected to your speeduino ECU, then the ECU’s calculated vss value will be copied into ‘speedmph’ and subsequently used for any system feature that requires speed. By choosing the ‘speedmph’ value as the display attribute of a gauge, you will see current speed no matter what the defined source is. You can still use the individual attributes directly on gauges (e.g. both Speeduino ECU speed and GPS speed could be independently displayed.) If you have a GPS receiver, you can use “speedsource=gpsspeedmph” if you wish to use GPS as the source. |
| globalscriptfrequency | Integer | Specifies the number of milliseconds between executions of the global script. The default setting is 500ms i.e. the script will execute twice per second. You can only configure values longer than 500ms, in order to prevent the global script from taking over the CPU too much. This setting has no effect if there is no global script in the scripts folder. |
| serverport | Integer | Specifies the TCP port number that the SDC Tools application will use to connect to the server. The default value is 3456 if this setting is not specified. There must be a similar matching entry in the screen designer’s ini file if you are changing the port from the default. |
| broadcastport | Integer | Specifies the UDP port number to be used for sending “alive” messages. These are used by the SDC Tools application to detect running devices. Default value if not specified is 9000. A matching entry must be present in the SDC tools ini file if you are to changing the port from the default. |
| scriptbroadcastport | Integer | Specifies the UDP port number to be used for reporting any errors during script development. These are used by the screen editor to show compilation errors in scripts. Default value if not specified is 6868. A matching entry must be present in the SDC tools ini file if you are to changing the port from the default. |