diff --git a/tutorials/tutorial_0_introduction.md b/tutorials/tutorial_0_introduction.md index 9c0d654..0808586 100644 --- a/tutorials/tutorial_0_introduction.md +++ b/tutorials/tutorial_0_introduction.md @@ -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. 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. + +Creative Commons License
keybrd tutorial by Wolfram Volpi is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.
Permissions beyond the scope of this license may be available at https://github.com/wolfv6/keybrd/issues/new. diff --git a/tutorials/tutorial_1_breadboard_keyboard.md b/tutorials/tutorial_1_breadboard_keyboard.md index a16c50c..5909207 100644 --- a/tutorials/tutorial_1_breadboard_keyboard.md +++ b/tutorials/tutorial_1_breadboard_keyboard.md @@ -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. ## Why a breadboard keyboard is useful -A breadboard is the easiest way to learn keyboard electronics. -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. - +All the tutorial example sketches run on breadboard keyboards that have 2 to 8 keys. 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 * A small keyboard is easier to trouble shoot -* Mistakes are easily corrected because no desoldering Breadboard keyboards are useful for: * learning keyboard electronics - diodes, micro controllers, I/O expanders * learning the firmware development workflow * 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 To understand the breadboard keyboard you will need to know the internal parts of a breadboard: -* terminal strip * power rail +* terminal strip These are explained in [How to Use a Breadboard](https://learn.sparkfun.com/tutorials/how-to-use-a-breadboard)