Writes the Local ID, and reads some hardware information. The old U6 version of this function used to write and read power-up defaults for many parameters, but that functionality has been moved to new functions.
If WriteMask is nonzero, some or all default values are written to flash. The U6 flash has a rated endurance of at least 20000 writes, which is plenty for reasonable operation, but if this function is called in a high-speed loop with a nonzero WriteMask, the flash could eventually be damaged.
Note: If the stream is running, you cannot update any of the values (WriteMask must equal 0).
|
Command: |
|
|
|
Byte |
|
|
|
0 |
Checksum8 |
|
|
1 |
0xF8 |
|
|
2 |
0x0A |
|
|
3 |
0x08 |
|
|
4 |
Checksum16 (LSB) |
|
|
5 |
Checksum16 (MSB) |
|
|
6 |
WriteMask0 |
|
|
|
|
Bit 3: Local ID |
|
7 |
Reserved |
|
|
8 |
LocalID |
|
|
9-25 |
Reserved |
|
|
|
|
|
|
Response: |
|
|
|
Byte |
|
|
|
0 |
Checksum8 |
|
|
1 |
0xF8 |
|
|
2 |
0x10 |
|
|
3 |
0x08 |
|
|
4 |
Checksum16 (LSB) |
|
|
5 |
Checksum16 (MSB) |
|
|
6 |
Error Code |
|
|
7 |
Reserved |
|
|
8 |
Reserved |
|
|
9-10 |
FirmwareVersion |
|
|
11-12 |
BootloaderVersion |
|
|
13-14 |
HardwareVersion |
|
|
15-18 |
SerialNumber |
|
|
19-20 |
ProductID |
|
|
21 |
LocalID |
|
|
22-36 |
Reserved |
|
|
37 |
VersionInfo |
|
-
WriteMask: Has bits that determine which, if any, of the parameters will be written to flash as the reset defaults. If a bit is 1, that parameter will be updated with the new passed value. If a bit is 0, the parameter is not changed and only a read is performed.
-
LocalID: If the WriteMask bit 3 is set, the value passed become the default value, meaning it is written to flash and used at reset. This is a user-configurable ID that can be used to identify a specific LabJack. The return value of this parameter is the current value and the power-up default value.
-
FirmwareVersion: Fixed parameter specifies the version number of the main firmware. A firmware upgrade will generally cause this parameter to change. The lower byte is the integer portion of the version and the higher byte is the fractional portion of the version.
-
BootloaderVersion: Fixed parameter specifies the version number of the bootloader. The lower byte is the integer portion of the version and the higher byte is the fractional portion of the version.
-
HardwareVersion: Fixed parameter specifies the version number of the hardware. The lower byte is the integer portion of the version and the higher byte is the fractional portion of the version.
-
SerialNumber: Fixed parameter that is unique for every LabJack.
-
ProductID: (6) Fixed parameter identifies this LabJack as a U6.
-
VersionInfo: Bit 2 specifies U6 and bit 3 specifies U6-Pro.