vail-adapter/README.md

59 lines
1.8 KiB
Markdown
Raw Normal View History

---
Author: neale
Email: neale@woozle.org
License: MIT
---
2020-05-16 10:43:38 -06:00
2022-05-21 20:14:03 -06:00
# Vail Adapter: Morse Code Key/Paddle to USB
2020-05-16 10:43:38 -06:00
2022-05-21 20:14:03 -06:00
![Vail adapter, assembled and connected](doc/vail-adapter-v2.jpg)
2020-05-17 13:24:58 -06:00
2020-05-16 10:43:38 -06:00
2022-05-21 20:14:03 -06:00
# Features
2022-05-21 20:14:03 -06:00
* Lets you key even if you move focus to another window
* Works with [Vail](https://vail.woozle.org/)
2022-07-15 10:27:54 -06:00
* Works with [VBand](https://hamradio.solutions/vband/), but the window has to remain focused
2022-07-15 10:26:54 -06:00
* Optional sidetone generator, which helps with latency
* Implements all nine keyer modes from Vail, in the adapter, so you lunatics can try to key at 50WPM with no latency issues
* Plays received signals in the adapter, so you can turn off your computer speaker
2022-05-21 20:14:03 -06:00
* Free firmware updates for life
* Can be wired up in about 5 minutes
2020-05-16 10:43:38 -06:00
2022-05-21 20:14:03 -06:00
[Vail Adapter benefits video](https://www.youtube.com/watch?v=XQ-mwdyLkOY) (4:46)
2020-05-16 10:43:38 -06:00
2022-05-21 20:14:03 -06:00
# Setting Up
2021-01-18 15:21:08 -07:00
2022-05-21 20:14:03 -06:00
* [Easy Setup](doc/easy-install.md)
* [Advanced Setup](doc/advanced-install.md)
2021-01-18 15:21:08 -07:00
2022-05-21 20:14:03 -06:00
# Future Work
2021-01-18 15:21:08 -07:00
2022-05-21 20:14:03 -06:00
Things I plan to add:
2021-01-18 15:21:08 -07:00
* [x] PCB to ease assembly and make a more robust shippable product
* [ ] Debug tone changes
* [ ] PCB v2 to get the speaker on pin 10 instead of pin 9
* [ ] Unplug detection: send a pulse out one pin and detect it on the T pin to reset straight-key detection
2020-05-16 10:43:38 -06:00
# Contributing
2020-05-16 10:43:38 -06:00
To contribute to this project please contact neale@woozle.org
https://id.arduino.cc/neale
2022-05-21 20:14:03 -06:00
# Similar projects
2021-01-18 15:21:08 -07:00
2022-05-21 20:14:03 -06:00
* Vail user Michele Giugliano's
[MorsePaddle2USB](https://github.com/mgiugliano/MorsePaddle2USB),
which runs on a DigiSpark (attiny85). It only sends keystrokes, so you must keep the Vail
window focused: you can't switch to other apps and still transimit.
* Ham Radio Solutions sells a
[USB Paddle Interface](https://hamradio.solutions/vband/)
which appears to be very similar to Michele's project. You must keep the
Vail window focused.
* [CWKeyboard](https://github.com/kevintechie/CWKeyboard) looks almost
exactly the same as the VBand adapter.