OsmocomDECT

h1. Virtual Transceiver Driver

{{>toc}}

The virtual transceiver driver allows to create groups of transceivers which can interact with each other.

h2. Kernel configuration

To enable the driver, set the config option

<pre>

CONFIG_DECT_VTRX=y/m

</pre>

The module is called @dect_vtrx@.

h2. Driver Configuration

Configuration of the driver is done through a sysfs interface. The driver registers a set of files under @/sys/class/dect/@, which are used to add or remove transceiver groups or transceivers and configure transceiver parameters.

h3. Groups

Groups are containers for transceivers, only transceivers contained in the same group can communicate with each other.

When loaded, the driver creates a single group called @group-1@. New groups can be created by executing

<pre>

echo group-name > /sys/class/dect/new-group

</pre>

Each group registers a directory named like the group in ''/sys/class/dect/''.

h3. Transceivers

New transceivers can be create by executing

<pre>

echo > /sys/class/dect/group-name/new_trx

</pre>

A unique name is assigned to newly created transceivers automatically. For each transceiver, a directory named like the transceiver is created in @/sys/class/dect/group-name@. This directory contains the following files:

 * @remove@: remove the transceiver

 * @tx_power@: transmit power in dBm

 * @pos_x@: position of the transceiver on the x-axis

 * @pos_y@: position of the transceiver on the y-axis

When receiving a frame from the transceiver, the received signal strength is calculated from the transmit power and the distance between the two transceivers. The frame received with the strongest signal strength is received by the transceiver. Interference is currently not simulated.