Linux Amateur Radio AX.25 HOWTO
Prev |  | Next

# 10. Configuring a ROSE port

The ROSE packet layer protocol is similar to layer three of the X.25 specification. The kernel based ROSE support is a modified version of the FPAC Rose implementation.

The ROSE packet layer protocol protocol relies on, and uses the AX.25 ports you have created. The ROSE protocol rides on top of the AX.25 protocol. To configure ROSE you must create a configuration file that describes the ROSE ports you want. You can create multiple ROSE ports if you wish, the same procedure applies for each.

## 10.1. Configuring `/etc/ax25/rsports`

The file where you configure your ROSE interfaces is the `/etc/ax25/rsports` file. This file describes the ROSE port in much the same way as the `/etc/ax25/axports` file describes the AX.25 ports.

This file is formatted as follows:

    name  address  description

Where:

name

  is the text name that you wish to refer to the port by.

address

  is the 10 digit ROSE address you wish to assign to this port.

description

  is a free text description of the port.

An example would look something like the following:

    rose  5050294760  Rose Port

Note that ROSE will use the default callsign/ssid configured on each AX.25 port unless you specify otherwise.

To configure a separate callsign/ssid for ROSE to use on each port you use the rsparms command as follows:

    # /usr/sbin/rsprams -call VK2KTJ-10

This example would make Linux listen for and use the callsign/ssid `VK2KTJ-10` on all of the configured AX.25 ports for ROSE calls.

## 10.2. Creating the ROSE Network device

When you have created the `/etc/ax25/rsports` file you may create the ROSE device in much the same way as you did for the AX.25 devices. This time you use the rsattach command. The rsattach command creates network devices named ``rose[0-5]`'. The first time you use the rsattach command it create the ``rose0`' device, the second time it creates the ``rose1`' device etc. For example:

    # rsattach rose

This command would start the ROSE device (`rose0`) configured with the details specified in the `/etc/ax25/rsports` file for the entry named ``rose`'.

## 10.3. Configuring ROSE Routing

The ROSE protocol currently supports only static routing. The rsparms utility allows you to configure your ROSE routing table under Linux.

For example:

    # rsparms -nodes add 5050295502 radio vk2xlz

would add a route to ROSE node `5050295502` via an AX.25 port named ``radio`' in your `/etc/ax25/axports` file to a neighbour with the callsign `VK2XLZ`.

You may specify a route with a mask to capture a number of ROSE destinations into a single routing entry. The syntax looks like:

    # rsparms -nodes add 5050295502/4 radio vk2xlz

which would be identical to the previous example except that it would match any destination address that matched the first four digits supplied, in this case any address commencing with the digits `5050`. An alternate form for this command is:

    # rsparms -nodes add 5050/4 radio vk2xlz

which is probably the less ambiguous form.

Prev | Home | Next
Configuring a NET/ROM interface for TCP/IP |  | Making AX.25/NET/ROM/ROSE calls