Activating and Editing the BLE Scan Plugin

The RUCKUS IoT Controller provides support for the Bluetooth Low Energy (BLE) BLE Scan Plugin . The RUCKUS IoT Controller reads the packet from the IoT AP and routes the packets to the BLE beacon vendor cloud services.

To establish a connection to a vendor infrastructure, the administrator must perform the following steps.

  1. From the main menu, click Admin.
  2. In the left navigation pane, click Plugins.
  3. In the Select a Plugin to Activate list, select the BLE Scan plugin and click Activate.
  4. After the BLE Scan plugin is activated, select either the HTTP or MQTT protocol option.

    Activating the BLE Scan Plugin

    If the HTTP option is selected, configure the following parameters.
    1. For Aggregation Interval, set the time interval between the two packets.
    2. Enter the Key.

      The RUCKUS IoT Controller posts the beacon messages using the Key provided. The Vendor application is responsible for authenticating the Keys.

    3. Enter the API URL.

      The RUCKUS IoT Controller connects to the vendor/connector URL to send the beacon messages. The URL can be a DNS-resolvable, FQDN-based address.

      Note: The plugin supports HTTP and HTTPS modes.

    4. Enter the Port number.

      This is the port number on which the vendor/connector web server is running.

    5. Enter the API Endpoint.

      This is the API route where the BLE beacon vendor cloud services receive the beacon payload.

    6. Enter the UUID Filter.
      The filter allows only the BLE ADV packets with the specified UUID to be passed on to the vendor application.
    7. Enable heartbeat.
      Enabling heartbeat allows the vendor application to receive the IoT AP status, such as online or offline.
    If the MQTT option is selected, configure the following parameters.

    Activating and Editing BLE Scan Plugin

    Activating and Editing BLE Scan Plugin
    1. Status, displays the connection status.
    2. For MQTT Broker IP, enter the IP address or hostname of the broker.
      This is a mandatory field.
    3. For MQTT Broker Port, enter the port number.
      This is a mandatory field.
    4. For MQTT Publish Topic, topic where messages from this device/system will be published.
      This is a mandatory field.
    5. For MQTT Username, enter the username for authenticating with the MQTT Broker.
    6. For MQTT Password, enter the password for authenticating with the MQTT Broker.
      Note: By default the password is hidden, click Show to view the password.
    7. For UUID Filter, enter the required UUID filter.
      The filter allows only the BLE ADV packets with the specified UUID to be passed on to the vendor application.
    8. For Enable heartbeat, toggle to enable periodic heartbeat messages, useful for monitoring connection health.
      Enabling heartbeat allows the vendor application to receive the IoT AP status, such as online or offline.
  5. Click Apply.
    The BLE Scan plugin is added in the Active Plugin List.
  6. (Optional) To delete the BLE Scan plugin, select it and click Delete.

    Deleting the BLE Scan Plugin

    Deleting the BLE Scan Plugin
  7. (Optional) To edit the configuration of the BLE Scan plugin, select it and click Update.

    Updating the HTTP Configuration Parameters

    Updating the MQTT Configuration Parameters