summaryrefslogtreecommitdiff
path: root/avr/README
diff options
context:
space:
mode:
authorFlorian Jung <flo@windfisch.org>2015-11-29 00:30:43 +0100
committerFlorian Jung <flo@windfisch.org>2015-11-29 00:30:43 +0100
commit84b980994934d54b3dad6dd2184830f4464b9933 (patch)
tree9e5eb6fb283e791ff50f85c6d97d28ccc7dca6b6 /avr/README
parent1923a8c9121788804a4e307688b6c45993f58205 (diff)
usb hello world \o/
Diffstat (limited to 'avr/README')
-rw-r--r--avr/README47
1 files changed, 47 insertions, 0 deletions
diff --git a/avr/README b/avr/README
new file mode 100644
index 0000000..16c75d9
--- /dev/null
+++ b/avr/README
@@ -0,0 +1,47 @@
+This is a Rotary-Dial-to-USB-Interface, based on the USB AVR Lab
+(http://www.ullihome.de/wiki/USBAVRLab/index). For the schematics
+of the USB AVR Lab, see http://www.ullihome.de/wiki/USBAVRLab/Download
+
+This is a tiny board with an ATMEGA8 speaking USB using the V-USB
+library. It features a 10-pin-port with some AVR pins routed out,
+and also has a bootloader, so it can be programmed without an
+ISP adapter, using USB.
+
+
+The Rotary-Dial-to-USB-Interface expects a rotary dial to be attached against PB4/5.
+When you look at the front of the connector:
+ ____ ____
+| 9 7 . . . | Attach the two cables for the idle switch at 9 and 0.
+| 0 8 . . . | Attach the two cables for the dial pulse switch at 7 and 8.
+ ----------- (0 and 8 are routed to GND, 9 and 7 to PB4 and PB5.)
+
+The program expects the "idle"-switch to be open when the dial is idle, and to be closed
+when the rotary dial is not in its idle position.
+The "pulse" switch is expected to be closed most of the time, and to be only opened shortly
+for each pulse.
+(This can be adapted easily).
+
+When attached to a computer, the device acts like a USB HID keyboard, no
+additional drivers are needed.
+
+
+If you want to enter the bootloader, then generate more than 17 dial pulses by
+dialing a zero, not letting the dial return fully into idle position yet,
+and pulling it to zero again.
+
+
+
+ This program is free software: you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation, either version 3 of the License, or
+ (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with this program. If not, see <http://www.gnu.org/licenses/>.
+
+ For details, see main.c