# Roaming

The roaming configuration consists of a list of roaming channels and roaming zones. While roaming channels specify those channel settings, that might be overridden during roaming, the roaming zone specifies a collection of roaming channels, that can be used to maintain a connection to a particular talk group.

Roaming channels contain those settings of a DMR channel, that are specific for a particular repeater. This allows to override these settings in a channel, when the repeater of that channel gets out of range. Then, the radio may switch to a different repeater to maintain the connection to the current talk group.

###

    roamingChannels:
      - id: rch1
        name: R DB0LDS
        rxFrequency: 439.5625
        txFrequency: 431.9625
      - id: rch2
        name: R DB0AFZ
        rxFrequency: 439.97500
        txFrequency: 430.57500
        colorCode: 1
        timeSlot: 1

The example above shows the definition of two roaming channels. Both are used to stay in contact with a regional talk group within the Brandmeister network. While the repeater DB0LDS is located within this region, DB0AFZ is not. Consequently, the time-slot of the channel needs to be overridden.

## Roaming channel fields

id

- Specifies the ID of the roaming channel. This ID can then be used to refer to this channel within a roaming zone. Any unique string is valid here.

name

- Specifies the name of the roaming channel. Any string is valid here.

rxFrequency, txFrequency

- Specifies the receive and transmit frequencies of the channel.

colorCode

- Specifies the color code of the channel. If set, overrides the color code of the current channel. If omitted, the color code of the selected channel is used during roaming.

timeSlot

- Specifies the time slot of the channel. If set, overrides the time slot of the current DMR channel. If omitted, the time slot of the selected channel is used during roaming.

Roaming zones are collections of roaming channels, that are scanned for the strongest signal to maintain connection to a particular network or talk group.

As an example, consider the following roaming zone:

###

    roamingZones:
      - id: roam1
        name: Berlin/Brand
        channels: [rch1, rch2, rch3]

This zone has the ID roam1 and the name Berlin/Brand. This group collects all roaming channels that provide access to the Berlin/Brandenburg talk group.

## Roaming zone fields

id

- Specifies the ID of the roaming zone. This ID can then be used to refer to this zone. Any unique string is valid here.

name

- Specifies the name of the roaming zone. Any string is valid here.

channels

- Specifies the member channels for this roaming zone. This must be a list of references to roaming channels.