DIO protocol - Revision history

Rew: /* BitMask value for every pin */

2017-05-19T10:04:15Z

BitMask value for every pin

2017-05-19T10:03:54Z

Using the digital ports

2015-12-14T12:52:41Z

BitMask value for every pin

2015-12-14T12:49:49Z

BitMask Value for every pin

2015-12-14T12:49:27Z

Using the digital ports

2015-12-14T11:39:59Z

Write Ports

2015-12-09T16:38:26Z

Write Ports

2015-12-09T15:27:29Z

Read Ports

2015-12-09T15:04:20Z

Write Ports

2015-12-09T15:03:39Z

Read Ports

@@ Line 138: / Line 138: @@
 |}
+=== inputs and pullups ===
 When a bit is defined as "input", you can use the data register (0x10) to configure the pullup on the pin. So if you write a 0 to a bit there, the corresponding pin will float, and can very easily be driven high or low. (max load by the chip: 1 micro amp). If you write a 1 there, the chip will drive a weak pullup of about 50k. This is useful to connect a switch for example. The switch goes from the pin to ground, and you activate the pullup to define the pin as "high" when the switch is not activated.

@@ Line 137: / Line 137: @@
 | 10 || IO6 || 40
 |}
+When a bit is defined as "input", you can use the data register (0x10) to configure the pullup on the pin. So if you write a 0 to a bit there, the corresponding pin will float, and can very easily be driven high or low. (max load by the chip: 1 micro amp). If you write a 1 there, the chip will drive a weak pullup of about 50k. This is useful to connect a switch for example. The switch goes from the pin to ground, and you activate the pullup to define the pin as "high" when the switch is not activated.
 = Using the analog inputs =

@@ Line 121: / Line 121: @@
 == BitMask value for every pin ==
 {| border=1
-! Pin !! Function !! value
+! Pin !! Function !! Value
 |-
 | 3 || IO0 || 01

@@ Line 119: / Line 119: @@
 For boards that only have outputs, like 3fets, 7fets, relay and bigrelay, the firmware will now default all the pins to outputs. However some early versions didn't have that yet. So we recommend that you still explicitly make the signals into outputs in your code. So we recommend that you send a 0xff to register 0x30 in the initialization sequence.
-== BitMask Value for every pin ==
+== BitMask value for every pin ==
 {| border=1
 ! Pin !! Function !! value

@@ Line 118: / Line 118: @@
 For boards that only have outputs, like 3fets, 7fets, relay and bigrelay, the firmware will now default all the pins to outputs. However some early versions didn't have that yet. So we recommend that you still explicitly make the signals into outputs in your code. So we recommend that you send a 0xff to register 0x30 in the initialization sequence.
+== BitMask Value for every pin ==
+{| border=1
+! Pin !! Function !! value
+|-
+| 3 || IO0 || 01
+|-
+| 4 || IO1 || 02
+|-
+| 5 || IO2 || 04
+|-
+| 6 || IO3 || 08
+|-
+| 8 || IO4 || 10
+|-
+| 9 || IO5 || 20
+|-
+| 10 || IO6 || 40
+|}
 = Using the analog inputs =

@@ Line 21: / Line 21: @@
 | 0x20 .. 0x26 || X || X || X ||  || set one output (0x20 for output 0, 0x21 for output 1 etc)
 |-
-| 0x30 || X || X || X ||  || define pins as inputs or outputs. 0 means input, 1 means output.
+| 0x30 || X || X || X ||  || define pins as inputs or outputs. 0 means input, 1 means output. (Read: Using the digital ports)
 |-
 | 0x40 || X || X ||  ||  || set current position. (32 bits) The current position will be "renamed" to the given value. No motor movement will occur.
@@ Line 31: / Line 31: @@
 | 0x43 || X || X ||  ||  || set stepdelay. (in tenths of a microsecond, default 200: 20ms between steps). (8bits)
 |-
-| 0x50 .. 0x56 || v1.1 and up || X ||  ||  || Set PWM value. 0x50: output 0, 0x51 output 1 etc.
+| 0x50 .. 0x56 || v1.1 and up || X ||  ||  || Set PWM value. 0x50: output 0, 0x51 output 1 etc. (Read: Using the digital ports)
 |-
 | 0x5f || v1.1 and up || X ||  ||  || Set PWM mask. PWM is enabled on the outputs, who's bit is high. send 0x01 as data, to enable PWM on output 0

@@ Line 50: / Line 50: @@
 |}
-All the above ports are read/write. I.e. if you read from that port, you will get the current value.
+All the above ports are read/write. It is if you read from that port, you will get the current value.
 = Read Ports =

@@ Line 98: / Line 98: @@
 | 0x56 || v1.1 and up  || X ||  ||  || Return PWM value for output 6
 |-
-| 0x5f || v1.1 and up  || X ||  ||  || Return PWM mask. PWM is enabled on the outputs, who's bit is high. send 0x01 as data, to enable PWM on output 0
+| 0x5f || v1.1 and up  || X ||  ||  || Return PWM mask. PWM is enabled on the outputs, who's bit is high. send 0x01 as data, to read PWM on output 0
 |-
 | 0x60.. 0x66 || v1.2 and up ||  ||  ||  || Return analog value (2 bytes)

@@ Line 19: / Line 19: @@
 | 0x10 || X || X || X ||  || set all outputs (bit 0 is output 0, etc).
 |-
-| 0x20 .. 0x27 || X || X || X ||  || set one output (0x20 for output 0, 0x21 for output 1 etc)
+| 0x20 .. 0x26 || X || X || X ||  || set one output (0x20 for output 0, 0x21 for output 1 etc)
 |-
 | 0x30 || X || X || X ||  || define pins as inputs or outputs. 0 means input, 1 means output.
@@ Line 35: / Line 35: @@
 | 0x5f || v1.1 and up || X ||  ||  || Set PWM mask. PWM is enabled on the outputs, who's bit is high. send 0x01 as data, to enable PWM on output 0
 |-
-| 0x70 .. 0x77 || v1.2 and up ||  ||  ||  || Select which i/o is coupled to which ADC channel. See [[analog inputs]]
+| 0x70 .. 0x76 || v1.2 and up ||  ||  ||  || Select which i/o is coupled to which ADC channel. See [[analog inputs]]
 |-
 | 0x80 || v1.2 and up ||  ||  ||  || Set number of ADC channels to read

@@ Line 76: / Line 76: @@
 | 0x17 || X ||  ||  ||  || "hasgonedown" the signal has been seen to transition "DOWN" since you last read this register.
 |-
-| 0x20 .. 0x27 || X ||  ||  || X || read one input (0x20 for input 0, 0x21 for input 1 etc)
+| 0x20 .. 0x26 || X ||  ||  || X || read one input (0x20 for input 0, 0x21 for input 1 etc)
 |-
 | 0x40 || X || X ||  ||  || read current position.
@@ Line 100: / Line 100: @@
 | 0x5f || v1.1 and up  || X ||  ||  || Return PWM mask. PWM is enabled on the outputs, who's bit is high. send 0x01 as data, to enable PWM on output 0
 |-
-| 0x60.. 0x67 || v1.2 and up ||  ||  ||  || Return analog value (2 bytes)
+| 0x60.. 0x66 || v1.2 and up ||  ||  ||  || Return analog value (2 bytes)
 |-
 | 0x68 .. 0x6f || v1.2 and up ||  ||  ||  || Return added and bitshifted analog value (2 bytes)