Usage
Once the set-up is complete you may start communicating with the modem. Ensure you have already connected the transducer then start the modem by executing the startmodem.sh
script.
The full path to run the main file from the user directory will be
/home/modem/moda/dev-toolbox/scripts4trials/startmodem.sh
This command will run the test-modem
process with the default settings.
Most parameters can be conveniently changed by editing the startmodem.sh
file. The table below lists them.
Modulation-independent parameters
Parameter | startmodem.sh label |
Possible values |
---|---|---|
ID (source address) | id | int [1;15] |
Carrier frequency | carrier | int (Hz) |
Modulation technique | modulation | flex,janus,flexofdm |
Output amplifier gain | gain | float [0.01;0.99] |
Flexframe-specific parameters
(only evaluated when modulation=flex or modulation=ofdmflex)
Parameter | startmodem.sh label |
Possible values |
---|---|---|
Modulation | flex_psk | Listed in Overview |
Interpolation | interpflex | int [5;20] |
Inner FEC scheme | intFEC | Listed in Overview |
Outer FEC scheme | outFEC | Listed in Overview |
JANUS-specific parameters
(only evaluated when modulation=janus)
Parameter | startmodem.sh label |
Possible values |
---|---|---|
Bandwidth | bandwidth | int (Hz) |
Communication
Once the startmodem.sh
script is up and running, the modem opens a TCP socket on port 55555
to communicate with the user.
You may use netcat to connect to the socket, typing
nc <SuM IP address> 55555
Alternatively, the socket can be opened locally: open another SSH terminal and connect to the modem (as in quickstart) then type
nc localhost 55555
Afterwards data can be sent and received through the terminal.
Having problems transmitting/receiving data? Take a look at the troubleshooting section.
Toggling autostart
If you wish the modem to start listening and transmitting to the socket port 55555 automatically after startup you may enable the autostart service by typing
sudo systemctl enable sumd.service
In order to disable the autostart feature instead type
sudo systemctl disable sumd.service