From d0a9f0eaa6bbbc885fe529ad2867734580b46b62 Mon Sep 17 00:00:00 2001 From: Charles Mangin Date: Mon, 10 Feb 2014 15:23:14 -0500 Subject: [PATCH] read me and FAQ updates --- .DS_Store | Bin 15364 -> 12292 bytes IIc-USB/README.md | 101 +++++++++++++++++++++++++++++++++++--- IIe-USB/README.md | 101 +++++++++++++++++++++++++++++++++++--- IIe-USB/arduino/.DS_Store | Bin 6148 -> 6148 bytes USB_IIe_Kbd/README.md | 74 +++++++++++++++++++++++++++- 5 files changed, 263 insertions(+), 13 deletions(-) diff --git a/.DS_Store b/.DS_Store index 819ddfe0f000c3750b529d504e64ff71524ad4dd..76c9a4166a6ed7a0fbd82e92f4ddb81439f2fa22 100644 GIT binary patch delta 581 zcmZpvXi1P@U|?W$DortDU;r^WfEYvza8E20o2Vx_*+7Ry6v$^#1Y$;@I73dlVQ_MO zZoy_jgXQd;Kp_y|;0AKVSvITlJYi;3oXn#jX&KLa6ez*MpvRETkjYSzoA2V1Qd*MC zz;Nzfwh&kol3WUs+~ha~Y395DhRKYIW&$wVz#15vm4JdyEE{wfK(ZE->lL|R95eoc z42Z)ZN*_!v6cC<#Psw(&oB$Wgx!(bcCtp+)nd~6I!vtj}2}n+!DPY8Ox_a_i0XdN9 zTLA?S#V@GD*f5z=+UK$zNq9Ia7+0bCUA&a~LQ8mz15HDaOlmA`Zxu zncO7{vGAj;EI+DVhRGl?6pMu$HWtoi5@ZJZok4;dNV|d}akC)Dcjn3bI-ZmLc{n(L okp+rhhRN|f)5J=Ev69S?jTA3HXF-f6!a87df9Bq-V6c=802L{m%K!iX literal 15364 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 Lz_q}2VS)bwf7Ar- diff --git a/IIc-USB/README.md b/IIc-USB/README.md index f56a791..2e764f9 100644 --- a/IIc-USB/README.md +++ b/IIc-USB/README.md @@ -1,9 +1,98 @@ -_Arduino code requires keypad library by Mark Stanley, Alexander Brevig from:_ -http://www.arduino.cc/playground/Code/Keypad +FAQ +=== -_Uses the PJRC Teensy++ 2.0 and Teensyduino libraries, specifically USB HID and Keyboard():_ -http://www.pjrc.com/teensy/teensyduino.html -Disconnect the Apple II keyboard ribbon cable from the logic board, and plug it into the RetroConnector Keyboard Shield. If you need a cable, one can be purchased at http://retroconnector.com +###What is it? -To emulate F-keys F1 through F10, press caps lock. When the keyboard is in caps lock mode, the number keys 1 through 0 will return F1 through F10. \ No newline at end of file +The RetroConnector Shield is a breakout board for the PJRC Teensy Arduino clone that, along with the RetroConnector firmware, connects to an Apple II keyboard and turns it into a USB keyboard. + +###What does it do? + +The RetroConnector Shield turns the built-in keyboard of an Apple //c or //e into a standard USB keyboard that is recognized by any modern computer. + +###What can I do with it? + +Type on your iPad, Mac, PC or Raspberry Pi with a the 30 year old, super clicky keyboard of your youth. Raspberry Pi RetroConnector Demo + +###Where do I buy one? + +Currently available at http://retroconnector.com + +###What do I need? + +The full version, currently $45, requires only a working //e or //c keyboard and the computer you intend to plug it into. Even if all you have left of the Apple II is a keyboard and a ribbon cable, you’re all set. + +The bare board, $18, requires the following parts/skills: + +- Teensy ++ 2.0 +- header pins +- female headers +- box header (34-pins for //c, 26-pins for //e) +- USB mini cable +- basic soldering + + +###Can I hack it? + +Yes. All the software and hardware are open source. Everything you need is on github. + +To update or modify the firmware on the Teensy, you will also need: + +- RetroConnector firmware https://github.com/option8/retroconnector +- Arduino software http://arduino.cc/en/Main/Software +- teensyduino library http://www.pjrc.com/teensy/td_download.html +- keypad.h library http://playground.arduino.cc/Code/Keypad + +Download and install the Arduino IDE software. + +Download and install the Teensy Arduino libraries (Teensyduino). + +Download the keypad.h library. Put the unzipped Keypad folder in “arduino\libraries\”. + +Download the updated Arduino sketch for your RetroConnector (IIe version, IIc version) and open the .INO file with the Arduino IDE. +In the Arduino application, select Tools > Board > Teensy++ 2.0 and Tools > USB Type > Keyboard + Mouse + Joystick + +Verify and upload the new sketch. + +###How does it work? + +The board is basically a breakout for the Teensy pins to connect to the proper pins on the Apple II keyboard connector. The rest is software, sending the right signal down the different pins based on keystrokes. The Teensy does all the heavy lifting, and includes the USB HID functionality out of the box. + +###What model Apple IIs will these work with? + +The //c version works with the Apple //c,and //c plus. + +The //e version will work with all versions of the //e, including those with the extended keyboard, which adds a numeric keypad to the standard keyboard of earlier models. + +###Will there be more models available? + +If there is sufficient demand, a version for Commodore 64 or other vintage computers with built-in keyboards may be developed as well. + +###Do lower-case characters function? I can’t remember if that was a hardware limitation or something to do w/ BASIC. + +Upper and lower case character input works as you would expect from a modern keyboard. As do modifier keys like shift, control, and caps-lock. Since the Apple //e and //c lack alt keys, the RetroConnector firmware maps “closed apple” key to alt. The “open apple” key is the default “GUI” key (command on the Mac, Windows key on PC). These default mappings can be changed by editing the Arduino sketch running on the Teensy board attached to the shield. + +###How about Function Keys and other special keys? + +The Shift and Control keys are mapped to their modern counterparts. The left Apple key is Command/Windows key, the right is Alt. + +To get Function keys (F1-F10) press CAPS-LOCK and the corresponding number key. + +###My //c doesn’t work – does the keyboard (or Teensy for that matter) require it’s own power source? Regards. + +All you need in working order from the //c is the keyboard and its ribbon cable. The RetroConnector and Teensy get power from the computer you hook it to via USB. + +###Can the //c keyboard’s ‘disk use’ and ‘power’ LEDs be programmatically controlled via the RetroConnector? Conversely, can the keyboard LEDs be wired directly into the Pi’s status LED pads with the RetroConnector installed? Thanks for such a geeky-cool product! + +To save space on the board, the RetroConnector Shield doesn’t make any connections to the //c Disk Activity LED. As for the power indictor, when power is applied, the power indicator LED should light up. It’s not an addressable pin on the Teensy, though, so it can’t be programmed in the current version. If you’re handy with a soldering iron, it would be an easy matter to connect a couple of lines to pin 11 (Disk Activity) and 25 (Power), and cut the current connection to pin 25. If it’s a popular feature, I’ll add those connections in to the next revision. + +###Why? + +My original, hand-wired version was for the G4 Apple //c project. I decided to make it available to see what other people would do with it. + +###Thanks + +Special thanks go to + +- Fritzing.org for their excellent circuit layout software and the Fritzing Fab prototypying service. http://fritzing.org/ +- David Schmidt (of ADTPro fame) for early testing, debugging and advice. http://adtpro.sourceforge.net/ diff --git a/IIe-USB/README.md b/IIe-USB/README.md index f56a791..2e764f9 100644 --- a/IIe-USB/README.md +++ b/IIe-USB/README.md @@ -1,9 +1,98 @@ -_Arduino code requires keypad library by Mark Stanley, Alexander Brevig from:_ -http://www.arduino.cc/playground/Code/Keypad +FAQ +=== -_Uses the PJRC Teensy++ 2.0 and Teensyduino libraries, specifically USB HID and Keyboard():_ -http://www.pjrc.com/teensy/teensyduino.html -Disconnect the Apple II keyboard ribbon cable from the logic board, and plug it into the RetroConnector Keyboard Shield. If you need a cable, one can be purchased at http://retroconnector.com +###What is it? -To emulate F-keys F1 through F10, press caps lock. When the keyboard is in caps lock mode, the number keys 1 through 0 will return F1 through F10. \ No newline at end of file +The RetroConnector Shield is a breakout board for the PJRC Teensy Arduino clone that, along with the RetroConnector firmware, connects to an Apple II keyboard and turns it into a USB keyboard. + +###What does it do? + +The RetroConnector Shield turns the built-in keyboard of an Apple //c or //e into a standard USB keyboard that is recognized by any modern computer. + +###What can I do with it? + +Type on your iPad, Mac, PC or Raspberry Pi with a the 30 year old, super clicky keyboard of your youth. Raspberry Pi RetroConnector Demo + +###Where do I buy one? + +Currently available at http://retroconnector.com + +###What do I need? + +The full version, currently $45, requires only a working //e or //c keyboard and the computer you intend to plug it into. Even if all you have left of the Apple II is a keyboard and a ribbon cable, you’re all set. + +The bare board, $18, requires the following parts/skills: + +- Teensy ++ 2.0 +- header pins +- female headers +- box header (34-pins for //c, 26-pins for //e) +- USB mini cable +- basic soldering + + +###Can I hack it? + +Yes. All the software and hardware are open source. Everything you need is on github. + +To update or modify the firmware on the Teensy, you will also need: + +- RetroConnector firmware https://github.com/option8/retroconnector +- Arduino software http://arduino.cc/en/Main/Software +- teensyduino library http://www.pjrc.com/teensy/td_download.html +- keypad.h library http://playground.arduino.cc/Code/Keypad + +Download and install the Arduino IDE software. + +Download and install the Teensy Arduino libraries (Teensyduino). + +Download the keypad.h library. Put the unzipped Keypad folder in “arduino\libraries\”. + +Download the updated Arduino sketch for your RetroConnector (IIe version, IIc version) and open the .INO file with the Arduino IDE. +In the Arduino application, select Tools > Board > Teensy++ 2.0 and Tools > USB Type > Keyboard + Mouse + Joystick + +Verify and upload the new sketch. + +###How does it work? + +The board is basically a breakout for the Teensy pins to connect to the proper pins on the Apple II keyboard connector. The rest is software, sending the right signal down the different pins based on keystrokes. The Teensy does all the heavy lifting, and includes the USB HID functionality out of the box. + +###What model Apple IIs will these work with? + +The //c version works with the Apple //c,and //c plus. + +The //e version will work with all versions of the //e, including those with the extended keyboard, which adds a numeric keypad to the standard keyboard of earlier models. + +###Will there be more models available? + +If there is sufficient demand, a version for Commodore 64 or other vintage computers with built-in keyboards may be developed as well. + +###Do lower-case characters function? I can’t remember if that was a hardware limitation or something to do w/ BASIC. + +Upper and lower case character input works as you would expect from a modern keyboard. As do modifier keys like shift, control, and caps-lock. Since the Apple //e and //c lack alt keys, the RetroConnector firmware maps “closed apple” key to alt. The “open apple” key is the default “GUI” key (command on the Mac, Windows key on PC). These default mappings can be changed by editing the Arduino sketch running on the Teensy board attached to the shield. + +###How about Function Keys and other special keys? + +The Shift and Control keys are mapped to their modern counterparts. The left Apple key is Command/Windows key, the right is Alt. + +To get Function keys (F1-F10) press CAPS-LOCK and the corresponding number key. + +###My //c doesn’t work – does the keyboard (or Teensy for that matter) require it’s own power source? Regards. + +All you need in working order from the //c is the keyboard and its ribbon cable. The RetroConnector and Teensy get power from the computer you hook it to via USB. + +###Can the //c keyboard’s ‘disk use’ and ‘power’ LEDs be programmatically controlled via the RetroConnector? Conversely, can the keyboard LEDs be wired directly into the Pi’s status LED pads with the RetroConnector installed? Thanks for such a geeky-cool product! + +To save space on the board, the RetroConnector Shield doesn’t make any connections to the //c Disk Activity LED. As for the power indictor, when power is applied, the power indicator LED should light up. It’s not an addressable pin on the Teensy, though, so it can’t be programmed in the current version. If you’re handy with a soldering iron, it would be an easy matter to connect a couple of lines to pin 11 (Disk Activity) and 25 (Power), and cut the current connection to pin 25. If it’s a popular feature, I’ll add those connections in to the next revision. + +###Why? + +My original, hand-wired version was for the G4 Apple //c project. I decided to make it available to see what other people would do with it. + +###Thanks + +Special thanks go to + +- Fritzing.org for their excellent circuit layout software and the Fritzing Fab prototypying service. http://fritzing.org/ +- David Schmidt (of ADTPro fame) for early testing, debugging and advice. http://adtpro.sourceforge.net/ diff --git a/IIe-USB/arduino/.DS_Store b/IIe-USB/arduino/.DS_Store index 9a6520c0c31bea30a8af54314a70542cea33e8a0..f8958a63f56d6648fe2758186faacc4bf72a7ab1 100644 GIT binary patch delta 75 zcmZoMXffCj&B&y5cd{X)%;ZW&Zr0!WLJSNbo