WizziLab / modem_ref

Dependents:   modem_ref_helper

Embed: (wiki syntax)

« Back to documentation index

D7A 1.x API

======================================================================= More...

Data Structures

union  d7a_vid_ctrl_t
 ======================================================================= ======================================================================= More...
union  d7a_phy_duty_cfg_t
 PHY Duty configuration. More...
union  d7a_phy_status_ch_id_t
 PHY Channel Status Identifier. More...
union  d7a_dll_cfg_flags_t
 DLL control flags structure. More...
union  d7a_dll_cfg_flags2_t
 DLL control flags2 structure. More...
union  d7a_nls_status_bmp_t
 ======================================================================= ======================================================================= More...
union  d7a_nwl_ssr_filter_t
 ======================================================================= ======================================================================= More...
struct  d7a_tp_ack_status_zip_t
 ======================================================================= ======================================================================= More...
union  d7a_agc_ctrl_t
 ======================================================================= ======================================================================= More...
union  d7a_sel_filter_t
 SEL segment filter options structure. More...
union  d7a_cca_cfg_t
 ======================================================================= ======================================================================= More...

Modules

 D7A API (all except APL)

Enumerations

enum  d7a_device_t { D7A_DEVICE_EP = 0, D7A_DEVICE_SC, D7A_DEVICE_GW, D7A_DEVICE_QTY }
 

======================================================================= =======================================================================

More...
enum  d7a_eng_mode_t { D7A_ENG_MODE_NORMAL = 0, D7A_ENG_MODE_SCP = 2, D7A_ENG_MODE_BEACON = 3, D7A_ENG_MODE_SENSITIVITY = 4 }
 

======================================================================= =======================================================================

More...
enum  d7a_ext_t { D7A_EXT_FSK = 0, D7A_EXT_OTHER = 1 }
 

======================================================================= =======================================================================

More...
enum  d7a_class_t {
  D7A_CLASS_LO = 0, D7A_CLASS_RFU, D7A_CLASS_NORMAL, D7A_CLASS_HI,
  D7A_CLASS_QTY
}
 

Enumerator of the nominal PHY channel classes.

More...
enum  d7a_class_ext_t {
  D7A_CLASS_EXT_LORA = 0, D7A_CLASS_EXT_RFU_1, D7A_CLASS_EXT_UNB, D7A_CLASS_EXT_UWB,
  D7A_CLASS_EXT_QTY
}
 

Enumerator of the Extended channel classes.

More...
enum  d7a_band_t {
  D7A_BAND_000 = 0, D7A_BAND_RFU_1 = 1, D7A_BAND_433 = 2, D7A_BAND_868 = 3,
  D7A_BAND_915 = 4, D7A_BAND_RFU_5 = 5, D7A_BAND_2400 = 6, D7A_BAND_UWB = 7,
  D7A_BAND_QTY
}
 

Enumerator of the PHY channel bands.

More...
enum  d7a_cs_t {
  D7A_CS_0 = 0, D7A_CS_1, D7A_CS_2, D7A_CS_3,
  D7A_CS_QTY
}
 

Enumerator of the PHY channel coding schemes.

More...
enum  d7a_nf_auto_t { D7A_NF_AUTO_NO = 0, D7A_NF_AUTO_SLOW = 1 }
 

======================================================================= =======================================================================

More...
enum  d7a_area_t
 

DLL Area Enumerator.

More...
enum  d7a_cond_t {
  D7A_COND_ANY = 0, D7A_COND_NE = 1, D7A_COND_EQ = 2, D7A_COND_LT = 3,
  D7A_COND_LTE = 4, D7A_COND_GT = 5, D7A_COND_GTE = 6
}
 

D7A comparison conditions.

More...
enum  d7a_nwl_routing_mode_t { D7A_NWL_ROUTING_MODE_DEFAULT = 0, D7A_NWL_ROUTING_MODE_QTY }
 

======================================================================= =======================================================================

More...

Variables

u8   bteq: 1
 Btag acceptance condition (0 : differ, 1 : equal)
u8   en: 1
 Declare myself using VID instead of UID.
u8 byte
 byte access
u8   rfu: 3
 RFU.
u8   sub_nb: 4
 When the widow type is sliding, number of sub-windows.
u8 word
 word access
u16   duty: 1
 duty limit (0 : duty limit applies, 1 : no duty limit)
u16   lo: 1
 Channel bandwidth (1 : 25 kHz, 0 : 200 kHz)
u16   band: 3
 Band.
u16 word
 word access
u8   ssr_ovf: 1
 SSR filter overflow.
u8   rfu: 6
 RFU.
u8   req_only: 1
 Consider only initial requests.
u8   rfu: 6
 RFU.
u8 start_id
 First non-received ID, before which all IDs are receive.
u8 end_id
 Last received ID.
u8 bitmap [32]
 Reception status bitmap.
u8   rxlev: 1
 Enable target RXLEV reporting When set, the target RXLEV is provided by the transmitting party in the DLL header.
u8   toggle: 1
 Toggle between min and max On a first failure or when the field is not set, the transmission power is set to the maximum authorized level.
u8   csma_err: 1
 Do not count TX CSMA-CA errors as ACK failures.
u8   duty_err: 1
 Do not count TX duty errors as ACK failures.
u8   opt: 1
 CCA not required flag.

Detailed Description

=======================================================================


Enumeration Type Documentation

enum d7a_area_t

DLL Area Enumerator.

Definition at line 606 of file d7a_1x_fs.h.

enum d7a_band_t

Enumerator of the PHY channel bands.

Enumerator:
D7A_BAND_000 

Universal Band 0.0 to 1684 MHz.

D7A_BAND_RFU_1 

RFU (band 315 MHz ?)

D7A_BAND_433 

Band 433.060 to 434.785 MHz.

D7A_BAND_868 

Band 863.000 to 870.000 MHz.

D7A_BAND_915 

Band 902.000 to 928.000 MHz.

D7A_BAND_RFU_5 

RFU.

D7A_BAND_2400 

Band 2400.000 to 2480.000 MHz.

D7A_BAND_UWB 

Band 3.1 to 10.6 GHz exclusively for UWB usage.

D7A_BAND_QTY 

Quantity.

Definition at line 395 of file d7a_1x_fs.h.

Enumerator of the Extended channel classes.

Enumerator:
D7A_CLASS_EXT_LORA 

LoRa modulation.

D7A_CLASS_EXT_RFU_1 

Reserved.

D7A_CLASS_EXT_UNB 

Sigfox / UNB modulation.

D7A_CLASS_EXT_UWB 

Decawave / UWB modulation (PHY 802.15.4a)

D7A_CLASS_EXT_QTY 

Quantity.

Definition at line 375 of file d7a_1x_fs.h.

Enumerator of the nominal PHY channel classes.

Enumerator:
D7A_CLASS_LO 

Lo-Rate, 9.6 kbps, 4.8 kHz deviation.

D7A_CLASS_RFU 

Reserved.

D7A_CLASS_NORMAL 

Normal-Rate, 55.555 kbps, 50 kHz deviation.

D7A_CLASS_HI 

Hi-Rate, 166.667 kbps, 41.667 kHz deviation.

D7A_CLASS_QTY 

Quantity.

Definition at line 355 of file d7a_1x_fs.h.

enum d7a_cond_t

D7A comparison conditions.

Enumerator:
D7A_COND_ANY 

<, =, > (always true)

D7A_COND_NE 

<, >

D7A_COND_EQ 

=

D7A_COND_LT 

<

D7A_COND_LTE 

<, =

D7A_COND_GT 

>

D7A_COND_GTE 

>, =

Definition at line 669 of file d7a_1x_fs.h.

enum d7a_cs_t

Enumerator of the PHY channel coding schemes.

Enumerator:
D7A_CS_0 

Nominal - PN9 encoding Extension LoRa - LoRaWAN mode 0 (BW = 125 KHz, SF = 12, FEC 4/5) Extension UNB - TBD Extension UWB - rate 110 kbps.

D7A_CS_1 

Nominal - 1/2 FEC + punc 1/4 + PN9 encoding Extension LoRa - LoRaWAN mode 1 (BW = 125 KHz, SF = 11, FEC 4/5) Extension UNB - TBD Extension UWB - rate 850 kbps.

D7A_CS_2 

Nominal - 1/2 FEC + PN9 encoding Extension LoRa - LoRaWAN mode 2 (BW = 125 KHz, SF = 10, FEC 4/5) Extension UNB - TBD Extension UWB - rate 6.8 Mbps.

D7A_CS_3 

Nominal - RFU Extension LoRa - LoRaWAN mode 3 (BW = 125 KHz, SF = 8, FEC 4/5) Extension UNB - TBD Extension UWB - TBD.

D7A_CS_QTY 

Quantity.

Definition at line 423 of file d7a_1x_fs.h.

======================================================================= =======================================================================

3. DEVICE CAPACITY

======================================================================= ======================================================================= Enumerator of the device types

Enumerator:
D7A_DEVICE_EP 

Endpoint.

D7A_DEVICE_SC 

Subcontroller.

D7A_DEVICE_GW 

Gateway.

D7A_DEVICE_QTY 

Quantity.

Definition at line 168 of file d7a_1x_fs.h.

======================================================================= =======================================================================

5. ENG

======================================================================= ======================================================================= Enumerator of the Engineering modes

Enumerator:
D7A_ENG_MODE_NORMAL 

Normal Mode param : not used.

D7A_ENG_MODE_SCP 

Spectrum Control Protocol flooding param[0] : access class param[1] : flooding duration in seconds (CTF)

D7A_ENG_MODE_BEACON 

Beacon Test Mode.

Discard duty and CSMA-CA param : not used

D7A_ENG_MODE_SENSITIVITY 

Sensitivity Test Mode.

Fixed NF/ECCAO sensotivity is set according to the parameters param[0] : Noise Floor / or ECCAO param[1] : param[0] is, when O = NF, when 1 = ECCAO

Definition at line 251 of file d7a_1x_fs.h.

enum d7a_ext_t

======================================================================= =======================================================================

8. PHY CONFIGURATION

======================================================================= ======================================================================= Enumerator of the PHY channel extensions

Enumerator:
D7A_EXT_FSK 

Nominal D7A channels (FSK modulation)

D7A_EXT_OTHER 

Other D7A channels.

Definition at line 341 of file d7a_1x_fs.h.

======================================================================= =======================================================================

10. DLL CONFIGURATION

======================================================================= ======================================================================= DLL Noise Floor Autoscaling

Enumerator:
D7A_NF_AUTO_NO 

No Autoscaling (default).

Always use the Noise Floor and Noise Floor Variance defined in the Access Profile

D7A_NF_AUTO_SLOW 

Slow RSSI Variation.

Noise Floor and Noise Floor variance are computed based on regular RSSI measurements with a forget factor defined by the associated parameter

Definition at line 587 of file d7a_1x_fs.h.

======================================================================= =======================================================================

12. NWL ROUTING

======================================================================= ======================================================================= NWL routing modes

Enumerator:
D7A_NWL_ROUTING_MODE_DEFAULT 

Default routing type.

D7A_NWL_ROUTING_MODE_QTY 

Qty.

Definition at line 819 of file d7a_1x_fs.h.


Variable Documentation

u16 band [inherited]

Band.

Definition at line 526 of file d7a_1x_fs.h.

u16 band [inherited]

Band.

Definition at line 526 of file d7a_1x_fs.h.

u8 bitmap[32] [inherited]

Reception status bitmap.

Definition at line 1054 of file d7a_1x_fs.h.

u8 bteq [inherited]

Btag acceptance condition (0 : differ, 1 : equal)

Definition at line 303 of file d7a_1x_fs.h.

u8 bteq [inherited]

Btag acceptance condition (0 : differ, 1 : equal)

Definition at line 303 of file d7a_1x_fs.h.

u8 byte [inherited]

byte access

Definition at line 309 of file d7a_1x_fs.h.

u8 csma_err [inherited]

Do not count TX CSMA-CA errors as ACK failures.

Definition at line 1136 of file d7a_1x_fs.h.

u8 csma_err [inherited]

Do not count TX CSMA-CA errors as ACK failures.

Definition at line 1136 of file d7a_1x_fs.h.

u16 duty [inherited]

duty limit (0 : duty limit applies, 1 : no duty limit)

Definition at line 522 of file d7a_1x_fs.h.

u16 duty [inherited]

duty limit (0 : duty limit applies, 1 : no duty limit)

Definition at line 522 of file d7a_1x_fs.h.

u8 duty_err [inherited]

Do not count TX duty errors as ACK failures.

Definition at line 1138 of file d7a_1x_fs.h.

u8 duty_err [inherited]

Do not count TX duty errors as ACK failures.

Definition at line 1138 of file d7a_1x_fs.h.

u8 en [inherited]

Declare myself using VID instead of UID.

Definition at line 305 of file d7a_1x_fs.h.

u8 en [inherited]

Declare myself using VID instead of UID.

Definition at line 305 of file d7a_1x_fs.h.

u8 end_id [inherited]

Last received ID.

Definition at line 1052 of file d7a_1x_fs.h.

u16 lo [inherited]

Channel bandwidth (1 : 25 kHz, 0 : 200 kHz)

Definition at line 524 of file d7a_1x_fs.h.

u16 lo [inherited]

Channel bandwidth (1 : 25 kHz, 0 : 200 kHz)

Definition at line 524 of file d7a_1x_fs.h.

u8 opt [inherited]

CCA not required flag.

Definition at line 1273 of file d7a_1x_fs.h.

u8 opt [inherited]

CCA not required flag.

Definition at line 1273 of file d7a_1x_fs.h.

u8 req_only [inherited]

Consider only initial requests.

Definition at line 948 of file d7a_1x_fs.h.

u8 req_only [inherited]

Consider only initial requests.

Definition at line 948 of file d7a_1x_fs.h.

u8 rfu [inherited]

RFU.

Definition at line 461 of file d7a_1x_fs.h.

u8 rfu [inherited]

RFU.

Definition at line 950 of file d7a_1x_fs.h.

u8 rfu [inherited]

RFU.

Definition at line 876 of file d7a_1x_fs.h.

u8 rfu [inherited]

RFU.

Definition at line 876 of file d7a_1x_fs.h.

u8 rfu [inherited]

RFU.

Definition at line 950 of file d7a_1x_fs.h.

u8 rfu [inherited]

RFU.

Definition at line 461 of file d7a_1x_fs.h.

u8 rxlev [inherited]

Enable target RXLEV reporting When set, the target RXLEV is provided by the transmitting party in the DLL header.

The target RXLEV is computed based on local noise floor, channel class and device sensitivity

Definition at line 1107 of file d7a_1x_fs.h.

u8 rxlev [inherited]

Enable target RXLEV reporting When set, the target RXLEV is provided by the transmitting party in the DLL header.

The target RXLEV is computed based on local noise floor, channel class and device sensitivity

Definition at line 1107 of file d7a_1x_fs.h.

u8 ssr_ovf [inherited]

SSR filter overflow.

Definition at line 874 of file d7a_1x_fs.h.

u8 ssr_ovf [inherited]

SSR filter overflow.

Definition at line 874 of file d7a_1x_fs.h.

u8 start_id [inherited]

First non-received ID, before which all IDs are receive.

Definition at line 1050 of file d7a_1x_fs.h.

u8 sub_nb [inherited]

When the widow type is sliding, number of sub-windows.

This parameter is used to manage properly the duty limit without having to record every unitary TX event. Instead the duty is always limited to (sub_nb-1)/sub_nb and the duty credit never exceeds 1/sub_nb of the maximum available duty over the window (sliding sub-window). The bigger is sub_nb, the closer the credited duty is to the duty limit, but the smaller is the immediate available credit. For regular transmission of small packets, sub_nb can be kept high (> 10). For rare transmissions of long packets, sub_nb shall be kept small (< 5).

Definition at line 473 of file d7a_1x_fs.h.

u8 sub_nb [inherited]

When the widow type is sliding, number of sub-windows.

This parameter is used to manage properly the duty limit without having to record every unitary TX event. Instead the duty is always limited to (sub_nb-1)/sub_nb and the duty credit never exceeds 1/sub_nb of the maximum available duty over the window (sliding sub-window). The bigger is sub_nb, the closer the credited duty is to the duty limit, but the smaller is the immediate available credit. For regular transmission of small packets, sub_nb can be kept high (> 10). For rare transmissions of long packets, sub_nb shall be kept small (< 5).

Definition at line 473 of file d7a_1x_fs.h.

u8 toggle [inherited]

Toggle between min and max On a first failure or when the field is not set, the transmission power is set to the maximum authorized level.

When the field is set, on a subsequent failure, the transmission power is toggled between the minimum possible level and the maximum authorized levels.

Definition at line 1114 of file d7a_1x_fs.h.

u8 toggle [inherited]

Toggle between min and max On a first failure or when the field is not set, the transmission power is set to the maximum authorized level.

When the field is set, on a subsequent failure, the transmission power is toggled between the minimum possible level and the maximum authorized levels.

Definition at line 1114 of file d7a_1x_fs.h.

u8 word [inherited]

word access

Definition at line 477 of file d7a_1x_fs.h.

u16 word [inherited]

word access

Definition at line 530 of file d7a_1x_fs.h.