Update the documentation to reflect the current state of the software.

This commit is contained in:
Jonathan Naylor 2026-04-07 12:57:38 +01:00
parent 5da5c46e04
commit be804801ac
2 changed files with 16 additions and 19 deletions

View file

@ -1,9 +1,11 @@
On Linux, to run MMDVMHost as a daemon, set "Daemon=1" in the ini file.
When this is set, MMDVMHost will attempt to drop privileges to user "mmdvm" and
It is possible to run the MMDVMHost via systemd, if this method is used, then
the following does not apply, and Daemon should be set to 0 in the ini file.
When Daemon is set, MMDVMHost will attempt to drop privileges to user "mmdvm" and
group "mmdvm". If this user and group do not exist on your system, an error
will occur and
MMDVMHost will not start.
will occur and MMDVMHost will not start.
To add these users, please do the following from the Linux command line:
@ -14,13 +16,8 @@ usermod mmdvm -G dialout
Note, without the last line, MMDVMHost will not be able to open the modem.
Also note, when running as a daemon, STDIN, STDOUT and STDERR are closed, so
you must use a logfile to capture logging and the logfile entry in the ini file
must be given a full path as MMDVMHost calls "cd /" when daemonising. The same
applies to the DMRIds.dat file.
you must use MQTT to capture logging. The paths to the other files (DMRIds,
RSSI, etc) should be absolute and not relative as the current working directory
is set to "/" when the program is being run as a daemon.
Also, please note that the code to drop privileges is currently disabled when
MMDVMHost is compiled with the HD44780 display as it's currently not possible
to use this display as a non-root user.
Simon - G7RZU
Simon - G7RZU

View file

@ -1,15 +1,15 @@
These are the source files for building the MMDVMHost, the program that
interfaces to the MMDVM or DVMega on the one side, and a suitable network on
the other. It supports D-Star, DMR, P25 Phase 1, NXDN, System Fusion,
These are the source files for building the MMDVM Host, the program that
interfaces to the MMDVM or DVMega on the one side, and a suitable network (via a
gateway) on the other. It supports D-Star, DMR, P25 Phase 1, NXDN, System Fusion,
POCSAG, and FM on the MMDVM, and D-Star, DMR, and System Fusion on the DVMega.
On the D-Star side the MMDVMHost interfaces with the ircDDB Gateway, on DMR it
connects to the DMR Gateway to allow for connection to multiple DMR networks,
or a single network directly. on System Fusion it connects to the YSF Gateway to allow
On the D-Star side the MMDVM Host interfaces with the D-Star Gateway, on DMR it
connects to the DMR Gateway to allow for connection to multiple DMR networks.
On System Fusion it connects to the DG-Id or YSF Gateway to allow
access to the FCS and YSF networks. On P25 it connects to the P25 Gateway. On
NXDN it connects to the NXDN Gateway which provides access to the NXDN and
NXCore talk groups. It uses the DAPNET Gateway to access DAPNET to receive
paging messages.
paging messages for transmission using POCSAG.
It builds on 32-bit and 64-bit Linux as well as on Windows using Visual Studio
2022 on x86 and x64.