keybrd/tutorials/tutorial_2_single-layer_keyboard.md

Tutorial 2 - single-layer keyboard
=======================================
The easiest way to learn the keyboard library is to read some simple sketches.
[keybrd_2_single-layer.ino](keybrd_2_single-layer/keybrd_2_single-layer.ino) is a simple sketch with annotations that explain how a keybrd sketch works.
The sketch will run on the basic breadboard keyboard described in [tutorial_1_breadboard_keyboard.md](tutorial_1_breadboard_keyboard.md)

After reading the sketch you will be able to modify it to suite your own single-layer keyboard design.

![basic breadboard keyboard](keybrd_1_breadboard/basic_breadboard_keyboard_front.JPG "basic breadboard keyboard")

Exercises
---------
1) Read the four class definitions #included in the sketch.
Classes are defined in the [keybrd library](../src/).

2) Add a fifth key to the breadboard keyboard and sketch.
Not all rows have to have the same number of keys.
The scanner should have enough readPins to cover all the keys of the longest row.

| Layout |**0**|**1**|**2**|
|:------:|:---:|:---:|:---:|
|  **0** |  1  |  2  |  3  |
|  **1** |  a  |  b  |     |

Please take the [keybrd tutorials usability survey](../CONTRIBUTING.md#keybrd-tutorials-usability-survey)

<br>
<a rel="license" href="https://creativecommons.org/licenses/by/4.0/"><img alt="Creative Commons License" style="border-width:0" src="https://licensebuttons.net/l/by/4.0/88x31.png" /></a><br /><span xmlns:dct="http://purl.org/dc/terms/" property="dct:title">keybrd tutorial</span> by <a xmlns:cc="https://creativecommons.org/ns" href="https://github.com/wolfv6/keybrd" property="cc:attributionName" rel="cc:attributionURL">Wolfram Volpi</a> is licensed under a <a rel="license" href="https://creativecommons.org/licenses/by/4.0/">Creative Commons Attribution 4.0 International License</a>.<br />Permissions beyond the scope of this license may be available at <a xmlns:cc="https://creativecommons.org/ns" href="https://github.com/wolfv6/keybrd/issues/new" rel="cc:morePermissions">https://github.com/wolfv6/keybrd/issues/new</a>.
initial commit keybrd version 0.3.0 2016-05-09 14:05:08 +00:00			`Tutorial 2 - single-layer keyboard`
			`=======================================`
document 2016-06-05 20:43:53 +00:00			`The easiest way to learn the keyboard library is to read some simple sketches.`
rename layer to layerId 2016-09-20 01:46:03 +00:00			`[keybrd_2_single-layer.ino](keybrd_2_single-layer/keybrd_2_single-layer.ino) is a simple sketch with annotations that explain how a keybrd sketch works.`
update tutorials 0 to 6 2016-07-18 02:03:03 +00:00			`The sketch will run on the basic breadboard keyboard described in [tutorial_1_breadboard_keyboard.md](tutorial_1_breadboard_keyboard.md)`

			`After reading the sketch you will be able to modify it to suite your own single-layer keyboard design.`
document 2016-06-05 20:43:53 +00:00
rename LED_IOE to LED_Port, update tutorials and sketches 2016-09-28 19:56:10 +00:00			`![basic breadboard keyboard](keybrd_1_breadboard/basic_breadboard_keyboard_front.JPG "basic breadboard keyboard")`
move Debug variables to static 2016-07-18 02:26:00 +00:00
			`Exercises`
			`---------`
update diagrams and tutorials: 0 1 2 3a 2016-09-17 05:45:12 +00:00			`1) Read the four class definitions #included in the sketch.`
document and format 2016-07-22 08:11:38 +00:00			`Classes are defined in the [keybrd library](../src/).`
move Debug variables to static 2016-07-18 02:26:00 +00:00
update diagrams and tutorials: 0 1 2 3a 2016-09-17 05:45:12 +00:00			`2) Add a fifth key to the breadboard keyboard and sketch.`
			`Not all rows have to have the same number of keys.`
			`The scanner should have enough readPins to cover all the keys of the longest row.`
initial commit keybrd version 0.3.0 2016-05-09 14:05:08 +00:00
document and format 2016-07-22 08:11:38 +00:00			`\| Layout \|0\|1\|2\|`
			`\|:------:\|:---:\|:---:\|:---:\|`
update diagrams and tutorials: 0 1 2 3a 2016-09-17 05:45:12 +00:00			`\| 0 \| 1 \| 2 \| 3 \|`
add sr0_LED_shiftRegs.ino, LED_shiftRegs, LED_shiftRegs 2016-10-30 08:30:13 +00:00			`\| 1 \| a \| b \| \|`

document 2016-11-06 19:43:09 +00:00			`Please take the [keybrd tutorials usability survey](../CONTRIBUTING.md#keybrd-tutorials-usability-survey)`
document and format 2016-07-22 08:11:38 +00:00
move Debug variables to static 2016-07-18 02:26:00 +00:00			`<br>`
fix broken links 2016-07-21 20:20:07 +00:00			<a rel="license" href="https://creativecommons.org/licenses/by/4.0/"><img alt="Creative Commons License" style="border-width:0" src="https://licensebuttons.net/l/by/4.0/88x31.png" /></a><br /><span xmlns:dct="http://purl.org/dc/terms/" property="dct:title">keybrd tutorial</span> by <a xmlns:cc="https://creativecommons.org/ns" href="https://github.com/wolfv6/keybrd" property="cc:attributionName" rel="cc:attributionURL">Wolfram Volpi</a> is licensed under a <a rel="license" href="https://creativecommons.org/licenses/by/4.0/">Creative Commons Attribution 4.0 International License</a>.<br />Permissions beyond the scope of this license may be available at <a xmlns:cc="https://creativecommons.org/ns" href="https://github.com/wolfv6/keybrd/issues/new" rel="cc:morePermissions">https://github.com/wolfv6/keybrd/issues/new</a>.