EFR32 RF射頻測試-RAILTEST
阿新 • • 發佈：2018-12-15
Silicon 提供了很多例程，這裡介紹怎樣生成和配置RAILTEST工程，我使用的官方開發板，所以有現成的例程，不需要做更改，但是我們的產品往往都是需要作一些修改的，以下內容將講述如何配置一個RAILTEST工程：
1、新建一個RAILTEST工程流程如下：
下面的比較重要，選擇開發板型號（沒有開發板的可以不選）和晶片型號（必須選擇），然後點選 “Finish”按鈕生成工程。
2、生工程後IDE會自動開啟配置檔案，選中Plugins項，配置輸出輸入裝置，如果你沒有使用Silicon提供的顯示屏，那麼需要將Application Graphics外掛前面的“√”去掉，我有顯示屏，所以√上，如圖：
3、如果的串列埠位置和預設的不一樣則需要更改位置，這裡的SERIAL使用USART3，注意需要把USART3的“Enabled”也打√，如圖：
4、配置完後儲存檔案，然後點選右上角的“Generate”生成程式碼；
5、生成的檔案如下圖，如果在步驟2中沒有選擇“Application Graphics”外掛的話可以將圖中框起來的幾個檔案刪除；
6、編譯後將程式碼下載到IC，連線串列埠到PC，使用串列埠助手檢視log，如下：
7、如果有顯示屏的話你可以看到下圖所示的介面：
8、沒有按鍵的話可以直接使用CLI操作，RAILTEST工程提供以下介面，在app_ci.h檔案可以找到：
#define APP_CI_COMMANDS \ COMMAND_SEPARATOR("Application Configuration"), \ COMMAND_ENTRY("setEventConfig", "ww", setEventConfig, "[mask events] Modify RAIL_ConfigEvents with the given mask and events"), \ COMMAND_ENTRY("printDataRates", "", printDataRates, "Print the data rates of the current PHY"), \ COMMAND_ENTRY("resetCounters", "", resetCounters, "Resets the Tx and Rx counters"), \ COMMAND_ENTRY("setPeripheralEnable", "u", setPeripheralEnable, "[enable] Enable(1) or Disable(0) LEDs and LCD peripherals"), \ COMMAND_ENTRY("setNotifications", "u", setNotifications, "[enable] Enable(1) or Disable(0) status prints that happen asynchronously (rxPacket, txEnd, txError)"), \ COMMAND_ENTRY("getLogLevels", "", getLogLevels, "Get whether notifications are set or peripherals are enabled"), \ COMMAND_ENTRY("getVersion", "", getVersion, "Get version information."), \ COMMAND_ENTRY("getVersionVerbose", "", getVersionVerbose, "Get verbose version information."), \ COMMAND_ENTRY("setPtiProtocol", "u", setPtiProtocol, "Get version information."), \ COMMAND_SEPARATOR("Receive and Transmit"), \ COMMAND_ENTRY("rx", "w", rx, "[enable] Enable(1) or Disable(0) receive mode"), \ COMMAND_ENTRY("rxAt", "wbwbu*", rxAt, "[start mode end mode rxTransEndSched hardEnd] Configure scheduled receive."), \ COMMAND_ENTRY("setRxOptions", "w", setRxOptions, "[rxOptionsBitField] Configure receive options, based on RAIL_RX_OPTION defines"), \ COMMAND_ENTRY("tx", "w", tx, "[n] Transmit n packets. If n is 0 transmit infinitely"), \ COMMAND_ENTRY("txWithOptions", "w", txWithOptions, "[n] Transmit n packets with tx options. If n is 0 transmit infinitely"), \ COMMAND_ENTRY("txAt", "wb*", txAtTime, "[time mode] Transmit a packet at the time and mode specified"), \ COMMAND_ENTRY("txAfterRx", "w", txAfterRx, "[time] Schedule a TX for a delay in us after each receive. 0 to disable"), \ COMMAND_ENTRY("configTxOptions", "u", configTxOptions, "[txOptionsBitfield] Sets the bitmask to be used as the tx options. See #defines starting with \"RAIL_TX_OPTION_\" in rail_types.h"), \ COMMAND_ENTRY("setFixedLength", "v", setFixedLength, "[fixedLength] Configure fixed length"), \ COMMAND_ENTRY("setchannel", "u", setChannel, "[channel] Set the current radio channel"), \ COMMAND_ENTRY("getchannel", "", getChannel, "Get the current radio channel"), \ COMMAND_ENTRY("setPower", "sb*", setPower, "[power raw] Set the current transmit power in deci dBm, or raw units if 'raw' is specified"), \ COMMAND_ENTRY("getPower", "", getPower, "Get the current transmit power in deci dBm"), \ COMMAND_ENTRY("sweepTxPower", "", sweepTxPower, "Sweep power levels for the current PA and stream at each level."), \ COMMAND_ENTRY("getRssi", "w*", getRssi, "[wait] Get RSSI in dBm if the receiver is turned on. Optionally specify whether or not to wait for a valid value in case it is initially invalid."), \ COMMAND_ENTRY("sweepPower", "ssw", sweepPower, "[lowPower] [hiPower] [period] Sweep power in square wave fashion. Specify power in deci dBm, period in microseconds."), \ COMMAND_ENTRY("startAvgRssi", "wu*", startAvgRssi, "[averageTimeUs] [channel] Start AGC RSSI averaging"), \ COMMAND_ENTRY("getAvgRssi", "", getAvgRssi, "Get AGC RSSI averaging result."), \ COMMAND_ENTRY("setRssiOffset", "s", setRssiOffset, "Sets the RSSI offset in dBm."), \ COMMAND_ENTRY("getRssiOffset", "", getRssiOffset, "Gets the RSSI offset."), \ COMMAND_ENTRY("setTxTone", "w", setTxTone, "[enable] Enable(1) or Disable(0) a tone from the radio"), \ COMMAND_ENTRY("setTxStream", "w", setTxStream, "[enable] Enable(1) or Disable(0) a PN9 stream from the radio"), \ COMMAND_ENTRY("status", "", getStatus, "Print the current status counters"), \ COMMAND_ENTRY("fifoStatus", "", fifoStatus, "Print the current fifo related counters"), \ COMMAND_ENTRY("setTxDelay", "w", setTxDelay, "[delay] Set the inter-packet delay in milliseconds for repeated Tx"), \ COMMAND_ENTRY("getTxDelay", "", getTxDelay, "Get the inter-packet delay in milliseconds for repeated Tx"), \ COMMAND_ENTRY("setTxPayload", "vu*", setTxPayload, "[offset byte0 byte1 ...] Set the packet bytes to be sent"), \ COMMAND_ENTRY("setTxPayloadQuiet", "vu*", setTxPayloadQuiet, "[offset byte0 byte1 ...] Functions like 'setTxPayload', but outputs less information"), \ COMMAND_ENTRY("setTxLength", "v", setTxLength, "[length] Set the number of bytes to load into the FIFO before transmitting. Actual packet length may vary based on radio configuration"), \ COMMAND_ENTRY("printTxPacket", "", printTxPacket, "Print the current Tx data and length"), \ COMMAND_ENTRY("peek", "v*", peekRx, "[number of bytes] [offset] Peek at the start of receive buffer."), \ COMMAND_ENTRY("getTime", "", getTime, "Get the current time from the RAIL timebase in microseconds"), \ COMMAND_ENTRY("setTime", "w", setTime, "Set the current time in the RAIL timebase in microseconds"), \ COMMAND_ENTRY("dataConfig", "bb", dataConfig, "[txMethod rxMethod] Choose between 'pkt' and 'fifo' data methods for RAIL Tx and Rx"), \ COMMAND_ENTRY("setRxFifo", "v", setRxFifo, "[length] Set the receive buffer's length, which is used in both packet mode and FIFO mode. The length cannot be set above RX_BUFFER_SIZE."), \ COMMAND_ENTRY("setTxFifoThreshold", "v", setTxFifoThreshold, "[txFifoThreshold] Set the Tx Fifo Almost Emtpy threshold"), \ COMMAND_ENTRY("setRxFifoThreshold", "v", setRxFifoThreshold, "[rxFifoThreshold] Set the Rx Fifo Almost Emtpy threshold"), \ COMMAND_ENTRY("fifoModeTestOptions", "bb", fifoModeTestOptions, "[txFifoManual rxFifoManual] Manual control over RAILTEST fifo actions"), \ COMMAND_ENTRY("rxFifoManualRead", "bvb*", rxFifoManualRead, "[appendedInfo bytesToRead printTiming] Read bytes out of receive fifo and print"), \ COMMAND_ENTRY("txFifoManualLoad", "", txFifoManualLoad, "Will attempt to load data into the fifo if there is space"), \ COMMAND_ENTRY("fifoReset", "bb", fifoReset, "[tx rx] Reset the transmit or receive fifo"), \ COMMAND_ENTRY("abortRxPacket", "w", abortRxPacket, "[abortOffset] Delay after sync word before idling radio."), \ COMMAND_ENTRY("printTxAcks", "w", printTxAcks, "[printTxAcks] Enable printing of tx ack packets as they happen."), \ COMMAND_SEPARATOR("Energy Modes and RF Sense"), \ COMMAND_ENTRY("sleep", "bw*", sleep, "[EM# [RfSenseUs RfBand]] Sleep in EM# with RFSenseUs on RfBand (0=none,1=2.4GHz,2=SubGHz,3=both) (and UART input)"), \ COMMAND_ENTRY("rfsense", "ww", rfSense, "[RfSenseUs RfBand] Start RfSensing with RSenseUs on RfBand"), \ COMMAND_SEPARATOR("Address Filtering"), \ COMMAND_ENTRY("configAddressFilter", "wu*", setAddressFilterConfig, "[matchTable offset0 size0 offset1 size1] Configure the addresss filter."), \ COMMAND_ENTRY("setAddressFiltering", "u", setAddressFilter, "[enable] Enable(1) or Disable(0) address filtering."), \ COMMAND_ENTRY("getAddressFiltering", "", getAddressFilter, "Print the current state of address filtering."), \ COMMAND_ENTRY("printAddresses", "", printAddresses, "Print the current address filtering addresses."), \ COMMAND_ENTRY("setAddress", "uuu*", setAddress, "[field index value...] Set the address value at (field, index) to value."), \ COMMAND_ENTRY("setAddressEnable", "uuu", enableAddress, "[field index enable] Enable address filtering for the given address."), \ COMMAND_SEPARATOR("Error Rate Testing"), \ COMMAND_ENTRY("perRx", "ww", startPerMode, "[packets delayUs] Start a Packet Error Rate test. 'perRx 0 0' will disable ongoing test."), \ COMMAND_ENTRY("perStatus", "", getPerStats, "Output the results of the PER test. Also see 'status' command"), \ COMMAND_ENTRY("setBerConfig", "w", berConfigSet, "[number bytes] Set number of bytes to receive in BER mode; 536870911 = max number of bytes to test; 0 = set max number of bytes to test"), \ COMMAND_ENTRY("berRx", "w", berRx, "[enable] Enable(1) or Disable(0) BER receive mode"), \ COMMAND_ENTRY("berStatus", "", berStatusGet, "Get status of last BER test or of current running test; status information is reset for commands setBerConfig and berRx enable"), \ COMMAND_SEPARATOR("Listen Before Talk (LBT)"), \ COMMAND_ENTRY("setLbtMode", "b*", setLbtMode, "[modeStr] Set LBT mode off, csma, lbt"), \ COMMAND_ENTRY("getLbtParams", "", getLbtParams, "Get the current LBT parameters"), \ COMMAND_ENTRY("setLbtParams", "uuusvvw", setLbtParams, "[minBo maxBo tries thresh backoff duration timeout] Set LBT parameters"), \ COMMAND_SEPARATOR("802.15.4 Mode"), \ COMMAND_ENTRY("enable802154", "bvvv", ieee802154Enable, "[defaultState idleTime turnaroundTime ackTimeout] Enable 802.15.4 mode"), \ COMMAND_ENTRY("config2p4GHz802154", "", config2p4Ghz802154, "Configure the radio for 2.4 GHz 802.15.4. This should be called in addition to 'enable802154'."), \ COMMAND_ENTRY("config863MHz802154", "", config863Mhz802154, "Configure the radio for 863 MHz 802.15.4 GB868. This should be called in addition to 'enable802154'."), \ COMMAND_ENTRY("config915MHz802154", "", config915Mhz802154, "Configure the radio for 915 MHz 802.15.4 GB868. This should be called in addition to 'enable802154'."), \ COMMAND_ENTRY("acceptFrames", "uuuu", ieee802154AcceptFrames, "[command ack data beacon] Enable(1) or Disable(0) 802.15.4 frame acceptance. Default settings for 802.15.4 are 1 0 1 1."), \ COMMAND_ENTRY("setPromiscuousMode", "u", ieee802154SetPromiscuousMode, "[enable] Enable(1) or Disable(0) promiscuous mode"), \ COMMAND_ENTRY("setPanCoordinator", "u", ieee802154SetPanCoordinator, "[enable] Enable(1) or Disable(0) the node acting as a PAN coordinator"), \ COMMAND_ENTRY("setPanId802154", "vu*", ieee802154SetPanId, "[panId index] Set the PAN ID for the given index. Index defaults to 0 if not given"), \ COMMAND_ENTRY("setShortAddr802154", "vu*", ieee802154SetShortAddress, "[shortAddr index] Set the short address(es) for the given index. Index defaults to 0 if not given"), \ COMMAND_ENTRY("setLongAddr802154", "uuuuuuuuu*", ieee802154SetLongAddress, "[longAddr_0 ... longAddr_7 index] Set the long address for the given index. Index defaults to 0 if not given"), \ COMMAND_ENTRY("setAddresses802154", "vvb*", ieee802154SetAddresses, "[panId0 shortAddr0 longAddr0 panId1 ... ] Set all 802.15.4 address information."), \ COMMAND_SEPARATOR("BLE Mode"), \ COMMAND_ENTRY("setBleMode", "u", bleEnable, "[enable] Set BLE mode to enabled or disabled"), \ COMMAND_ENTRY("getBleMode", "", bleStatus, "Get the current BLE mode"), \ COMMAND_ENTRY("setBleChannelParams", "uw*", bleSetChannelParams, "[logicalChannel accessAddr crcInit disableWhiten] Configure channel parameters related to BLE"), \ COMMAND_ENTRY("setBleAdvertising", "u", bleAdvertisingConfig, "[advChannel] Configure for BLE advertising on channel 37, 38, or 39"), \ COMMAND_ENTRY("setBle1Mbps", "u*", bleSet1MbpsPhy, "[isViterbi] Switch to the 1Mbps BLE PHY"), \ COMMAND_ENTRY("setBle2Mbps", "u*", bleSet2MbpsPhy, "[isViterbi] Switch to the 2Mbps BLE PHY"), \ COMMAND_ENTRY("setBleCoding", "u", bleSetCoding, "[coding] Switch to the given RAIL_BLE_Coding_t value"), \ COMMAND_SEPARATOR("RAIL Timer"), \ COMMAND_ENTRY("setTimer", "wb", setTimer, "[timeout mode] Set the RAIL timer timeout. You can use either an absolute (abs) or relative (rel) timer mode."), \ COMMAND_ENTRY("timerCancel", "", timerCancel, "Cancel the RAIL timer if it's active."), \ COMMAND_ENTRY("printTimerStats", "", printTimerStats, "Print current timer configuration."), \ COMMAND_SEPARATOR("Auto Acking"), \ COMMAND_ENTRY("autoAckConfig", "bvvv", autoAckConfig, "[defaultState idleTime turnaroundTime ackTimeout] Configure and enable auto ack functionality in RAIL. "), \ COMMAND_ENTRY("autoAckDisable", "", autoAckDisable, "Disable auto ack. Use autoAckConfig to reenable."), \ COMMAND_ENTRY("setAckPayload", "vu*", setAckPayload, "[offset byte0 byte1 ...] Set the ack bytes to be sent."), \ COMMAND_ENTRY("setAckLength", "v", setAckLength, "[length] Set the number of bytes to transmit for ack payloads"), \ COMMAND_ENTRY("printAckPacket", "", printAckPacket, "Print the current ack data and length"), \ COMMAND_ENTRY("getAutoAck", "", getAutoAck, "Print the current state of auto acking."), \ COMMAND_ENTRY("autoAckPause", "uu", autoAckPause, "[RxPause TxPause] Pause(1) or Resume(0) Auto Acking"), \ COMMAND_ENTRY("setTxAckOptions", "uu", setTxAckOptions, "[cancelAck useTxBuf] Enable(1) or Disable(0) feature for one receive"), \ COMMAND_SEPARATOR("Diagnostic and Test"), \ COMMAND_ENTRY("getmemw", "ww*", getMemWord, "[address count] Read count 32bit words starting at address"), \ COMMAND_ENTRY("setmemw", "ww*", setMemWord, "[address value...] Write as many 32bit values as specified starting at address"), \ COMMAND_ENTRY("setCtune", "v", setCtune, "[ctune] Set the value of CTUNE in the CMU->HFXOSTEADYSTATECTRL register"), \ COMMAND_ENTRY("getCtune", "", getCtune, "Get the value of CTUNE in the CMU->HFXOSTEADYSTATECTRL register"), \ COMMAND_ENTRY("setPaCtune", "uu", setPaCtune, "[txPaCtune] [rxPaCtune] Set the value of PACTUNE for TX and RX mode"), \ COMMAND_ENTRY("enablePaCal", "u", enablePaCal, "[enable] Enable(1) or Disable(0) PA power calibration"), \ COMMAND_ENTRY("setDebugSignal", "?", setDebugSignal, "Configure chip specific debug output. Use 'setDebugSignal help' for more details."), \ COMMAND_ENTRY("setDebugMode", "w", setDebugMode, "[mode] 1 = Frequency Override. 0 = Disable debug mode"), \ COMMAND_ENTRY("freqOverride", "w", setFrequency, "[freq] Change to freq specified in Hz. Requires debug mode to be enabled. Only small frequency deviations from the current configuration are supported."), \ COMMAND_ENTRY("directMode", "u", setDirectMode, "[enable] Enable(1) or Disable(0) direct mode"), \ COMMAND_ENTRY("directTx", "u", setDirectTx, "[enable] Enable(1) or Disable(0) TX in direct mode"), \ COMMAND_ENTRY("txCancel", "s", txCancel, "[delay] Set the time in microseconds after which we should cancel a tx (a negative value disables this)"), \ COMMAND_ENTRY("getRandom", "vu*", getRandom, "[len hidden] Get len bytes of random data from the radio. Only print them to the screen if hidden is 0 (default)."), \ COMMAND_ENTRY("setTxUnderflow", "w", setTxUnderflow, "[enable] Enable(1) or Disable(0) TX underflows"), \ COMMAND_ENTRY("setRxOverflow", "w*", setRxOverflow, "[enable delayUs] Enable(1) or Disable(0) RX overflows. The overflow will be caused by hanging in the interrupt handler for delayUs"), \ COMMAND_ENTRY("setCalibrations", "w", setCalibrations, "[enable] Enable(1) or Disable(0) RAIL calibrations"), \ COMMAND_ENTRY("setTxTransitions", "bb", setTxTransitions, "[txSuccess txError] Set each RAIL TX state transition value to r(x) or i(dle)"), \ COMMAND_ENTRY("setRxTransitions", "bb", setRxTransitions, "[rxSuccess rxError] Set each RAIL RX state transition value to t(x), r(x), or i(dle)."), \ COMMAND_ENTRY("setTimings", "vvvv*", setTimings, "[idleToRx txToRx idleToTx rxToTx rxSearch txToRxSearch] Set RAIL state transition timings in microseconds"), \ COMMAND_ENTRY("forceAssert", "w", forceAssert, "[errorCode] Force a RAIL assert with the given error code."), \ COMMAND_ENTRY("printEvents", "w", configPrintEvents, "[printEvents] Enable printing of RAIL events in chronological order."), \ COMMAND_ENTRY("getAppMode", "", getAppMode, "Print the current app mode of RAILTEST. Values printed are those to be found in AppMode_t."), \ COMMAND_ENTRY("getRadioState", "", getRadioState, "Get the RAIL radio state. Values returned correspond to RAIL_RadioState_t."), \ COMMAND_ENTRY("verifyRadio", "wuuu", verifyRadio, "[durationUs restart override callback] Verify radio memory contents and return after duration in microseconds. Restart (1) or resume (0) from last run."), \ COMMAND_ENTRY("reset", "", resetChip, "Perform a reboot of the chip")
9、更多內容請檢視官方文件《an972-efr32-rf-eval-guide》和《an971-efr32-radio-configurator-guide》。