wayne roberts / Mbed OS utility_sx12xx

Text menu driven ANSI/VT100 console test utility for LoRa transceivers

radio chip selection

Radio chip driver is not included, allowing choice of radio device.
If you're using SX1272 or SX1276, then import sx127x driver into your program.
if you're using SX1261 or SX1262, then import sx126x driver into your program.
if you're using SX1280, then import sx1280 driver into your program.
if you're using LR1110, then import LR1110 driver into your program.
If you're using NAmote72 or Murata discovery, then you must import only sx127x driver.
If you're using Type1SJ select target DISCO_L072CZ_LRWAN1 and import sx126x driver into your program.

This is VT100 text-based menu driven test program for SX12xx transceiver devices.
Serial console is divided into horizontally into top half and bottom half.
The bottom half serves as scrolling area to log activity.
The top half serves as menu, to configure the radio.
For all devices, the serial console operates at 115200 8N1, and requires terminal with ANSI-VT100 capability, such as putty/teraterm/minicom etc.
Use program only with keyboard up/down/left/right keys. Enter to change an item, or number for value item. Some items are single bit, requiring only enter key to toggle. Others with fixed choices give a drop-down menu.

Diff: radio_sx128x.cpp

Revision:
2:ea9245bb1c53
Parent:
1:0817a150122b
Child:
3:56fc764dee0a
--- a/radio_sx128x.cpp	Mon Aug 20 18:13:09 2018 -0700
+++ b/radio_sx128x.cpp	Wed Aug 22 09:50:32 2018 -0700
@@ -58,12 +58,12 @@
     NULL
 };
 
-unsigned Radio::pktType_read_cb(bool fw)
+unsigned Radio::pktType_read(bool fw)
 {
     return radio.getPacketType();
 }
 
-menuMode_e Radio::pktType_write_cb(unsigned idx)
+menuMode_e Radio::pktType_write(unsigned idx)
 {
     radio.setPacketType(idx);
     return MENUMODE_REINIT_MENU;
@@ -81,7 +81,7 @@
     NULL
 };
 
-unsigned Radio::tx_ramp_read_cb(bool fw)
+unsigned Radio::tx_ramp_read(bool fw)
 {
     PaPwrCtrl_t PaPwrCtrl;
     PaPwrCtrl.octet = radio.readReg(REG_ADDR_PA_PWR_CTRL, 1);
@@ -100,7 +100,7 @@
     return PaPwrCtrl.bits.ramp_time;
 }
 
-menuMode_e Radio::tx_ramp_write_cb(unsigned val)
+menuMode_e Radio::tx_ramp_write(unsigned val)
 {
     switch (val) {
         case 0: tx_param_buf[1] = RADIO_RAMP_02_US; break;
@@ -173,7 +173,7 @@
     NULL
 };
 
-unsigned Radio::opmode_read_cb(bool forWriting)
+unsigned Radio::opmode_read(bool forWriting)
 {
     status_t status;
     status.octet = radio.xfer(OPCODE_GET_STATUS, 0, 0, NULL);
@@ -192,7 +192,7 @@
         return status.bits.chipMode;
 }
 
-menuMode_e Radio::opmode_write_cb(unsigned sel)
+menuMode_e Radio::opmode_write(unsigned sel)
 {
     switch (sel) {
         case 0: // SLEEP
@@ -516,12 +516,22 @@
         RadioEvents->TxDone_botHalf();
 }
 
+void Radio::cadDone(bool det)
+{
+    log_printf("cadDone ");
+    if (det)
+        pc.printf("CadDetected");
+
+    pc.printf("\r\n");
+}
+
 void Radio::boardInit(const RadioEvents_t* e)
 {
     hw_reset();
 
     radio.txDone = txDoneBottom;
     radio.rxDone = rxDone;
+    radio.cadDone = cadDone;
 
     radio.chipModeChange = chipModeChange;
 
@@ -537,11 +547,17 @@
 void Radio::tx_carrier()
 {
     radio.xfer(OPCODE_SET_TX_CARRIER, 0, 0, NULL);
+
+    radio.chipMode = CHIPMODE_TX;
+    chipModeChange();
 }
 
 void Radio::tx_preamble()
 {
     radio.xfer(OPCODE_SET_TX_PREAMBLE, 0, 0, NULL);
+
+    radio.chipMode = CHIPMODE_TX;
+    chipModeChange();
 }
 
 void Radio::txPkt()
@@ -575,7 +591,7 @@
 #define REGBW_0_6MHZ    2
 #define REGBW_0_3MHZ    3
 
-unsigned Radio::gfsk_flrc_bpsbw_read_cb(bool fw)
+unsigned Radio::gfsk_flrc_bpsbw_read(bool fw)
 {
     unsigned n = UINT_MAX;
     RegRxBw_t RegRxBw;
@@ -660,7 +676,7 @@
     return n;
 }
 
-menuMode_e Radio::gfsk_flrc_bpsbw_write_cb(unsigned sidx)
+menuMode_e Radio::gfsk_flrc_bpsbw_write(unsigned sidx)
 {
     pktType = radio.getPacketType();
 
@@ -716,7 +732,7 @@
     NULL
 };
 
-const dropdown_item_t Radio::gfsk_bitrate_item = { _ITEM_DROPDOWN, gfsk_bpsbw, gfsk_bpsbw, gfsk_flrc_bpsbw_read_cb, gfsk_flrc_bpsbw_write_cb};
+const dropdown_item_t Radio::gfsk_bitrate_item = { _ITEM_DROPDOWN, gfsk_bpsbw, gfsk_bpsbw, gfsk_flrc_bpsbw_read, gfsk_flrc_bpsbw_write};
 
 void Radio::modindex_print()
 {
@@ -779,21 +795,21 @@
     NULL
 };
 
-unsigned Radio::gfsk_flrc_bt_read_cb(bool fw)
+unsigned Radio::gfsk_flrc_bt_read(bool fw)
 {
     FskCfg_t FskCfg;
     FskCfg.octet = radio.readReg(REG_ADDR_FSK_CFG, 1);
     return FskCfg.bits.gf_bt;
 }
 
-menuMode_e Radio::gfsk_flrc_bt_write_cb(unsigned sidx)
+menuMode_e Radio::gfsk_flrc_bt_write(unsigned sidx)
 {
     mpBLE_GFSK.gfskBle.ModulationShaping = sidx << 4;
     radio.xfer(OPCODE_SET_MODULATION_PARAMS, 3, 0, mpBLE_GFSK.buf);
     return MENUMODE_REDRAW;
 }
 
-const dropdown_item_t Radio::gfsk_flrc_bt_item = { _ITEM_DROPDOWN, gfsk_flrc_bts, gfsk_flrc_bts, gfsk_flrc_bt_read_cb, gfsk_flrc_bt_write_cb };
+const dropdown_item_t Radio::gfsk_flrc_bt_item = { _ITEM_DROPDOWN, gfsk_flrc_bts, gfsk_flrc_bts, gfsk_flrc_bt_read, gfsk_flrc_bt_write};
 
 static const char* gfsk_flrc_pblLens[] = {
     "4",
@@ -807,7 +823,7 @@
     NULL,
 };
 
-unsigned Radio::gfsk_flrc_pl_read_cb(bool fw)
+unsigned Radio::gfsk_flrc_pl_read(bool fw)
 {
     PktCtrl1_t PktCtrl1;
     PktCtrl1.octet = radio.readReg(REG_ADDR_PKTCTRL1, 1);
@@ -816,7 +832,7 @@
     return PktCtrl1.gfsk.preamble_len;
 }
 
-menuMode_e Radio::gfsk_flrc_pl_write_cb(unsigned sidx)
+menuMode_e Radio::gfsk_flrc_pl_write(unsigned sidx)
 {
     ppFLRC.gfskFLRC.PreambleLength = sidx << 4;
     ppGFSK.gfskFLRC.PreambleLength = ppFLRC.gfskFLRC.PreambleLength;
@@ -824,7 +840,7 @@
     return MENUMODE_REDRAW;
 }
 
-const dropdown_item_t Radio::gfsk_flrc_preamble_item = { _ITEM_DROPDOWN, gfsk_flrc_pblLens, gfsk_flrc_pblLens, gfsk_flrc_pl_read_cb, gfsk_flrc_pl_write_cb };
+const dropdown_item_t Radio::gfsk_flrc_preamble_item = { _ITEM_DROPDOWN, gfsk_flrc_pblLens, gfsk_flrc_pblLens, gfsk_flrc_pl_read, gfsk_flrc_pl_write};
 
 static const char* gfsk_syncLens[] = {
     "1", // 0
@@ -835,7 +851,7 @@
     NULL,
 };
 
-unsigned Radio::gfsk_synclen_read_cb(bool fw)
+unsigned Radio::gfsk_synclen_read(bool fw)
 {
     PktCtrl1_t PktCtrl1;
     PktCtrl1.octet = radio.readReg(REG_ADDR_PKTCTRL1, 1);
@@ -846,7 +862,7 @@
     return PktCtrl1.gfsk.sync_adrs_len;
 }
 
-menuMode_e Radio::gfsk_synclen_write_cb(unsigned sidx)
+menuMode_e Radio::gfsk_synclen_write(unsigned sidx)
 {
     ppGFSK.gfskFLRC.SyncWordLength = sidx << 1;
     //log_printf("SWL %u %02x\r\n", sidx, ppGFSK.gfskFLRC.SyncWordLength);
@@ -855,7 +871,7 @@
     return MENUMODE_REDRAW;
 }
 
-const dropdown_item_t Radio::gfsk_synclen_item = { _ITEM_DROPDOWN, gfsk_syncLens, gfsk_syncLens, gfsk_synclen_read_cb, gfsk_synclen_write_cb };
+const dropdown_item_t Radio::gfsk_synclen_item = { _ITEM_DROPDOWN, gfsk_syncLens, gfsk_syncLens, gfsk_synclen_read, gfsk_synclen_write};
 
 bool Radio::gfsk_flrc_fixvar_read()
 {
@@ -903,7 +919,7 @@
     NULL,
 };
 
-unsigned Radio::gfsk_flrc_crclen_read_cb(bool fw)
+unsigned Radio::gfsk_flrc_crclen_read(bool fw)
 {
     PktBitStreamCtrl_t PktBitStreamCtrl;
     PktBitStreamCtrl.octet = radio.readReg(REG_ADDR_PKT_BITSTREAM_CTRL, 1);
@@ -911,7 +927,7 @@
     return PktBitStreamCtrl.bits.crc_mode;
 }
 
-menuMode_e Radio::gfsk_flrc_crclen_write_cb(unsigned sidx)
+menuMode_e Radio::gfsk_flrc_crclen_write(unsigned sidx)
 {
     pktType = radio.getPacketType();
 
@@ -926,7 +942,7 @@
     return MENUMODE_REDRAW;
 }
 
-const dropdown_item_t Radio::gfsk_flrc_crclen_item = { _ITEM_DROPDOWN, gfsk_flrc_crclens, gfsk_flrc_crclens, gfsk_flrc_crclen_read_cb, gfsk_flrc_crclen_write_cb };
+const dropdown_item_t Radio::gfsk_flrc_crclen_item = { _ITEM_DROPDOWN, gfsk_flrc_crclens, gfsk_flrc_crclens, gfsk_flrc_crclen_read, gfsk_flrc_crclen_write};
 
 bool Radio::gfsk_flrc_whit_read()
 {
@@ -1195,7 +1211,7 @@
     NULL
 };
 
-const dropdown_item_t Radio::flrc_bitrate_item = { _ITEM_DROPDOWN, flrc_bpsbw, flrc_bpsbw, gfsk_flrc_bpsbw_read_cb, gfsk_flrc_bpsbw_write_cb};
+const dropdown_item_t Radio::flrc_bitrate_item = { _ITEM_DROPDOWN, flrc_bpsbw, flrc_bpsbw, gfsk_flrc_bpsbw_read, gfsk_flrc_bpsbw_write};
 
 static const char* flrc_crs[] = {
     "1/2",
@@ -1203,7 +1219,7 @@
     "1  ",
     NULL
 };
-unsigned Radio::flrc_cr_read_cb(bool fw)
+unsigned Radio::flrc_cr_read(bool fw)
 {
     PktBitStreamCtrl_t PktBitStreamCtrl;
     PktBitStreamCtrl.octet = radio.readReg(REG_ADDR_PKT_BITSTREAM_CTRL, 1);
@@ -1213,14 +1229,14 @@
     return PktBitStreamCtrl.bits.flora_coding_rate;
 }
 
-menuMode_e Radio::flrc_cr_write_cb(unsigned sidx)
+menuMode_e Radio::flrc_cr_write(unsigned sidx)
 {
     mpFLRC.flrc.CodingRate = sidx << 1;
     radio.xfer(OPCODE_SET_MODULATION_PARAMS, 3, 0, mpFLRC.buf);
     return MENUMODE_REDRAW;
 }
 
-const dropdown_item_t Radio::flrc_cr_item = { _ITEM_DROPDOWN, flrc_crs, flrc_crs, flrc_cr_read_cb, flrc_cr_write_cb };
+const dropdown_item_t Radio::flrc_cr_item = { _ITEM_DROPDOWN, flrc_crs, flrc_crs, flrc_cr_read, flrc_cr_write};
 
 static const char* flrc_syncLens[] = {
     "SYNC OFF  ",
@@ -1229,7 +1245,7 @@
     NULL
 };
 
-unsigned Radio::flrc_synclen_read_cb(bool fw)
+unsigned Radio::flrc_synclen_read(bool fw)
 {
     PktCtrl1_t PktCtrl1;
     PktCtrl1.octet = radio.readReg(REG_ADDR_PKTCTRL1, 1);
@@ -1242,14 +1258,14 @@
     return PktCtrl1.flrc.sync_adrs_len;
 }
 
-menuMode_e Radio::flrc_synclen_write_cb(unsigned sidx)
+menuMode_e Radio::flrc_synclen_write(unsigned sidx)
 {
     ppFLRC.gfskFLRC.SyncWordLength = sidx << 1;
     radio.xfer(OPCODE_SET_PACKET_PARAMS, 7, 0, ppFLRC.buf);
     return MENUMODE_REDRAW;
 }
 
-const dropdown_item_t Radio::flrc_synclen_item = { _ITEM_DROPDOWN, flrc_syncLens, flrc_syncLens, flrc_synclen_read_cb, flrc_synclen_write_cb };
+const dropdown_item_t Radio::flrc_synclen_item = { _ITEM_DROPDOWN, flrc_syncLens, flrc_syncLens, flrc_synclen_read, flrc_synclen_write};
 
 
 const menu_t Radio::flrc_menu[] = {
@@ -1341,7 +1357,7 @@
     NULL
 };
 
-unsigned Radio::lora_cr_read_cb(bool fw)
+unsigned Radio::lora_cr_read(bool fw)
 {
     LoRaPktPar1_t LoRaPktPar1;
     LoRaPktPar1.octet = radio.readReg(REG_ADDR_LORA_PKTPAR1, 1);
@@ -1349,14 +1365,14 @@
     return LoRaPktPar1.bits.coding_rate;
 }
 
-menuMode_e Radio::lora_cr_write_cb(unsigned sidx)
+menuMode_e Radio::lora_cr_write(unsigned sidx)
 {
     mpLORA.lora.codingRate = sidx;
     radio.xfer(OPCODE_SET_MODULATION_PARAMS, 3, 0, mpLORA.buf);
     return MENUMODE_REDRAW;
 }
 
-const dropdown_item_t Radio::lora_cr_item = { _ITEM_DROPDOWN, lora_crs, lora_crs, lora_cr_read_cb, lora_cr_write_cb};
+const dropdown_item_t Radio::lora_cr_item = { _ITEM_DROPDOWN, lora_crs, lora_crs, lora_cr_read, lora_cr_write};
 
 void Radio::lora_pblLen_print()
 {
@@ -1462,6 +1478,37 @@
     lora_iqinv_read, lora_iqinv_push
 };
 
+void Radio::cad_push()
+{
+    radio.setCAD();
+}
+
+const button_item_t Radio::lora_cad_item = { _ITEM_BUTTON, "CAD", cad_push };
+
+static const char* lora_cadsymbs[] = {
+    " 1",
+    " 2",
+    " 4",
+    " 8",
+    "16",
+    NULL
+};
+
+unsigned Radio::lora_cadsymbs_read(bool forWriting)
+{
+    unsigned n = radio.readReg(REG_ADDR_LORA_FE_GAIN, 1);
+    return n >> 5;
+}
+
+menuMode_e Radio::lora_cadsymbs_write(unsigned sidx)
+{
+    uint8_t buf = sidx << 5;
+    radio.xfer(OPCODE_SET_CAD_PARAM, 1, 0, &buf);
+    return MENUMODE_REDRAW;
+}
+
+const dropdown_item_t Radio::lora_cadsymbs_item = { _ITEM_DROPDOWN, lora_cadsymbs, lora_cadsymbs, lora_cadsymbs_read, lora_cadsymbs_write};
+
 const menu_t Radio::lora_menu[] = {
     { {FIRST_CHIP_MENU_ROW  ,  1},              NULL,      &lora_bw_item, FLAG_MSGTYPE_ALL },
     { {FIRST_CHIP_MENU_ROW  , 12},             "sf:",      &lora_sf_item, FLAG_MSGTYPE_ALL },
@@ -1470,6 +1517,10 @@
     { {FIRST_CHIP_MENU_ROW+1,  1},              NULL,  &lora_fixlen_item, FLAG_MSGTYPE_ALL },
     { {FIRST_CHIP_MENU_ROW+1, 12},              NULL,   &lora_crcon_item, FLAG_MSGTYPE_ALL },
     { {FIRST_CHIP_MENU_ROW+1, 25},              NULL,   &lora_iqinv_item, FLAG_MSGTYPE_ALL },
+
+    { {FIRST_CHIP_MENU_ROW+2,  1},          NULL,        &lora_cad_item, FLAG_MSGTYPE_ALL },
+    { {FIRST_CHIP_MENU_ROW+2,  5},    "symbols:",   &lora_cadsymbs_item, FLAG_MSGTYPE_ALL },
+
     { {0, 0}, NULL, NULL }
 };
 
@@ -1497,7 +1548,6 @@
 bool Radio::service(int8_t statusRow)
 {
     static pktStatus_t prevPktStatus;
-    //static uint8_t foo;
     static IrqFlags_t prevIrqFlags;
     IrqFlags_t irqFlags;
     bool ret = false;
@@ -1522,14 +1572,12 @@
                 slen = 6;
 
             radio.xfer(OPCODE_GET_PACKET_STATUS, 0, slen, pktStatus.buf);
-            cmp = memcmp(prevPktStatus.buf, pktStatus.buf, sizeof(pktStatus_t));
+            cmp = memcmp(prevPktStatus.buf, pktStatus.buf, slen);
         }
 
         if (irqFlags.word != prevIrqFlags.word || cmp) {
             pc.printf("\e[%u;1f", statusRow);  // set (force) cursor to row;column
 
-            //pc.printf("%u ", foo++);
-            //
             if (cmp) {
                 if (pktType == PACKET_TYPE_FLRC || pktType == PACKET_TYPE_BLE || pktType == PACKET_TYPE_GFSK) {
                     if (pktStatus.ble_gfsk_flrc.errors.SyncError)