Software » Campo

h1. Intro

With the TDT-Protocol sensors can just send their values on the BUS without complex object catalogue.

An monitor-software is able to display values without knowing anything about the sensors or their configuration.

The CANId of sensors is actually their configurable ID.

Sensor values are ususally not very important so the CAN-IDs start at 0x200 (max ids 0x800);

|_. Size |_. Decription |_. Examples                                                       |

| 1      | Sub-Id;      | Futher index; Sub-Sensor or more specifi kind of thing to be set |

| 1      | Reserved     | Maybe config-Flags; require Confirmation, is confirmation...     |

| 1      | Data type    | Int, Float, Time, Date, Percent, Promil, Multipacket-String      |

| 1      | Unit         | Hz, °C, Time, Date, PWM, CAN-ID, Name, Description, Room         |

| 4      | Value        | 32Bit                                                            |

h2. Device behaviour

All devices should shut down after 5 hours when no master-heartbeat is received.

h1. IDs, ranges and commands

h2. CAN IDs

|_. Range      |_. Decription           |_. Examples              |

| 0x010-0x0FF  | Alarms                 | Devices have an issue   |

| 0x100-0x1FF  | Control commands       | Set global actuator     |

| 0x200-0x2FF  | Sensors/actors fixed   |                         |

| 0x300-0x6FF  | Sensors/actors dynamic |                         |

| 0x6FF-0x7FF  | Low priority boradcast | Power on devices        |

h2. Global actuator

Global means that all actuators of an type is addressed and not one concrete partipiant.

An specific partipiant can be specified when sending the target CAN-Id in the value.

In this way the message is still high priority other than the "Remote Transmission Request"

|_. ID         |_. global actuator    |_. Decription                                  |

| 0x100        | System command       | Perform system command; e.g. reboot, poweroff |

| 0x101        | Date/Time            | Set date/time of all actuator                 |

| 0x102        | Illumination         | Set brightness of lamps                       |

| 0x103        | Powerswitch          | Power on devices                              |

| 0x104        | Plant watering pump  | Automatically watering indoor plants          |

h2. System commands

|_. Sub-ID     |_. Type              |

| 0x0          | Shutdown            |

| 0x1          | Heartbeat           |

h2. Illumination commands

|_. Sub-ID     |_. Type                    |

| 0x0          | Set ambient light         |

| 0x1          | Get ambient light         |

| 0x2          | Set ambient light, fading |

| 0x3          | Get ambient light, fading |

| 0x4          | Set plant light           |

| 0x5          | Get plant light           |

h2. Powerswitch commands

|_. Sub-ID     |_. Type                         |

| 0x0          | Set powerline for multimedia   |

| 0x1          | Get powerline for multimedia   |

h1. Multipacket-Strings

|_. Address |_. Type          |

| 0x0       | Package count   |

| 0x1       | Package number  |

| 0x2..0x3  | Data            |

h1. Actuator introduction

When introduction is requested by system command, each device must send description for each subid.

h1. Example

|_.Data   |_.Size   |_.Description               |

|0x100    | 29 Bits | CAN-Id: Global command     |

|0x0 	  | 1 Byte  | Sub-Id: Set ambient light  |

|0x0      | 1 Byte  | Reserved 	                 |

|0y1      | 1 Byte  | Data-Type: Integer         |

|0x1      | 1 Byte  | Data-Type: Integer         |

h1. Usecases

* simple actors can filter message to "Global actuator" messages, at least "system commands"

* There are 14 or 28 Filters on STM32Fs