<HTML ><HEAD ><TITLE >Configuring a ROSE port</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.63 "><LINK REL="HOME" TITLE="Linux Amateur Radio AX.25 HOWTO" HREF="index.html"><LINK REL="PREVIOUS" TITLE="Configuring a NET/ROM interface for TCP/IP" HREF="x1343.html"><LINK REL="NEXT" TITLE="Making AX.25/NET/ROM/ROSE calls" HREF="x1449.html"></HEAD ><BODY CLASS="SECT1" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="3" ALIGN="center" >Linux Amateur Radio AX.25 HOWTO</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="x1343.html" >Prev</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="x1449.html" >Next</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><DIV CLASS="SECT1" ><H1 CLASS="SECT1" ><A NAME="AEN1374" >10. Configuring a ROSE port</A ></H1 ><P >The ROSE packet layer protocol is similar to layer three of the X.25 specification. The kernel based ROSE support is a <EM >modified</EM > version of the <A HREF="http://fpac.lmi.ecp.fr/f1oat/f1oat.html" TARGET="_top" >FPAC Rose implementation</A >.</P ><P >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.</P ><DIV CLASS="SECT2" ><H2 CLASS="SECT2" ><A NAME="AEN1380" >10.1. Configuring <TT CLASS="LITERAL" >/etc/ax25/rsports</TT ></A ></H2 ><P >The file where you configure your ROSE interfaces is the <TT CLASS="LITERAL" >/etc/ax25/rsports</TT > file. This file describes the ROSE port in much the same way as the <TT CLASS="LITERAL" >/etc/ax25/axports</TT > file describes the AX.25 ports.</P ><P >This file is formatted as follows:</P ><P ><TABLE BORDER="1" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><FONT COLOR="#000000" ><PRE CLASS="SCREEN" >name address description</PRE ></FONT ></TD ></TR ></TABLE ></P ><P >Where: <P ></P ><DIV CLASS="VARIABLELIST" ><DL ><DT >name</DT ><DD ><P >is the text name that you wish to refer to the port by.</P ></DD ><DT >address</DT ><DD ><P >is the 10 digit ROSE address you wish to assign to this port.</P ></DD ><DT >description</DT ><DD ><P >is a free text description of the port.</P ></DD ></DL ></DIV ></P ><P >An example would look something like the following:</P ><P ><TABLE BORDER="1" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><FONT COLOR="#000000" ><PRE CLASS="SCREEN" >rose 5050294760 Rose Port</PRE ></FONT ></TD ></TR ></TABLE ></P ><P >Note that ROSE will use the default callsign/ssid configured on each AX.25 port unless you specify otherwise.</P ><P >To configure a separate callsign/ssid for ROSE to use on each port you use the <EM >rsparms</EM > command as follows:</P ><P ><TABLE BORDER="1" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><FONT COLOR="#000000" ><PRE CLASS="SCREEN" ># /usr/sbin/rsprams -call VK2KTJ-10</PRE ></FONT ></TD ></TR ></TABLE ></P ><P >This example would make Linux listen for and use the callsign/ssid <TT CLASS="LITERAL" >VK2KTJ-10</TT > on all of the configured AX.25 ports for ROSE calls.</P ></DIV ><DIV CLASS="SECT2" ><H2 CLASS="SECT2" ><A NAME="AEN1413" >10.2. Creating the ROSE Network device</A ></H2 ><P >When you have created the <TT CLASS="LITERAL" >/etc/ax25/rsports</TT > 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 <EM >rsattach</EM > command. The <EM >rsattach</EM > command creates network devices named `<TT CLASS="LITERAL" >rose[0-5]</TT >'. The first time you use the <EM >rsattach</EM > command it create the `<TT CLASS="LITERAL" >rose0</TT >' device, the second time it creates the `<TT CLASS="LITERAL" >rose1</TT >' device etc. For example:</P ><P ><TABLE BORDER="1" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><FONT COLOR="#000000" ><PRE CLASS="SCREEN" ># rsattach rose</PRE ></FONT ></TD ></TR ></TABLE ></P ><P >This command would start the ROSE device (<TT CLASS="LITERAL" >rose0</TT >) configured with the details specified in the <TT CLASS="LITERAL" >/etc/ax25/rsports</TT > file for the entry named `<TT CLASS="LITERAL" >rose</TT >'.</P ></DIV ><DIV CLASS="SECT2" ><H2 CLASS="SECT2" ><A NAME="AEN1429" >10.3. Configuring ROSE Routing</A ></H2 ><P >The ROSE protocol currently supports only static routing. The <EM >rsparms</EM > utility allows you to configure your ROSE routing table under Linux.</P ><P >For example:</P ><P ><TABLE BORDER="1" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><FONT COLOR="#000000" ><PRE CLASS="SCREEN" ># rsparms -nodes add 5050295502 radio vk2xlz</PRE ></FONT ></TD ></TR ></TABLE ></P ><P >would add a route to ROSE node <TT CLASS="LITERAL" >5050295502</TT > via an AX.25 port named `<TT CLASS="LITERAL" >radio</TT >' in your <TT CLASS="LITERAL" >/etc/ax25/axports</TT > file to a neighbour with the callsign <TT CLASS="LITERAL" >VK2XLZ</TT >.</P ><P >You may specify a route with a mask to capture a number of ROSE destinations into a single routing entry. The syntax looks like:</P ><P ><TABLE BORDER="1" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><FONT COLOR="#000000" ><PRE CLASS="SCREEN" ># rsparms -nodes add 5050295502/4 radio vk2xlz</PRE ></FONT ></TD ></TR ></TABLE ></P ><P >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 <TT CLASS="LITERAL" >5050</TT >. An alternate form for this command is:</P ><P ><TABLE BORDER="1" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><FONT COLOR="#000000" ><PRE CLASS="SCREEN" ># rsparms -nodes add 5050/4 radio vk2xlz</PRE ></FONT ></TD ></TR ></TABLE ></P ><P >which is probably the less ambiguous form.</P ></DIV ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="x1343.html" >Prev</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="index.html" >Home</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="x1449.html" >Next</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >Configuring a NET/ROM interface for TCP/IP</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" > </TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >Making AX.25/NET/ROM/ROSE calls</TD ></TR ></TABLE ></DIV ></BODY ></HTML >