fixed *.md indenting
apparently, sublists need to be indented 4 spaces (1 tab) or more to be recognized as such (because subsequent lines of a list may be indented up to 3 spaces). it's right there on the markdown syntax page, but i didn't catch it the first time.partial-rewrite
Ben Blazak
parent
a0f69c9200
commit
15efb43b76
140
references.md
140
references.md
|
|
@ -4,9 +4,9 @@
|
||||||
(http://www.ladyada.net/wiki/lib/exe/fetch.php?hash=a2c6a9&w=501&h=785&media=http%3A%2F%2Fwww.ladyada.net%2Fimages%2Fmetertutorial%2Frescolorcode.jpg)
|
(http://www.ladyada.net/wiki/lib/exe/fetch.php?hash=a2c6a9&w=501&h=785&media=http%3A%2F%2Fwww.ladyada.net%2Fimages%2Fmetertutorial%2Frescolorcode.jpg)
|
||||||
: image
|
: image
|
||||||
|
|
||||||
* from [the Multimeter Tutorial]
|
* from [the Multimeter Tutorial]
|
||||||
(http://www.ladyada.net/learn/multimeter/resistance.html)
|
(http://www.ladyada.net/learn/multimeter/resistance.html)
|
||||||
(on <http://ladyada.net/>)
|
(on <http://ladyada.net/>)
|
||||||
|
|
||||||
* [Schematic Symbols]
|
* [Schematic Symbols]
|
||||||
(http://img.docstoccdn.com/thumb/orig/28066054.png)
|
(http://img.docstoccdn.com/thumb/orig/28066054.png)
|
||||||
|
|
@ -22,14 +22,14 @@
|
||||||
* [Powering Light Emitting Diodes(LEDs)]
|
* [Powering Light Emitting Diodes(LEDs)]
|
||||||
(http://wolfstone.halloweenhost.com/Lighting/litlpo_PoweringLEDs.html)
|
(http://wolfstone.halloweenhost.com/Lighting/litlpo_PoweringLEDs.html)
|
||||||
|
|
||||||
* can also be reached via <http://thewolfstone.com/>
|
* can also be reached via <http://thewolfstone.com/>
|
||||||
-> [ENTER] ('http://thewolfstone.com/Welcome/Home.html)
|
-> [ENTER] ('http://thewolfstone.com/Welcome/Home.html)
|
||||||
-> [Wolfstone's Haunted Halloween Page]
|
-> [Wolfstone's Haunted Halloween Page]
|
||||||
(http://thewolfstone.com/_ar/Halloween.html)
|
(http://thewolfstone.com/_ar/Halloween.html)
|
||||||
-> [technology]
|
-> [technology]
|
||||||
(http://wolfstone.halloweenhost.com/Navigation/TechBase.html)
|
(http://wolfstone.halloweenhost.com/Navigation/TechBase.html)
|
||||||
-> [powering LEDs]
|
-> [powering LEDs]
|
||||||
(http://wolfstone.halloweenhost.com/Lighting/litlpo_PoweringLEDs.html)
|
(http://wolfstone.halloweenhost.com/Lighting/litlpo_PoweringLEDs.html)
|
||||||
|
|
||||||
* [All About Circuits : Reference]
|
* [All About Circuits : Reference]
|
||||||
(http://www.allaboutcircuits.com/vol_5/index.html)
|
(http://www.allaboutcircuits.com/vol_5/index.html)
|
||||||
|
|
@ -115,8 +115,10 @@
|
||||||
: tutorial by [Dean Camera] (http://fourwalledcubicle.com/AboutMe.php)
|
: tutorial by [Dean Camera] (http://fourwalledcubicle.com/AboutMe.php)
|
||||||
(on <http://www.avrfreaks.net/>)
|
(on <http://www.avrfreaks.net/>)
|
||||||
|
|
||||||
* updated version available as a pdf at [Four Walled Cubicle : AVR Articles]
|
* updated version available as a pdf at
|
||||||
(http://www.fourwalledcubicle.com/AVRArticles.php), along with a few other good articles on AVR programming
|
[Four Walled Cubicle : AVR Articles]
|
||||||
|
(http://www.fourwalledcubicle.com/AVRArticles.php), along with a few
|
||||||
|
other good articles on AVR programming
|
||||||
|
|
||||||
|
|
||||||
## Protocol Stuff
|
## Protocol Stuff
|
||||||
|
|
@ -150,7 +152,7 @@
|
||||||
* [HID Device Class Definition]
|
* [HID Device Class Definition]
|
||||||
(http://www.usb.org/developers/devclass_docs/HID1_11.pdf)
|
(http://www.usb.org/developers/devclass_docs/HID1_11.pdf)
|
||||||
: pdf (from <http://www.usb.org/developers/hidpage>)
|
: pdf (from <http://www.usb.org/developers/hidpage>)
|
||||||
* HID = Human Interface Device
|
* HID = Human Interface Device
|
||||||
|
|
||||||
* [HID Usage Tables]
|
* [HID Usage Tables]
|
||||||
(http://www.usb.org/developers/devclass_docs/Hut1_12v2.pdf)
|
(http://www.usb.org/developers/devclass_docs/Hut1_12v2.pdf)
|
||||||
|
|
@ -164,38 +166,38 @@
|
||||||
* zip: [Phantom Firmware from PrinsValium]
|
* zip: [Phantom Firmware from PrinsValium]
|
||||||
(http://geekhack.org/attachment.php?attachmentid=38982&d=1327895092)
|
(http://geekhack.org/attachment.php?attachmentid=38982&d=1327895092)
|
||||||
|
|
||||||
* mentioned in the [Building Phantom Hardware and Firmware Mods]
|
* mentioned in the [Building Phantom Hardware and Firmware Mods]
|
||||||
(http://geekhack.org/showwiki.php?title=Island:26742)
|
(http://geekhack.org/showwiki.php?title=Island:26742)
|
||||||
article (on <http://geekhack.org/>)
|
article (on <http://geekhack.org/>)
|
||||||
|
|
||||||
* github: [tmk / tmk_keyboard]
|
* github: [tmk / tmk_keyboard]
|
||||||
(https://github.com/tmk/tmk_keyboard)
|
(https://github.com/tmk/tmk_keyboard)
|
||||||
|
|
||||||
* forked by [Pyrolistical / tmk_keyboard]
|
* forked by [Pyrolistical / tmk_keyboard]
|
||||||
(https://github.com/Pyrolistical/tmk_keyboard/tree/master/fourway)
|
(https://github.com/Pyrolistical/tmk_keyboard/tree/master/fourway)
|
||||||
|
|
||||||
* mentioned in the [KeyPoard]
|
* mentioned in the [KeyPoard]
|
||||||
(http://geekhack.org/showwiki.php?title=Island:26845)
|
(http://geekhack.org/showwiki.php?title=Island:26845)
|
||||||
article on <http://geekhack.org/>
|
article on <http://geekhack.org/>
|
||||||
|
|
||||||
* forked by [riffautae / tmk_keyboard]
|
* forked by [riffautae / tmk_keyboard]
|
||||||
(https://github.com/riffautae/tmk_keyboard)
|
(https://github.com/riffautae/tmk_keyboard)
|
||||||
|
|
||||||
* mentioned on the [Teensy Keyboard Firmware Discussion]
|
* mentioned on the [Teensy Keyboard Firmware Discussion]
|
||||||
(http://geekhack.org/showthread.php?26730-Teensy-Keyboard-Firmware-Discussion/page2)
|
(http://geekhack.org/showthread.php?26730-Teensy-Keyboard-Firmware-Discussion/page2)
|
||||||
thread on <http://geekhack.org/>
|
thread on <http://geekhack.org/>
|
||||||
|
|
||||||
* github: [humblehacker / keyboard]
|
* github: [humblehacker / keyboard]
|
||||||
(https://github.com/humblehacker/keyboard)
|
(https://github.com/humblehacker/keyboard)
|
||||||
|
|
||||||
* mentioned on [the humblehacker keyboard website]
|
* mentioned on [the humblehacker keyboard website]
|
||||||
(http://humblehacker.com/keyboard/)
|
(http://humblehacker.com/keyboard/)
|
||||||
|
|
||||||
* mentioned on [the humblehacker geekhack page]
|
* mentioned on [the humblehacker geekhack page]
|
||||||
(http://geekhack.org/showwiki.php?title=Island:6292)
|
(http://geekhack.org/showwiki.php?title=Island:6292)
|
||||||
|
|
||||||
* mentioned on [the designer's blog]
|
* mentioned on [the designer's blog]
|
||||||
(http://humblehacker.com/blog/)
|
(http://humblehacker.com/blog/)
|
||||||
|
|
||||||
### USB Libraries
|
### USB Libraries
|
||||||
|
|
||||||
|
|
@ -205,8 +207,8 @@
|
||||||
* zip: [PJRC: usb_keyboard]
|
* zip: [PJRC: usb_keyboard]
|
||||||
(http://pjrc.com/teensy/usb_keyboard.zip)
|
(http://pjrc.com/teensy/usb_keyboard.zip)
|
||||||
|
|
||||||
* mentioned on [the PJRC website]
|
* mentioned on [the PJRC website]
|
||||||
(http://pjrc.com/teensy/usb_keyboard.html)
|
(http://pjrc.com/teensy/usb_keyboard.html)
|
||||||
|
|
||||||
### TWI Libraries
|
### TWI Libraries
|
||||||
|
|
||||||
|
|
@ -235,8 +237,8 @@
|
||||||
* zip: [PJRC: blinky]
|
* zip: [PJRC: blinky]
|
||||||
(http://pjrc.com/teensy/blinky.zip)
|
(http://pjrc.com/teensy/blinky.zip)
|
||||||
|
|
||||||
* mentioned on [the PJRC website]
|
* mentioned on [the PJRC website]
|
||||||
(http://pjrc.com/teensy/gcc.html)
|
(http://pjrc.com/teensy/gcc.html)
|
||||||
|
|
||||||
|
|
||||||
## Hardware Documentation
|
## Hardware Documentation
|
||||||
|
|
@ -244,44 +246,44 @@
|
||||||
* [Microchip: Analog & Interface Product Selector Guide]
|
* [Microchip: Analog & Interface Product Selector Guide]
|
||||||
(http://ww1.microchip.com/downloads/en/DeviceDoc/21060z.pdf)
|
(http://ww1.microchip.com/downloads/en/DeviceDoc/21060z.pdf)
|
||||||
|
|
||||||
* from [the Microchip website (MCP23017 product listing page)]
|
* from [the Microchip website (MCP23017 product listing page)]
|
||||||
(http://www.microchip.com/wwwproducts/Devices.aspx?dDocName=en023499)
|
(http://www.microchip.com/wwwproducts/Devices.aspx?dDocName=en023499)
|
||||||
|
|
||||||
* [MCP23017 / MCP23S17 Data Sheet]
|
* [MCP23017 / MCP23S17 Data Sheet]
|
||||||
(http://ww1.microchip.com/downloads/en/DeviceDoc/21952b.pdf)
|
(http://ww1.microchip.com/downloads/en/DeviceDoc/21952b.pdf)
|
||||||
|
|
||||||
* from [the Microchip website]
|
* from [the Microchip website]
|
||||||
(http://www.microchip.com/wwwproducts/Devices.aspx?dDocName=en023499)
|
(http://www.microchip.com/wwwproducts/Devices.aspx?dDocName=en023499)
|
||||||
|
|
||||||
* [MCP23018 / MCP23S18 Data Sheet]
|
* [MCP23018 / MCP23S18 Data Sheet]
|
||||||
(http://ww1.microchip.com/downloads/en/DeviceDoc/22103a.pdf)
|
(http://ww1.microchip.com/downloads/en/DeviceDoc/22103a.pdf)
|
||||||
|
|
||||||
* from [the Microchip website]
|
* from [the Microchip website]
|
||||||
(http://www.microchip.com/wwwproducts/Devices.aspx?dDocName=en537375)
|
(http://www.microchip.com/wwwproducts/Devices.aspx?dDocName=en537375)
|
||||||
|
|
||||||
* [Teensy 2.0 (ATMEGA32U4) Data Sheet]
|
* [Teensy 2.0 (ATMEGA32U4) Data Sheet]
|
||||||
(http://pjrc.com/teensy/atmega32u4.pdf)
|
(http://pjrc.com/teensy/atmega32u4.pdf)
|
||||||
|
|
||||||
* from [the PJRC website]
|
* from [the PJRC website]
|
||||||
(http://pjrc.com/teensy/datasheets.html)
|
(http://pjrc.com/teensy/datasheets.html)
|
||||||
|
|
||||||
* [Teensy++ 2.0 (AT90USB1286) Data Sheet]
|
* [Teensy++ 2.0 (AT90USB1286) Data Sheet]
|
||||||
(http://pjrc.com/teensy/at90usb1286.pdf)
|
(http://pjrc.com/teensy/at90usb1286.pdf)
|
||||||
|
|
||||||
* from [the PJRC website]
|
* from [the PJRC website]
|
||||||
(http://pjrc.com/teensy/datasheets.html)
|
(http://pjrc.com/teensy/datasheets.html)
|
||||||
|
|
||||||
* [Teensy 2.0 Pin Assignments, Using C]
|
* [Teensy 2.0 Pin Assignments, Using C]
|
||||||
(http://pjrc.com/teensy/card2a.pdf)
|
(http://pjrc.com/teensy/card2a.pdf)
|
||||||
|
|
||||||
* from [the PJRC website]
|
* from [the PJRC website]
|
||||||
(http://pjrc.com/teensy/datasheets.html)
|
(http://pjrc.com/teensy/datasheets.html)
|
||||||
|
|
||||||
* [Teensy 2.0 Pin Assignments, Using Arduino]
|
* [Teensy 2.0 Pin Assignments, Using Arduino]
|
||||||
(http://pjrc.com/teensy/card2b.pdf)
|
(http://pjrc.com/teensy/card2b.pdf)
|
||||||
|
|
||||||
* from [the PJRC website]
|
* from [the PJRC website]
|
||||||
(http://pjrc.com/teensy/datasheets.html)
|
(http://pjrc.com/teensy/datasheets.html)
|
||||||
|
|
||||||
* [Cherry MX Series Keyswitches : Specifications]
|
* [Cherry MX Series Keyswitches : Specifications]
|
||||||
(http://www.cherrycorp.com/english/switches/key/mx.htm)
|
(http://www.cherrycorp.com/english/switches/key/mx.htm)
|
||||||
|
|
@ -289,6 +291,12 @@
|
||||||
|
|
||||||
## Miscellaneous
|
## Miscellaneous
|
||||||
|
|
||||||
|
### Typical Keyboard Information
|
||||||
|
|
||||||
|
* [Keyboard Scan Rates]
|
||||||
|
(http://geekhack.org/showwiki.php?title=Keyboard+scan+rates)
|
||||||
|
list (on <http://geekhack.org/>)
|
||||||
|
|
||||||
### Documentation and Design Tools
|
### Documentation and Design Tools
|
||||||
|
|
||||||
* [Markdown: Syntax]
|
* [Markdown: Syntax]
|
||||||
|
|
@ -298,34 +306,28 @@
|
||||||
(http://teholabs.com/knowledge/kicad.html)
|
(http://teholabs.com/knowledge/kicad.html)
|
||||||
(on <http://teholabs.com/>)
|
(on <http://teholabs.com/>)
|
||||||
|
|
||||||
* mentioned on the [circuit/block-diagram drawing]
|
* mentioned on the [circuit/block-diagram drawing]
|
||||||
(http://stackoverflow.com/questions/6422603/circuit-block-diagram-drawing)
|
(http://stackoverflow.com/questions/6422603/circuit-block-diagram-drawing)
|
||||||
question (on <http://stackoverflow.com/>)
|
question (on <http://stackoverflow.com/>)
|
||||||
|
|
||||||
* [Ti_k_Z and PGF]
|
* [Ti<i>k</i>Z and PGF]
|
||||||
(http://www.texample.net/tikz/)
|
(http://www.texample.net/tikz/)
|
||||||
: a TeX graphics package
|
: a TeX graphics package
|
||||||
|
|
||||||
* mentioned on the [circuit/block-diagram drawing]
|
* mentioned on the [circuit/block-diagram drawing]
|
||||||
(http://stackoverflow.com/questions/6422603/circuit-block-diagram-drawing)
|
(http://stackoverflow.com/questions/6422603/circuit-block-diagram-drawing)
|
||||||
question (on <http://stackoverflow.com/>)
|
question (on <http://stackoverflow.com/>)
|
||||||
|
|
||||||
* [Documentation (for version 2010-09-28)]
|
* [Documentation (for version 2010-09-28)]
|
||||||
(http://www.texample.net/media/pgf/builds/pgfmanualCVS2010-09-28.pdf)
|
(http://www.texample.net/media/pgf/builds/pgfmanualCVS2010-09-28.pdf)
|
||||||
: pdf
|
: pdf
|
||||||
|
|
||||||
* [Example: Block diagram line junctions]
|
* [Example: Block diagram line junctions]
|
||||||
(http://www.texample.net/tikz/examples/line-junctions/)
|
(http://www.texample.net/tikz/examples/line-junctions/)
|
||||||
|
|
||||||
* [Inkscape : Connector tool tutorial]
|
* [Inkscape : Connector tool tutorial]
|
||||||
(http://wiki.inkscape.org/wiki/index.php/UsingTheConnectorTool)
|
(http://wiki.inkscape.org/wiki/index.php/UsingTheConnectorTool)
|
||||||
|
|
||||||
### Typical Keyboard Information
|
|
||||||
|
|
||||||
* [Keyboard Scan Rates]
|
|
||||||
(http://geekhack.org/showwiki.php?title=Keyboard+scan+rates)
|
|
||||||
list (on <http://geekhack.org/>)
|
|
||||||
|
|
||||||
|
|
||||||
-------------------------------------------------------------------------------
|
-------------------------------------------------------------------------------
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -21,11 +21,11 @@ To write a new one:
|
||||||
for the layout. This should be enough for about 7 layers. Watch your RAM
|
for the layout. This should be enough for about 7 layers. Watch your RAM
|
||||||
usage if you're getting close.
|
usage if you're getting close.
|
||||||
|
|
||||||
* The layout matricies could be moved to flash memory (program space, instead
|
* The layout matricies could be moved to flash memory (program space,
|
||||||
of data space) in order to save RAM, but that doesn't seem necessary at the
|
instead of data space) in order to save RAM, but that doesn't seem
|
||||||
moment. It would also be slightly slower, though that probably shouldn't
|
necessary at the moment. It would also be slightly slower, though that
|
||||||
be a concern. It might be necessary (or convenient) if one were trying to
|
probably shouldn't be a concern. It might be necessary (or convenient)
|
||||||
implement on-keyboard remaping.
|
if one were trying to implement on-keyboard remaping.
|
||||||
|
|
||||||
|
|
||||||
-------------------------------------------------------------------------------
|
-------------------------------------------------------------------------------
|
||||||
|
|
|
||||||
|
|
@ -6,18 +6,20 @@
|
||||||
* coordinates without brackets are unused
|
* coordinates without brackets are unused
|
||||||
* left and right hands are mostly the same except that `row += 6` for the left
|
* left and right hands are mostly the same except that `row += 6` for the left
|
||||||
|
|
||||||
....... rows x columns = positions; assigned, unassigned .......
|
```
|
||||||
....... per hand: 6 x 7 = 42; 38, 4 .......
|
....... rows x columns = positions; assigned, unassigned .......
|
||||||
....... total: 12 x 7 = 84; 76, 8 .......
|
....... per hand: 6 x 7 = 42; 38, 4 .......
|
||||||
----------------------------------------------------------------------------
|
....... total: 12 x 7 = 84; 76, 8 .......
|
||||||
[60][61][62][63][64][65][66] [00][01][02][03][04][05][06]
|
----------------------------------------------------------------------------
|
||||||
[70][71][72][73][74][75][76] [10][11][12][13][14][15][16]
|
[60][61][62][63][64][65][66] [00][01][02][03][04][05][06]
|
||||||
[80][81][82][83][84][85] 86 20 [21][22][23][24][25][26]
|
[70][71][72][73][74][75][76] [10][11][12][13][14][15][16]
|
||||||
[90][91][92][93][94][95][96] [30][31][32][33][34][35][36]
|
[80][81][82][83][84][85] 86 20 [21][22][23][24][25][26]
|
||||||
[A0][A1][A2][A3][A4] A5 A6 40 41 [42][43][44][45][46]
|
[90][91][92][93][94][95][96] [30][31][32][33][34][35][36]
|
||||||
[B0] B6 50 [56]
|
[A0][A1][A2][A3][A4] A5 A6 40 41 [42][43][44][45][46]
|
||||||
[B1] [B5] [51] [55]
|
[B0] B6 50 [56]
|
||||||
[B2][B3][B4] [52][53][54]
|
[B1] [B5] [51] [55]
|
||||||
|
[B2][B3][B4] [52][53][54]
|
||||||
|
```
|
||||||
|
|
||||||
-------------------------------------------------------------------------------
|
-------------------------------------------------------------------------------
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -41,18 +41,18 @@
|
||||||
NC o14-------15+ ADDR (see note)
|
NC o14-------15+ ADDR (see note)
|
||||||
|
|
||||||
* notes:
|
* notes:
|
||||||
* ADDR (pin15): Set slave address to `0b0100000` by connecting to Vss(GND).
|
* ADDR (pin15): Set slave address to `0b0100000` by connecting to Vss(GND).
|
||||||
* The user-defined bits are the three least significant
|
* The user-defined bits are the three least significant
|
||||||
* I2C addresses are 7 bits long (the last bit in the byte is used for
|
* I2C addresses are 7 bits long (the last bit in the byte is used for
|
||||||
indicating read/write)
|
indicating read/write)
|
||||||
* RESET (pin16) must be externally biased. Since we're not going to trigger
|
* RESET (pin16) must be externally biased. Since we're not going to
|
||||||
it ourselves, we can tie it high.
|
trigger it ourselves, we can tie it high.
|
||||||
* This is not noted in the I2C Pinout Description section of the MCP23018
|
* This is not noted in the I2C Pinout Description section of the
|
||||||
datasheet, but it's true (empirically), and it is noted in the SPI Pinout
|
MCP23018 datasheet, but it's true (empirically), and it is noted in
|
||||||
Description section, and in the MCP23017 datasheet.
|
the SPI Pinout Description section, and in the MCP23017 datasheet.
|
||||||
* I'm not the first person who's failed to notice ;)
|
* I'm not the first person who's failed to notice ;)
|
||||||
* <http://davidn.org/wp/?p=89>
|
* <http://davidn.org/wp/?p=89>
|
||||||
* <http://www.arduino.cc/cgi-bin/yabb2/YaBB.pl?num=1293498979>
|
* <http://www.arduino.cc/cgi-bin/yabb2/YaBB.pl?num=1293498979>
|
||||||
|
|
||||||
## Notes about Registers
|
## Notes about Registers
|
||||||
|
|
||||||
|
|
@ -69,28 +69,28 @@
|
||||||
pins configured as output
|
pins configured as output
|
||||||
|
|
||||||
* IOCON register (see datasheet section 1.6, table 1-5, register 1-8)
|
* IOCON register (see datasheet section 1.6, table 1-5, register 1-8)
|
||||||
* BANK: bit 7; read/write; default = 0
|
* BANK: bit 7; read/write; default = 0
|
||||||
* 1: The registers associated with each port are separated into different
|
* 1: The registers associated with each port are separated into
|
||||||
banks
|
different banks
|
||||||
* 0: The registers are in the same bank (addresses are sequential)
|
* 0: The registers are in the same bank (addresses are sequential)
|
||||||
* SEQOP: bit 5; read/write; default = 0
|
* SEQOP: bit 5; read/write; default = 0
|
||||||
* 1: Sequential operation disabled, address pointer does not increment
|
* 1: Sequential operation disabled, address pointer does not increment
|
||||||
* 0: Sequential operation enabled, address pointer increments
|
* 0: Sequential operation enabled, address pointer increments
|
||||||
|
|
||||||
* notes:
|
* notes:
|
||||||
* All addresses given for IOCON.BANK = 0, since that's the default value of
|
* All addresses given for IOCON.BANK = 0, since that's the default value of
|
||||||
the bit, and that's what we'll be using.
|
the bit, and that's what we'll be using.
|
||||||
* We want the row pins set as output high (hi-Z) without pull-ups initially,
|
* We want the row pins set as output high (hi-Z) without pull-ups
|
||||||
and the column pins set as input with pull-ups. We'll cycle through
|
initially, and the column pins set as input with pull-ups. We'll cycle
|
||||||
driving the row pins low and checking the column pins in the update
|
through driving the row pins low and checking the column pins in the
|
||||||
function.
|
update function.
|
||||||
|
|
||||||
* abbreviations:
|
* abbreviations:
|
||||||
* IODIR = I/O Direction Register
|
* IODIR = I/O Direction Register
|
||||||
* IOCON = I/O Control Register
|
* IOCON = I/O Control Register
|
||||||
* GPPU = GPIO Pull-Up Resistor Register
|
* GPPU = GPIO Pull-Up Resistor Register
|
||||||
* GPIO = General Purpose I/O Port Register
|
* GPIO = General Purpose I/O Port Register
|
||||||
* OLAT = Output Latch Register
|
* OLAT = Output Latch Register
|
||||||
|
|
||||||
## I²C Device Protocol (see datasheet section 1.3, figure 1-1)
|
## I²C Device Protocol (see datasheet section 1.3, figure 1-1)
|
||||||
|
|
||||||
|
|
@ -130,8 +130,8 @@
|
||||||
Sequential : S OP W ADDR --> SR OP R Dout ... Dout --> P
|
Sequential : S OP W ADDR --> SR OP R Dout ... Dout --> P
|
||||||
|
|
||||||
* notes:
|
* notes:
|
||||||
* We'll be using sequential mode (ICON.SEQOP = 0; default) (see datasheet
|
* We'll be using sequential mode (ICON.SEQOP = 0; default) (see datasheet
|
||||||
section 1.3.1).
|
section 1.3.1).
|
||||||
|
|
||||||
-------------------------------------------------------------------------------
|
-------------------------------------------------------------------------------
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -44,10 +44,10 @@
|
||||||
GND-------/
|
GND-------/
|
||||||
|
|
||||||
* notes:
|
* notes:
|
||||||
* SCL and SDA: Need external pull-up resistors. Sometimes the Teensy
|
* SCL and SDA: Need external pull-up resistors. Sometimes the Teensy
|
||||||
internal pull-ups are enough (see datasheet section 20.5.1), but i think
|
internal pull-ups are enough (see datasheet section 20.5.1), but i think
|
||||||
for this project we'll want external ones. The general recommendation for
|
for this project we'll want external ones. The general recommendation
|
||||||
400kHz I²C seems to be 2.2kΩ.
|
for 400kHz I²C seems to be 2.2kΩ.
|
||||||
|
|
||||||
|
|
||||||
## Notes about Registers
|
## Notes about Registers
|
||||||
|
|
@ -65,51 +65,51 @@
|
||||||
read returns the logical value (1|0) of the pin
|
read returns the logical value (1|0) of the pin
|
||||||
|
|
||||||
* notes:
|
* notes:
|
||||||
* Unused pins should be set as input, with internal pullup enabled in order
|
* Unused pins should be set as input, with internal pullup enabled in order
|
||||||
to give them a defined level (see datasheet section 10.2.6).
|
to give them a defined level (see datasheet section 10.2.6).
|
||||||
* PD6 (the onboard LED) already has a defined level (low), so there's no
|
* PD6 (the onboard LED) already has a defined level (low), so there's no
|
||||||
reason to set internal pull-up enabled on it. If we do, it will source
|
reason to set internal pull-up enabled on it. If we do, it will source
|
||||||
current to the LED, which is fine, but unnecessary.
|
current to the LED, which is fine, but unnecessary.
|
||||||
* We want the row pins 'hi-Z' initially (set as input with pull-up disabled),
|
* We want the row pins 'hi-Z' initially (set as input with pull-up
|
||||||
and the column pins set as input with internal pull-up enabled. We'll
|
disabled), and the column pins set as input with internal pull-up
|
||||||
cycle through driving the row pins low (setting them as output) and
|
enabled. We'll cycle through driving the row pins low (setting them as
|
||||||
checking the column pins in the update function.
|
output) and checking the column pins in the update function.
|
||||||
* Switching the row pins between hi-Z and drive low (treating them as if
|
* Switching the row pins between hi-Z and drive low (treating them as
|
||||||
they were open drain) seems just as good as, and a little safer than,
|
if they were open drain) seems just as good as, and a little safer
|
||||||
driving them high when the row's not active.
|
than, driving them high when the row's not active.
|
||||||
|
|
||||||
### PWM on ports OC1(A|B|C) (see datasheet section 14.10)
|
### PWM on ports OC1(A|B|C) (see datasheet section 14.10)
|
||||||
|
|
||||||
* notes: settings:
|
* notes: settings:
|
||||||
* PWM pins should be set as outputs.
|
* PWM pins should be set as outputs.
|
||||||
* we want Waveform Generation Mode 5
|
* we want Waveform Generation Mode 5
|
||||||
(fast PWM, 8-bit)
|
(fast PWM, 8-bit)
|
||||||
(see table 14-5)
|
(see table 14-5)
|
||||||
* set `TCCRB[4,3],TCCRA[1,0]` to `0,1,0,1`
|
* set `TCCRB[4,3],TCCRA[1,0]` to `0,1,0,1`
|
||||||
* we want "Compare Output Mode, Fast PWM" to be `0b10`
|
* we want "Compare Output Mode, Fast PWM" to be `0b10`
|
||||||
"Clear OCnA/OCnB/OCnC on compare match, set OCnA/OCnB/OCnC at TOP"
|
"Clear OCnA/OCnB/OCnC on compare match, set OCnA/OCnB/OCnC at TOP"
|
||||||
(see table 14-3)
|
(see table 14-3)
|
||||||
this way higher values of `OCR1(A|B|C)` will mean longer 'on' times for the
|
this way higher values of `OCR1(A|B|C)` will mean longer 'on' times for
|
||||||
LEDs (provided they're hooked up to GND; other way around if they're hooked
|
the LEDs (provided they're hooked up to GND; other way around if they're
|
||||||
up to Vcc)
|
hooked up to Vcc)
|
||||||
* when in a fast PWM mode, set `TCCR1A[7,6,5,4,3,2]` to `1,0,1,0,1,0`
|
* when in a fast PWM mode, set `TCCR1A[7,6,5,4,3,2]` to `1,0,1,0,1,0`
|
||||||
* we want "Clock Select Bit Description" to be `0b001`
|
* we want "Clock Select Bit Description" to be `0b001`
|
||||||
"clkI/O/1 (No prescaling)"
|
"clkI/O/1 (No prescaling)"
|
||||||
(see table 14-6)
|
(see table 14-6)
|
||||||
* set `TCCR1B[2,1,0]` to `0,0,1`
|
* set `TCCR1B[2,1,0]` to `0,0,1`
|
||||||
* LEDs will be at minimum brightness until OCR1(A|B|C) are changed (since
|
* LEDs will be at minimum brightness until OCR1(A|B|C) are changed
|
||||||
the default value of all the bits in those registers is 0)
|
(since the default value of all the bits in those registers is 0)
|
||||||
|
|
||||||
* notes: behavior:
|
* notes: behavior:
|
||||||
* The pins source current when on, and sink current when off. They aren't
|
* The pins source current when on, and sink current when off. They aren't
|
||||||
set to high impediance for either.
|
set to high impediance for either.
|
||||||
* In Fast PWM mode setting `OCR1(A|B|C)` to `0` does not make the output on
|
* In Fast PWM mode setting `OCR1(A|B|C)` to `0` does not make the output on
|
||||||
`OC1(A|B|C)` constant low; just close. Per the datasheet, this isn't true
|
`OC1(A|B|C)` constant low; just close. Per the datasheet, this isn't
|
||||||
for every PWM mode.
|
true for every PWM mode.
|
||||||
|
|
||||||
* abbreviations:
|
* abbreviations:
|
||||||
* OCR = Output Compare Register
|
* OCR = Output Compare Register
|
||||||
* TCCR = Timer/Counter Control Register
|
* TCCR = Timer/Counter Control Register
|
||||||
|
|
||||||
-------------------------------------------------------------------------------
|
-------------------------------------------------------------------------------
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -3,7 +3,7 @@
|
||||||
## links to original files
|
## links to original files
|
||||||
|
|
||||||
* [pjrc] (http://pjrc.com/teensy/)
|
* [pjrc] (http://pjrc.com/teensy/)
|
||||||
* [usb_keyboard] (http://pjrc.com/teensy/usb_keyboard.zip)
|
* [usb_keyboard] (http://pjrc.com/teensy/usb_keyboard.zip)
|
||||||
|
|
||||||
-------------------------------------------------------------------------------
|
-------------------------------------------------------------------------------
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -2,7 +2,6 @@
|
||||||
# makefile for the ergoDOX project
|
# makefile for the ergoDOX project
|
||||||
#
|
#
|
||||||
# - .h file dependencies are automatically generated
|
# - .h file dependencies are automatically generated
|
||||||
# -
|
|
||||||
#
|
#
|
||||||
# - This makefile was originally (extensively) modified from the WinAVR
|
# - This makefile was originally (extensively) modified from the WinAVR
|
||||||
# makefile template, mostly by removing stuff. The copy I used was from
|
# makefile template, mostly by removing stuff. The copy I used was from
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue