Added support for channel mask at cmd

Author: felixgalindo

src/xbee_api_frames.h

@@ -210,6 +210,7 @@ typedef enum {
     XBEE_API_TYPE_LR_TX_REQUEST = 0x50,            ///< Frame for transmitting data in LoRaWAN
     XBEE_API_TYPE_LR_RX_PACKET = 0xD0,             ///< Frame for receiving data packets in LoRaWAN
     XBEE_API_TYPE_LR_EXPLICIT_RX_PACKET = 0xD1,    ///< Frame for receiving explicitly addressed packets in LoRaWAN
+    XBEE_API_TYPE_LR_EXPLICIT_TX_STATUS = 0xD2,    ///< Frame for explicit TX status in LoRaWAN
 
     /**< XBee 3 RF Specific API Frames */
     XBEE_API_TYPE_3RF_REMOTE_AT_COMMAND = 0x17,    ///< Frame for sending remote AT commands (XBee 3 RF)

src/xbee_at_cmds.c

@@ -153,6 +153,7 @@ const char* atCommandToString(at_command_t command) {
         case AT_XD: return "XD";            ///< LoRaWAN RX2 Data Rate
         case AT_XF: return "XF";            ///< LoRaWAN RX2 Frequency   
         case AT_PO: return "PO";            ///< LoRaWAN Transmit Power   
+        case AT_CM: return "CM";            ///< LoRaWAN Channels Mask
 
         default: return NULL;               ///< Unknown command
     }

src/xbee_at_cmds.h

@@ -156,6 +156,7 @@ typedef enum {
     AT_XD,   /**< LoRaWAN RX2 Data Rate */ 
     AT_XF,   /**< LoRaWAN RX2 Frequency */ 
     AT_PO,   /**< LoRaWAN Transmit Power */ 
+    AT_CM,   /**< LoRaWAN Channels Mask */
 
     // ... (other existing AT commands) ...
 

src/xbee_lr.c

@@ -657,6 +657,30 @@ bool XBeeLRGetDevEUI(XBee* self, uint8_t* responseBuffer, uint8_t buffer_size) {
     return true;  
 }
 
+
+/**
+ * @brief Sends the AT_CM command to set the LoRaWAN Channels Mask on the XBee LR module.
+ * 
+ * This function configures the Channels Mask for the LoRaWAN network on the XBee LR module by
+ * sending the AT_CM command. The Channels Mask specifies the sub-bands that are enabled for 
+ * communication. The function checks the command response to verify if the mask was successfully set.
+ * 
+ * @param[in] self Pointer to the XBee instance.
+ * @param[in] value Pointer to a null-terminated string representing the Channels Mask in hexadecimal format.
+ * 
+ * @return bool Returns true if the Channels Mask was successfully set; otherwise, false.
+ */
+bool XBeeLRSetChannelsMask(XBee* self, const char* value) {
+    uint8_t response[33];
+    uint8_t responseLength;
+    uint8_t paramLength = (value != NULL) ? strlen(value) : 0;
+    int status = apiSendAtCommandAndGetResponse(self, AT_CM, value, paramLength, response, &responseLength, 5000);
+    if(status != API_SEND_SUCCESS){
+        XBEEDebugPrintEnabled("Failed to set Channels Mask\n");
+    }
+    return status;
+}
+
 // XBeeLR private functions
 
 /**

src/xbee_lr.h

@@ -88,6 +88,7 @@ bool XBeeLRSetRX2Delay(XBee* self, const uint32_t value);
 bool XBeeLRSetRX2DataRate(XBee* self, const uint8_t value);
 bool XBeeLRSetRX2Frequency(XBee* self, const uint32_t value);
 bool XBeeLRSetTransmitPower(XBee* self, const uint8_t value);
+bool XBeeLRSetChannelsMask(XBee* self, const char* value);
 
 #if defined(__cplusplus)
 }