di0ib/keybrd
Archived
1
0
Fork 0
Code Releases Activity

document

Browse Source
This commit is contained in:
wolfv6 2016-05-10 11:15:47 -06:00
parent 4214c51bae
commit d0ad8ead81
2 changed files with 11 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
tutorials/tutorial_0_introduction.md
View File

@ -24,3 +24,5 @@ The tutorials assume the reader:
You will need a breadboard keyboard with a Teensy 2.0 controller to run the tutorial sketches. 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 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. 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-nc-sa/4.0/"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/l/by-nc-sa/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/tree/master/tutorials" property="cc:attributionName" rel="cc:attributionURL">Wolfram Volpi</a> is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/4.0/">Creative Commons Attribution-NonCommercial-ShareAlike 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>.

17
tutorials/tutorial_1_breadboard_keyboard.md
View File

@ -3,26 +3,27 @@ Tutorial 1 - breadboard keyboard
When you finish this tutorial you will have a working keyboard and understand how a key matrix works. When you finish this tutorial you will have a working keyboard and understand how a key matrix works.
## Why a breadboard keyboard is useful ## Why a breadboard keyboard is useful
A breadboard is the easiest way to learn keyboard electronics. All the tutorial example sketches run on breadboard keyboards that have 2 to 8 keys.
Electronics are fickle, you won't get everything right the first time, there is a learning curve.
Breadboards make the learning electronics faster and fun.
Breadboard keyboards have row-column matrices and diodes just like the big keyboards. Breadboard keyboards have row-column matrices and diodes just like the big keyboards.
Compared to full size keyboards on PCBs, breadboard keyboards are easier to learn on because:
A breadboard is the easiest way to learn keyboard electronics.
Electronics are fickle, and you won't get everything right the first time.
There is a learning curve.
Compared to PCBs, breadboard keyboards are easier to learn on because:
* Mistakes are easily corrected because no desoldering
* Parts can be reused in many different configurations * Parts can be reused in many different configurations
* A small keyboard is easier to trouble shoot * A small keyboard is easier to trouble shoot
* Mistakes are easily corrected because no desoldering
Breadboard keyboards are useful for: Breadboard keyboards are useful for:
* learning keyboard electronics - diodes, micro controllers, I/O expanders * learning keyboard electronics - diodes, micro controllers, I/O expanders
* learning the firmware development workflow * learning the firmware development workflow
* prototyping circuits before making a PCB * prototyping circuits before making a PCB
* testing firmware concepts before building the keyboard hardware * testing firmware concepts before committing to a keyboard-hardware design
## How a breadboard works ## How a breadboard works
To understand the breadboard keyboard you will need to know the internal parts of a breadboard: To understand the breadboard keyboard you will need to know the internal parts of a breadboard:
* terminal strip
* power rail * power rail
* terminal strip
These are explained in [How to Use a Breadboard](https://learn.sparkfun.com/tutorials/how-to-use-a-breadboard) These are explained in [How to Use a Breadboard](https://learn.sparkfun.com/tutorials/how-to-use-a-breadboard)