The Disc Stakka controller typically listens on the following port
Comms with the localhost is performed through a series of well structured packets. Actually, there are only three. They are:
Enumerate serials (Command 0x00) Send: 00 Command Recv: NN NN NN NN DD DD DD DD DD DD DD DD ....... Num Devices Serial 1 Serial 2 Description: This command obtains a list of devices that are registered with the server. The serial numbers will be used for all other packet comms.
Read From Device (Command 0x01) Send: 01 DD DD DD DD Command Serial Recv: RR RR RR RR XX XX XX XX XX XX Return Value 6 Byte Data Block Description: This command reads a block of data from the specified device. The structure of the data block is defined later.
Write To Device (Command 0x02) Send: 02 DD DD DD DD XX XX XX XX XX XX XX Command Serial 7 Byte Data Block Recv: RR RR RR RR Return Value Description: This command writes a block of data to the specified device. The structure of the data block is defined later.
It should be noted that all the four byte integers are sent LSB first.
The structure of the data blocks are as follows:
Read data block (6 bytes) 1 Byte MessageID 1 Byte CommandCode 1 Byte X1 1 Byte X2 1 Byte X3 1 Byte X4
Write data block (7 bytes) 1 Byte MessageID 1 Byte CommandCode 1 Byte X1 1 Byte X2 1 Byte X3 1 Byte X4 1 Byte X5
Unless otherwise specified, all values here are in hex Command Code 01 Init? Ready to start operation? Send: X1-X5 = 0 Unused? Recv: X1 = 0 Unused? X2-X3 = Status flags? X4 = 0 Unused? Desc: Only noticed when the unit is first initialised. Command Code 03 ?? Send: X1-X5 = 0 Unused? Recv: X1 = 08 ?? X2-X4 = 0 Unused? Desc: This was seen when performing maintenance. Probably clears errors when trying to eject a slot with no disc. Should be followed by command code 14. Command Code 04 Move carousel Send: X1 = pos (0-64) X2 = eject (0 no, 1 eject) X3-X5 = 0 Unused? Recv: X1 = pos (0-64) X2-X3 = status flags X4 = 0 Unused? Desc: This will rotate the carousel to positions 0 to 0x64 (100 decimal). Yes, there are 101 (decimal) slots in the carousel. Slot 0 is used for alignment and will not accept a disc. If you do attempt to make it accept a disc prepare to get it jammed. Command Code 05 Retract Disc Send: X1-X5 = 0 Unused? Recv: X1-X4 - 0 Unused? Desc: Allows the unit to pull back a disc after it was ejected, but not removed from the bay. Command Code 06 Set LED Flash rate Send: X1 = On time (in approx 0.03sec units) X2 = Period (in units) X3-X5 = 0 Unused? Recv: Unknown! (Never checked! Guess I never needed to.) Desc: The LED is on for X1 time units, and off for (X2-X1) units. Hence if X1 >= X2 then the LED will always be on. Command Code 0A Diagnostics? Startup? Send: X1-X5 = 0 Unused? Recv: X1-X3 = 0 Unused? X4 = Seen 00 (when unit 0) Seen BF (when unit 1 when serial ending in BF) Seen AF (when unit 2 with serial ending in AF) Seen 6A (when unit 3 with serial ending in 6A) Appears to carry last byte of serial if unit pos not 0 Desc: Seen when the proprietary driver first communicates with a newly connected device. Command Code 14 ?? Send: X1-X5 = 0 Unused? Recv: X1 = pos X2-X3 = status flags???? X4 = 0 Unused? Desc: This was seen when performing maintenance. Probably clears errors when trying to eject a slot with no disc. Only seen immediately following command code 03. Command Code 1A Request for some info? Send: X1-X5 = 0 Unused? Recv: X1-X4 = Seen 01 04 23 17 Desc: X1-X3 unknown (but they must have some significance...) X4 appears to be boot block version. Command Code 1B Request for some info? Send: X1-X5 = 0 Unused? Recv: X1-X4 = Seen 00 02 00 79 Desc: X1 unknown. X2 appears to be hardware version. X3-X4 appears to be firmware revision. 02.17.0079) Command Code 1C Request serial number Send: X1-X5 = 0 Unused? Recv: X1-X4 = Serial number Desc: Obtains the devices serial number. It is NOT present where it should be in the USB specs. This is probably because the specs dont allow for units to "stack" on top of each other (but what do I know?) Command Code 1D Accept CD Send: X1-X5 = 0 Unused? Recv: X1 = pos X2-X3 = status flags X4 = 0 unused? Desc: Tells the unit to accept the disc that was recently inserted. Command Code CC Uninitialised unit Send: This command code is not sent to the unit Recv: X1-X4 = Seen DD EE FF 00 Desc: Appears to indicate a freshly connected unit that needs to be acknowledged before it can be used. Note, this will be handled by the core so you should never see this response
The status flags are still a bit of a mystery. The following information may or may not be correct. However everything _seems_ to work ok.
Bit Order: 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 0 = 1 Unit busy 1 = ? Ok? 2 = ? Ok? 3 = 1 CD detected in slot 4 = New CD in slot awaiting ack 5 = Timeout awaiting ack, cd ejecting, in bay 6 = Timeout awaiting ack, cd removed from bay. Old errval 7 = 8 = 1 Unit Busy 9 = 10 = 11 = 12 = 13 = 14 = 15 = ? Ok?