Wiki source code of Radio Log
Last modified by Treyfane Dingo on 2025/04/27 13:33
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | (% data-widget="image" contenteditable="false" tabindex="-1" %)[[image:radiolog1.png]](% title="Click and drag to resize" %) | ||
| 2 | |||
| 3 | |||
| 4 | The **Radio Log** is a module, which can be called by pressing **F8** anywhere in L.A.S.S.I.E.. It will be available if L.A.S.S.I.E. is connected to a [[Pi-Star>>https://www.pistar.uk/]] with [[pistarlog2ws>>https://git.furcom.org/Dingo/pistarlog2ws]] installed (green antenna symbol) and subsequently show the DMR radio traffic. | ||
| 5 | |||
| 6 | **Please be aware that only radio DMR IDs in the range 10000 < x < 9999999 will work due to a limitation of the Pi-Star MMDVMHost software.** | ||
| 7 | |||
| 8 | = Pi-Star Preparation = | ||
| 9 | |||
| 10 | == OS Installation == | ||
| 11 | |||
| 12 | Pi-Star has to be installed on a Raspberry Pi (Zero) with a MMDVM HAT. A non-duplex MMDVM HAT is fully sufficient since Pi-Star only can monitor one single frequency and sending is not something this setup is expected to do. See [[https:~~/~~/www.pistar.uk/downloads/>>https://www.pistar.uk/downloads/]] for image download and installation instructions. | ||
| 13 | |||
| 14 | The SD card for the Raspberry Pi will be flashed using [[Raspberry Pi Imager>>https://www.raspberrypi.com/software/]]. During the process, you will be asked if you like to apply OS customization settings. You can change the //hostname//, //wireless LAN// and //locale settings// here. **Do not set username and password, or anything in the Services or Options tab!** | ||
| 15 | |||
| 16 | **~ **[[image:radiolog_set3.png]] | ||
| 17 | |||
| 18 | After flashing and booting the Raspberry from the SD card, you should be able to access the Pi-Star webinterface via browser at e.g. [[http:~~/~~/radiolog.local/admin/>>http://radiolog.local/admin/]] | ||
| 19 | |||
| 20 | Default Username: pi-star | ||
| 21 | Default Password: raspberry | ||
| 22 | |||
| 23 | == Configuration == | ||
| 24 | |||
| 25 | After installing Pi-Star, the following configuration should be used for the Radio Log. First, in the “General Configuration” section the Radio Frequency has to be set to the **output** frequency of your DMR repeater. Also the correct Radio/Modem Type has to be selected, depending on the MMDVM HAT used, and the Node Type has to be set to “Public”. **Please remember to press “Apply Changes” after changing every section.** Depending on the changes some options may only show after pressing “Apply Changes”. | ||
| 26 | |||
| 27 | [[image:radiolog_cfg2.png]] | ||
| 28 | |||
| 29 | (% id="cke_bm_335101S" style="display:none" %) (%%)In the “MMDVMHost Configuration” section the DMR Mode should be enabled. | ||
| 30 | |||
| 31 | [[image:radiolog_cfg1.png]] | ||
| 32 | |||
| 33 | After enabling the DMR Mode in the “MMDVMHost Configuration” section, you should head over to “Expert” → “MMDVMHost” in the top menu. Here it is imperative to set “Enable = 0” in the “DMR Network” section (**not** the “DMR” section!). This will disable all DMR networking. We don't want to have the Radio Log Pi-Star send out our private DMR communication to the world after all. | ||
| 34 | |||
| 35 | [[image:radiolog_cfg2b.png]] | ||
| 36 | |||
| 37 | As an additional information, the OLED display of a Raspberry Pi Zero can be configured to face the right direction and show some useful information, when the parameters in the “OLED” section are set as follows. This is especially useful if your OLED until now is just black. | ||
| 38 | |||
| 39 | [[image:radiolog_cfg2c.png]] | ||
| 40 | |||
| 41 | Back on the regular configuration page, in the “Wireless Configuration”, the IP address of the Pi-Star acquired by DHCP is shown. This IP address has to be configured as “IP for a FurCom Services Radio Log system” in L.A.S.S.I.E. (System Settings → General Settings). | ||
| 42 | |||
| 43 | [[image:radiolog_cfg4.png]] | ||
| 44 | |||
| 45 | For the configuration to be completed and usable, you should change the default password to something more secure. Please remember the password! | ||
| 46 | |||
| 47 | [[image:radiolog_cfg5.png]] | ||
| 48 | |||
| 49 | You also should run an Update of the Pi-Star using the “Configuration” → “Update” page. | ||
| 50 | |||
| 51 | After all of the configuration, the “Dashboard” of the Pi-Star should look like this (frequency may vary): | ||
| 52 | |||
| 53 | [[image:radiolog_cfg6.png]] | ||
| 54 | |||
| 55 | = Installing pistarlog2ws = | ||
| 56 | |||
| 57 | The pistarlog2ws repository can be found at the [[FurCom Git>>https://git.furcom.org/Dingo/pistarlog2ws]]. To install it, you have to connect to the Pi-Star via ssh. | ||
| 58 | |||
| 59 | //Pi-Star's disk is read-only by default, so you have to enable read-write with “rpi-rw”.// | ||
| 60 | |||
| 61 | Clone the repository into the pi-star home and run the install script: | ||
| 62 | |||
| 63 | {{{rpi-rw | ||
| 64 | git clone https://git.furcom.org/dingo/pistarlog2ws | ||
| 65 | cd pistarlog2ws | ||
| 66 | ./install.sh | ||
| 67 | }}} | ||
| 68 | |||
| 69 | This should install and enable the websocket service and make the necessary adjustments to the firewall. | ||
| 70 | |||
| 71 | == Test == | ||
| 72 | |||
| 73 | You can test the installation from another machine in the network using “nc” or “wscat”. | ||
| 74 | |||
| 75 | {{{nc -zv <IP-ADDRESS OF PI-STAR> 8765 | ||
| 76 | }}} | ||
| 77 | |||
| 78 | {{{wscat -c ws://<IP-ADDRESS OF PI-STAR>:8765 --no-color}}} | ||
| 79 | |||
| 80 | = DMR ID Naming = | ||
| 81 | |||
| 82 | To get a readable nickname in the Radio Log rather than the DMR ID, the respective Radio has to be handed out to the Operative via the Personal Assets Database. The DMR ID (e.g. 9912345) has to be set as ”Information” when handing out the radio. | ||
| 83 | |||
| 84 | **Please be aware that only radio DMR IDs in the range 10000 < x < 9999999 will work due to a limitation of the Pi-Star MMDVMHost software.** | ||
| 85 | |||
| 86 | |||
| 87 | [[image:radiolog_asset.png]] |