Properties

Configuration, status and telemetry download from the device is handled using a number of property variables. Each variable has a type (signed/unsigned integers, floating point numbers, strings, etc.) and a default value. Some properties are used for configuration and can be modified and stored in (optionally write-protected) non-volatile memory. Others are read-only and used for telemetry purposes. Some property changes take effect immediately, while others require a store and a system reset after update.

The system properties are divided into a number of property groups, each covering a specific part of the firmware.

Property values can be listed, modified and stored using the prop debug shell commands or remotely through the Property Client Library library. As an example, to change the CSP address of the device to 11 and the default interface to RS422/KISS, run:

[srs-4] prop get sys.csp.address
24
[srs-4] prop set sys.csp.address 11
[srs-4] prop set sys.csp.routes "0/0 KISS"
[srs-4] prop unlock sys
[srs-4] prop save sys
[srs-4] prop unlock -f sys
[srs-4] prop save -f sys
[srs-4] reboot
...
[srs-4] prop get sys.csp.address
11
[srs-4] prop get sys.csp.routes
"0/0 KISS"

System Group

The sys group contains system parameters that should remain fixed after launch. The group can be stored twice in boot and fallback configuration. Both are write-protected and must be unlocked using prop unlock before they can be written to.

Property

Type

Default

Description

sys.name

string

srs-4

String name for system

sys.serial

uint32

Serial number/ID

sys.sw.version

uint32

Running software version

sys.bootcount

uint32

Number of times the system was booted

sys.reboot

uint16

0

Reboot timer

sys.gwdt.init

uint32

86400

GWDT timer reset value

sys.gwdt.counter

uint32

0

GWDT current counter value

sys.gwdt.reset

uint32

0

GWDT reset trigger

sys.csp.address

uint8

24

CSP address of the device

sys.csp.routes

string

0/0 CAN,10/5 SPACE

CSP routing table in CIDR notation

sys.can.rate

uint32

1000000

CAN-bus bitrate

sys.can.promisc

bool

True

Accept all CSP CAN-frames

sys.uart.rate

uint32

1000000

UART baudrate

sys.uart.multidrop

bool

False

UART multidrop mode

sys.net.enable

bool

False

IP stack enable

sys.net.en.ip

string

192.168.100.2

Ethernet IP address

sys.net.en.prefix

uint8

24

Ethernet network prefix bits

sys.net.en.gw

string

192.168.100.1

Ethernet gateway IP address

sys.net.rf.ip

string

192.168.200.2

Spacelink IP address

sys.net.rf.prefix

uint8

24

Spacelink network prefix bits

sys.net.rf.gw

string

192.168.200.1

Spacelink gateway IP address

Calibration Group

The cal group contains factory calibration settings and should not be modified.

Transmitter Group

The tx group contains settings for the transmitter. The group can be stored twice in boot and fallback configuration. The fallback configuration is write-protected and must be unlocked using prop unlock before it can be written to.

Property

Type

Default

Description

tx.allow.always

bool

True

Always allow transmissions

tx.allow.time

uint16

0

Allow transmissions time

tx.freq

uint32

2229500000

Transmit frequency

tx.type

uint8

1

Transmit modulation type (0 = BPSK, 1 = QPSK, 2 = 8PSK)

tx.rate

uint32

1000000

Transmit symbol rate

tx.rolloff

uint8

0

RRC roll-off (0 = 0.20, 1 = 0.25, 2 = 0.35)

tx.pout

float

20.0

Transmit power

tx.alc.mode

uint8

1

Automatic Level Control mode (0 = open-loop, 1 = closed-loop)

tx.rs

bool

True

Enable Reed-Solomon coding

tx.cc

bool

True

Enable convolutional coding

tx.rand

bool

True

Enable randomization

tx.crc

bool

True

Enable CRC checksum

tx.idletime

uint16

30

Active transmitter time after each frame

tx.size

uint16

217

Maximum payload size

tx.id

uint16

0

Satellite ID/address

tx.crypto.key

binary

00…00

Encryption key

tx.crypto.encrypt

bool

False

Encrypt frames

tx.crypto.auth

bool

False

Add authentication tag

tx.pa.templimit

uint8

80

PA temperature limit

tx.frames

uint32

Transmitted frames

tx.pwr.fwd

float

Measured forward power

tx.pwr.rfl

float

Measured reflected power

Receiver Group

The rx group contains settings for the receiver. The group can be stored twice in boot and fallback configuration. The fallback configuration is write-protected and must be unlocked using prop unlock before it can be written to.

Property

Type

Default

Description

rx.freq

uint32

2029500000

Receive frequency

rx.type

uint8

1

Receive modulation type (0 = BPSK, 1 = QPSK)

rx.rate

uint32

1000000

Receive symbol rate

rx.rolloff

uint8

0

RRC roll-off (0 = 0.20, 1 = 0.25, 2 = 0.35)

rx.afc.enable

bool

True

Enable AFC

rx.afc.range

uint32

15000

AFC adjustment range

rx.rs

bool

True

Enable Reed-Solomon coding

rx.cc

bool

True

Enable convolutional coding

rx.rand

bool

True

Enable randomization

rx.crc

bool

True

Enable CRC checksum

rx.size

uint16

217

Maximum payload size

rx.id

uint16

0

Satellite ID/address

rx.crypto.key

binary

00…00

Decryption key

rx.crypto.decrypt

bool

False

Decrypt frames

rx.crypto.auth

bool

False

Verify authentication tag

rx.local.drop

bool

False

Drop CSP and IP for local node

rx.frames

uint32

Received frames

rx.detected

uint32

Detected frames

rx.rssi

float

Measured RSSI

rx.freqerr

float

Estimated frequency error

rx.symerr

float

Estimated symbol rate error

rx.ebn0

float

Estimated Eb/N0

rx.carrier.lock

bool

Carrier lock

rx.frame.lock

bool

Frame synchronizer lock

Telemetry Group

Telemetry values are stored in the tm group and updated once every second. The group does not support storage.

Property

Type

Default

Description

tm.temp.psu

int16

Power conversion temperature

tm.temp.mcu

int16

MCU package temperature

tm.temp.fpga

int16

FPGA temperature

tm.temp.xcvr

int16

Transceiver temperature

tm.temp.lna

int16

LNA temperature

tm.temp.pa

int16

PA temperature

tm.volt.vin

uint16

Input voltage

tm.volt.3v3

uint16

3.3 V rail voltage

tm.volt.1v8

uint16

1.8 V rail voltage

tm.volt.1v0

uint16

1.0 V rail voltage

tm.volt.pa

uint16

PA voltage

tm.cur.vin

int16

Input current

tm.cur.3v3

int16

3.3 V rail current

tm.cur.1v8

int16

1.8 V rail current

tm.cur.1v0

int16

1.0 V rail current

tm.cur.pa

int16

PA current

tm.power.vin

uint16

Input power

tm.power.3v3

uint16

3.3 V rail power

tm.power.1v8

uint16

1.8 V rail power

tm.power.1v0

uint16

1.0 V rail power

tm.power.pa

uint16

PA power