Example: Sending text to an XBee node through Remote Manager

The following example assumes the microcontroller attached to the XBee device is a computer.

You must install XCTU on your computer. If you do not have XCTU installed, go to www.digi.com/xctu to download and install XCTU.

To send a Hello, World! text to an XBee node on your network through Remote Manager:

  1. Attach the XBee node from your network to an XBIB device and connect it to your computer using a serial or USB cable. This is the node that will receive the serial data.

  2. Open XCTU and add the XBee node that is connected to your computer to the list of radio modules.

  3. Once XCTU has started and your XBee node is added to the list, select the node and click the Consoles working mode Consoles working mode icon tab. The Console log window appears and displays the XBee node’s serial console.

  4. Connect the console.

  5. From a web browser, log in to Remote Manager.

  6. Click Documentation and then click API Explorer. The API console appears.

  7. From the API console, select POST HTTP Method and write the following SCI request that includes the send_serial command. The send_serial command will be sent to the remote XBee node within the RCI do_command element, as follows:

    <sci_request version="1.0">
    <send_message>
        <targets>
            <device id="{device_id}"/>
       </targets>
      <rci_request version="1.1">
         <do_command target="xbgw">
             <send_serial addr="{xbee_mac}"
                        encoding="base64">SGVsbG8sIFdvcmxkIQ==
             </send_serial>
         </do_command>
     </rci_request>
  </send_message>
</sci_request>

    Where:

    • {device_id} is the ID of your XBee Gateway device.

      {xbee_mac} is the MAC address of the XBee node that you attached to your computer.

    For example:

    <sci_request version="1.0">
    <send_message>
        <targets>
            <device id="00000000-00000000-00409dff-ff5c3BBd"/>
       </targets>
      <rci_request version="1.1">
         <do_command target="xbgw">
             <send_serial addr="0013A2004031A8E1"
                        encoding="base64">SGVsbG8sIFdvcmxkIQ==
             </send_serial>
         </do_command>
     </rci_request>
  </send_message>
</sci_request>

    The content of the send_serial command is the text Hello, World! encoded in base64 as it is specified in the encoding attribute.

  8. Click Send.

  9. Verify in XCTU that the serial console for the XBee node that you added received the data. Depending on the operating mode (API or AT) of the XBee device, you will receive the data in one of the following modes:

    • AT mode: You will see the text Hello, World! in the console.

    • API mode: You will receive a Receive Packet API frame with the Hello World! text (HEX values of the ASCII characters) in the Received data field of the frame.