lili/amodem
1
0
Fork 0
mirror of https://github.com/romanz/amodem.git synced 2026-03-27 21:39:06 +08:00
Code Issues Packages Projects Releases Wiki Activity

fix README

Browse Source
This commit is contained in:
Roman Zeyde
2014-07-05 21:28:38 +03:00
parent 309377b1ba
commit 648cd894dc
1 changed files with 19 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

19
README.md
View File

@@ -1,2 +1,21 @@
# Audio Modem for Air-Gapped Communication #
I am using a simple headset, whose speaker is connected to the transmitting PC and the microphone is connected to the receiving PC.
Then, I bring the speaker and the microphone close together and use the PC's sound cards to perform the communication.
The sender is modulating `data.send` binary file using `send.py` script into 32kHz audio file (`tx.int16`), which is played using `aplay` Linux utility.
The receiver is using `arecord` Linux utility to record the audio file into `rx.int16` 32kHz audio file, which is demodulated by `recv.py` script into `data.recv` binary file.
The process requires a single manual calibration step - in order to find the maximal volume for the speaker, which will not saturate the microphone.
The modem's bitrate is currently 8kbps - so it should have no problem sending a simple transaction in O(second).
Moreover, I am sure it can be optimized by using better modulation, error correction and better audio equipment.
Currently, the documentation is quite lacking, but today was the first time I successfully transmitted 1KB of data between 2 PCs, so I am quite excited :)
The recorded audio file is currently stored at `rx.int16` - and can be demodulated by running:
$ virtualenv env
$ source env/bin/activate
$ pip install reedsolo numpy
$ python recv.py
I would be happy to continue developing this library, in order to be able to integrate it with popular Bitcoin wallets, to support air-gapped transaction signing.