Arduino Rotary Encoder Protocol

This protocol controls a rotary encoder connected to the microcontroller. Rotary encoders can turn infinite number of rounds. If the rotary encoder turns or the state of the button on the encoder changes, the device sends an event to the .Net. You can use full, half or quarter rotary encoders.

How to build a test circuit with a rotary encoder and an Arduino Mega?
Arduino codes are included.

I. "Welcome" event from microcontroller

Example

c=welcome&type=OzRotaryController&id=IqlZci&pos=2&t=3

Parameters

Parameter	Type	Range	Functionality
c	String	"welcome"	Identifies the welcome message.
type	String	"OzRotaryController"	Determines the type of the device.
id	String	6 characters (numbers, uppercase and lowercase characters)	The ID of the device which is chosen by the microcontroller.
pos	Byte	0-255	Determines the position of the device on the list of the ID manager of the microcontroller. Please make sure there are no other devices in the same position.
t	Byte	0-255	Counts the number of events sent combined. Counts from 0 to 255 then from 0 again.

II. Commands to microcontroller

None

III. Event from microcontroller

"Rotary Changed" event

This event is called if the rotary encoder changes direction or the button is pressed or released.

Example

c=rotarychange&button=1&left=0&right=0&id=IqlZci&t=3

Parameters

Parameter	Type	Range	Functionality
c	String	"rotarychange"	Identifies the event.
button	Bool	0,1	Button's state (see:OzekiButtonController).
left	Bool	0,1	If rotated left, it changes to 1. It is 0 otherwise.
right	Bool	0,1	If rotated right, it changes to 1. It is 0 otherwise.
id	String	6 characters (numbers, uppercase and lowercase characters)	The ID of the device which is chosen by the microcontroller.
t	Byte	0-255	Counts the number of events sent combined. Counts from 0 to 255 then from 0 again.

Response

This response is sent from your computer.

c=rotarychange_resp&button=1&left=0&right=0&id=IqlZci&t=1

Parameters

Parameter	Type	Range	Functionality
c	String	"rotarychange_resp"	Identifies the event response.
button	Bool	0,1	Button's state (see:OzekiButtonController).
left	Bool	0,1	If rotated left, it changes to 1. It is 0 otherwise.
right	Bool	0,1	If rotated right, changes to 1. It is 0 otherwise.
id	String	6 characters (numbers, uppercase and lowercase characters)	The ID of the device which is chosen by the microcontroller.
t	Byte	0-255	Counts the number of responses sent combined. Counts from 0 to 255 then from 0 again.