ST / X_NUCLEO_IDB0XA1

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Dependents:   Nucleo_Zumo_BLE_IDB04A1 contest_IOT5 contest_IOT6 contest_IOT_10 ... more

Fork of X_NUCLEO_IDB0XA1 by ST Expansion SW Team

Arduino Connector Compatibility Warning

X-NUCLEO-IDB04A1 and X-NUCLEO-IDB05A1 are Arduino compatible with an exception: instead of using pin D13 for the SPI clock, they use pin D3. The default configuration for this library is having the SPI clock on pin D3.

To be fully Arduino compatible, X-NUCLEO-IDB04A1 and X-NUCLEO-IDB05A1 need a small HW patch.

For X-NUCLEO-IDB04A1 this patch consists in removing zero resistor R10 and instead soldering zero resistor R11. For X-NUCLEO-IDB05A1 this patch consists in removing zero resistor R4 and instead soldering zero resistor R6.

In case you patch your board, then you also have to configure this library to use pin D13 to drive the SPI clock (see macro IDB0XA1_D13_PATCH in file x_nucleo_idb0xa1_targets.h).

If you use pin D13 for the SPI clock, please be aware that on STM32 Nucleo boards you may not drive the LED, otherwise you will get a conflict: the LED on STM32 Nucleo boards is connected to pin D13.

Referring to the current list of tested platforms (see X-NUCLEO-IDB04A1 and X-NUCLEO-IDB05A1 pages), the patch is required by ST-Nucleo-F103RB; ST-Nucleo-F302R8; ST-Nucleo-F411RE; and ST-Nucleo-F446RE.

Diff: source/utils/Utils.cpp

Revision:
132:51056160fa4a
Child:
226:be2f4e1d0515
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/source/utils/Utils.cpp	Wed Oct 07 08:39:04 2015 +0200
@@ -0,0 +1,125 @@
+/* mbed Microcontroller Library
+* Copyright (c) 2006-2013 ARM Limited
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*     http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+#include "Utils.h"
+
+/**************************************************************************/
+/*!
+    @brief  sets values of EN_HIGH_POWER and PA_LEVEL corresponding to dBMLevel of tx power
+
+    @returns    value of tx power in dbm actually set
+
+    @params[in] dBMLevel
+                dBMLevel of tx power to be set
+                
+    @params[in] dBMLevel
+                dBMLevel of tx power to be set                
+                
+    @endcode
+*/
+/**************************************************************************/
+double getHighPowerAndPALevelValue(int8_t dBMLevel, int8_t& EN_HIGH_POWER, int8_t& PA_LEVEL) {
+    double dbm = (double) dBMLevel;
+    if(dbm<-18.0) {
+        dbm = -18;
+        EN_HIGH_POWER = 0;
+        PA_LEVEL = 0;         
+    }
+    else if(dbm>8.0) {
+        dbm = 8;
+        EN_HIGH_POWER = 1;
+        PA_LEVEL = 7;        
+    }
+    
+    // As a policy we are setting tx power level to the higher side
+    if((dbm>-18.0) && (dbm<=-15)) {
+        // set tx power to -15dBM
+        EN_HIGH_POWER = 0;
+        PA_LEVEL = 0;
+    }
+    else if((dbm>-15) && (dbm<=-14.7)) {
+        // set tx power to -14.7dBM
+        EN_HIGH_POWER = 0;
+        PA_LEVEL = 1;         
+    }
+    else if((dbm>-14.7) && (dbm<=-11.7)) {
+        // set tx power to -11.7dBM
+        EN_HIGH_POWER = 1;
+        PA_LEVEL = 1;            
+    }   
+    else if((dbm>-11.7) && (dbm<=-11.4)) {
+        // set tx power to -11.4dBM
+        EN_HIGH_POWER = 0;
+        PA_LEVEL = 2;            
+    }
+    else if((dbm>-11.4) && (dbm<=-8.4)) {
+        // set tx power to -8.4dBM
+        EN_HIGH_POWER = 1;
+        PA_LEVEL = 2;           
+    }  
+    else if((dbm>-8.4) && (dbm<=-8.1)) {
+        // set tx power to -8.1dBM
+        EN_HIGH_POWER = 0;
+        PA_LEVEL = 3;           
+    }
+    else if((dbm>-8.1) && (dbm<=-5.1)) {
+        // set tx power to -5.1dBM
+        EN_HIGH_POWER = 1;
+        PA_LEVEL = 3;          
+    }   
+    else if((dbm>-5.1) && (dbm<=-4.9)) {
+        // set tx power to -4.9dBM
+        EN_HIGH_POWER = 0;
+        PA_LEVEL = 4;            
+    }
+    else if((dbm>-4.9) && (dbm<=-2.1)) {
+        // set tx power to -2.1dBM
+        EN_HIGH_POWER = 1;
+        PA_LEVEL = 4;          
+    }
+    else if((dbm>-2.1) && (dbm<=-1.6)) {
+        // set tx power to -1.6dBM
+        EN_HIGH_POWER = 0;
+        PA_LEVEL = 5;           
+    }
+    else if((dbm>-1.6) && (dbm<=1.4)) {
+        // set tx power to -1.6dBM
+        EN_HIGH_POWER = 1;
+        PA_LEVEL = 5;           
+    }   
+    else if((dbm>1.4) && (dbm<=1.7)) {
+        // set tx power to 1.7dBM
+        EN_HIGH_POWER = 0;
+        PA_LEVEL = 6;            
+    }
+    else if((dbm>1.7) && (dbm<=4.7)) {
+        // set tx power to 4.7dBM
+        EN_HIGH_POWER = 1;
+        PA_LEVEL = 6;            
+    }  
+    else if((dbm>4.7) && (dbm<=5.0)) {
+        // set tx power to 5.0dBM
+        EN_HIGH_POWER = 0;
+        PA_LEVEL = 7;           
+    }
+    else if((dbm>5.0) && (dbm<=8)) {
+        // set tx power to 8.0dBM
+        EN_HIGH_POWER = 1;
+        PA_LEVEL = 7;              
+    }  
+    
+    return dbm;         
+}