pYSFReflector – User Guide

Home DG-ID, monitor lists, dynamic DG-IDs and automatic return.

1. General information

The pYSFReflector is a powerful YSF reflector for the Yaesu System Fusion network. It allows a reflector to be operated with advanced features that go beyond the standard feature set.

Key additions include:

  • Support for Home DG-IDs
  • Simultaneous monitoring of multiple DG-IDs
  • Dynamic assignment of additional DG-IDs
  • Automatic return to the Home DG-ID
  • Convenient management through the dashboard
  • Display of the current monitor lists of all connected clients

This lets a repeater or hotspot monitor several talk groups at once, without the user having to constantly switch between DG-IDs manually.

If your GPS position or radio model is not shown on the dashboard, it's because you are connecting via a non-YSF reflector. This can happen, for example, when connecting through Wires-X, which loses all YSF metadata via the Brandmeister bridge (gateway "BM2622"), or through a multimode setup based on XLX (gateway "XLXxxx"). In both cases this data is lost and can only be recovered by connecting your hotspot/repeater directly to DE-Deutschland (YSF26200).

2. Home DG-ID and monitor list

Every client has exactly one Home DG-ID.

The Home DG-ID is the client's preferred talk group. After a certain period of inactivity, the client automatically returns to this DG-ID.

Example

SettingValue
Home DG-ID76
Monitor list66,79,80

The client normally operates on DG-ID 76.

In addition, it continuously monitors:

  • DG-ID 66
  • DG-ID 79
  • DG-ID 80

As soon as a transmission starts on one of these DG-IDs, the reflector automatically switches the client to that DG-ID.

This means no conversations on the monitored DG-IDs are missed.

3. Creating a monitor list

The monitor list can be set either

  • via the YSF Options String (YSFO)
  • or via the reflector configuration

The first entry always defines the Home DG-ID. All further entries form the monitor list.

WPSD hotspot

On WPSD, the monitor list is entered in the YCS Network Options field. The first value is always the Home DG-ID, all further values form the monitor list.

Example:
76;92;66;63;37;79

Home DG-ID: 76
Monitor list: 92, 66, 63, 37, 79
WPSD hotspot configuration
Configuring the Home DG-ID and monitor list in WPSD.

openSPOT

On the openSPOT, the monitor list is entered in the DGID list (separate IDs with ;) field. Unlike WPSD, this field contains only the monitor DG-IDs. The Home DG-ID is determined by the radio's currently configured transmit DG-ID.

Example:
DGID list: 66;63;

The client additionally monitors DG-IDs 66 and 63.
openSPOT monitor list
Configuring the monitor list in openSPOT.

BlueDV

BlueDV also lets you set the YSF options string. Simply add the following line under the FUSION section of your BlueDV config (in Documents/Bluedv):


            [FUSION]
            ..........
            Options="76;79;92;63"
        

Pi-Star

On Pi-Star, the Home DG-ID together with the monitor list is entered in expert mode in the file YSFGateway.ini.

There are two ways to configure the connection string on Pi-Star: through a manual ini entry, or by applying a patch.

Applying the patch on Pi-Star

Go to the Pi-Star dashboard, then Configuration, then Expert. On the far right you'll find "SSH Access". Click it and then enter the following commands one after another.

  • rpi-rw
  • wget http://ysf-deutschland.de/pi-star/pistar-patch.zip
  • unzip pistar-patch.zip
  • cd pistar-4.3.7-ysf-options-inline-v2
  • sudo ./install.sh
After that you should find the Options field under YSF Configuration.

Pi-Star monitor list
Configuring the monitor list in Pi-Star.

Editing the YSFGateway file directly under /etc/YSFGateway

In the [Network] section, the following configuration can be used, for example:

[Network]
InactivityTimeout=1440
Revert=1
Debug=0
Startup=DE-Deutschland
Reconnect=1
Options="76;79;92;63"
Parameter Meaning
InactivityTimeout=1440 Time until automatic disconnect on inactivity.
Revert=1 Enables reverting to the configured startup reflector.
Debug=0 Disables extra debug output.
Startup=DE-Deutschland Connects Pi-Star to the DE-Deutschland reflector after startup.
Reconnect=1 Enables automatic reconnection.
Options="76;79;92;63" Defines the Home DG-ID and the monitor list.
Interpreting the options string:
Home DG-ID: 76
Monitor list: 79, 92, 63

The first entry in the Options field is always the Home DG-ID. All further entries form the monitor list.

After connecting, the hotspot initially operates on Home DG-ID 76. The reflector additionally monitors DG-IDs 79, 92 and 63. If a QSO starts on one of these DG-IDs, the client is automatically switched to that talk group.

An unconfigured DG-ID is dynamically added to the monitor list for 15 minutes when the client transmits on it. Sending on DG-ID 90 immediately clears all dynamic DG-ID assignments and returns the client to its Home DG-ID.

Example

76,66,79,80
Home DG-ID
76
Monitor list
66, 79, 80

4. Switching to another DG-ID

There are two different options.

4.1 Switching to a DG-ID on the monitor list

If activity starts on a DG-ID that is already on the monitor list, the reflector automatically switches to that DG-ID.

Example:
Home DG-ID: 76
Monitor list: 66, 79, 80

A user starts a conversation on DG-ID 79. The reflector detects the activity and automatically switches the client to DG-ID 79.

After the conversation ends, the client initially stays on DG-ID 79. Only once the back-to-home timer expires does it automatically return to the Home DG-ID.

4.2 Switching to a DG-ID outside the monitor list

If a DG-ID is used that is not on the monitor list, the reflector treats it as a temporary dynamic DG-ID.

Example:
Home DG-ID: 76
Monitor list: 66, 79, 80
Selected DG-ID: 12

Since DG-ID 12 is not part of the monitor list:

  • the client automatically switches to DG-ID 12,
  • DG-ID 12 is additionally added to the monitor list,
  • this addition is valid for 15 minutes.

During this time, DG-ID 12 behaves exactly like any other monitor DG-ID. After the 15 minutes expire, the dynamic assignment is automatically removed.

5. Dynamic monitor DG-IDs

Dynamic monitor DG-IDs have the following properties:

  • They are created automatically.
  • They do not need to be configured.
  • They stay active for 15 minutes.
  • Each new activity extends their lifetime.
  • They appear on the dashboard.
  • They are automatically removed once they expire.

This makes it possible to switch to any talk group for a short time, without permanently changing the actual configuration.

6. Disconnecting a DG-ID

A dynamically added DG-ID can be manually disconnected again at any time.

Manual disconnect with DG-ID 90

For an immediate disconnect, select DG-ID 90 on the radio and briefly press the PTT button.

DG-ID 90 is a control command:
It is not used as a talk group; instead it removes the client's dynamically added DG-IDs.

After transmitting on DG-ID 90:

  • all of the client's dynamic DG-ID assignments are removed,
  • the temporary monitor list is cleared,
  • the client immediately returns to its Home DG-ID.

Automatic disconnect

If no manual disconnect occurs, a dynamic DG-ID is automatically removed after 15 minutes without further activity.

This keeps the permanently configured monitor list unchanged; only the temporary assignments are removed.

7. Automatic return to the Home DG-ID

After every switch, the reflector monitors activity.

Once no activity remains on any monitored DG-ID, the back-to-home timer starts.

Once this timer expires, the client is automatically switched back to its Home DG-ID.

This means the repeater or hotspot returns to its starting state after every conversation.

8. Summary

The combination of

  • Home DG-ID
  • Monitor list
  • Dynamic monitor DG-IDs
  • Automatic return to the Home DG-ID

makes for very convenient operation of the reflector.

The user rarely needs to switch between DG-IDs manually, while still being able to monitor several talk groups at the same time.

Status indicators on the dashboard

TX – Transmission active
TD – DG-ID change
TO – Timeout
WD – Watchdog
Last Heard guide

Repeaters and hotspots

A client's current Home DG-ID, active DG-ID and monitor list are shown in the "Repeater / Hotspots" list.

Repeaters and hotspots

Note on Yaesu radios

On many radios, DG-ID selection is opened by pressing and holding the GM button. On the FT-70, the MODE button is held instead.

Note: Activated group mode can cause periodic automatic transmissions and thereby trigger a temporary block.