Add setup documention (mostly ICOM repeater related)

This commit is contained in:
Josh Proehl 2023-03-30 20:48:28 -05:00
parent 59a7d1ab1e
commit bd35217169

View file

@ -53,3 +53,28 @@ Note that this will remove the systemd unit, but will not first stop or disable
```shell
sudo systemctl disable --now ircddbgateway.service
```
It will also not remove your /etc/ircddbgateway configuration file.
# Setup
Only the ircddbgatewayd service is required for basic usage, all other compiled applications are optional.
## ICOM repeater configuration
If using an ICOM ID-RP2C you will need to use the ICOM utility to configure the repeater. By default the ID-RP2C uses the IP address 172.16.0.1, and expects the device controlling it (either your computer, or the computer running ircddbgatewayd) to be using the IP address 172.16.0.20, and uses the default password "PASSWORD". It may not be advisable to change this password as performing a hardware reset is not a documented feature. Ideally the ID-RP2C is connected directly to a secondary ethernet port on the device running ircddbgatewayd and configured with a static IP address, other configurations may prove problematic.
When configuring the repeater using the ICOM utility you will need to change the port in the "Communication Settings" section to use the same port as is used in the "Gateway" section (20000 by default), and then go into the Options/Network Setup menu of the ICOM app to change the port to match what you put into the "Communication Settings" section.
Once both of those fields are set to the same port number, ensure that the "Local RPT" section is set correctly for whichever physical plug your ID-RP2D is plugged into on the back of the ID-RP2C. Whichever number you have plugged in to should be set to "Voice", and have the correct band entered in the text box. ("B" for 70cm, for example.)
In your /etc/ircddbgateway config file the following options are important:
```
icomAddress=172.16.0.20
icomPort=20000
repeaterCall1=REPEATERCALLSIGN
repeaterBand1=B
repeaterType1=1
repeaterAddress=172.16.0.1
repeaterPort1=20000
```
Note that this assumes you're configuring "Repeater 1".
The repeaterAdress is the address of the ID-RP2C controller, and "icomAddress" is the address of the device running ircddbgatewayd. The "Type" being 1 indicates an ICOM repeater. The Band should be set to whichever band you entered in the "Local RPT" section of the ICOM configuration software, and the callsign should match the call used in in the ICOM software.