User Guide for SILICON LABS models including: FG23, EFR32 Series 2 Long Range, Series 2 Long Range, 2 Long Range, Long Range, Range, FG25, FG28
Silicon Labs RAIL API Reference Guide - v2.16.0 - RAIL Silicon Labs
13 déc. 2023 — Simplicity Studio 5 (SSv5) makes it easy to access Long Range PHY configurations by selecting the Long Range profile in the Radio. Configurator interface. If ...
Developing with RAIL - v2.16.0 - RAIL Silicon Labs
File Info : application/pdf, 15 Pages, 2.27MB
DocumentDocumentUG460.2: EFR32 Series 2 Long Range Configuration Reference To help customers achieve the crucial design element of maximum effective range, Silicon Labs has a Long Range radio profile for the EFR32 Series 2 family of Wireless MCU devices, fully compatible with the existing solution on Series 1. From the current lineup, only SubGHz capable ones are supported, namely FG23/FG25/FG28. This guide introduces the profile, describes its development, and examines underlying details that enable it to realize extended range. It also includes an exercise to build a Range Test example using Simplicity Studio 5 and to explore the Long Range profile, so that you can quickly begin implementation in your next project. This guide is designed for developers who would like to test long range performance on EFR32 Series 2 devices using Simplicity Studio 5 and Silicon Labs development hardware. It provides instructions to get started using the example applications provided with the Gecko SDK Suite (GSDK) v4. KEY FEATURES · Learn about DSSS · Learn about the Long Range Profile · Learn about the Radio Configurator · Create a Range Test application with a long range PHY · Overview measured performance met- rics silabs.com | Building a more connected world. Copyright © 2023 by Silicon Laboratories Rev. 0.1 UG460.2: EFR32 Series 2 Long Range Configuration Reference Introduction 1 Introduction One of the most important performance metrics for an IoT application is maximum usable range. Practically speaking, this refers to the maximum distance at which messages can be received without a loss of information. The achievable range is impacted by many different factors: · Hardware influences, including: · Antenna physical parameters (size, shape, directivity, gain) · Battery physical parameters (size, capacity, load current, and so on) · Propagation attributes of the radio signal (carrier frequency, humidity, obstacles, and so on) · Transmit power · Receiver sensitivity To maximize usable range, when developing the Long Range (LR) profile Silicon Labs targeted the last item above, receiver sensitivity, which is affected by multiple input parameters: · Frame length: The amount of data to be transported · Data rate: The timeframe available to transport the data · Baud rate offset tolerance: How much the data rate can change during reception · Frequency offset tolerance: How severely the carrier frequency can vary during the reception · Selectivity and blocking: Robustness against interferer signals Though many paths can be taken to improve RX sensitivity, Silicon Labs avoided hardware changes and instead focused on radio configuration modifications. This reliance on PHY development insulated the Long Range profile from additional external hardware dependencies, making the LR PHY benefits available to a broader selection of applications. The construction of these PHYs is detailed in the next chapter. Chapter 3 provides instructions on evaluating the Long Range Profile using new Silicon Labs development tools and hardware. Chapter 4 reviews real-world measured performance with the LR PHYs. silabs.com | Building a more connected world. Rev. 0.1 | 1 UG460.2: EFR32 Series 2 Long Range Configuration Reference Development of the EFR32 Long Range PHYs 2 Development of the EFR32 Long Range PHYs The fundamental approach to extend usable range is to decrease receiver bandwidth, while keeping key signal parameters for the demodulator, such as modulation index for FSK, intact. A few rules of thumb help to visualize what is possible by this effort: · Reducing bandwidth by half improves sensitivity by 3 dB · Reducing bandwidth by 90% (to 1/10th of the original) boosts sensitivity by 10 dB A straightforward compromise to achieve bandwidth reduction is to decrease the data rate. By cutting bandwidth in favor of sensitivity, one has to also contend with the resulting degradation in frequency offset tolerance. Therefore, such narrow-band PHYs require very accurate and stable clock references (for example, a 0.5 ppm TCXO), and those elements are more costly. In terms of RF immunity, the effect of going narrow band is mixed, with some improvement in selectivity and blocking offset by extended packet time and exposure to interferers due to the reduced data rate. Importantly, all of these drawbacks can be mitigated by using Direct Sequence Spectral Spreading (DSSS). This technique, which is available for all major modulation formats on the EFR32, is explored in the following section. 2.1 DSSS: Theory of Operation DSSS is a technique to increase the bandwidth of a transmitted signal, and thereby decrease its power spectral density. It is beneficial for the receiver side as well, as the robustness (immunity against interferer signals) significantly improves. This section reviews the DSSS implementation on EFR32 Series 2 devices. 2.1.1 TX Side Figure 2-1. Transmission of 802.15.4 Signals Using DSSS The above figure shows how a DSSS-based signal is constructed. As a practical demonstration vehicle, this example uses the 802.15.4 Zigbee packet format. The baseband input signal is a narrow band, low data rate signal stream (its spectrum plot represented by the green cone). This bitstream is fed into a DSSS encoder, which replaces every 4 bits of the bitstream with a 32-bit symbol, often referred to as 32 "chips". Transmitting 1 symbol takes the same amount of time as transmitting 4 bits of the original data stream. This means that the "chip rate" is 8x higher than the original data rate, a multiplier often referred to as the Spreading Factor. The blue rectangle (spectrum plot of baseband input signal after DSSS encoding) demonstrates that the original narrow band signal has become much wider (though not quite 8x), with less power density. The resulting data stream with the chip rate is then fed into the modulator and radiated over the air. Therefore, by increasing the link's in-air baud rate, the same data can be transmitted with the same net data rate, over the same period of time, but using a much wider band and lower power spectral density. silabs.com | Building a more connected world. Rev. 0.1 | 2 2.1.2 RX Side UG460.2: EFR32 Series 2 Long Range Configuration Reference Development of the EFR32 Long Range PHYs Figure 2-2. Reception of 802.15.4 Signals Using DSSS The above figure shows reception of the DSSS-encoded transmission detailed in the previous section. The demodulator retrieves the data stream from the OQPSK signal. The bits are changing with the chip rate, and the stream may contain errors due to the presence of noise and interferers in the air. The plot at the top left corner of the above figure demonstrates the spectral conditions while receiving a DSSS packet. The red pyramid indicates the presence of a strong narrowband interferer, while the yellow trapezium represents the wideband noise. This corrupted chip stream is fed into the DSSS Decoder, which replaces every 32-chip long symbol with a 4-bit pattern in restoring the original data stream. Up to a given error rate in the chip stream, the decoder can still identify the correct 32-chip symbols due to the 8x redundancy presented by the scaling factor. The spectrum plot at the top right corner of the figure shows that the original green cone has been restored by this de-spreading procedure, while the red cone has been "smeared" with the noise. As a result, SNR is increased, which compensates for the increased noise power experienced by the demodulator due to the high in-air bandwidth. 2.2 DSSS: Practical Impacts As a result of using DSSS, an application is subject to the following considerations: · Co-channel and adjacent channel selectivity improve by a factor of the coding gain (3 to 8 dB, depending on spreading factor). · A less accurate (cheaper) crystal can be used for the clock reference. · Higher TX power can be used in cases where the regulatory limit is defined as maximum allowed power spectral density. · DSSS alone does not technically improve RX sensitivity to in-air signals: · Receiving a 1 kbps data stream exhibits the same RX sensitivity whether or not the signal content is DSSS-encoded. · DSSS increases the symbol rate and bandwidth of the signal physically present in the air, which actually degrades reception at the RX side, but this consequence is compensated by the DSSS processing gain in the receiver. 2.3 Scaling Down the 802.15.4 O-QPSK PHY To leverage the benefits of DSSS and develop Long Range options for EFR32 Series 2 devices, Silicon Labs began with the highly optimized 2.4 GHz 802.15.4 Zigbee OQPSK PHY and derived a series of radio configurations to serve a variety of sensitivity and tolerance requirements. Essentially, the data rate (and therefore the occupied bandwidth) has been scaled down, while retaining the same Zigbee coding scheme: OQPSK, DSSS SF=8, and 32-bit symbol length with a 4-bit symbol map. The resulting PHY configurations are currently available for FG23 / FG25 / FG28 variants of the Series 2 family. The following table shows one group of PHYs optimized for a lower frequency band, and another group optimized at a higher frequency band. Notably, the stated performance is maintained when setting the carrier frequency to anywhere within each band. silabs.com | Building a more connected world. Rev. 0.1 | 3 UG460.2: EFR32 Series 2 Long Range Configuration Reference Development of the EFR32 Long Range PHYs The table indicates the required XO accuracy for the TX and RX side combined, an offset budget of a given LR link. This presents a cost savings opportunity on nodes manufactured in large quantities vs low volume base stations, where you can asymmetrically distribute the XO accuracy budget to reduce the cost of high-volume elements. Most commonly in practice, the value in the table is split between TX and RX devices. Note: The last item, 80 kbps for 915MHz, can be used to pass FCC 15.247 requirements without the need for frequency hopping, as the occupied bandwidth (- 6 dB) of the signal is >= 500 kHz. Table 2-1. PHY Configuration Options on the Long Range Profile Frequency Band [MHz] 434/490 434/490 434/490 434/490 434/490 868/915 868/915 868/915 868/915 868/915 868/915 Data Rate [kbps] 1.2 2.4 4.8 9.6 19.2 2.4 4.8 9.6 19.2 38.4 80 (TX + RX) XO Accuracy [ppm +/-] 2.5 5 10 20 40 2.5 5 10 20 40 80 2.4 Radio Boards Supporting Long Range PHY Evaluation Many configurations within the Long Range Profile can be successfully demonstrated on any radio board with a supported EFR32 Series 2 SoC and suitable sub-GHz band support. · Please note that Silicon Labs typical radio boards have a +/- 10ppm crystal as a reference. · Refer to PHY config XO tolerances in Table 2-1. PHY Configuration Options on the Long Range Profile above to verify support for your preferred PHY using two (2) +/- 10ppm radio boards (+/- 20ppm combined). · If your PHY of choice requires tighter tolerance applying a TCXO is recommended For reference, the following table specifies development boards Silicon Labs used for testing, but as said, any sub-GHz capable board with FG23/FG25/FG28 on it can be used. For the test, Silicon Labs used 0.5 ppm TCXO. Table 2-2. Radio Boards Used During Testing Ordering Part Number xG23-RB4204D FG23-RB4265A Board ID BRD4204D BRD4265A Board Configuration EFR32ZG23 868-915 MHz 14 dBm Radio Board EFR32FG23 433 MHz 10 dBm Radio Board silabs.com | Building a more connected world. Rev. 0.1 | 4 3 Using the Long Range Profile in Simplicity Studio 5 UG460.2: EFR32 Series 2 Long Range Configuration Reference Using the Long Range Profile in Simplicity Studio 5 3.1 Long Range Profile in the Radio Configurator Simplicity Studio 5 (SSv5) makes it easy to access Long Range PHY configurations by selecting the Long Range profile in the Radio Configurator interface. If you need a refresher, please see the Simplicity Studio 5 User's Guide and AN1253: EFR32 Radio Configurator Guide for Simplicity Studio 5 for more information on building an example wireless application with the Radio Configurator. Click the Select radio profile dropdown and select Long Range Profile. Note that PHYs in this profile have reduced configuration options (carrier frequency, and FEC enable), described here: · Carrier frequency can be set to anywhere within each band baseband performance will be sustained at all frequencies within a given band. However, be aware that external components (antenna matching for example) can exhibit a frequency dependence. · FEC (Forward Error Correction) can be enabled for any of the PHY configurations: · Current FEC options in EFR32 Series 2 are convolutional codes with a rate of ½, doubling the number of transmitted symbols after the sync word. Enabling FEC does not automatically adjust the data rate. To maintain the original effective throughput, manually select a data rate that is twice the original rate. · FEC does not increase sensitivity, but it can protect against bit errors over the payload due to interferer signals. The next section provides a procedure to construct a complete example application with which to evaluate PHYs in the Long Range Profile using two EFR32 radio boards. silabs.com | Building a more connected world. Rev. 0.1 | 5 UG460.2: EFR32 Series 2 Long Range Configuration Reference Using the Long Range Profile in Simplicity Studio 5 3.2 Build a Range Test Example Application This section describes the steps to build a Range Test application, and is based on UG147: Range Test Demo User's Guide. Additional guidance on using the Range Test application can be found in this article. The procedure assumes that you have downloaded the Flex SDK, and have connected the two boards required for this example, as described in the Simplicity Studio 5 User's Guide. 1. Click the "Example Projects & Demos" tab to see the projects available for the selected target hardware. 2. Scroll down or use the example filter to locate the "RAIL SoC Range Test" project, and then click CREATE. 3. Enter the name of the project you want to create, or just leave it as the default, "range_test". silabs.com | Building a more connected world. Rev. 0.1 | 6 4. Click FINISH to create the new project. UG460.2: EFR32 Series 2 Long Range Configuration Reference Using the Long Range Profile in Simplicity Studio 5 5. Once the project is created, SSv5 opens the Simplicity IDE perspective, and the radio configuration GUI appears. From the Project Explorer view, you can see the project files that have been generated. silabs.com | Building a more connected world. Rev. 0.1 | 7 UG460.2: EFR32 Series 2 Long Range Configuration Reference Using the Long Range Profile in Simplicity Studio 5 If you close this tab, the Radio Configurator can be accessed again at any time via the Software Components tab. Click the Advanced Configurators item, then Radio Configurator (alternatively, you can simply search for configurator using the search input at the top right of the .slcp frame). Once this Radio Configurator gateway element has been located, simply click OPEN to its right and proceed to the next step. If you have a radio board with a TCXO on it, change the HFXO software component's Mode to External sine wave. 6. Before configuring a Long Range PHY, you must adjust the selected radio profile for the project. On the Navigation Panel, click Protocol Configuration. You should see the General Settings and Channel Overview cards open in the editor window on the right. 7. On the General Settings card, click the Select radio profile drop-down field, and select Long Range Profile. silabs.com | Building a more connected world. Rev. 0.1 | 8 UG460.2: EFR32 Series 2 Long Range Configuration Reference Using the Long Range Profile in Simplicity Studio 5 8. On the Select radio PHY field, choose one of the predefined long range configurations, keeping the following guidance in mind: · For 434-490 MHz boards, select a 490 MHz config. · For 868-915 MHz boards, select a 915 MHz config. 9. Enable the Customized switch to allow fine tuning of the selected PHY config. 10. On the Operational Frequency card, set the Base Channel Frequency according to your planned operating band. 11. On the Crystal card, set the XO frequency. 12. On the Other settings card, you have the option to override the data rate selection and/or to enable FEC. (Note: On an EFR32, enabling FEC doubles the number of transmitted symbols after the sync word, but does not automatically adjust the data rate. To retain the original (before enabling FEC) effective throughput with FEC, you must manually select a doubled data rate.) silabs.com | Building a more connected world. Rev. 0.1 | 9 UG460.2: EFR32 Series 2 Long Range Configuration Reference Using the Long Range Profile in Simplicity Studio 5 13. Build the project by clicking the hammer toolbar button. 14. Once built, flash the generated hex file to the target by right-clicking the <project name>.hex file in the "GNU ARM v7.2.1 Debug" folder, and selecting Flash to Device... 15. The Flash Programmer will open. Click Program to download the code to the target. silabs.com | Building a more connected world. Rev. 0.1 | 10 UG460.2: EFR32 Series 2 Long Range Configuration Reference Using the Long Range Profile in Simplicity Studio 5 16. Now flash the same .hex file to your second radio board. Select the other WSTK mainboard as the target device, and click Program. silabs.com | Building a more connected world. Rev. 0.1 | 11 UG460.2: EFR32 Series 2 Long Range Configuration Reference Measured Performance of the Long Range PHYs on FG23 4 Measured Performance of the Long Range PHYs on FG23 4.1 Conducted Testing The following table presents the following measurement results collected on real silicon with the PHYs available in the LR Profile: · Receiver sensitivity corresponding to 1% packet error rate (PER) with 22 byte payload (CRC incl.) · No FEC applied due to the short payload · Similar or better sensitivity numbers can be expected on FG25 and FG28 for the current LR profile PHYs · Overall required link (Rx + Tx) XO accuracy requirement calculated from frequency offset tolerance captures with wanted signal at 3 dB above sensitivity level · 0.5 ppm, 39 MHz TCXO was used on our dev boards listed in Table 2-2. Radio Boards Used During Testing used during testing Table 4-1. LR PHY Parameters Frequency Band [MHz] 434/490 434/490 434/490 434/490 434/490 868/915 868/915 868/915 868/915 868/915 868/915 Data Rate [kbps] 1.2 2.4 4.8 9.6 19.2 2.4 4.8 9.6 19.2 38.4 80 Measured Sensitivity [dBm] -131.5 -129 -126 -123 -120 -128 -125 -122 -119.5 -116.5 -113.5 (TX + RX) XO Accuracy [ppm +/-] 2.5 5 10 20 40 2.5 5 10 20 40 80 The following tables present basic blocking performance metrics for the 4.8 kbps and the 80 kbps LR PHYs as reference, measured with CW tone as interferer with wanted signal at 3 dB above sensitivity levels. The accuracy of the results is <= +/- 1 dB. Table 4-2. CW blocking performance of 4.8 kbps LR PHY @ 915 MHz PER [%] <= 1 >= 95 1 79 dB 85 dB -1 80 dB 85 dB 3 87 dB 92 dB CW blocker offset [MHz] -3 10 87 dB 87 dB 92 dB 92 dB -10 86 dB 92 dB 20 88 dB 94 dB -20 88 dB 94 dB Table 4-3. CW blocking performance of 80 kbps LR PHY @ 915 MHz PER [%] <= 1 >= 95 1 54 dB 58 dB -1 65 dB 69 dB 3 71 dB 74 dB CW blocker offset [MHz] -3 10 73 dB 76 dB 77 dB 82 dB -10 76 dB 82 dB 20 77 dB 84 dB -20 77 dB 84 dB Note: the 80 kbps PHY, as all others, has a spreading factor of 8, resulting in a 640 kcps with an Rx BW of 800 kHz. The IF frequency is 450 kHz, injection side is high-side, therefore the image frequency is located at 900 kHz above the carrier. This means that we have a ~800 kHz wide region around 900 kHz above the carrier where the image rejection performance is the dominant factor in blocking performance This explains the asymmetric results at +1 / -1 MHz. silabs.com | Building a more connected world. Rev. 0.1 | 12 UG460.2: EFR32 Series 2 Long Range Configuration Reference Measured Performance of the Long Range PHYs on FG23 As a reference, packet error rate-based waterfall and frequency offset tolerance curves are provided in the following two figures for the 4.8 and 19.2 kbps PHYs in the 490 and 915 MHz bands. Figure 4-1. LR PHY Packet Error Rate (PER) Waterfall Curves In the offset tolerance capture below, wanted signal was at sensitivity level and TCXO generator residual frequency offset was compensated. Figure 4-2. LR PHY Frequency Offset Tolerance Measurement Results at Sensitivity Level Note: in general, the expected tolerable frequency offset across LR PHYs, at 3 dB above sensitivity levels is +/- symbol rate in Hz. For example, the 4.8 kbps PHY should tolerate +/- 4.8 kHz frequency offset with wanted signal at 3 dB above sensitivity level. The required XO accuracy reflects this fact. silabs.com | Building a more connected world. Rev. 0.1 | 13 Simplicity Studio One-click access to MCU and wireless tools, documentation, software, source code libraries & more. Available for Windows, Mac and Linux! IoT Portfolio www.silabs.com/IoT SW/HW www.silabs.com/simplicity Quality www.silabs.com/quality Support & Community www.silabs.com/community Disclaimer Silicon Labs intends to provide customers with the latest, accurate, and in-depth documentation of all peripherals and modules available for system and software implementers using or intending to use the Silicon Labs products. Characterization data, available modules and peripherals, memory sizes and memory addresses refer to each specific device, and "Typical" parameters provided can and do vary in different applications. Application examples described herein are for illustrative purposes only. Silicon Labs reserves the right to make changes without further notice to the product information, specifications, and descriptions herein, and does not give warranties as to the accuracy or completeness of the included information. Without prior notification, Silicon Labs may update product firmware during the manufacturing process for security or reliability reasons. Such changes will not alter the specifications or the performance of the product. Silicon Labs shall have no liability for the consequences of use of the information supplied in this document. This document does not imply or expressly grant any license to design or fabricate any integrated circuits. The products are not designed or authorized to be used within any FDA Class III devices, applications for which FDA premarket approval is required or Life Support Systems without the specific written consent of Silicon Labs. A "Life Support System" is any product or system intended to support or sustain life and/or health, which, if it fails, can be reasonably expected to result in significant personal injury or death. Silicon Labs products are not designed or authorized for military applications. Silicon Labs products shall under no circumstances be used in weapons of mass destruction including (but not limited to) nuclear, biological or chemical weapons, or missiles capable of delivering such weapons. Silicon Labs disclaims all express and implied warranties and shall not be responsible or liable for any injuries or damages related to use of a Silicon Labs product in such unauthorized applications. Note: This content may contain offensive terminology that is now obsolete. Silicon Labs is replacing these terms with inclusive language wherever possible. For more information, visit www.silabs.com/about-us/inclusive-lexicon-project Trademark Information Silicon Laboratories Inc.®, Silicon Laboratories®, Silicon Labs®, SiLabs® and the Silicon Labs logo®, Bluegiga®, Bluegiga Logo®, EFM®, EFM32®, EFR, Ember®, Energy Micro, Energy Micro logo and combinations thereof, "the world's most energy friendly microcontrollers", Redpine Signals®, WiSeConnect , n-Link, ThreadArch®, EZLink®, EZRadio®, EZRadioPRO®, Gecko®, Gecko OS, Gecko OS Studio, Precision32®, Simplicity Studio®, Telegesis, the Telegesis Logo®, USBXpress® , Zentri, the Zentri logo and Zentri DMS, Z-Wave®, and others are trademarks or registered trademarks of Silicon Labs. ARM, CORTEX, Cortex-M3 and THUMB are trademarks or registered trademarks of ARM Holdings. Keil is a registered trademark of ARM Limited. Wi-Fi is a registered trademark of the Wi-Fi Alliance. All other products or brand names mentioned herein are trademarks of their respective holders. Silicon Laboratories Inc. 400 West Cesar Chavez Austin, TX 78701 USA www.silabs.com