TOOTHPIC RF Solutions, TOOTHPIC Datasheet - Page 65

• Manufacturer Part Number: TOOTHPIC
• Description: MODULE, BLUETOOTH, DATA ACQUISITION
• Manufacturer: RF Solutions

Specifications of TOOTHPIC

• Svhc: No SVHC (15-Dec-2010)

Set Row Command
The Set Row Data Command byte 0x0B sets a single row of data on a matrix control. The user interface
must first be programmed from FlexiPanel Designer as described in the above section Adding a FlexiPanel
User Interface. The FlexiPanel Server does not need to be running in order to get or set values.
The two bytes after the command byte are the matrix Control ID. This is the value displayed in FlexiPanel
Designer under heading ID in the main controls list. Beware that this ID may change if you insert a dialog or a
control earlier in the control list. You may therefore wish to define constants in your host controller code to
simplify changes to ID values.
The next two bytes are the row number to be set (little-endian). The first row is row zero. No row should be
set unless all row numbers preceding have been previously set. The Set Row Command should not be given
on any matrix which has previously received an Append Row or Log Row command.
If the matrix is a Date-Time matrix, the next 8 bytes are the date-time axis data; otherwise, if it is an XY matrix
with n bytes per X-axis value, the next n bytes are the X-axis data.
The remaining rows are the data for each cell in the row. The number of bytes of data should equal the
number of bytes per cell multiplied by the number of columns.
Unlike the Append Row and Log Row commands, it is quite probable that you will wish to update more than
one row at a time, and only transmit the result to the client when all rows have been updated. For this reason,
the client is not updated unless a Set Row command is sent containing no X or Y or row index data (i.e. just
the first four bytes of the command).
Page 65
Set Control Data Command Examples
Set list or number control
0x0002 to the value 0x00000005
Set text control 0x0705 to the value
“ABCDEFGHIJKLMNOPQRSTUVWXYZ”
Note zero terminator and little-endian
offset value.
First 16 bytes sent last to ensure that all
control data are updated on the client
simultaneously.
9-Apr-06
Control Data Types
Control
Blob
Button
Date-Time
Files
Image
Latch
List
Matrix
Message
Number
Password
Section
Text
Toothpick 3.0.00007
Data type description.
Binary data object – size specified in FlexiPanel Designer.
No data.
8-byte DateTimeU data structure.
No data.
No data.
1 byte, 0x00 for off, 0xFF for on.
4 bytes, little-endian, zero-based index of the selected item.
Extensive – see ToothPIC Services Reference.
No data.
4 bytes, little-endian, signed integer.
1 byte, 0x00 for closed, 0xFF for open.
1 byte, 0x00 for closed, 0xFF for open.
ASCII or Unicode text – size specified in FlexiPanel Designer.
DS380-8
© FlexiPanel Ltd
0x0A 0x0A 0x00 0x02 0x00 0x00 0x05
0x00 0x00 0x00
0x11 0x0A 0x07 0x05 0x10 0x00 0x51
0x52 0x53 0x54 0x55 0x56 0x57 0x58
0x59 0x5A 0x00
0x16 0x0A 0x07 0x05 0x00 0x00 0x41
0x42 0x43 0x44 0x45 0x46 0x47 0x48
0x49 0x4A 0x4B 0x4C 0x4D 0x4E 0x4F
0x50
Patents apply and/or pending
www.FlexiPanel.com