wiki:Configuration

Configuration

Currently the netlink API example programs in 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.

Cluster configuration

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

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

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:

# dect-cluster-list 
1: DECT Cluster cluster0:
	Mode: FP
	PARI: class A (residential) EMC: 1182 FPN: 0fac3

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

# dect-cluster-delete --name cluster0

Cell configuration

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

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

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:

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

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

1: DECT Cell cell0@cluster0:
	Transceiver: trx0
	Transceiver: trx1
	Transceiver: trx2

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

# dect-cell-delete --name cell0

Misc

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

# 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
...

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.

# 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

Last modified 7 years ago Last modified on Oct 5, 2010, 4:28:48 AM

Attachments (1)

  • join.pl (412 bytes) - added by kaber 7 years ago. Perl script to join the dect-transceiver-list output of multiple transceivers

Download all attachments as: .zip