keybrd/tutorials/tutorial_0_introduction.md

Tutorial 0 - Introduction
=========================
Tutorials 2 through 6 present an example sketch.
All the example sketches have 2 to 8 keys and run on a breadboard keyboard.

The first two tutorials are intended to be read in sequence:
 1. Breadboard keyboard
 2. Single-layer keybrd

Topics covered in tutorial 2 apply to all keybrd sketches.
The remaining tutorials can be read in any order.

The tutorials assume the reader:
* is familiar with C++
* is new to Arduino, firmware, controllers, and the internal workings of keyboards

<!-- todo -->
> All the tutorial sketches are tested on teensy 2.0 and PCA9655E-D I/O expander

> The tutorial sketches will be changed to Teensy LC and MCP23018 I/O expander

> Some of the pictures do not match the sketches, they will be updated after changing to Teensy LC

> Schematic diagrams are missing from tutorials 2 and 4, they will be added after changing to Teensy LC

You will need a breadboard keyboard with a Teensy 2.0 controller to run the tutorial sketches.
If you use a different controller, you may have to change port classes.
If you already have a keyboard with an Arduino compatible controller, you can use that instead of a breadboard keyboard.

<a rel="license" href="http://creativecommons.org/licenses/by/4.0/"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/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="http://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="http://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="http://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 0 - Introduction`
			`=========================`
document 2016-05-10 15:05:25 +00:00			`Tutorials 2 through 6 present an example sketch.`
			`All the example sketches have 2 to 8 keys and run on a breadboard keyboard.`

initial commit keybrd version 0.3.0 2016-05-09 14:05:08 +00:00			`The first two tutorials are intended to be read in sequence:`
			`1. Breadboard keyboard`
			`2. Single-layer keybrd`
document 2016-05-10 15:05:25 +00:00
initial commit keybrd version 0.3.0 2016-05-09 14:05:08 +00:00			`Topics covered in tutorial 2 apply to all keybrd sketches.`
document 2016-05-10 15:05:25 +00:00			`The remaining tutorials can be read in any order.`
initial commit keybrd version 0.3.0 2016-05-09 14:05:08 +00:00
			`The tutorials assume the reader:`
document 2016-05-10 15:05:25 +00:00			`* is familiar with C++`
			`* is new to Arduino, firmware, controllers, and the internal workings of keyboards`
initial commit keybrd version 0.3.0 2016-05-09 14:05:08 +00:00
document 2016-05-10 15:05:25 +00:00			`<!-- todo -->`
			`> All the tutorial sketches are tested on teensy 2.0 and PCA9655E-D I/O expander`

improve tutorials 2016-05-11 15:25:48 +00:00			`> The tutorial sketches will be changed to Teensy LC and MCP23018 I/O expander`
initial commit keybrd version 0.3.0 2016-05-09 14:05:08 +00:00
improve tutorials 2016-05-11 15:25:48 +00:00			`> Some of the pictures do not match the sketches, they will be updated after changing to Teensy LC`
initial commit keybrd version 0.3.0 2016-05-09 14:05:08 +00:00
improve tutorials 2016-05-11 18:46:53 +00:00			`> Schematic diagrams are missing from tutorials 2 and 4, they will be added after changing to Teensy LC`

initial commit keybrd version 0.3.0 2016-05-09 14:05:08 +00:00			`You will need a breadboard keyboard with a Teensy 2.0 controller to run the tutorial sketches.`
			`If you use a different controller, you may have to change port classes.`
			`If you already have a keyboard with an Arduino compatible controller, you can use that instead of a breadboard keyboard.`
document 2016-05-10 17:15:47 +00:00
improve tutorials 2016-05-11 15:25:48 +00:00			<a rel="license" href="http://creativecommons.org/licenses/by/4.0/"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/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="http://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="http://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="http://creativecommons.org/ns#" href="https://github.com/wolfv6/keybrd/issues/new" rel="cc:morePermissions">https://github.com/wolfv6/keybrd/issues/new</a>.