![]() |
SX126x-Arduino
1.3.0
|
Implementation according to LoRaWAN Specification v1.0.2. More...
Functions | |
PhyParam_t | RegionKR920GetPhyParam (GetPhyParams_t *getPhy) |
The function gets a value of a specific phy attribute. More... | |
void | RegionKR920SetBandTxDone (SetBandTxDoneParams_t *txDone) |
Updates the last TX done parameters of the current channel. More... | |
void | RegionKR920InitDefaults (InitType_t type) |
Initializes the channels masks and the channels. More... | |
bool | RegionKR920Verify (VerifyParams_t *verify, PhyAttribute_t phyAttribute) |
Verifies a parameter. More... | |
void | RegionKR920ApplyCFList (ApplyCFListParams_t *applyCFList) |
The function parses the input buffer and sets up the channels of the CF list. More... | |
bool | RegionKR920ChanMaskSet (ChanMaskSetParams_t *chanMaskSet) |
Sets a channels mask. More... | |
bool | RegionKR920AdrNext (AdrNextParams_t *adrNext, int8_t *drOut, int8_t *txPowOut, uint32_t *adrAckCounter) |
Calculates the next datarate to set, when ADR is on or off. More... | |
void | RegionKR920ComputeRxWindowParameters (int8_t datarate, uint8_t minRxSymbols, uint32_t rxError, RxConfigParams_t *rxConfigParams) |
bool | RegionKR920RxConfig (RxConfigParams_t *rxConfig, int8_t *datarate) |
Configuration of the RX windows. More... | |
bool | RegionKR920TxConfig (TxConfigParams_t *txConfig, int8_t *txPower, TimerTime_t *txTimeOnAir) |
TX configuration. More... | |
uint8_t | RegionKR920LinkAdrReq (LinkAdrReqParams_t *linkAdrReq, int8_t *drOut, int8_t *txPowOut, uint8_t *nbRepOut, uint8_t *nbBytesParsed) |
The function processes a Link ADR Request. More... | |
uint8_t | RegionKR920RxParamSetupReq (RxParamSetupReqParams_t *rxParamSetupReq) |
The function processes a RX Parameter Setup Request. More... | |
uint8_t | RegionKR920NewChannelReq (NewChannelReqParams_t *newChannelReq) |
The function processes a Channel Request. More... | |
int8_t | RegionKR920TxParamSetupReq (TxParamSetupReqParams_t *txParamSetupReq) |
The function processes a TX ParamSetup Request. More... | |
uint8_t | RegionKR920DlChannelReq (DlChannelReqParams_t *dlChannelReq) |
The function processes a DlChannel Request. More... | |
int8_t | RegionKR920AlternateDr (AlternateDrParams_t *alternateDr) |
Alternates the datarate of the channel for the join request. More... | |
void | RegionKR920CalcBackOff (CalcBackOffParams_t *calcBackOff) |
Calculates the back-off time. More... | |
bool | RegionKR920NextChannel (NextChanParams_t *nextChanParams, uint8_t *channel, TimerTime_t *time, TimerTime_t *aggregatedTimeOff) |
Searches and set the next random available channel. More... | |
LoRaMacStatus_t | RegionKR920ChannelAdd (ChannelAddParams_t *channelAdd) |
Adds a channel. More... | |
bool | RegionKR920ChannelsRemove (ChannelRemoveParams_t *channelRemove) |
Removes a channel. More... | |
void | RegionKR920SetContinuousWave (ContinuousWaveParams_t *continuousWave) |
Sets the radio into continuous wave mode. More... | |
uint8_t | RegionKR920ApplyDrOffset (uint8_t downlinkDwellTime, int8_t dr, int8_t drOffset) |
Computes new datarate according to the given offset. More... | |
Variables | |
static const uint8_t | DataratesKR920 [] = {12, 11, 10, 9, 8, 7} |
static const uint32_t | BandwidthsKR920 [] = {125000, 125000, 125000, 125000, 125000, 125000} |
static const uint8_t | MaxPayloadOfDatarateKR920 [] = {51, 51, 51, 115, 242, 242} |
static const uint8_t | MaxPayloadOfDatarateRepeaterKR920 [] = {51, 51, 51, 115, 222, 222} |
Implementation according to LoRaWAN Specification v1.0.2.
#define KR920_MAX_NB_CHANNELS 16 |
LoRaMac maximum number of channels
#define KR920_NUMB_DEFAULT_CHANNELS 7 |
Number of default channels
#define KR920_NUMB_CHANNELS_CF_LIST 5 |
Number of channels to apply for the CF list
#define KR920_TX_MIN_DATARATE DR_0 |
Minimal datarate that can be used by the node
#define KR920_TX_MAX_DATARATE DR_5 |
Maximal datarate that can be used by the node
#define KR920_RX_MIN_DATARATE DR_0 |
Minimal datarate that can be used by the node
#define KR920_RX_MAX_DATARATE DR_5 |
Maximal datarate that can be used by the node
#define KR920_DEFAULT_DATARATE DR_0 |
Default datarate used by the node
#define KR920_MIN_RX1_DR_OFFSET 0 |
Minimal Rx1 receive datarate offset
#define KR920_MAX_RX1_DR_OFFSET 5 |
Maximal Rx1 receive datarate offset
#define KR920_DEFAULT_RX1_DR_OFFSET 0 |
Default Rx1 receive datarate offset
#define KR920_MIN_TX_POWER TX_POWER_7 |
Minimal Tx output power that can be used by the node
#define KR920_MAX_TX_POWER TX_POWER_0 |
Maximal Tx output power that can be used by the node
#define KR920_DEFAULT_TX_POWER TX_POWER_0 |
Default Tx output power used by the node
#define KR920_DEFAULT_MAX_EIRP_LOW 10.0f |
Default Max EIRP for frequency 920.9 MHz - 921.9 MHz
#define KR920_DEFAULT_MAX_EIRP_HIGH 14.0f |
Default Max EIRP for frequency 922.1 MHz - 923.3 MHz
#define KR920_DEFAULT_ANTENNA_GAIN 2.15f |
Default antenna gain
#define KR920_ADR_ACK_LIMIT 64 |
ADR Ack limit
#define KR920_ADR_ACK_DELAY 32 |
ADR Ack delay
#define KR920_DUTY_CYCLE_ENABLED 0 |
Enabled or disabled the duty cycle
#define KR920_MAX_RX_WINDOW 4000 |
Maximum RX window duration
#define KR920_RECEIVE_DELAY1 1000 |
Receive delay 1
#define KR920_RECEIVE_DELAY2 2000 |
Receive delay 2
#define KR920_JOIN_ACCEPT_DELAY1 5000 |
Join accept delay 1
#define KR920_JOIN_ACCEPT_DELAY2 6000 |
Join accept delay 2
#define KR920_MAX_FCNT_GAP 16384 |
Maximum frame counter gap
#define KR920_ACKTIMEOUT 2000 |
Ack timeout
#define KR920_ACK_TIMEOUT_RND 1000 |
Random ack timeout limits
#define KR920_RX_WND_2_FREQ 921900000 |
Second reception window channel frequency definition.
#define KR920_RX_WND_2_DR DR_0 |
Second reception window channel datarate definition.
#define KR920_MAX_NB_BANDS 1 |
Maximum number of bands
#define KR920_BAND0 |
Band 0 definition { DutyCycle, TxMaxPower, LastTxDoneTime, TimeOff }
#define KR920_LC1 |
#define KR920_LC2 |
#define KR920_LC3 |
LoRaMac channels which are allowed for the join procedure
#define KR920_RSSI_FREE_TH -65 |
RSSI threshold for a free channel [dBm]
#define KR920_CARRIER_SENSE_TIME 6 |
Specifies the time the node performs a carrier sense
PhyParam_t RegionKR920GetPhyParam | ( | GetPhyParams_t * | getPhy | ) |
The function gets a value of a specific phy attribute.
getPhy | Pointer to the function parameters. |
Returns | a structure containing the PHY parameter. |
void RegionKR920SetBandTxDone | ( | SetBandTxDoneParams_t * | txDone | ) |
Updates the last TX done parameters of the current channel.
txDone | Pointer to the function parameters. |
void RegionKR920InitDefaults | ( | InitType_t | type | ) |
Initializes the channels masks and the channels.
type | Sets the initialization type. |
bool RegionKR920Verify | ( | VerifyParams_t * | verify, |
PhyAttribute_t | phyAttribute | ||
) |
Verifies a parameter.
verify | Pointer to the function parameters. |
phyAttribute | Sets the initialization type. |
Returns | true, if the parameter is valid. |
void RegionKR920ApplyCFList | ( | ApplyCFListParams_t * | applyCFList | ) |
The function parses the input buffer and sets up the channels of the CF list.
applyCFList | Pointer to the function parameters. |
bool RegionKR920ChanMaskSet | ( | ChanMaskSetParams_t * | chanMaskSet | ) |
Sets a channels mask.
chanMaskSet | Pointer to the function parameters. |
Returns | true, if the channels mask could be set. |
bool RegionKR920AdrNext | ( | AdrNextParams_t * | adrNext, |
int8_t * | drOut, | ||
int8_t * | txPowOut, | ||
uint32_t * | adrAckCounter | ||
) |
Calculates the next datarate to set, when ADR is on or off.
adrNext | Pointer to the function parameters. |
drOut | The calculated datarate for the next TX. |
txPowOut | The TX power for the next TX. |
adrAckCounter | The calculated ADR acknowledgement counter. |
Returns | true, if an ADR request should be performed. |
void RegionKR920ComputeRxWindowParameters | ( | int8_t | datarate, |
uint8_t | minRxSymbols, | ||
uint32_t | rxError, | ||
RxConfigParams_t * | rxConfigParams | ||
) |
Computes the Rx window timeout and offset.
datarate | Rx window datarate index to be used |
minRxSymbols | Minimum required number of symbols to detect an Rx frame. |
rxError | System maximum timing error of the receiver. In milliseconds The receiver will turn on in a [-rxError : +rxError] ms interval around RxOffset |
rxConfigParams | Returns updated WindowTimeout and WindowOffset fields. |
bool RegionKR920RxConfig | ( | RxConfigParams_t * | rxConfig, |
int8_t * | datarate | ||
) |
Configuration of the RX windows.
rxConfig | Pointer to the function parameters. |
datarate | The datarate index which was set. |
Returns | true, if the configuration was applied successfully. |
bool RegionKR920TxConfig | ( | TxConfigParams_t * | txConfig, |
int8_t * | txPower, | ||
TimerTime_t * | txTimeOnAir | ||
) |
TX configuration.
txConfig | Pointer to the function parameters. |
txPower | The tx power index which was set. |
txTimeOnAir | The time-on-air of the frame. |
Returns | true, if the configuration was applied successfully. |
uint8_t RegionKR920LinkAdrReq | ( | LinkAdrReqParams_t * | linkAdrReq, |
int8_t * | drOut, | ||
int8_t * | txPowOut, | ||
uint8_t * | nbRepOut, | ||
uint8_t * | nbBytesParsed | ||
) |
The function processes a Link ADR Request.
linkAdrReq | Pointer to the function parameters. |
drOut | Data rate. |
txPowOut | TX power. |
nbRepOut | Number of repeats. |
nbBytesParsed | Number of parsed bytes. |
Returns | the status of the operation, according to the LoRaMAC specification. |
uint8_t RegionKR920RxParamSetupReq | ( | RxParamSetupReqParams_t * | rxParamSetupReq | ) |
The function processes a RX Parameter Setup Request.
rxParamSetupReq | Pointer to the function parameters. |
Returns | the status of the operation, according to the LoRaMAC specification. |
uint8_t RegionKR920NewChannelReq | ( | NewChannelReqParams_t * | newChannelReq | ) |
The function processes a Channel Request.
newChannelReq | Pointer to the function parameters. |
Returns | the status of the operation, according to the LoRaMAC specification. |
int8_t RegionKR920TxParamSetupReq | ( | TxParamSetupReqParams_t * | txParamSetupReq | ) |
The function processes a TX ParamSetup Request.
txParamSetupReq | Pointer to the function parameters. |
Returns | the status of the operation, according to the LoRaMAC specification. Returns -1, if the functionality is not implemented. In this case, the end node shall not process the command. |
uint8_t RegionKR920DlChannelReq | ( | DlChannelReqParams_t * | dlChannelReq | ) |
The function processes a DlChannel Request.
dlChannelReq | Pointer to the function parameters. |
Returns | the status of the operation, according to the LoRaMAC specification. |
int8_t RegionKR920AlternateDr | ( | AlternateDrParams_t * | alternateDr | ) |
Alternates the datarate of the channel for the join request.
alternateDr | Pointer to the function parameters. |
Datarate | to apply. |
void RegionKR920CalcBackOff | ( | CalcBackOffParams_t * | calcBackOff | ) |
Calculates the back-off time.
calcBackOff | Pointer to the function parameters. |
bool RegionKR920NextChannel | ( | NextChanParams_t * | nextChanParams, |
uint8_t * | channel, | ||
TimerTime_t * | time, | ||
TimerTime_t * | aggregatedTimeOff | ||
) |
Searches and set the next random available channel.
nextChanParams | Parameters of next channel to use for TX. |
channel | Next channel to use for TX. |
time | Time to wait for the next transmission according to the duty cycle. |
aggregatedTimeOff | Updates the aggregated time off. |
Function | status [1: OK, 0: Unable to find a channel on the current datarate] |
LoRaMacStatus_t RegionKR920ChannelAdd | ( | ChannelAddParams_t * | channelAdd | ) |
Adds a channel.
channelAdd | Pointer to the function parameters. |
Status | of the operation. |
bool RegionKR920ChannelsRemove | ( | ChannelRemoveParams_t * | channelRemove | ) |
Removes a channel.
channelRemove | Pointer to the function parameters. |
Returns | true, if the channel was removed successfully. |
void RegionKR920SetContinuousWave | ( | ContinuousWaveParams_t * | continuousWave | ) |
Sets the radio into continuous wave mode.
continuousWave | Pointer to the function parameters. |
uint8_t RegionKR920ApplyDrOffset | ( | uint8_t | downlinkDwellTime, |
int8_t | dr, | ||
int8_t | drOffset | ||
) |
Computes new datarate according to the given offset.
downlinkDwellTime | Downlink dwell time configuration. 0: No limit, 1: 400ms |
dr | Current datarate |
drOffset | Offset to be applied |
newDr | Computed datarate. |
|
static |
Data rates table definition
|
static |
Bandwidths table definition in Hz
|
static |
Maximum payload with respect to the datarate index. Can operate with and without a repeater.
|
static |
Maximum payload with respect to the datarate index. Can operate with repeater.