MorseDistanceModulator.py: be more precise in an error message
[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.
 
 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.
 
 
 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
 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
 
 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
 
 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`
 
 
 4. Transmit and/or receive a message using `src/transmit.py` or `src/receive.py`
 
@@ -49,4 +50,5 @@ The only dependencies are:
 Authors
 -------
 
 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>.