==== Rotary-Encoder on Android ====

<WRAP center round important>
** You must install the Android release V2.6 or higher to use Rotary-Encoder. ** \\
** In this example, we used PEL12T Rotary Encoder. ** \\
** Please check the revision of PCB. This page is based on the board revision 0.2. **
</WRAP>

This page explains how to use the Rotary-Encoder example. \\
It can be used for volume control, page up/down and etc. \\

Rotary-Encoder control example App project : [[https://github.com/codewalkerster/RotaryEncoder|Rotary-Encoder controller]] \\
Applied patches to kernel : [[https://github.com/hardkernel/linux/commit/8ade58eac365fbc2386ce1a3663f1508c1431c99|patch 1]], [[https://github.com/hardkernel/linux/commit/699df5848d06c0d527066a9ffef84ccc5e766a5d|patch 2]]\\
[[http://www.bourns.com/docs/Product-Datasheets/PEL12T.pdf|PEL12T Data sheet]]
=== Rotary-Encoder circuit ===
If you want to connect pin to another GPIO pin, please check GPIO description.[[en:c2_hardware&#expansion_connectors|GPIO Pin description]] \\

{{:en:rotary_encoder_bb.png?direct&200|}} \\
The schematic of Rotary-Encoder circuit. \\
{{:en:rotary_encoder_schem.png?direct&200|}} \\

{{:en:rotary.jpg?direct&300|}}

=== Result of using Rotary-Encoder and Controller app ===
After install the Rotary-Encoder controller app, you can map the gpio code and keycode to each opertions. you can change the keycode.
[[http://www.comptechdoc.org/os/linux/howlinuxworks/linux_hlkeycodes.html|reference]] \\

In first screen shot, Count clock wise operation is mapped to Volume Down, clock wise operations is mapped to Volume Up and switch button(push the Rotary-encoder) is mapped to mute key. \\
{{:en:volume_control.png?direct&400|}} \\

In second, Count clock wise operation is mapped to KEYCODE_DPAD_DOWN, clock wise operations is mapped to KEYCODE_DPAD_UP, and switch button is mapped to KEYCODE_ENTER. \\
{{:en:up_down.png?direct&400|}}