This file contains the type definitions for SIxx3xx chip-specific aspects of RAIL.

License#

Copyright 2024 Silicon Laboratories Inc. www.silabs.com

SPDX-License-Identifier: Zlib

The licensor of this software is Silicon Laboratories Inc.

This software is provided 'as-is', without any express or implied warranty. In no event will the authors be held liable for any damages arising from the use of this software.

Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions:

  1. The origin of this software must not be misrepresented; you must not claim that you wrote the original software. If you use this software in a product, an acknowledgment in the product documentation would be appreciated but is not required.

  2. Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software.

  3. This notice may not be removed or altered from any source distribution.

Modules#

RAIL_ChannelConfigEntryAttr

Macros#

#define
__RAIL_CHIP_SPECIFIC_H_

SLI_LIBRARY_BUILD.

#define
RAIL_ENUM (name)

The RAIL library does not use enumerations because the ARM EABI leaves their size ambiguous, which causes problems if the application is built with different flags than the library.

#define
RAIL_ENUM_GENERIC (name, type)

This macro is a more generic version of the RAIL_ENUM() macro that allows the size of the type to be overridden instead of forcing the use of a uint8_t.

#define
RAIL_S3LPW_HANDLE RAIL_EFR32_HANDLE

Synonym of RAIL_EFR32_HANDLE for Series 3.

#define
TRANSITION_TIME_US 510

Time it takes to take care of protocol switching.

#define
RAIL_RF_PATHS_2P4GIG 0

Indicates the number of 2.4 GHz RF Paths suppported.

#define
RAIL_RF_PATHS_SUBGIG 0

Indicates the number of Sub-GHz RF Paths supported.

#define
RAIL_RF_PATHS (RAIL_RF_PATHS_SUBGIG + RAIL_RF_PATHS_2P4GIG)

Indicates the number of RF Paths supported.

#define
RADIO_CONFIG_ENABLE_IRCAL_MULTIPLE_RF_PATHS 0

Indicates this version of RAIL supports IR calibration on multiple RF paths Needed for backwards compatibility.

#define
RAIL_POWER_MODE_IS_ANY_DBM_POWERSETTING_MAPPING_TABLE (x)

The number of PA's on this chip (including Virtual PAs).

#define
RAIL_POWER_MODE_SUPPORTS_RAW_SETTING (x)

Convenience macro to check if the power mode supports raw setting.

#define
RAIL_CHANNEL_HOPPING_BUFFER_SIZE_PER_CHANNEL (54U)

The static amount of memory needed per channel for channel hopping, measured in 32 bit words, regardless of the size of radio configuration structures.

#define
RAIL_TIMER_SYNC_PRS_CHANNEL_DEFAULT (7U)

Default PRS channel to use when configuring sleep.

#define
RAIL_TIMER_SYNC_RTCC_CHANNEL_DEFAULT (0U)

Default RTCC channel to use when configuring sleep.

#define
RAIL_MINIMUM_TRANSITION_US (75U)

The minimum value for a consistent RAIL transition.

#define
RAIL_MAXIMUM_TRANSITION_US (1000000U)

The maximum value for a consistent RAIL transition.

Enumerations#

enum
RAIL_RAC_STATE_SIX3X_OFF = 0
RAIL_RAC_STATE_SIX3X_RXWARM = 1
RAIL_RAC_STATE_SIX3X_RXSEARCH = 2
RAIL_RAC_STATE_SIX3X_RXFRAME = 3
RAIL_RAC_STATE_SIX3X_RXWRAPUP = 4
RAIL_RAC_STATE_SIX3X_TXWARM = 5
RAIL_RAC_STATE_SIX3X_TX = 6
RAIL_RAC_STATE_SIX3X_TXWRAPUP = 7
RAIL_RAC_STATE_SIX3X_SHUTDOWN = 8
RAIL_RAC_STATE_SIX3X_POR = 9
RAIL_RAC_STATE_SIX3X_NONE
}

Detailed Series 3 Radio state machine states.

Typedefs#

Internal Radio State type mapping for SIxx3xx chips.

 

Enumeration Documentation#

RAIL_RadioStateSix3x_t#

RAIL_RadioStateSix3x_t

Detailed Series 3 Radio state machine states.

Enumerator
RAIL_RAC_STATE_SIX3X_OFF

Radio is off.

RAIL_RAC_STATE_SIX3X_RXWARM

Radio is enabling the receiver.

RAIL_RAC_STATE_SIX3X_RXSEARCH

Radio is listening for incoming frames.

RAIL_RAC_STATE_SIX3X_RXFRAME

Radio is receiving a frame.

RAIL_RAC_STATE_SIX3X_RXWRAPUP

Radio is wrapping up after receiving a frame.

RAIL_RAC_STATE_SIX3X_TXWARM

Radio is enabling transmitter.

RAIL_RAC_STATE_SIX3X_TX

Radio is transmitting data.

RAIL_RAC_STATE_SIX3X_TXWRAPUP

Radio is wrapping up after transmitting a frame.

RAIL_RAC_STATE_SIX3X_SHUTDOWN

Radio is powering down and going to OFF state.

RAIL_RAC_STATE_SIX3X_POR

Radio power-on-reset state.

RAIL_RAC_STATE_SIX3X_NONE

Invalid Radio state, must be the last entry.


Typedef Documentation#

RAIL_RacRadioState_t#

typedef RAIL_RadioStateSix3x_t RAIL_RacRadioState_t

Internal Radio State type mapping for SIxx3xx chips.