moip/README.md

59 lines
3.2 KiB
Markdown
Raw Permalink Normal View History

2015-02-15 05:42:12 -05:00
MoIP - Morse over IP
====================
2015-04-29 18:31:33 -04:00
Go to the website: http://8ch9azbsfifz.github.io/moip/
2015-02-15 05:49:54 -05:00
In analogy to voice over ip (voip) we can also do morse code over ip (moip).
2015-02-15 06:01:50 -05:00
A number of different approaches for CW over IP exist. Here we describe the
2015-02-15 06:53:24 -05:00
well-establised CWCom protocol (since 1998).
2015-02-15 05:42:12 -05:00
Besides a variety of other approaches exist, for example an IRC
plugin ([CWirc](http://myspace.voo.be/pcoupard/cwirc/)),
a [JavaScript implementation](http://morsecode.me),
a [bandwidth-eating UDP implementation](http://hans.liss.pp.se/node/343),
a [chat for iOS](http://pignology.net/cwwithme.html)
or a modulated CW over IP using Mumble ([iCW](https://sites.google.com/site/icwoip/)).
2015-02-15 06:37:23 -05:00
![MOIP](/img/kob.jpg?raw=true "MOIP")
2015-02-15 05:53:40 -05:00
# CWCom Protocol
2015-02-15 07:03:03 -05:00
The [CWCom protocol](/doc/cwcom.pdf?raw=true) (cw communicator) is an effective method for transmitting
2015-02-15 07:06:49 -05:00
morse code signals as UDP packets over IP.
2015-02-15 06:53:24 -05:00
2015-02-15 06:01:50 -05:00
## CWCom Servers
2015-02-15 07:06:49 -05:00
The clients will connect to one of the servers using the CWCom protocol.
2015-02-15 06:45:15 -05:00
![Architecture](/img/architecture.png?raw=true "Architecture")
2015-02-15 07:08:48 -05:00
The source code for a server on a Raspi can be found [here](https://sites.google.com/site/morsekob/server).
2015-02-15 06:44:24 -05:00
2015-02-15 06:53:24 -05:00
## Compatibility
The original CWCom protocol has been extended for MorseKOB, as landline telegraphy uses
closed circuits (latching). There are mainly two server types for moip (see below):
the original CWCom server and the MorseKOB server. Both servers are compatible using a
2015-02-15 07:03:03 -05:00
relay server written by Bob Denny ([source code](https://github.com/8cH9azbsFifZ/moip-relay-server/tree/master)).
2015-02-15 06:01:50 -05:00
# How to use?
2015-02-15 05:42:12 -05:00
2015-02-15 06:01:50 -05:00
## Client Software
2015-02-15 05:42:12 -05:00
2015-02-15 06:34:50 -05:00
| Architecture | Name | License | Comment |
| :------------ |:------------ | :----- | :------ | 
2015-04-18 16:13:50 -04:00
| Windows | [MorseKOB 2.5](http://kob.sdf.org/morsekob/morsekob25/index.htm) | ? | Original MorseKOB Software by Les Kerr. [Source Code](https://sites.google.com/site/morsekob/morsekob25) |
| Browser | [MorseKOB 3.0](http://kob.sdf.org/morsekob/morsekob30/index.htm) | ? | Java implementation of MorseKOB by Les Kerr |
2015-04-28 16:56:45 -04:00
| Linux (Python) | [MorseKOB 4.0](https://sites.google.com/site/morsekob/morsekob40) [1](https://github.com/8cH9azbsFifZ/morsekob)| ? | Python port to Raspi by Les Kerr |
2015-02-15 06:34:50 -05:00
| Linux, OSX, BSD | [IRMC](https://github.com/8cH9azbsFifZ/irmc) | GPL | C implementation of morsekob|
| Arduino | [irmc-avr](https://github.com/8cH9azbsFifZ/irmc-avr) | GPL | arduino port|
2015-04-18 16:13:50 -04:00
| iOS | [irmc-ios](https://github.com/8cH9azbsFifZ/irmc-ios) | GPL | ios port with support for external key using bluetooth [ble-morse](https://github.com/8cH9azbsFifZ/ble-morse) |
2015-02-15 06:44:48 -05:00
| Windows | [CWCom](http://www.mrx.com.au/d_cwcom.htm) | Closed Source | original cwcom software by John Samin |
2015-02-15 06:40:13 -05:00
2015-02-15 05:42:12 -05:00
2015-02-15 06:01:50 -05:00
## Servers
2015-02-15 06:07:52 -05:00
| Network | Server | Port | Activity |
2015-02-15 06:06:21 -05:00
| :------------ | ---------------: | :---- | :------- |
2015-02-15 06:08:53 -05:00
| MorseKOB | faeroes.sdf.org, mtc-kob.dyndns.org | 7890 | [Info](http://mtc-kob.dyndns.org/info.html) [Activity](http://mtc-kob.dyndns.org) |
| MRX CWCom | morsecode.dyndns.org | 7890 | [Activity](http://morsecode.dyndns.org) |
2015-02-15 06:53:24 -05:00
| Relay Server | N/A | N/A | [Activity](http://morsecode.dc3.com:7890) |
2015-02-15 06:04:45 -05:00
2015-02-15 05:42:12 -05:00
# References
* Morse KOB, Les Kerr: https://sites.google.com/site/morsekob/ and http://kob.sdf.org/morsekob/
2015-02-15 06:44:48 -05:00
* CWCom, John Samin (VK1EME): http://www.mrx.com.au/
2015-02-15 05:42:12 -05:00