Wiliot Ecosystem Setup Guide
Introduction
This guide will help you to set up and operate the Wiliot Ecosystem, including products like the Dual Band Wiliot Pixel Tag, Energous 1W PowerBridge, Wiliot App, and Wiliot Cloud.
Figure 1: System Diagram showing the flow: IoT Pixel ➡️ Bridge ➡️ Gateway ➡️ Wiliot Cloud.
1. Purchase a Wiliot Cloud Account
- Head to https://www.wiliot.com/contact#01 ?.
- Subscription models are based on:
- Duration: monthly, quarterly, half-yearly
- Update resolution: 60, 30, 10, 5, or 1 min
- Localization features: location, zone
- Sensing features: temperature
Figure 2: Wiliot Cloud Account Registration form, showing fields for contact information, company details, and interest selection, alongside Energous and Wiliot branding.
2. Purchase the PowerBridge
- Head to https://energous.com/products/developer-kits/ ?.
- For Wiliot applications, Energous provides the VN55 model, featuring:
- "Works with Wiliot" characteristics
- Dual band operation
- 30dBm in Sub-1GHz band
- 20dBm in 2.4GHz band
Figure 3: A "Request Form" for purchasing the PowerBridge, with fields for name, email, company, and kit interest, alongside an image of the Energous VN55 PowerBridge device with a ruler indicating its size.
3. Purchase Wiliot Pixel Tags
- Head to https://www.identiv.com/products/rfid-tags-inlays-labels/iot-pixel-tags/iot-pixel-tags ?.
- Dual band Wiliot Pixel tags (v2) are provided in various formats.
Figure 4: A purchase form for Wiliot Pixel Tags with fields for name, email, phone, and company, and images of two types of Wiliot Pixel Tags.
4. Download & Install the Wiliot App
- Download the Wiliot App ? from the Android or Apple Store.
Figure 5: QR code for Apple App Store. Figure 6: QR code for Google Play Store. Below these are screenshots of the Wiliot App installation process on an Android device. A note indicates to set Google Chrome as the default browser for Android devices.
5. Create a User Account
- Head to https://management.wiliot.com ?.
- Sign up for a new user account ?.
- Insert your details & agree with the terms of service.
- Wait for activation email ✉️.
- Your account is now activated ✔️.
Figure 7: Shows the Wiliot Management interface for login and signup, a prompt to check email for activation, and an example of an activation email with a link.
6. Log into the User Account
- Head to https://platform.wiliot.com ?.
- Insert your credentials ?.
- Enter Access Code from email.
- Dashboard ON - no devices.
Figure 8: Illustrates the Wiliot login process, including the login form, an email with a verification code, and the Wiliot platform dashboard showing zero devices.
7. Start the Gateway (GW)
- Activate Bluetooth on mobile device & open the Wiliot App ?.
- Log In ?; Get access code from email.
- Activate "Gateway Mode" ?.
- GW active - keep screen ON.
Figure 9: Shows the Wiliot App interface with the "Gateway Mode" activated, indicating the phone is acting as a gateway to detect Wiliot devices and send data to the Wiliot Cloud.
8. Observe the GW (auto) Assignment
- Head to https://platform.wiliot.com ?.
- 1 GW must be seen on the dashboard.
- Click on "Gateways" ?.
- Observe GW ID and Status.
- GW status is 'online' ✔️.
Figure 9: Depicts the Wiliot platform dashboard showing the "Gateways" section, and a detailed view of the Gateways list with status indicators.
9. Register a GW device (optional)
- Access the Wiliot App ? & Power-up your GW device ?.
- Click on 'Edge' -> 'GW settings' ⚙️.
- Scan the QR code on the GW ?.
- Set the GW into AP mode.
- Select a local WiFi connection & Pass the credentials.
- Press 'Next' -> 'OK'; GW device active ✔️.
Figure 10: A series of screenshots from the Wiliot App demonstrating the steps for registering a GW device, including Edge settings, Wi-Fi configuration, and AP mode setup. The final screen shows the Wiliot App can be turned off after setup.
10. GW device / FW update (optional)
- Head to https://platform.wiliot.com ?.
- Click on 'Gateways' ?.
- Click on 'Update available' ⬆️, then click on "Update" ✏️.
- Keep the GW powered & Wait for a few minutes.
- GW device's FW updated ✔️.
Figure 11: Shows the Wiliot platform interface for updating Gateway firmware, including the "Firmware Update" dialog and the progress indication.
11. Claim the PowerBridge
- Head to https://platform.wiliot.com ?.
- Power Up the bridge ?.
- Click on "Bridges" ? & Claim the bridge ✅.
- Click on "Home" ?.
- Bridge is online and claimed ✔️.
Figure 12: Illustrates the process of claiming a PowerBridge on the Wiliot platform, showing the bridge connection port and the platform interface for managing bridges.
12. Prepare PowerBridge for FW Update
- Head to https://platform.wiliot.com ?.
- Power Up the bridge ? & Click on "Bridges" ?.
- Select the bridge and Click on "Edit" ✏️.
- Set "otaEnabled" to "1" and Click "Save" ✅.
- Bridge is ready for OTA reflash ✔️.
Figure 11: Shows the Wiliot platform interface for editing bridge settings, specifically highlighting the "otaEnabled" field to prepare for firmware updates.
13. Run FW Update
- Access the Wiliot App ?.
- Click on "Edge", then "FW Update", then "Next" ▶️.
- Click on "Update Required", then "Next" & wait for download ⬇️.
- Unpower then power-up bridge ?, & wait for the FW to be flashed.
- Bridge is flashed with new FW ✔️.
Figure 12: A sequence of Wiliot App screens demonstrating the firmware update process for a bridge, from initiating the update to confirming its success.
14. Configure the Operation Parameters
- Head to https://platform.wiliot.com ?.
- Click on "Bridges" ? & select the bridge.
- Click on "Edit" ✏️ & set operation parameters ⚙️.
- Bridge set correctly ✔️.
Figure 13: Shows the Wiliot platform interface for editing bridge settings, focusing on configuring various operation parameters like pacing rate, output power, and frequency. Notes advise setting parameters according to manufacturer recommendations.
15. Create a Location
- Head to https://platform.wiliot.com ?.
- Click on "Locations" ? then "Add New" ➕.
- Assign a Name.
- Set Coordinates using Map CTRL & Click "Add" ✅.
- Location ready - unassigned.
Figure 14: Illustrates the process of creating a new location on the Wiliot platform, showing the "Add Location" form and a map interface for setting coordinates.
16. Partition a location into zones
- Head to https://platform.wiliot.com ?.
- Click on "Locations" ? & Click on the available location.
- Click on the "Zones" ?️ tab, then "Add New" ➕.
- Assign a name and Click "Add" ✅.
- Zone (within location) ready ✔️.
Figure 15: Shows the Wiliot platform interface for partitioning a location into zones, including selecting a location, navigating to the "Zones" tab, and adding a new zone.
17. Link PowerBridge to location/zone
- Head to https://platform.wiliot.com ?.
- Click on "Associate Bridges" ?.
- Select the Bridge & Click "Save" ✅.
- Bridge linked to location/zone ✔️.
Figure 16: Illustrates linking a PowerBridge to a location/zone on the Wiliot platform, showing the "Add Edge Device" interface and the Bridges list.
18. Prepare Pixel Transfer
- Head to https://platform.wiliot.com ?.
- Identify source account admin ?.
- Click "Account Management", then "User Management" ?.
- Click "Add New" ➕ & Insert Source Admin Email ✉️, then Click "Add" ✅.
- Source/Destination (Src/Dst) have a common admin.
Figure 17: Shows the Wiliot platform interface for preparing a pixel transfer, including Account Management and User Management sections.
19. Request Pixel Transfer
- Contact src. account admin through email ✉️, phone ?, etc.
- Provide the pixel(s) ID ?.
- Provide the dst. account info ?.
- Request the transfer ➡️.
- Acceptance from src admin ✔️.
Figure 18: Continues the pixel transfer preparation, showing the Users Management interface with options to add users.
20. Run Pixel Transfer
- Head to https://platform.wiliot.com ?.
- Access the source account ?.
- Click on "Pixels" ?, then "Transfer" ➡️, then "Method Settings" ⚙️.
- Specify the pixel ID & Continue to "Select Account" ?.
- Specify the destination account.
- Pixel transferred to destination ✔️.
Figure 19: Illustrates running a pixel transfer on the Wiliot platform, showing the "Transfer Pixels" interface with options for method settings, pixel selection, and account selection.
21. Create Asset Category
- Head to https://platform.wiliot.com ?.
- Click on "Categories" ?️, then "Add New" ➕.
- Assign a name, e.g., "default", then Assign a type & Press "Add" ✅.
- Asset category created ✔️.
Figure 20: Shows the Wiliot platform interface for creating asset categories, including the "Add Category" form and examples of category types like "Object" and "Liquid Container". A note emphasizes this is vital for event generation.
22. Associate Pixel to Asset
- Head to https://platform.wiliot.com ?.
- Click on "Assets" ?, then "Add New" ➕.
- Select asset category ?️, then Press "Next" ▶️.
- Specify pixel ID ? to be attached and Click "Add" ✅.
- Asset Created ✔️.
Figure 21: Illustrates associating a Pixel to an Asset on the Wiliot platform, showing the "Add Asset" form with options to select a category, enter an Asset ID, and attach pixels. A note emphasizes this is vital for event generation.
23. Create MQTT Connection
- Head to https://platform.wiliot.com ?.
- Click on "Connections" ?, then Click "Add New" ➕.
- Set connection type "MQTT" ?.
- Specify the name, URL, topic, log-in credentials and body content (as shown) & Click "Add" ✅.
- MQTT connection running ✔️.
Figure 22: Shows the Wiliot platform interface for creating an MQTT connection, including connection type selection, settings for URL, topic, username, password, and body content, as well as a "Test Connection" result.
24. Receive Tag Events on Web Platform
- Head to https://platform.wiliot.com ?.
- Expose the pixel ? to the bridge ?.
- Click on the "Assets" ? tab & then click on the entry.
- Visualize the pixel events ?.
- Receiving pixel events ✔️.
Figure 23: Illustrates receiving tag events on the Wiliot web platform, showing the Assets tab and a graph displaying sensor data over time.
25. Interact with the System over Mobile
- Head to https://platform.wiliot.com ?.
- Expose the pixel ? to the bridge ?.
- Click on "Show Nearby" ? & Click on "Assets" ? tab.
- Click on "Pixels" ? tab; see RSSI.
- Click on "Bridges" ? tab; see config ⚙️.
- Click on parameter to set value ⚙️.
Figure 24: Demonstrates interacting with the Wiliot system via the mobile app, showing screens for "Show Nearby", "Assets", "Pixels", "Bridges", and configuring parameters like Pacing Rate and Energizing Pattern.