CallDistanceTransceiver.py: clarify the use of a transceiver in DummyModem
[SaveMySugar/python3-savemysugar.git] / README.md
index 947bd19..b0924c8 100644 (file)
--- a/README.md
+++ b/README.md
@@ -4,9 +4,9 @@ SaveMySugar
 SaveMySugar is an experiment about transmitting and receiving messages for free
 using phone call rings to encode Morse code.
 
-The name SaveMySugar is a joke on the price per bit of SMSs (Short Message
-Service) which is quite high, and the distress signal Save Our Soul used in
-Morse communications.
+The name SaveMySugar is a pun on the price per bit of SMSs (Short Message
+Service) which is quite high, and the distress signal Save Our Soul (SOS) used
+in Morse communications.
 
 See [http://savemysugar.ao2.it](http://savemysugar.ao2.it) for further details.
 
@@ -21,14 +21,15 @@ A possible setup is to have two cell phones providing serial ports over which
 the programs can send AT commands and receive RING notifications.
 
 1. Measure the call setup time using `src/measure_call_setup_time.py` and take
-   note of `Max call setup time` and `Call setup time uncertainty`.
+   note of `Min call setup time` and `Max call setup time`.
 
 2. Measure the distance between rings in the same call using
-   `src/measure_ring_distance.py` and take note of `max_distance` and
-   `uncerainty`.
+   `src/measure_ring_distance.py` and take note of `Min ring distance` and
+   `Max ring distance`.
 
 3. Adjust the parameters in `src/savemysugar/CallDistanceTransceiver.py` using
-   the values measured before, possibly approximated by excess.
+   the values measured before, possibly approximating the minima by defect and
+   the maxima by excess.
 
 4. Transmit and/or receive a message using `src/transmit.py` or `src/receive.py`
 
@@ -49,4 +50,5 @@ The only dependencies are:
 Authors
 -------
 
-Written by Antonio Ospite <ao2@ao2.it> starting from an idea by Corrado Rubera.
+From an idea by Corrado Rubera.
+Written by Antonio Ospite <ao2@ao2.it>.