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 or an global command.

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. Values

* Date: year 2B, month 1B, day 1B

* Time: hour 1B, minute 1B, second 1B, subsecond 1B

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

* 11-Bit-Identifier, (CAN 2.0A); 2048; 0x800

* 29-Bit-Identifier, (CAN 2.0B); 0x20000000

|_. 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

h2. Turn on the lights

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

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

|0x0      | 1 Byte  | Message-Type: Global command |

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

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

|0x1      | 1 Byte  | PWM: PWM permilli            |

|1000     | 4 Byte  | Value: Full Brightness       |

h1. Usecases

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

* There are 14 or 28 Filters on STM32Fs

h1. ID Assigning

Some STM32 have an internal 96-bit unique ID.

h1. V2

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

| 1      | Packet type  | Standard TDT packet                                              |

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

| 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. Multimessage package

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

| 1      | Packet type  | Multimessage package                                             |

| 1      | count        | Number of packages                                               |

| 1      | number       | 0: value=data length in bytes                                    |

| 4      | Value        | 32Bit                                                            |

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

| 1      | Packet type  | Multimessage package 2                                           |

| 1      | id           | Mailbox                                                          |

| 1      | number       | 0: value=data length in bytes                                    |

|        |              | 1: value=number of messages                                      |

|        |              | 2..x: data                                                       |

| 4      | Value        | 32Bit                                                            |