NXP / Mbed 2 deprecated mcr20_connectivity_test

The MCR20A Connectivity Test application is an SMAC based demo application which provides the user with means to test basic transmission-reception functionalities along with several advanced testing features based on the ASP and SMAC APIs.

Dependencies:   fsl_phy_mcr20a fsl_smac mbed-rtos mbed

Fork of mcr20_connectivity_test by Freescale

Modes of Operation

The MCR20A Connectivity Test application has five main features:

Continuous Tests

This menu option displays several test suites

  • IDLE: This option sets the transceiver and all the state machines to idle.
  • Burst PRBS Transmission using packet mode: This option continuously sends packets which contain a pseudo-random payload of fixed length.
  • Continuous Modulated Transmission: This option allows the user to select between modulating 1’s, 0’s, or a pseudo-random sequence (PN) and sending them OTA continuously (in continuous mode).
  • Continuous Unmodulated Transmission: This option allows the user to send an unmodulated signal OTA having the frequency equal to the central frequency of the currently selected channel.
  • Continuous Reception: This test places the transceiver in reception and dumps the payload bytes of the received packets to the TERM in ASCII-converted hexadecimal characters.
  • Continuous Energy Detect: This option launches consecutive energy detect requests at fixed hard-coded intervals for the current channel, and prints their values to the TERM.
  • Continuous Scan: This option is similar to the previous one, except that at each iteration it obtains the energy values on all channels.
  • Continuous CCA: This option launches consecutive CCA requests for the currently selected channel at a fixed. hard-coded interval, and prints “Idle” or “Busy” depending on the CCA result.

Packet Error Rate

This menu option displays a configuration menu for testing the packet error rate. The menu displayed also depends on the ‘r’ or ‘t’ shortcut key. If ‘r’ is pressed, the following menu is for PER RX, otherwise it is for PER TX. For example, if two MCR20A platforms have Connectivity Test loaded, one of the boards can be set in RX and the other in TX as in the following figures.

Range Test

This test displays a configuration menu that performs a ‘ping-pong’ test to aid the user in determining the range (as distance between two platforms) in which the MCR20A platform can function properly. The sub-menu also depends on the ‘r’ and ‘t’ shortcuts so that one of the platforms can be the initializer (first to start a TX) and the other can respond to requests. The test is started and stopped only by user intervention and during its execution it will display the signal strength for each received packet. At the end of the test, the platform configured as the initializer (TX) displays a summary of how many packets were lost and what was the average RSSI.

Radio Registers Edit

This menu allows the user to read-write transceiver registers and to dump all address-value pairs from the transceiver registers to the TERM. The described features are accessible through the entries of this menu. For each access request (read or write) to a certain register, the register address is validated partially, and it is the responsibility of the user to access an existing register. For example, if the last accessible register is at 0xFD, the application only validates that the address is in the unsigned char range, but the user has the possibility to request register 0xFF. To ensure that a proper range is used, the user should first use the dump register feature to see the valid address ranges.

Carrier Sense and Transmission Control

This menu allows the user to choose between two tests. The former is the Carrier Sense test, which performs ED continuously until the ED value is above the CCA threshold (configured using ‘k’ and ‘l’ shortcuts) and then transmits a packet which contains pseudo-random data with the payload size configured using ‘n’ and ‘m’ shortcuts. The latter is the Transmission Control test, which displays a selection menu for number of packets identical with the one in PER TX test, then prompts the user to enter a decimal value resembling the inter-packet delay in milliseconds. After that, the application starts sending the selected number of packets with the selected inter-packet delay, using pseudo-random data for the payload with the size configured with ‘n’ and ‘m’ shortcuts.

Keys Usage

The following keys have the effect described below:

  • ‘t’ : Brings up the configuration menu for the transmitter in both PER and Range tests.
  • ‘r’ : Brings up the configuration menu for the receiver in both PER and Range tests.
  • ‘q’ : Increments channel number. If pressed when the current channel is 26, the channel number changes to 11.
  • ‘w’ : Decrements channel number. If pressed when the current channel is 11, the channel number will change to 26.
  • ‘a’ : Increments output power value. If output power is at maximum and this key is pressed, the output power goes to the minimum (in this case 0x03).
  • ‘s’ : Decrements output power value. If output power is at minimum and this key is pressed, the output power goes to the maximum (in this case 0x1F). These are not directly mapped to dBm values. Instead the output power value is written to the appropriate register. The user should consult the reference manual to determine the relationship between selected value and power in dBm.
  • ‘n’ : Increments the length of the payload. This value is used in both PER TX test to build-up the payload and in Transmission Control test for the same reason.
  • ‘m’ : Decrements the length of the payload. Incrementation and decrementation are performed in the [17, 116] interval. All overflows at one end lead to setting the other end’s value.
  • ‘k’ : Increments the CCA threshold for the Carrier Sense test. In this test the CCA before TX algorithm is implemented at application level, and the channel idle threshold is established using this parameter.
  • ‘l’ : Decrements the CCA threshold for the Carrier Sense test.

Documentation

SMAC Demo Applications User Guide

Diff: Source/Application_Interface.h

Revision:
0:4eb2240dbd22
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Source/Application_Interface.h	Thu Jul 16 07:29:15 2015 +0000
@@ -0,0 +1,209 @@
+/*!
+* Copyright (c) 2015, Freescale Semiconductor, Inc.
+* All rights reserved.
+*
+* \file Application_Interface.h
+*
+* Redistribution and use in source and binary forms, with or without modification,
+* are permitted provided that the following conditions are met:
+*
+* o Redistributions of source code must retain the above copyright notice, this list
+*   of conditions and the following disclaimer.
+*
+* o Redistributions in binary form must reproduce the above copyright notice, this
+*   list of conditions and the following disclaimer in the documentation and/or
+*   other materials provided with the distribution.
+*
+* o Neither the name of Freescale Semiconductor, Inc. nor the names of its
+*   contributors may be used to endorse or promote products derived from this
+*   software without specific prior written permission.
+*
+* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
+* ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+* ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+*/
+
+#ifndef __SMAC_APPLICATION_CONF_H__
+#define __SMAC_APPLICATION_CONF_H__
+
+#include "MemManager.h"
+#include "ConnectivityMenus.h"      /*Defines the Application menus*/
+
+#include "SMAC_Interface.h"         /*@CMA Conn Test*/
+#include "FunctionLib.h"
+#include "AspInterface.h"
+#ifdef gPHY_802_15_4g_d
+#include "PhyTime.h"
+#endif
+
+#include "mbed.h"
+#include "rtos.h"
+
+
+
+/* BEGIN Configuration Parameters Definition */ 
+typedef enum ConnectivityStates_tag
+{
+  gConnInitState_c,
+  gConnIdleState_c,
+  gConnSelectTest_c,
+  gConnContinuousTxRxState_c,
+  gConnPerState_c,
+  gConnRangeState_c,
+  gConnRegEditState_c,
+  gConnSetChannelState_c,
+  gConnSetPowerState_c,
+  gConnSetTxTestState_c,
+  gConnSetRxTestState_c,
+  gConnSetTrimCoarseState_c,
+  gConnSetTrimFineState_c,
+  gConnContinuousTxState_c,
+  gConnPerTxState_c,
+  gConnRangeTxState_c,
+  gConnContinuousRxState_c,
+  gConnPerRxState_c,
+  gConnRangeRxState_c,
+  gConnBitrateSelectState_c,
+  gConnCSenseAndTCtrl_c,
+  gConnEDMeasCalib_c,
+  gConnMaxState_c
+}ConnectivityStates_t;
+
+
+typedef enum ContinuousTxRxTestStates_tag 
+{
+  gCTxRxStateInit_c,
+  gCTxRxStateIdle_c,
+  gCTxRxStateSelectTest_c,
+  gCTxRxStateRunnigEdTest_c,
+  gCTxRxStateRunningEdTestGotResult_c,
+  gCTxRxStateRunningPRBS9Test_c,
+  gCTxRxStateRunnigScanTest_c,
+  gCTxRxStateRunnigRxTest_c,
+  gCTxRxStateRunningTXModSelectOpt,  
+  gCTxRxStateRunnigCcaTest_c,
+  gCTxRxMaxState_c
+}ContinuousTxRxTestStates_t;
+
+typedef enum PerTxStates_tag 
+{
+  gPerTxStateInit_c = 0,
+  gPerTxStateIdle_c,
+  gPerTxStateSelectPacketNum_c,
+  gPerTxStateInputPacketDelay_c,
+  gPerTxStateStartTest_c,
+  gPerTxStateRunningTest_c,
+  gPerTxStateSendingLastFrames_c,
+  gPerTxStateMaxState_c
+}PerTxStates_t;
+
+typedef enum PerRxStates_tag 
+{
+  gPerRxStateInit_c = 0,
+  gPerRxStateIdle_c,
+  gPerRxWaitStartTest_c,
+  gPerRxStateStartTest_c,
+  gPerRxStateRunningTest_c,
+  gPerRxStateReceivingLastFrames_c,
+  gPerrxStateMaxState_c
+}PerRxStates_t;
+
+typedef enum RangeTxStates_tag 
+{
+  gRangeTxStateInit_c = 0,
+  gRangeTxStateIdle_c,
+  gRangeTxWaitStartTest_c,
+  gRangeTxStateStartTest_c,
+  gRangeTxStateRunningTest_c,
+  gRangeTxStatePrintTestResults_c,
+  gRangeTxStateMaxState_c
+}RangeTxStates_t;
+
+typedef enum RangeRxStates_tag 
+{
+  gRangeRxStateInit_c = 0,
+  gRangeRxStateIdle_c,
+  gRangeRxWaitStartTest_c,
+  gRangeRxStateStartTest_c,
+  gRangeRxStateRunningTest_c,
+  gRangeRxStatePrintTestResults_c,
+  gRangeRxStateMaxState_c
+}RangeRxStates_t;
+
+typedef enum CSenseTCtrlStates_tag
+{
+  gCsTcStateInit_c = 0,
+  gCsTcStateSelectTest_c,
+  gCsTcStateCarrierSenseStart_c,
+  gCsTcStateCarrierSenseSelectType_c,
+  gCsTcStateCarrierSensePerformingTest_c,
+  gCsTcStateCarrierSenseEndTest_c,
+  gCsTcStateTransmissionControlStart_c,
+  gCsTcStateTransmissionControlSelectNumOfPackets_c,
+  gCsTcStateTransmissionControlSelectInterpacketDelay_c,
+  gCsTcStateTransmissionControlPerformingTest_c,
+  gCsTcStateTransmissionControlEndTest_c,
+  gCsTcStateMaxState_c
+}CSenseTCtrlStates_t;
+
+typedef enum overrideRegistersStates_tag 
+{
+  gORStateInit_c = 0,
+  gORStateStart_c,
+  gORWaitForTheAddress_c,
+  gORWaitForTheValue_c,  
+  gORStateIdle_c,
+  gORStateMaxState_c
+}oRStates_t;
+
+typedef enum readRegistersStates_tag
+{
+  gRRStateInit_c = 0,
+  gRRStateStart_c,
+  gRRWaitForTheAddress_c,
+  gRRStateMaxState_c
+}rRStates_t;
+
+typedef enum EditRegsStates_tag 
+{
+  gERStateInit_c = 0,
+  gERWaitSelection_c,
+  gERStateOverrideReg_c,
+  gERStateReadReg_c,
+  gERStateDumpAllRegs_c,
+  gERStateOverrideRadioSpiReg_c,
+  gERStateReadRadioSpiReg_c,
+  gERStateMaxState_c
+}EditRegsStates_t;
+
+typedef enum dumpRegistersStates_t
+{
+  gDRStateInit_c = 0,
+  gDRStateDumpRegs_c
+}dRStates_t;
+/* END Configuration Parameters Definition */
+
+#define gDefaultOperationMode_c         mTxOperation_c
+#define gDefaultPayload_c               20
+#define mTotalFinalFrames_c             25
+
+#ifdef gPHY_802_15_4g_d
+ #define gMaxChannel_c                   ((channels_t)(gTotalChannels - 1))
+ #define gMinChannel_c                   (gChannel0_c)
+#else
+ #define gMaxChannel_c                   ((channels_t)gTotalChannels)
+ #define gMinChannel_c                   (gChannel11_c)
+#endif
+
+extern smacErrors_t smacToAppMlmeSap(smacToAppMlmeMessage_t* pMsg, instanceId_t instance);
+extern smacErrors_t smacToAppMcpsSap(smacToAppDataMessage_t* pMsg, instanceId_t instance);
+extern void InitApp();
+
+#endif /* __SMAC_APP_CONFIG_H__ */