====== Protocol for Connection of Transmitters ======

Connection for transmitters is based on a simple cleartext TCP protocol ((Described here (Geman only): https://www.afu.rwth-aachen.de/images/vortraege/Wilke_FunkrufTX_Weinheim2012.pdf)). A tcpdump of a connection is shown below. Comments are inserted in italic where applicable. \\
<color #ed1c24>Red color denotes what is sent to the master.</color> \\
<color #7092be>Blue color shows answers received from the master.</color>

----

<color #ed1c24>[UniPager-Raspager1 v1.0.3 df2et ThisIsAReallyGoodAuthKey]</color> \\

//First you have to send the name of your software, a version string starting with "v", the callsign of the transmitter and your AuthKey. Remember that this is not the user account but an account for a transmitter. //

<color #7092be>2:6116</color> \\

//The master answers with message type 2 and his time hex encoded. The next five steps were originally designed to calculate the time offset between master and slave to determine the correct time slots. In the current implementation this is not needed because clients are NTP synced. Normally the client would answer by adding his time. As a dummy "0000" is used here.//

//If login fails due to invalid credentials or the transmitter not being registered you will receive a message of type 7 and a string containing details about why the login failed. This could look as follows://

<color #7092be>7 Invalid credentials</color> \\

//But let's continue as normal... :-) //

<color #ed1c24>2:6116:0000</color> \\
<color #ed1c24>+ </color> \\

//So we answer by repeating what the master sent and adding ":0000" as our time. Transmission end is indicated by a "+".//

<color #7092be>2:6118</color> \\
<color #ed1c24>2:6118:0000</color> \\
<color #ed1c24>+</color> \\

//The same procedure happens a second time ...//

<color #7092be>2:611A</color> \\
<color #ed1c24>2:611A:0000</color> \\
<color #ed1c24>+</color> \\

//... a third time ...//

<color #7092be>2:611B</color> \\
<color #ed1c24>2:611B:0000</color> \\
<color #ed1c24>+</color> \\

//... four ...//

<color #7092be>2:611D</color> \\
<color #ed1c24>2:611D:0000</color> \\
<color #ed1c24>+</color> \\

// ... and done. //

<color #7092be>3:+611A</color> \\
<color #ed1c24>+</color> \\

// If the master answered with message type 3 (first number before the ":")  it is going to tell us how we need to set our clock. This is ignored here due to NTP.//

<color #7092be>4:0189</color> \\
<color #ed1c24>+</color> \\

//Then we finally get a message of type 4 telling us which time slots we are allowed to use for POCSAG tranmissions. In this case we got 4 (of 16 time slots): 0, 1, 8 and 9. From here on the master will send out information about incoming calls.//

<color #7092be>#00 6:1:3EC:3:5357.0 EA5FIV       von DL4MFF um 1933z</color> \\
<color #ed1c24>#01 +</color> \\

//This is the first call. The master sent "#00" which we have to confirm by increasing by one -> "#:01 +". The rest of the line is as follows (values separated by a ":"): //
  * ''6'' //is the message type. 6 is a text message transmission and 5 is a time sync message (see further below for an example).//
  * ''1'' //indicates the POCSAG tranmission speed to use ( 1 = 1200 bit/s).//
  * ''3EC'' //is the RIC/CAP code that the message is intended for. It is the hexadecimal representation of the decimal value  1004 in this case.//
  * ''3'' //is the function bit or sub RIC that the message is addressed to.//
  * ''5357.0 EA5FIV       von DL4MFF um 1933z'' //The rest of the line is the content of the message (an information of the DX cluster here).//

<color #7092be>#01 6:1:11A8:3:#"6468/1!FB6GJW!!!!!!!wpo!EM5NGG!vn!2:44{</color> \\
<color #ed1c24>#02 +</color> \\
<color #7092be>#02 6:1:3EC:3:7133.0 RL5A         von DG1RMY um 1933z</color> \\
<color #ed1c24>#03 +</color> \\
<color #7092be>#03 6:1:11A8:3:##8244/1!SM6B!!!!!!!!!wpo!EH2SNZ!vn!2:44{</color> \\
<color #ed1c24>#04 +</color> \\
<color #7092be>#04 6:1:3F0:3:7011.0 OE100BKC     von OE3BKC um 1933z</color> \\
<color #ed1c24>#05 +</color> \\
<color #7092be>#05 6:1:11A8:3:'#8122/1!PF211CLD!!!!!wpo!PF4CLD!vn!2:44{</color> \\
<color #ed1c24>#06 +</color> \\

//This is a message to the rubrics content of Skyper pagers. It is adressed to RIC 4520 function 3 and the content is ROT-1 encoded.//

<color #7092be>#06 6:1:1B050:3:Edingen-Neckarhausen Entwarnung: Brand in einer Trafostation  21:33 Dies ist die</color> \\
<color #ed1c24>#07 +</color> \\
<color #7092be>#07 6:1:F4628:3:Edingen-Neckarhausen Entwarnung: Brand in einer Trafostation  21:33 Dies ist die</color> \\
<color #ed1c24>#08 +</color> \\
<color #7092be>#08 6:1:1B40B:3:Edingen-Neckarhausen Entwarnung: Brand in einer Trafostation  21:33 Dies ist die</color> \\
<color #ed1c24>#09 +</color> \\
<color #7092be>#09 6:1:18C9B:3:Edingen-Neckarhausen Entwarnung: Brand in einer Trafostation  21:33 Dies ist die</color> \\
<color #ed1c24>#0a +</color> \\
<color #7092be>#0A 6:1:1EE2B0:3:Edingen-Neckarhausen Entwarnung: Brand in einer Trafostation  21:33 Dies ist die</color> \\
<color #ed1c24>#0b +</color> \\
<color #7092be>#0B 6:1:15E220:3:Edingen-Neckarhausen Entwarnung: Brand in einer Trafostation  21:33 Dies ist die</color> \\
<color #ed1c24>#0c +</color> \\
<color #7092be>#0C 6:1:2047D:3:Edingen-Neckarhausen Entwarnung: Brand in einer Trafostation  21:33 Dies ist die</color> \\
<color #ed1c24>#0d +</color> \\
<color #7092be>#0D 6:1:1EEAA3:3:Edingen-Neckarhausen Entwarnung: Brand in einer Trafostation  21:33 Dies ist die</color> \\
<color #ed1c24>#0e +</color> \\
<color #7092be>#0E 6:1:1CAFD:3:Edingen-Neckarhausen Entwarnung: Brand in einer Trafostation  21:33 Dies ist die</color> \\
<color #ed1c24>#0f +</color> \\
<color #7092be>#0F 6:1:18D40:3:Edingen-Neckarhausen Entwarnung: Brand in einer Trafostation  21:33 Dies ist die</color> \\
<color #ed1c24>#10 +</color> \\
<color #7092be>#10 6:1:644E:3:Edingen-Neckarhausen Entwarnung: Brand in einer Trafostation  21:33 Dies ist die</color> \\
<color #ed1c24>#11 +</color> \\
<color #7092be>#11 6:1:E49A:3:Edingen-Neckarhausen Entwarnung: Brand in einer Trafostation  21:33 Dies ist die</color> \\
<color #ed1c24>#12 +</color> \\
<color #7092be>#12 6:1:1EF198:3:Edingen-Neckarhausen Entwarnung: Brand in einer Trafostation  21:33 Dies ist die</color> \\
<color #ed1c24>#13 +</color> \\
<color #7092be>#13 6:1:1D83D:3:Edingen-Neckarhausen Entwarnung: Brand in einer Trafostation  21:33 Dies ist die</color> \\
<color #ed1c24>#14 +</color> \\
<color #7092be>#14 6:1:1603F:3:Edingen-Neckarhausen Entwarnung: Brand in einer Trafostation  21:33 Dies ist die</color> \\
<color #ed1c24>#15 +</color> \\
<color #7092be>#15 6:1:1C71:3:Edingen-Neckarhausen Entwarnung: Brand in einer Trafostation  21:33 Dies ist die</color> \\
<color #ed1c24>#16 +</color> \\
<color #7092be>#16 6:1:1EEF2D:3:Edingen-Neckarhausen Entwarnung: Brand in einer Trafostation  21:33 Dies ist die</color> \\
<color #ed1c24>#17 +</color> \\
<color #7092be>#17 6:1:61A09:3:Edingen-Neckarhausen Entwarnung: Brand in einer Trafostation  21:33 Dies ist die</color> \\
<color #ed1c24>#18 +</color> \\
<color #7092be>#18 6:1:2118F:3:Edingen-Neckarhausen Entwarnung: Brand in einer Trafostation  21:33 Dies ist die</color> \\
<color #ed1c24>#19 +</color> \\
<color #7092be>#19 6:1:12E0D:3:Edingen-Neckarhausen Entwarnung: Brand in einer Trafostation  21:33 Dies ist die</color> \\
<color #ed1c24>#1a +</color> \\
<color #7092be>#1A 6:1:411:3:Edingen-Neckarhausen Entwarnung: Brand in einer Trafostation  21:33 Dies ist die</color> \\
<color #ed1c24>#1b +</color> \\
<color #7092be>#1B 6:1:11A8:3:H!Fejohfo.Ofdlbsibvtfo!Fouxbsovoh;!Csboe!jo!fjofs!Usbgptubujpo!!32;44!Ejft!jtu!ejf</color> \\
<color #ed1c24>#1c +</color> \\
<color #7092be>#1C 6:1:11A8:3:H"Fejohfo.Ofdlbsibvtfo!Csboe!jo!fjofs!Usbgptubujpo!!31;59!Bvghsvoe!fjoft!Csboeft!l</color> \\
<color #ed1c24>#1d +</color> \\
<color #7092be>#1D 5:1:9C8:0:193500   161018</color> \\
<color #ed1c24>#1e +</color> \\

//This is a time synchronization call for Skypers. Adressed to RIC 2504 function 0 and contains time and date.//

<color #7092be>#1E 6:1:287E0:3:XTIME=1935161018XTIME=1935161018</color> \\
<color #ed1c24>#1f +</color> \\

//This is a time synchronization call for Swissphone pagers.//

<color #7092be>#1F 6:1:287EA:3:YYYYMMDDHHMMSS181016193500</color> \\
<color #ed1c24>#20 +</color> \\

//This is a time synchronization call for AlphaPoc pagers.//

<color #7092be>#20 6:1:3EC:3:7088.0 OE100OE      von ON4AZP um 1935z</color> \\
<color #ed1c24>#21 +</color> \\
<color #7092be>#21 6:1:11A8:3:#$8199/1!PF211PF!!!!!!wpo!PO5B[Q!vn!2:46{</color> \\
<color #ed1c24>#22 +</color> \\
<color #7092be>#22 6:1:3EB:3:1840.6 HB3YAS       von OK1AY um 1935z</color> \\
<color #ed1c24>#23 +</color> \\
<color #7092be>#23 6:1:11A8:3:"$2951/7!IC4ZBT!!!!!!!wpo!PL2BZ!vn!2:46{</color> \\
<color #ed1c24>#24 +</color> \\
<color #7092be>#24 6:1:3F0:3:7003.0 TA1PB        von SP8ARY um 1935z</color> \\
<color #ed1c24>#25 +</color> \\
<color #7092be>#25 6:1:11A8:3:'$8114/1!UB2QC!!!!!!!!wpo!TQ9BSZ!vn!2:46{</color> \\
<color #ed1c24>#26 +</color> \\

----

The client initiates a TCP connection to one node of the masters on port 43434. Login and AuthKey need to be available. So you may need to register a transmitter beforehand. 

The incemental counter is just an 8-bit value that is reset on overflow meaning that if you receive FF from the master you answer with 00.