Template / VarDataAlign Protocol Frame
Copies Len bytes from source data, beginning at StartPos, to the TemplateCommands location.
Is identical to the VarData TemplateCommand, except that it accepts source data of variable length. It will extend/cut the source data depending on its length.
Template: VarDataAlign "_" 01 04 Right NoFilter
Sourcedata: "1234"
Destination data: "_234"
Properties
- Frame value: 0x1B05
Format
| Name | Type/Size | Description | |
|---|---|---|---|
| FillByte | Integer (8 bits) | If the extracted block is shorter than Len , it will be filled up with FillByte. If Alignment is Right, it will be filled up on the left; otherwise on the right. | |
| StartPos | Integer (8 bits) | Specifies the offset of the block to extract from the source data. If Alignment is Right , this offset counts from the right of the source data; otherwise, it counts from the left. | |
| Len | Integer (8 bits) | The size of the block to extract from the source data. | |
| Alignment | Enumeration (8 bits) |
- Values:
|
|
| Filters | Bit mask (8 bits) |
For every of these filter bits, a specific data conversion mechanism is specified. This mechanism is applied to a TemplateCommand if the filterbit is set. The activated filters are applied ordered by there value. Starting with the smallest value. |
|
| BcdToBin | Boolean (bit 0x80) |
Converts a BCD Number (must only contain nibbles 0-9, not A-F) to a binary number. Input and Output data are MSB encoded. The length of the destination data is the length of the source data (in bytes) multiplied by 0.83048 (and rounded down to the next byte boundary). Some source data's binary representation is longer than the calculated destination length. If such source data could occur, an additional leading zerobyte has to be inserted in front of the source data
0x12 0x34 => 0x04 0xD2
|
|
| BinToAscii | Boolean (bit 0x40) |
Convert Binarydata to ASCII by converting the ASCII
characters 0x00-0x09 to 0x30-0x39 and 0x0A-0x0F to
0x41-0x49.
0x01 0x0A -> 0x31 0x41
|
|
| Unpack | Boolean (bit 0x20) |
Splits the high and the low nibble of each byte
into two separate bytes, where the high nibble is
set to 0.
0x01 CF => 0x00 0x01 0x0C 0x0F
|
|
| BinToBcd | Boolean (bit 0x10) |
Converts a binary Number to a BCD encoded number. Input and Output data are MSB encoded. The length of the destination data is the length of the source data in bytes) multiplied by 1.2041 (and rounded up to the next byte boundary). This is not exactly the inverse of BcdToBin, since the length may differ.
0x04 0xD2 => 0x12 0x34
|
|
| SwapNibbles | Boolean (bit 0x08) |
Swap the higher nibble (bits 5-7) of each byte with
the lower nibble (bits 0-3).
0x12 0x34 0xEF => 0x21 0x43 0xFE
|
|
| Pack | Boolean (bit 0x04) |
Merges two Bytes at a time to a single one by
removing the leading nibble (which has to be 0) of
each byte.
0x03 0x0F -> 0x3F
|
|
| AsciiToBin | Boolean (bit 0x02) |
Convert ASCII to Binarydata by converting the ASCII
characters 0x30-0x39 to 0x00-0x09 and 0x41-0x49
(0x61-0x66) to 0x0A-0x0F.
0x31 0x41 -> 0x01 0x0A
|
|
| Reverse | Boolean (bit 0x01) |
Swap the first byte with the last one, the second
one with the next to last one and so on.
0x12 0x3D 0xEF => 0xEF 0x3D 0x12
|
|