The binaries included here are specifically intended for
PuceBaboon Y.K. USB controllers connected to OpenBSD and FreeBSD
systems.
They are specifically for i386 architecture.
The syntax is puce_controller <NUMBER> where the number is the specific controller you want to address (usually 0 through n) on the machine. In other words, you can have as many controllers as you want plugged into different USB ports... but don't forget to make the device file if you use a non-standard or high-numbered port.
The output from the binary is in this format:-
1087383580:0xed00080057f62610:33.00:32.75 Timestamp : Serial Number : Temperature (0.5C & Accurate)
The timestamp is a standard, "seconds since epoch" count (man -k epoch, or man time2posix).
The serial number consists of the "0x" hex specifier, one byte of checksum, six bytes of actual serial number and a one byte device specifier. Thus our example of "0xed00080057f62610" breaks down into:-
Ox = Hex Specifier ed = Checksum 00080057f626 = Serial Number 10 = Device Specifier
Both temperature readings are in Centigrade. The first temperature (33.00 in our example) is accurate to within 0.5°C. The second (32.75) may, or may not, be useful or accurate, depending upon the manufacturing batch of the active sensor in the unit, and is best ignored in end-user applications.