You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
-[Arduino Renesas Portenta Boards core](https://github.com/arduino/ArduinoCore-renesas) (required to work with the Portenta C33 board)
39
39
@@ -53,7 +53,7 @@ Ultra-Wideband (UWB) is a radio technology that uses very low energy levels for
53
53
54
54
#### UWB vs. Traditional Narrowband Technologies
55
55
56
-
The fundamental difference between UWB and traditional wireless technologies (Wi-Fi, Bluetooth, Zigbee® and Cellular) lies in their transmission methods:
56
+
The fundamental difference between UWB and traditional wireless technologies (Wi-Fi®, Bluetooth®, Zigbee® and Cellular) lies in their transmission methods:
@@ -67,7 +67,7 @@ Traditional narrowband systems use frequency or amplitude modulation to send dat
67
67
68
68
#### Key Characteristics of UWB
69
69
70
-
-**High precision**: UWB can determine the relative position of devices with centimeter-level accuracy (typically 5-10 cm), far more precise than GPS (meters), Bluetooth (1-3 meters) or Wi-Fi (2-15 meters).
70
+
-**High precision**: UWB can determine the relative position of devices with centimeter-level accuracy (typically 5-10 cm), far more precise than GPS (meters), Bluetooth® (1-3 meters) or Wi-Fi® (2-15 meters).
71
71
-**Low-power consumption**: Despite its high data rates, UWB consumes very little power, making it suitable for battery-operated devices and long-term deployments.
72
72
-**Short range**: Typically effective within 10-30 meters, making it ideal for indoor positioning applications where GPS signals are weak or unavailable.
73
73
-**Strong security**: The unique physical layer characteristics of UWB, including its wide bandwidth and low power spectral density, make it more resistant to jamming, eavesdropping, and relay attacks compared to other wireless technologies.
@@ -154,7 +154,7 @@ The Portenta UWB Shield and the Arduino Stella use different libraries and board
154
154
155
155
#### Portenta UWB Shield Library
156
156
157
-
The [`ardUWBSr150` library](https://github.com/arduino-libraries/ardUWBSr150) contains an application programming interface (API) to read data from the Portenta UWB Shield and control its parameters and behavior. This library is designed to work with the DCU150 module on the shield and supports the following:
157
+
The [`PortentaUWBShield` library](https://github.com/Truesense-it/PortentaUWBShield) contains an application programming interface (API) to read data from the Portenta UWB Shield and control its parameters and behavior. This library is designed to work with the DCU150 module on the shield and supports the following:
158
158
159
159
- One-way ranging (Time Difference of Arrival - TDoA) and two-way ranging (TWR).
160
160
- Angle of Arrival (AoA) measurement for 2D and 3D positioning.
@@ -164,20 +164,20 @@ The [`ardUWBSr150` library](https://github.com/arduino-libraries/ardUWBSr150) co
164
164
165
165
#### Arduino Stella Library
166
166
167
-
For two-way ranging experiments between the Portenta UWB Shield and Arduino Stella, you'll also need the [`ardUWBSr040` library](https://github.com/arduino-libraries/ardUWBSr040). This library provides similar functionality but is specifically optimized for the DCU040 module in the Stella board.
167
+
For two-way ranging experiments between the Portenta UWB Shield and Arduino Stella, you'll also need the [`StellaUWB` library](https://github.com/Truesense-it/StellaUWB). This library provides similar functionality but is specifically optimized for the DCU040 module in the Stella board.
168
168
169
169
***The Arduino mbed OS Boards core is required to work with Stella's nRF52840 microcontroller.***
170
170
171
-
#### Bluetooth Communication
171
+
#### Bluetooth® Communication
172
172
173
-
For examples that use Bluetooth Low Energy (BLE) communication (like the Nearby Demo), you'll also need the [`ArduinoBLE` library](https://github.com/arduino/ArduinoBLE). This library enables BLE functionality for device discovery and initial connection setup before UWB ranging begins.
173
+
For examples that use Bluetooth® Low Energy (BLE) communication (like the Nearby Demo), you'll also need the [`ArduinoBLE` library](https://github.com/arduino/ArduinoBLE). This library enables BLE functionality for device discovery and initial connection setup before UWB ranging begins.
174
174
175
175
#### Installing the Libraries and Board Cores
176
176
177
177
To install the required libraries:
178
178
179
179
1. Navigate to `Tools > Manage libraries...` or click the **Library Manager** icon in the left tab of the Arduino IDE.
180
-
2. In the Library Manager tab, search for the library name (`ardUWBSr150`, `ardUWBSr040`, or `ArduinoBLE`).
180
+
2. In the Library Manager tab, search for the library name (`PortentaUWBShield`, `StellaUWB`, or `ArduinoBLE`).
181
181
3. Click "Install" to install the latest version of each library.
182
182
183
183

@@ -190,7 +190,7 @@ To install the required board cores:
190
190
191
191

192
192
193
-
***<strong>Important note:</strong> Make sure to install both the appropriate library and board core for your specific hardware. The Portenta UWB Shield with Portenta C33 requires the `ardUWBSr150` library and Arduino Renesas Boards core. For examples involving Arduino Stella, you'll need the `ardUWBSr040` library and Arduino mbed OS Boards core. For examples involving BLE communication, both devices will need the `ArduinoBLE` library installed.***
193
+
***<strong>Important note:</strong> Make sure to install both the appropriate library and board core for your specific hardware. The Portenta UWB Shield with Portenta C33 requires the `PortentaUWBShield` library and Arduino Renesas Boards core. For examples involving Arduino Stella, you'll need the `StellaUWB` library and Arduino mbed OS Boards core. For examples involving BLE communication, both devices will need the `ArduinoBLE` library installed.***
194
194
195
195
### Pinout
196
196
@@ -244,19 +244,19 @@ Align the shield's High-Density connectors with those on the Portenta C33 board
244
244
245
245
The Portenta UWB Shield is powered exclusively through the `VCC` pins (+3.3 VDC) of its High-Density Connectors. These connectors are designed to be used with boards from the Portenta family, such as the Portenta C33 board. The power is supplied directly from the connected Portenta family board, which acts as the power source for the Portenta UWB Shield.
246
246
247
-
***<strong>Important note:</strong> The Portenta UWB Shield does not have an independent power input. It receives power only through the High-Density connectors when properly connected to a Portenta C33 board. Additionally, if you plan to use Bluetooth Low Energy (BLE) functionality, make sure to connect an antenna to the Wi-Fi/Bluetooth module of the Portenta C33 for optimal wireless performance.***
247
+
***<strong>Important note:</strong> The Portenta UWB Shield does not have an independent power input. It receives power only through the High-Density connectors when properly connected to a Portenta C33 board. Additionally, if you plan to use Bluetooth® Low Energy (BLE) functionality, make sure to connect an antenna to the Wi-Fi®/Bluetooth module of the Portenta C33 for optimal wireless performance.***
248
248
249
249
### Nearby World Example
250
250
251
-
Let's use the Portenta UWB Shield with the Portenta C33 to create a real-time distance measurement system using UWB technology. We will implement what we call the `Nearby World` example (based on the `NearbyDemo` sketch), which serves as our `Hello World` sketch for UWB technology. This example will verify the Portenta UWB Shield's connection to the host board, the host board's connection to the Arduino IDE and that the `ardUWBSr150` library and both the board and the shield are working as expected.
251
+
Let's use the Portenta UWB Shield with the Portenta C33 to create a real-time distance measurement system using UWB technology. We will implement what we call the `Nearby World` example (based on the `NearbyDemo` sketch), which serves as our `Hello World` sketch for UWB technology. This example will verify the Portenta UWB Shield's connection to the host board, the host board's connection to the Arduino IDE and that the `PortentaUWBShield` library and both the board and the shield are working as expected.
252
252
253
253
***This example sketch leverages Apple's Nearby Interaction protocol and similar UWB implementations on Android devices to establish a communication channel between the Portenta UWB Shield and a UWB-enabled smartphone, allowing precise distance and angle measurements.***
254
254
255
255
#### How It Works
256
256
257
257
The `Nearby World` example demonstrates the core functionality of UWB technology through a simple example sketch that can be described in the following key steps:
258
258
259
-
1.**BLE connection setup**: The Portenta UWB Shield establishes a Bluetooth Low Energy (BLE) connection with a compatible smartphone app.
259
+
1.**BLE connection setup**: The Portenta UWB Shield establishes a Bluetooth® Low Energy (BLE) connection with a compatible smartphone app.
260
260
2.**Configuration exchange**: The BLE connection is used to exchange necessary UWB configuration parameters.
261
261
3.**UWB ranging**: Once configured, the actual UWB ranging session begins, providing precise distance measurements.
262
262
4.**Real-time feedback**: Distance data is continuously updated and can be viewed on the IDE's Serial Monitor and the smartphone app.
@@ -574,8 +574,8 @@ uint16_t numConnected = 0;
574
574
575
575
The code includes two essential libraries:
576
576
577
-
-`ArduinoBLE`: Provides Bluetooth Low Energy (BLE) functionality for device discovery and initial connection.
578
-
-`ardUWBSr150`: The core library that enables interaction with the UWB hardware on the Portenta UWB Shield.
577
+
-`ArduinoBLE`: Provides Bluetooth® Low Energy (BLE) functionality for device discovery and initial connection.
578
+
-`PortentaUWBShield`: The core library that enables interaction with the UWB hardware on the Portenta UWB Shield.
579
579
580
580
The `numConnected` variable tracks how many BLE clients are currently connected to the Portenta UWB Shield.
581
581
@@ -916,8 +916,8 @@ The Two-Way Ranging example demonstrates a more direct approach to UWB communica
916
916
917
917
Both devices use their respective UWB libraries:
918
918
919
-
- The Portenta UWB Shield uses `ardUWBSr150.h` (for the DCU150 module)
920
-
- The Stella uses `ardUWBSr040.h` (for the DCU040 module)
919
+
- The Portenta UWB Shield uses `PortentaUWBShield.h` (for the DCU150 module)
920
+
- The Stella uses `StellaUWB.h` (for the DCU040 module)
921
921
922
922
Both sketches configure MAC addresses for identification:
-[Arduino mbed OS Boards core](https://github.com/arduino/ArduinoCore-mbed) (required for the nRF52840 microcontroller of the Arduino Stella)
40
40
@@ -149,7 +149,7 @@ The Arduino Stella and Portenta UWB Shield use different libraries and board cor
149
149
150
150
#### Arduino Stella Library
151
151
152
-
The [`ardUWBSr040` library](https://github.com/arduino-libraries/ardUWBSr040) contains an application programming interface (API) to read data from the Arduino Stella and control its parameters and behavior. This library is designed to work with the DCU040 module on the Arduino Stella and supports the following:
152
+
The [`StellaUWB` library](https://github.com/Truesense-it/StellaUWB) contains an application programming interface (API) to read data from the Arduino Stella and control its parameters and behavior. This library is designed to work with the DCU040 module on the Arduino Stella and supports the following:
153
153
154
154
- One-way ranging (Time Difference of Arrival - TDoA) and two-way ranging (TWR).
155
155
- Power management for battery-efficient operation.
@@ -160,7 +160,7 @@ The [`ardUWBSr040` library](https://github.com/arduino-libraries/ardUWBSr040) co
160
160
161
161
#### Portenta UWB Shield Library
162
162
163
-
If you plan to use the Arduino Stella with a Portenta UWB Shield for two-way ranging, you'll also need the [`ardUWBSr150` library](https://github.com/arduino-libraries/ardUWBSr150) for the Portenta UWB Shield. This library is specifically designed for the DCU150 module used in the shield.
163
+
If you plan to use the Arduino Stella with a Portenta UWB Shield for two-way ranging, you'll also need the [`PortentaUWBShield` library](https://github.com/Truesense-it/PortentaUWBShield) for the Portenta UWB Shield. This library is specifically designed for the DCU150 module used in the shield.
164
164
165
165
***The [Arduino Renesas Portenta Boards core](https://github.com/arduino/ArduinoCore-renesas) is required to work with the Portenta C33 board that hosts the UWB Shield.***
166
166
@@ -173,7 +173,7 @@ For examples that use Bluetooth Low Energy (BLE) communication, you'll also need
173
173
To install the required libraries:
174
174
175
175
1. Navigate to `Tools > Manage libraries...` or click the **Library Manager** icon in the left tab of the Arduino IDE.
176
-
2. In the Library Manager tab, search for the library name (`ardUWBSr040`, `ardUWBSr150`, or `ArduinoBLE`).
176
+
2. In the Library Manager tab, search for the library name (`StellaUWB`, `PortentaUWBShield`, or `ArduinoBLE`).
177
177
3. Click "Install" to install the latest version of each library.
178
178
179
179

@@ -186,7 +186,7 @@ To install the required board cores:
186
186
187
187

188
188
189
-
***<strong>Important note:</strong> Make sure to install both the appropriate library and board core for your specific hardware. The Arduino Stella requires the `ardUWBSr040` library and Arduino mbed OS Boards core, while the Portenta UWB Shield with Portenta C33 requires the `ardUWBSr150` library and Arduino Renesas Boards core. For examples involving BLE communication, both devices will need the `ArduinoBLE` library installed.***
189
+
***<strong>Important note:</strong> Make sure to install both the appropriate library and board core for your specific hardware. The Arduino Stella requires the `StellaUWB` library and Arduino mbed OS Boards core, while the Portenta UWB Shield with Portenta C33 requires the `PortentaUWBShield` library and Arduino Renesas Boards core. For examples involving BLE communication, both devices will need the `ArduinoBLE` library installed.***
190
190
191
191
### Pinout
192
192
@@ -981,8 +981,8 @@ The Two-Way Ranging example demonstrates a more direct approach to UWB communica
981
981
982
982
Both devices use their respective UWB libraries:
983
983
984
-
- The Portenta UWB Shield uses `ardUWBSr150.h` (for the DCU150 module)
985
-
- The Arduino Stella uses `ardUWBSr040.h` (for the DCU040 module)
984
+
- The Portenta UWB Shield uses `PortentaUWBShield.h` (for the DCU150 module)
985
+
- The Arduino Stella uses `StellaUWB.h` (for the DCU040 module)
986
986
987
987
Both sketches configure MAC addresses for identification:
0 commit comments