OsmocomDECT

h1. Configuration

Currently the netlink API example programs in [wiki:libnl] contained in the src/ directory are used for configuration.

Configuration consists of two steps: creating and configuring a DECT cluster and application specific configuration.

A cluster consists of one or more cells, each containing one or more transceivers. Currently only single-cell systems are supported though.

h2. Cluster configuration

To create a cluster, use the dect-cluster-add command:

<pre>

# dect-cluster-add --name cluster0 --mode fp --emc 0x1182 --fpn 0x0fac3

</pre>

The mode can be either FP for a fixed part, or PP for a portable part. The EMC and FPN specify the ID of the Fixed Part, in PP mode the cluster will scan for a matching FP and lock to its signal. For portable parts it is additionally possible to configure the cluster to "monitor" mode, in which the traffic bearers of all other portable parts will be received, by specifying "--flags monitor".

The cluster configuration can be shown using the dect-cluster-list command:

<pre>

# dect-cluster-list 

1: DECT Cluster cluster0:

	Mode: FP

	PARI: class A (residential) EMC: 1182 FPN: 0fac3

</pre>

The cluster can be removed again using the dect-cluster-delete command:

<pre>

# dect-cluster-delete --name cluster0

</pre>

h2. Cell configuration ==

Cells always exist in the context of a cluster. They can be created using the dect-cell-add command:

<pre>

# dect-cell-add --name cell0 --cluster cluster0

</pre>

To actually do something useful, one or more transceivers need to be attached to a cell using the

dect-transceiver-bind command. Attaching multiple transceivers is only valid if the cluster is

operating in FP mode:

<pre>

# dect-transceiver-bind --transceiver trx0 --cell cell0

# dect-transceiver-bind --transceiver trx1 --cell cell0

# dect-transceiver-bind --transceiver trx2 --cell cell0

</pre>

Similar to clusters, cells can be displayed using the dect-cell-list command:

<pre>

1: DECT Cell cell0@cluster0:

	Transceiver: trx0

	Transceiver: trx1

	Transceiver: trx2

</pre>

The cell can be removed again using the dect-cell-delete command:

<pre>

# dect-cell-delete --name cell0

</pre>

h2. Misc

To find the ID of an existing station, the dect-llme-scan command can be used. This is only

valid in PP mode:

<pre>

# dect-llme-scan --cluster cluster0

Requested: SCAN-req: 

1: Station: MAC_INFO-ind: 

	ARI: class A (residential) EMC: 0aa1 FPN: 0f732 RPN: 0 signal level: -69.24dBm

	MAC layer capabilities: extended_fp_info,full_slot,page_repetition,basic_a_field_setup,in_min_delay

	Extended MAC layer capabilities: prolonged_preamble

	Higher layer capabilities: adpcm_g721_voice,gap_pap_basic_speech,standard_authentication,standard_ciphering,location_registration

2: Station: MAC_INFO-ind: 

	ARI: class A (residential) EMC: 022f FPN: 197da RPN: 0 signal level: -48.29dBm

	MAC layer capabilities: full_slot,page_repetition,basic_a_field_setup,in_min_delay

	Higher layer capabilities: adpcm_g721_voice,gap_pap_basic_speech,standard_authentication,location_registration

3: Station: MAC_INFO-ind: 

	ARI: class A (residential) EMC: 09fd FPN: 0f3ac RPN: 0 signal level: -72.29dBm

	MAC layer capabilities: extended_fp_info,full_slot,page_repetition,basic_a_field_setup,in_min_delay

	Extended MAC layer capabilities: prolonged_preamble,

	Higher layer capabilities: adpcm_g721_voice,gap_pap_basic_speech,standard_authentication,standard_ciphering,location_registration,ciss_service

4: Station: MAC_INFO-ind: 

	ARI: class A (residential) EMC: 0fe5 FPN: 08dd5 RPN: 0 signal level: -70.18dBm

	MAC layer capabilities: full_slot,page_repetition,basic_a_field_setup,in_min_delay

	Higher layer capabilities: adpcm_g721_voice,gap_pap_basic_speech,standard_authentication,location_registration

...

</pre>

To verify whether a given station is your own, put it into pairing mode (usually by pressing a button on the station) and

look for the "access_rights_requests" higher layer capability.

To list registered transceivers and get some status information while a cluster is running, the dect-transceiver-list

command can be used. In the example below trx0 is the primary transceiver of a system using 10 transceivers and is

scanning for PP bearer setup attempts on slots 12-23 (PP normal transmit slots). The dummy bearer is transmitted on

slot 10. trx9 is the last transceiver of the cell and is receiving the dummy bearer of the primary transceiver for

clock synchronization on slot 10, additionally it has one active traffic bearer on slot-pair 0/12.

<pre>

# dect-transceiver-list --name trx0

DECT Transceiver trx0@cell0:

	Type: sc1442x

	RF-band: 00000

	Events: busy: 0 late: 0

	slot 0: <idle> carrier: 4 (1890.432 MHz)

	    RX: bytes 0 packets 0 a-crc-errors 0 x-crc-errors 0 z-crc-errors 0

	    TX: bytes 0 packets 0

	slot 2: <idle> carrier: 4 (1890.432 MHz)

	    RX: bytes 0 packets 0 a-crc-errors 2 x-crc-errors 0 z-crc-errors 0

	    TX: bytes 0 packets 0

	slot 4: <idle> carrier: 4 (1890.432 MHz)

	    RX: bytes 0 packets 0 a-crc-errors 0 x-crc-errors 0 z-crc-errors 0

	    TX: bytes 0 packets 0

	slot 6: <idle> carrier: 4 (1890.432 MHz)

	    RX: bytes 8 packets 1 a-crc-errors 2 x-crc-errors 0 z-crc-errors 0

	    TX: bytes 0 packets 0

	slot 8: <idle> carrier: 4 (1890.432 MHz)

	    RX: bytes 0 packets 0 a-crc-errors 1 x-crc-errors 0 z-crc-errors 0

	    TX: bytes 0 packets 0

	slot 10: <tx> carrier: 8 (1883.520 MHz)

	    RX: bytes 0 packets 0 a-crc-errors 0 x-crc-errors 0 z-crc-errors 0

	    TX: bytes 39680 packets 4960

	slot 12: <scanning> carrier: 1 (1895.616 MHz)

	    RX: bytes 12348 packets 252 a-crc-errors 231 x-crc-errors 220 z-crc-errors 212

	    TX: bytes 0 packets 0

	slot 14: <scanning> carrier: 1 (1895.616 MHz)

	    RX: bytes 16807 packets 343 a-crc-errors 236 x-crc-errors 211 z-crc-errors 215

	    TX: bytes 0 packets 0

	slot 16: <scanning> carrier: 1 (1895.616 MHz)

	    RX: bytes 14798 packets 302 a-crc-errors 255 x-crc-errors 240 z-crc-errors 230

	    TX: bytes 0 packets 0

	slot 18: <scanning> carrier: 0 (1897.344 MHz)

	    RX: bytes 11172 packets 228 a-crc-errors 210 x-crc-errors 193 z-crc-errors 188

	    TX: bytes 0 packets 0

	slot 20: <scanning> carrier: 0 (1897.344 MHz)

	    RX: bytes 9800 packets 200 a-crc-errors 200 x-crc-errors 188 z-crc-errors 172

	    TX: bytes 0 packets 0

	slot 22: <scanning> carrier: 0 (1897.344 MHz)

	    RX: bytes 11270 packets 230 a-crc-errors 230 x-crc-errors 222 z-crc-errors 209

	    TX: bytes 0 packets 0

# dect-transceiver-list --name trx9

DECT Transceiver trx9@cell0:

	Type: sc1442x

	RF-band: 00000

	Events: busy: 0 late: 2587

	slot 0: <tx> carrier: 2 (1893.888 MHz)

	    RX: bytes 320 packets 40 a-crc-errors 1 x-crc-errors 0 z-crc-errors 0

	    TX: bytes 1776 packets 37

	slot 2: <idle> carrier: 0 (1897.344 MHz)

	    RX: bytes 0 packets 0 a-crc-errors 0 x-crc-errors 0 z-crc-errors 0

	    TX: bytes 0 packets 0

	slot 4: <idle> carrier: 0 (1897.344 MHz)

	    RX: bytes 0 packets 0 a-crc-errors 0 x-crc-errors 0 z-crc-errors 0

	    TX: bytes 0 packets 0

	slot 6: <idle> carrier: 0 (1897.344 MHz)

	    RX: bytes 0 packets 0 a-crc-errors 0 x-crc-errors 0 z-crc-errors 0

	    TX: bytes 0 packets 0

	slot 8: <idle> carrier: 0 (1897.344 MHz)

	    RX: bytes 0 packets 0 a-crc-errors 0 x-crc-errors 0 z-crc-errors 0

	    TX: bytes 0 packets 0

	slot 10: <rx,sync> carrier: 9 (1881.792 MHz +0.569 kHz) signal level: -41.94dBm

	    RX: bytes 2600 packets 325 a-crc-errors 0 x-crc-errors 0 z-crc-errors 0

	    TX: bytes 0 packets 0

	slot 12: <rx> carrier: 2 (1893.888 MHz +0.083 kHz) signal level: -57.47dBm

	    RX: bytes 1764 packets 36 a-crc-errors 0 x-crc-errors 0 z-crc-errors 0

	    TX: bytes 0 packets 0

	slot 14: <idle> carrier: 0 (1897.344 MHz)

	    RX: bytes 0 packets 0 a-crc-errors 0 x-crc-errors 0 z-crc-errors 0

	    TX: bytes 0 packets 0

	slot 16: <idle> carrier: 0 (1897.344 MHz)

	    RX: bytes 0 packets 0 a-crc-errors 0 x-crc-errors 0 z-crc-errors 0

	    TX: bytes 0 packets 0

	slot 18: <idle> carrier: 0 (1897.344 MHz)

	    RX: bytes 0 packets 0 a-crc-errors 0 x-crc-errors 0 z-crc-errors 0

	    TX: bytes 0 packets 0

	slot 20: <idle> carrier: 0 (1897.344 MHz)

	    RX: bytes 0 packets 0 a-crc-errors 0 x-crc-errors 0 z-crc-errors 0

	    TX: bytes 0 packets 0

	slot 22: <idle> carrier: 0 (1897.344 MHz)

	    RX: bytes 0 packets 0 a-crc-errors 0 x-crc-errors 0 z-crc-errors 0

	    TX: bytes 0 packets 0

</pre>