1 Attachment(s)
Low Level Interface Protocol
Version 4:
Code:
*******************************
* FUSION BRAIN V4 BYTE STREAM *
* *
* Deterministic Difference: *
* PID Suffix: E *
* *
*******************************
**** ID CODE ****
Version 3a: VID_04D8&PID_000A
Version 3b: VID_04D8&PID_000B
Version 3c: VID_04D8&PID_000C
Version 3d: VID_04D8&PID_000D
Version 4: VID_04D8&PID_000E
**** STREAM ****
Bytes
[00-31] Digital Outputs 00 through 15
[32-57] Analogue Inputs 00 through 12
[57-59] Not Used Now, Maybe in future
[60] Number of Streams to Receive
[61] Initialize/Watchdog byte
[62] Hardware Version
[63] Firmware Version
Bits 0bMxxxxxxL | M = MSB and L = LSB
Digital Outputs
2 bytes per output
[PPPPPPPS][TTTTTTMM]
P = Value of PWM
([7bit Value + 1]/128)% duty cycle
Details of full period to be determined later
S = 1bit state
0 = Off
1 = on
T = 6bits of Timer to shutoff --> [Evaluated Units in Seconds]
If 6'bTTTTTT is 0, then shut off immediately on disconnect
If 6'bTTTTTT is between 1 and 10 inclusive, then wait [6'bTTTTTT] seconds after disconnect
If 6'bTTTTTT is 11, then wait 30 seconds after disconnect
If 6'bTTTTTT is 12, then wait 60 seconds after disconnect
If 6'bTTTTTT is 13, then wait 90 seconds after disconnect
If 6'bTTTTTT is greater than 14, then wait ([6'bTTTTTT] * 10) seconds after disconnect
M = 2bit Output Mode
2'b00: Normal Full-Off or Full-On Operation Mode
2'b01: Pulse Width Modulation Operation Mode
2'b10: Yet to be determined
2'b11: Yet to be determined
Analogue Inputs
2 bytes per input
[index][index + 1] = [000000Mx][xxxxxxxL] | M = MSB and L = LSB
Number of Streams to Receive
1 byte
[NNNNNNNN] | N = Number of streams to receive
If [8'bNNNNNNNN] is 0 (default) then receive 1 byte and send 1 byte
If [8'bNNNNNNNN] is greater than 0 then receive 1 byte and send 1 byte [8'bNNNNNNNN] times
Each of these "extra" byte streams received may not coorespond with the details of this byte stream outline
Each of the "extra" byte streams sent back to the PC may not coorespond with the details of this byte stream
Initialize/Watchdog Byte
1 byte
[000000IF] | F = Flipping Bit and I = Initialize Bit
F = Instead of flipping a bit in every digital output, flip 1 bit constantly
I = Needs I high to turn anything on, just like default behaviour of byte[61] now
Hardware Version
[MMMMLLLL]
M = Major Version. Currently Version 4, so MMMM = 0100
L = Minor Version. Currently Version 0, so LLLL = 0000
Firmware Version
1 byte
[????????]
Version 3:
Ok, the credit goes to Brain Wendt who was kind enough last July to ask me all sorts of questions and compile this excellent document on the low level protocol. I think he is planning something big with his own software so he has been in the dark recently, but thank him for this
Protocol same for v4 board? PWM?
Hi All,
Is the protocol the same for the v4 boards? If not, what is different, or, is there a new document?
Also, how does one use PWM on a digital output using the low-level protocol? The website says this is supported.
Thanks.
-Dave Levi
FusionBrain Objects-Make Programming Easier
Would this help any?
http://uniquelycommon.com/extern/Fus...usionBrain.zip
Its a C# project creating a DLL (like FusionBrain_WinUSB.dll) that allows for creating FusionBrain objects where you can call functions to set ports on/off & read values without needing to know the bytestream. Detection of Fusion Brains is done through a FuBrainCollection (.detectAll() ) which keeps track of all the inputs & outputs, and allows the same functionality to change them through the collection without needing to know which specific board its on (though that information is available through .outputPortLocation(int port) returning int[]{board, port})
Also, time saving of data transfers is used: calling .setOutputOn(channel) doesn't tell the board to do that until .sendRecieve() is also called, allowing for multiple channels to be toggled quickly/in sync. If one channel at a time is desired, use the .setOutputOnNow() method.
A few important notes:
* I only have a v3 board right now, v4 (& esp. v6) functionality is untested but my best guess I got a v4 board! I did encounter some problems, but I'm almost done fixing them.
* I haven't had too much experience with the FusionBrain_WinUSB.dll that my FusionBrain.DLL references, so I might not call the proper disconnect functions, etc. that should be called (if there's anything I should know, pls tell me!!)
* I've tried to keep uniformity throughout each FusionBrain3, FusionBrain4, FusionBrain6, etc. classes. Just because FusionBrain3 has a .setPWM() doesn't mean it dims, but trying to use it will turn the output on/off (50% or higher, lower). Each class does have a .isPWMCapable() to tell your program, regardless of FusionBrain version.
* The classes are almost (~98%) fully functional, but aren't complete. Ex, you can turn outputs on and off, but setting the timeout portion of the channel isn't added in yet. (time functionality added, keepAlive not) You can get the major version number from the software, but getting it (major & minor) from the board itself isn't in there...yet
* Halfway through the coding I switch from ports being, for example, 0-11 to 1-12 to keep in line with hardware labels. If a different port toggles on, this might be why (haven't had too much time to go back through yet again :) ) All fixed, use 1-12 notation (reasoning: new users are more likely to use that notation)
Please give any/all feedback if you try it out/look at it. I guess the idea is that these classes get added right into FusionBrain_WinUSB.dll so more people can start using the FusionBrains quicker without needing to know hardware specifics.
A previous project I using this code:
lightsequencer-retrofit-demo
Look at HardwareHandler.cs You can see how easy the FusionBrain portion becomes, most of the code is retrofitting the existing Coding4Fun project that was designed around more complicated, but less capable, hardware
A sample quick'n'dirty implementation is here:
http://uniquelycommon.com/extern/Fus...ntrolTest1.zip
(Used just to test what's going on)
On both you'll need to link to the DLL's mentioned (FusionBrain to FusionBrain_WinUSB.dll and ControlTest1 to FusionBrain.dll)
Thanks! :wave:
(This is why I've been asking so many annoying questions, sorry)
UPDATE:
ha ha, I was running through the LightSequencer and remembered the output port quirk for v3 boards. Now there is a .setOutputCorrection(true/false) function to accommodate this insertion of fun :) by default .setOutputOn(1) sets the hardware output at pin 1 on (and the LED at 4)
