TimeDateGauge
The TimeDateGauge is a non-visual gauge which is used to tie together a group of settings for Day, Month, Year, Hour and Minute into a single time entity, which can then be used to set the local time on the device.
| Attribute | Mandatory? | Value Type | Description |
|---|---|---|---|
| ADayAttribute | Yes | String | Attribute name of the setting to use for the Day |
| AMonthAttribute | Yes | String | Attribute name of the setting to use for the Month |
| AYearAttribute | Yes | String | Attribute name of the setting to use for the Year |
| AHourAttribute | Yes | String | Attribute name of the setting to use for the Hour |
| AMinuteAttribute | Yes | String | Attribute name of the setting to use for the Minute |
The XML format of this gauge is not described here, although you can easily view it if you open an XML pageset in an editor. Use SDC tools to set the properties.
To use this gauge to set the time on the device you need the following configured:
- Settings in your ini file for the names used in the attributes above for Day, Month, Year, Hour, Minute. These are already present in current distributions.
- A touch gauge that can invoke the SETTIME= touch action (the parameter is the TimeDateGauge name)
- A set of touch gauges that can increment and decrement the Day, Month, Year, Hour, Minute settings. There is an example page that does this in the distribution. You would normally chain the SETTIME action into these toch gauges, so that as well as incrementing or decrementing the setting, the new value would be used to set the time immediately, instead of needing a separate set time button.
When the local time is set using the SETTIME action, if a CANBus is connected and configured, the time will be translated to a UTC time and then sent on the bus for other devices to see. See the CANBus controller message formats for further details.