lwvmobile / ledacs-esk Goto Github PK
View Code? Open in Web Editor NEWLinux EDACS ESK Trunk Tracking using rtl_fm and rtl_udp.
License: The Unlicense
Linux EDACS ESK Trunk Tracking using rtl_fm and rtl_udp.
License: The Unlicense
2021-11 Update Going forward, this version will no longer be supported by me. Please go to: https://github.com/lwvmobile/edacs-fm For the new version. Thanks. Forked from https://github.com/sp5wwp/ledacs LEDACS-ESK v0.3b Build 2020.10.06 LEDACS-ESK is a command line system written and modified to trunk track EDACS ESK systems. This software was forked from aforementioned LEDACS found at the link provided above, but having diverged too far from the source it is most likely not going to be incorporated into the original project. LEDACS-ESK can be run for legacy EDACS systems, but its current working status for other variants of EDACS is still unknown. LEDACS-ESK uses standard rtl_fm for the trunk tracking ledacs-esk program which only decifers the EDACS ESK control channel and provides controls to the second program, DOT-DETECTOR DOT-DETECTOR is used in conjunction with rtl_udp, a fork of RTL_SDR which allows for remote control input from another software via UDP ports. Port 6020 is the default port this software uses. In future releases, it is hopeful to move away from RTL_UDP in favor of another solution, as RTL_UDP seems to be an outdated and perhaps *dead* project in its own right, but still works well enough for the current scope of this project. LEDACS-ESK requires two dongles if you wish to track the control channel and tune the voice channels. LEDACS-ESK has currently been testing and known to run on Ubuntu 18.04 based desktop distros (Ubuntu, LM19, Zorin 15, etc) as well as Raspberri Pi 3b+ hardware running Raspian Buster. Many more are likely to be added as soon as they can be properly tested. Installation: Make sure to have the prerequisite sox, aplay, cmake and build-essential installed. You will also need rtl-sdr already installed as well. Raspberry Pi Raspian users will also need libusb-1.0.0-dev sudo apt update sudo apt install sox aplay build-essential cmake sudo apt install rtl-sdr #Additional For Raspberry Pi users# sudo apt install libusb-1.0.0-dev #NCURSES support if desired sudo apt install libncurses5 libncurses5-dev If you haven't already, please git clone the source code. git clone https://github.com/lwvmobile/ledacs-esk cd LEDACS-ESK chmod +x build.sh pi-build.sh rebuild.sh start.sh detector.sh analyzer.sh nstart.sh This command will give the necessary execution permissions to our scripts for building and quickly starting up the software without needing to remember long strings of code. Next, run the included build.sh script to compile all the code necesary. ./build.sh // ./pi-build.sh on Raspberry Pi This process will compile ledacs-esk and dot-detector, extract, cmake and make the rtl-sdr-udp required. Make install is not run, and is not recommended to be installed as it may cause issues, overwrite, or conflict with RTL_SDR. RTL_UDP will be called and executed in its own folder where it was made. Usage: First, you will need to make a simple text file with LCN channel numbers entered in Hz. For example, in the site243 file included you will find: 851375000 851800000 855987500 858487500 Listed out seperated by line with no decimals or engineering notation. This format is required for now. The LCN channels will need to be in order from 1,2,3, until the end. EDACS/EDACS-ESK with EA has a limit of 32 LCN Channels, most CCs won't have this many. Next, we will view the start.sh file, this is where the commands required for running LEDACS-ESK will be, and we will simply execute the start.sh file to start the software. The contents of a typical file will be: rtl_fm -d 0 -f 851375000 -s 28.8k -p 0.5 -g 49 | ./ledacs-esk site243 1 1 0 allow deny First, we will specify -d 0 as our RTL of choice, -f 851375000, tune it to our control channel frequency -s 28.8k to specify the sample rate of 28.8k THIS VALUE MUST REMAIN 28.8k, DO NOT CHANGE THIS VALUE AS IT DIRECTLY CORRELATES TO THE bitrate of EDACS systems. THE SOFTWARE WILL NOT WORK IF THIS VALUE IS CHANGED. DON'T TOUCH IT!! -p 0.5 will specify our PPM correction, adjust as required for your device. -g 49 specifies a gain value of 49 (the max) you may adjust this as neccesary, or omit gain to have it set automatically. Please see man rtl_fm for more information on fine tuning options available. REPEAT, DO NOT CHANGE THE SAMPLE RATE. LEAVE AS -s 28.8k. On the other side, we see this is piped into our software. Currently, you need to specify the file name with the LCN channels, the first (1) specifies LCN 1 as control, the second (1) specifies EDACS-ESK, which can be changed to (2) for legacy, and the (0) specifies debug verbosity levels. allow and deny refer to files which can be populated with group numbers in decimal format for the purpose of allow or deny of voice channel assignment. Currently, allow overrides everything in deny, having information in both will default to the allow list. Currently, all of these arguments are required, otherwise a segmentation fault will occur. Sorry :( I'm not a good programmer :), just a tinkerer. See ./ledacs-esk -h for more info. Then, when you have all values set appropriately in the start.sh file, simply execute it with the following command: ./start.sh Example Output: If you should get this software running properly on an EDACS ESK system(Fingers Crossed) you will find typical output can include the following. Sockets successfully initialized Found 2 device(s): 0: Realtek, RTL2838UHIDIR, SN: 00000001 1: Realtek, RTL2838UHIDIR, SN: 00000002 Using device 0: Generic RTL2832U OEM Found Rafael Micro R820T tuner Tuner gain set to 49.60 dB. Tuned to 856239500 Hz. Oversampling input by: 35x. Oversampling output by: 1x. Buffer size: 8.13ms Exact sample rate is: 1008000.009613 Hz Sampling at 1008000 S/s. Output at 28800 Hz. LCN[1]=851375000Hz LCN[2]=851800000Hz LCN[3]=855987500Hz LCN[4]=858487500Hz CC=LCN[3] Allow[1]=22049 Group/Sender LEDACS-ESK v0.27 Build 2020.09.07 Time: 18:32:29 OFF=1600 IDLE MT-1=[0x1F] MT-2=[0xA] Site ID=[243] Time: 18:32:37 OFF=1934 IDLE MT-1=[0x1F] MT-2=[0xB] Site ID=[243] Time: 18:32:45 OFF=1852 IDLE MT-1=[0x1F] MT-2=[0xA] Site ID=[243] Time: 18:32:53 OFF=1908 IDLE MT-1=[0x1F] MT-2=[0xA] Site ID=[243] Time: 18:33:05 OFF=2089 IDLE MT-1=[0x1F] MT-2=[0xA] Site ID=[243] Time: 18:33:13 OFF=2026 IDLE MT-1=[0x1F] MT-2=[0xA] Site ID=[243] First, we see that RTL_FM initializes, sets its setting as appropriate, then LEDACS-ESK lists our LCN channels in our example site243 file, and we are greeted with a rolling IDLE status, OFF (offset from center freq of device), MT-1 and MT-2 Status bits in hex, and Site ID in decimal form. The closer the OFFset value comes to 0, the better/cleaner the signal. Typical OFF numbers can vary, but ideally this value will tell you how far off center the frequency is in Hz, but shouldn't be too heavily relied on as long as performance on the user end seems good and accurate. When the software receives ACTIVE commands from the EDACS signal, we will begin to see Time: 18:34:38 OFF=2167 ACTIVE MT-1=[0x 3] MT-2=[0x0] LCN=2 Sender=[ 271955i] Group=[ 22033g] Digital Group Voice Channel Assignment Time: 18:34:46 OFF=2137 ACTIVE MT-1=[0x 3] MT-2=[0x1] LCN=4 Sender=[ 271985i] Group=[ 22033g] Digital Group Voice Channel Assignment Time: 18:34:54 OFF=1977 ACTIVE MT-1=[0x 3] MT-2=[0x0] LCN=1 Sender=[ 271985i] Group=[ 22033g] Digital Group Voice Channel Assignment First, we see the current time, the ACTIVE status, MT-1 and MT-2 Status (hex), LCN channel number, and on the next line we see the SENDER and GROUP ID followed by the type of channel assignment. Note: If you select a higher debug verbosity, you may see more information depending on the level of debug selected. For example: Time: 18:39:08 OFF=2108 ACTIVE MT-1=[0x 3] MT-2=[0x1] LCN=4 Sender=[ 271985i] Group=[ 22033g] Digital Group Voice Channel Assignment MT-1 Binary = [0] [0] [0] [1] [1] MT-2 Binary = [0] [0] [0] [1] FR_1=[B895611E3B] FR_2=[476A9EE1C4] FR_3=[B895611E3B] FR_4=[BA426712E8] FR_5=[45BD98ED17] FR_6=[BA426712E8] Time: 18:39:08 OFF=2232 ACTIVE MT-1=[0x 3] MT-2=[0x1] LCN=4 Sender=[ 271985i] Group=[ 22033g] Digital Group Voice Channel Assignment MT-1 Binary = [0] [0] [0] [1] [1] MT-2 Binary = [0] [0] [0] [1] FR_1=[B895611E3A] FR_2=[476A9EE1C4] FR_3=[B815611E3B] FR_4=[BA426712E8] FR_5=[45BD98ED17] FR_6=[BA426792E8] Time: 18:39:10 OFF=2253 IDLE MT-1=[0x1F] MT-2=[0xA] Site ID=[243] MT-1 Binary = [1] [1] [1] [1] [1] MT-2 Binary = [1] [0] [1] [0] FR_1=[5D07133193] FR_2=[A2F8ECCE6C] FR_3=[5D07133193] FR_4=[5D07133193] FR_5=[A2F8ECCE6C] FR_6=[5D07133193] In this example with debug 1, we can see the FR frames (40-bit messages sent in triplicate) as well as the MT-1 and MT-2 status bits in binary. Higher verbosity levels can also show things such as PEERS, ADDS, KICKS, etc, but this information becomes very verbose and is recommended for study purposes, not for daily tracking purposes. Please see 'understanding_frames.txt' for more information on EDACS message frames. Note: You may also wish to use ./analyzer as opposed to ./start, using similar parameters. This uses the ledacs-esk-analyzer version which only tracks the control channel, but does not attempt to tune frequencies. This may be preferred if you only have or want to use one dongle. Raspberry Pi repo version of rtl-sdr includes UDP functionality, which using the ./start method may cause the program to attempt to tune its own instance of rtl_fm if ./detector hasn't launched yet. Please be sure to run ./detector first, or use the ./analyzer if you only have one dongle on RPi. Dot Detector: After we have verified we have an active control channel, we can look at the script to start up Dot-Detector in conjuction with rtl_udp, this software will listen to the output of LEDACS-ESK and tune to the appropriate voice channel. Below is our example ./detector.sh script: rtl-sdr-master-upd/rtl-sdr-master/build/src/rtl_udp -d 1 -f 851.375M -s 28.8k -p 0.5 -g 49 | tee >(sox -t raw -b 16 -e signed-integer -r 28800 -c 1 - -t raw - vol 2 sinc 0.2k-4.5k -a 110 rate 48000 | aplay -t raw -f S16_LE -r 48000 -c 1) | ./dot-detector First, we see we call rtl_upd much like we did above with rtl_fm, the values for frequency don't matter as the software will change to the appropriate channel, but in this example we tune to the Control Channel to verify audio output listening to the control channel's machine gun like tone. You may wish to add the argument '-l 5000' to set the squelch to a really high number to not listen. All of these values can be tweaked, however, DO NOT CHANGE THE SAMPLE RATE. LEAVE AS -s 28.8k. The software requires this precise number for proper function. In fact, past RTL_UDP, it is not advised to change any of the values as it may hamper the proper functionality of the dot-detector program and subsequently, properly tuning in voice channels. ANY FURTHER MODIFICATION IS AT YOUR OWN DISCRETION AND CANNOT BE HELPED. Alternatively, on Rapberry Pi hardware, you may be able to use the repo version of rtl_fm as it incorporates UDP threads and seems to some degree to function properly, but you may need to specify a manual squelch level that encompasses all of your LCNs. However, it cannot be officially supported now, and it is recommended to stick with rtl_udp for now. Any feedback of working setups with rtl-sdr+rpt UDP functionality greatly appreciated. Note: On Raspberry Pi, if ./detector and rtl_udp come up with a USB claimed error message, please run: sudo modprobe -r dvb_usb_rtl28xxu. running pi-build.sh to build should run -DDETACH_KERNEL_DRIVER=ON to prevent this error, please rebuild if you are coming from an older version prior to 0.27. New: 2020.10.06 ledacs-esk-ncurses Users may wish to use the optional ncurses version of ledacs-esk, just call it with the same parameters as ledacs-esk Out will remain in fixed area of the terminal, providing a concise view of all info but limits review capability Call with ./nstart.sh or rtl_fm -d 0 -f 851375000 -s 28.8k -p 0.5 -g 49 | ./ledacs-esk-ncurses site243 1 1 0 allow deny What Dot Detector does: You may wonder what Dot Detector does exactly. It is an software, that besides tuning or aiding rtl_udp tune to voice channels, can determine when the ending sequence of EDACS voice transmissions occur. If you have ever noticed by listening, EDACS has a distinct bleeping sequence at the end of its VOICE assignment that hampers scanners from scanning, as the voice has changed to another channel, but the "DOTTING" at the end makes scanners stay until the end. This in turn, makes it so that you are always late to the next LCN. Dot-detector can detect this sequence and squelch it, freeing up the RTL stick so it can be changed to the next LCN in time for its transmission to start. Go ahead now and start up the detector with ./detector.sh When it is used with LEDACS-ESK, you will typically see this output: Sockets successfully initialized Found 2 device(s): 0: Realtek, RTL2838UHIDIR, SN: 00000001 1: Realtek, RTL2838UHIDIR, SN: 00000002 Using device 1: ezcap USB 2.0 DVB-T/DAB/FM dongle Found Rafael Micro R820T tuner Oversampling input by: 35x. Oversampling output by: 1x. Buffer size: 8.13ms Tuned to 851627000 Hz. Sampling at 1008000 Hz. Output at 28800 Hz. Exact sample rate is: 1008000.009613 Hz Tuner gain set to 49.60 dB. Main socket started! :-) Tuning enabled on UDP/6020 Playing raw data 'stdin' : Signed 16 bit Little Endian, Rate 14400 Hz, Mono First, as we are using an OLD FORK of RTL_SDR, do not be surprised if your dongle is misnamed, in most cases, everything should work just as well otherwise. When the software receives the tuning commands from LEDACS-ESK, you will begin to see (and hopefully hear) the voice channel audio. In most cases, you will likely want to pipe this audio using pavucontrol through a virtual audio sink into Provoice decoding software, much like DSD, DSD+, or others. Those are currently outside the scope of this readme, but may be included in a tutorial/wiki. Typical output when tuning channels will include: Tuning to: 851800000 [Hz] (central freq: 852052000 [Hz]) Changing squelch to 0 Changing squelch to 5000 OFF=1917 Changing squelch to 0 Changing squelch to 5000 OFF=2046 Changing squelch to 5000 Tuning to: 855987500 [Hz] (central freq: 856239500 [Hz]) Changing squelch to 0 Changing squelch to 5000 OFF=1820 Changing squelch to 5000 Tuning to: 858487500 [Hz] (central freq: 858739500 [Hz]) Changing squelch to 0 Changing squelch to 5000 You can see the frequency (in the LCN channel file) being tuned to and squelch being set to 0 (listen) for the duration of that channel assignment, then squelch to 5000 to "turn off" that channel, then the next LCN tuned, etc etc. I hope you all find this readme useful, please feel free to send any questions to the radioreference.com forums or on github. Thank you. Also, I hope you find usefulness from this software and in the future, I hope to add new features, re-write much of the forked code and clean up lots of it, maybe convert it to python, and hopefully, get rid of RTL_UDP. For now, it can successfully track EDACS ESK, display senders and groups, and tune VOICE channel assignments and has a pretty good success rate for me. Hopefully you will all have success with it as well. Best of all, it does all of these things in LINUX, no Windows required. lwvmobile
A declarative, efficient, and flexible JavaScript library for building user interfaces.
๐ Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. ๐๐๐
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google โค๏ธ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.