Introduction
This guide is specifically designed for the setup and configuration of Aruba Access Points (APs) managed in Aruba Central running ArubaOS 10.x or higher for integration with the Blyott platform.
Prerequisites:
-
Aruba Central administrator access.
-
APs running ArubaOS 10.x or higher.
-
Blyott tenant code and access token (please contact helpdesk@blyott.com).
-
AWS Trusted Root CA certificate installed (see step 4).
-
Firewall/Router Requirements:
-
TCP/UDP 123 → NTP server access (e.g.
pool.ntp.org
). -
TCP 443 → HTTPS access to:
-
https://api.blyott.com
-
https://portal.blyott.com
-
https://firmware.blyott.com
-
or
https://*.blyott.com
-
-
TCP 8883 → MQTT over TLS to:
-
tcp://aroncdz10y0su-ats.iot.eu-west-1.amazonaws.com:8883
-
-
Step 1: Add a New Group
Groups allow you to manage configuration for multiple APs at once.
-
In Global → Organization → Network Structure → Groups, click the ➕ icon.
-
Enter a descriptive group name (e.g.,
Blyott_AOS10
). -
Select Access Points only to avoid mixing device types.
-
Click Next to continue.
Tip: Use a naming convention that reflects the project or customer site for easier management later.
Step 2: Define Group Architecture
Choosing the correct architecture ensures Aruba Central applies the right configuration options.
-
Set Architecture to ArubaOS 10.
-
Set Role to Campus/Branch.
-
Click Add to confirm.
-
Verify that your group appears in the list.
Warning: Selecting the wrong architecture may hide or disable certain AOS10-specific options needed for BLE and IoT.
Step 3: Assign Devices to the Group
Your APs must be in the correct group for the settings to apply.
-
Go to Devices and locate unassigned APs.
-
Select the device(s) to move.
-
Click Group Assignment.
-
Choose your AOS10 group.
-
Click Move.
Step 4: Manage Certificates
Blyott connections require a trusted CA certificate from AWS. Without it, the AP will reject the secure connection.
Install AWS Root CA:
-
Download the AWS Root CA certificate in DER format from https://www.amazontrust.com/repository/
-
In Aruba Central, go to Organization → Certificates.
-
Click ➕ Add and fill in:
-
Name: Amazon Root CA 1
-
Type: CA Certificate
-
Format: DER
-
File: Select your downloaded certificate file.
-
-
Click Add to upload.
Assign the Certificate:
-
Go to Global → Network Structure → [Your Group] → Devices → Config → Security.
-
Under Certificate Usage, scroll to IoT CA.
-
Select the uploaded certificate.
-
Click Save Settings.
Step 5: Add IoT Connector
The IoT connector defines where and how your BLE scan data is sent.
-
In Aruba Central, go to Applications → IoT Operations.
-
Click Add Connector.
-
Select the connection type as Telemetry-WebSocket.
-
Enter the Blyott connection details.
-
Save.
Step 6: Install the Blyott App
The Blyott application in Aruba Central allows APs to recognize and handle Blyott tag data.
-
In Aruba Central, navigate to the App Marketplace.
-
Find Blyott Devices.
-
Click Install.
Step 7: Create Transport Profile for Blyott
The transport profile is the link between your AP’s BLE scans and Blyott’s servers.
-
Go to Applications → IoT Operations → Manage Transport Profiles → IoT Transport
-
Click + Add Transport.
-
Fill in:
-
Name: Blyott
-
Stream Type: Data Frames
-
Subscription: Device Class = Blyott
-
Protocol Type: WSS
-
URL:
wss://proxylocator.blyott.com/aruba10/{TENANTCODE}
-
Format: protobuf
-
Authentication: Token
-
Token: (Provided by Blyott)
-
-
Click Create and assign to your AP group.
Important: Replace
{TENANTCODE}
with your actual Blyott tenant code exactly as given — it is case-sensitive.
Step 8: Configure BLE on Access Points
Your Aruba APs must have BLE scanning enabled to detect Blyott tags. This process activates the AP’s internal Bluetooth radio and determines how it listens for advertisements.
Steps to Enable BLE Scanning:
-
In Devices → Config → IoT, locate BLE Radio Settings.
-
Set Radio Mode to Internal, BLE.
-
Set BLE Operation Mode to Scanning.
-
Adjust Tx Power according to your coverage needs (default is usually sufficient for indoor tracking).
-
Click Save changes.
Optional – Apply Company ID Filtering
You can limit BLE data collection to only devices broadcasting with Blyott’s assigned Company Identifier. This reduces network traffic and processing overhead while improving tag detection accuracy.
-
In the same BLE settings screen, find the Filter by Company ID option.
-
Enable Custom Filtering.
-
Enter
09CD
as the Company ID. -
Save and apply changes.
Tip: Filtering ensures your APs ignore unrelated BLE devices such as smartwatches, fitness trackers, or other beacons from neighboring systems.
Step 9: Add AP as Locator in Blyott Portal
You can also refer to our how to guide - How to add a locator
-
Log in to the Blyott Portal.
-
Go to Locators.
-
Click + New Locator.
-
Enter:
-
Locator Name
-
Hardware Model: Aruba | BLE-enabled
-
ID (MAC): Ethernet MAC (uppercase, no colons)
-
Fixed Location: Select from predefined locations
-
-
Save.
Note: Always use the Ethernet MAC — using the Bluetooth MAC will prevent the locator from working.
Step 10: Post-Deployment Checks & Configuration Verification
After completing the configuration, perform these checks to ensure your Aruba APs are successfully detecting Blyott tags and communicating with the Blyott cloud.
Quick Checklist
-
BLE Tag Detection:
Runshow ap debug ble-table generic
— confirm tags with Company ID09CD
are detected, with Last Updatetimes within a few seconds. -
IoT Transport Connection:
Runshow ap debug ble-relay iot-profile
— confirm Server Connection State = "Connection Established". -
Blyott Dashboard Status:
Verify each locator’s Last Seen value is ≤ 5 minutes. -
Certificate Health:
Ensure AWS Trusted Root CA is still valid. -
After Firmware Updates:
Re-check BLE scanning mode, IoT profile, and Company ID filter settings.
Support Note: If any check fails or you’re unsure about the output, email helpdesk@blyott.com with the relevant CLI outputs. Our team will assist in reviewing the logs and guiding you through following actions.
10.1. Aruba Instant Locator Status in Blyott Dashboard
To verify that the applied configuration is working correctly, check the Locator Status in the Blyott dashboard.
The Last Seen field should show 5 minutes or less.
1. Verify BLE Tag Detection on the AP
From the AP CLI, run:
show ap debug ble-table generic
Example Output:
---------------------------
MAC Address Type RSSI Last Update Device Class Generic Filter BT-SIG Company IDs
--- ------------ ---- ----------- ------------ -------------- ------------------
60:c0:bf:60:de:0b Public -77 I:5s blyott -- 0x09CD
60:c0:bf:61:0e:bf Public -43 I:3s blyott -- 0x09CD
Generic BLE devices:2
Total BLE devices:2
Notes:
Last Update is in seconds since the last packet was received.
0x09CD
is the Blyott Company Identifier.
If no Blyott devices appear:
-
Ensure tags are powered on and within AP range.
-
Verify IoT radio is enabled with the correct settings.
-
Ensure Device Class =
Blyott
is set in IoT Transport. -
Confirm AWS Trusted Root CA is installed (see Step 4).
2. Verify IoT Transport Connection to Blyott Cloud
Run:
show ap debug ble-relay iot-profile
show ap debug ble-relay report
Look for:
Server Connection State: Connection Established
If not established, run:
show ap debug ble-relay ws-log <profile>
to check WebSocket logs and send them to helpdesk@blyott.com to review.
3. Check Message Processing
If connected but data is not flowing:
show ap debug ble-relay tag-report
Confirm that counters for Incoming Tag messages and Tag messages processed are increasing, and that Tag messages dropped remain very low (ideally <0.5%).
10.2. Common Causes of Connection Errors
-
Missing or incorrect Trusted Certificate Chain for the remote IoT server.
-
Incorrect authentication credentials (token, username/password).
-
DNS resolution issues.
-
Firewall or network device blocking communication.
Note: In ArubaOS 10, IoT server connections are established even when no BLE devices are currently detected.
11. Additional Aruba Information
11.1 API Integration (AOS 10.x)
-
Aruba provides a robust REST API for ArubaOS, supporting automation and third-party integrations.
-
ArubaOS 10.x API Developer Guide – available in the Aruba Developer Hub.
-
Aruba Developer Hub – https://developer.arubanetworks.com.
-
11.2 Aruba Support Portal
-
Access the full range of user guides, firmware updates, technical articles, and support documentation via the Aruba Support Portal:
12. Blyott Support and Assistance
Within this Help Center, we aim to provide you with useful information, documentation, and guidance that will enable you to make the most out of your access to the Blyott Platform. In the Knowledge base section you can find a video walkthrough guide for the support page, Release Notes, Documentation, Manuals, and “How to” guides.
Please be reminded that you need to register/log in to the support page to access all Blyott- related documentation.
If you have any questions or suggestions at all, please feel free to get in touch with us at helpdesk.blyott.com
Thanks and regards,
The Blyott Support Team