Bluetooth Low Energy (BLE) beacon with nRF24L01(+). Data is received and displayed by Android device (Android app source code is attached).

Dependencies:   DS1820 mbed

nRF24L01 as Bluetooth Low Energy (BLE) Broadcaster/Beacon

Temperature measured by a DS1820 sensor is broadcasted by a nRF24L01(+) module as Bluetooth Low Energy signal. Data is then received and displayed on an Android device (smartphone/tablet) with Bluetooth Low Energy (Bluetooth Smart) enabled. In order to have Bluetooth LE available your device should run Android 4.3 or more recent.

Needed parts:

Zoom in /media/uploads/hudakz/img_20150314_115402.jpg
Figure 1: The hookup and the Android app in action

It was Dmitry Grinberg who figured out how to use nRF24L01 for BLE.
Read his amazing "Bit-banging" Bluetooth Low Energy. Thank you Dmitry!
I ported the code to mbed from Lijun's repository. Read his very neat article on the topic. Thank you Lijun!


It takes just few steps to build a Temperature Beacon

  1. Connect the nRF24L01(+) module and the DS1820 sensor to the mbed board according to the pin assignment defined in main.cpp. Don't forget to connect a 4.7k Ohm resistor between the DS1820's data pin and the +3.3V pin.

    /media/uploads/hudakz/nrf24l01.png
    Figure 2: nRF24L01(+) pinout

  2. Compile the project and save the binary file to your mbed module.
  3. Enable Bluetooth on the Android device.
  4. To view the raw data, install Nordic's nRF Master Control Panel (available at Google Play for free) to your Android device. Run the app and wait until a new nRF24L01 device is found. Do not tap the CONNECT button. This device is a broadcaster and enables only one way data flow (from the mbed to the Android). To see more details, tap the found nRF24L01 device on the left side of the screen and then the small RAW button which appears on the right side just below the CONNECT button. Now you should be able to see and check the raw bytes received from the mbed.
  5. Install the Android app:
    - Download the TemperatureBeacon app to your computer's folder of choice.
    - Open the folder and copy (send via Bluetooth or USB cable) the downloaded file to your Android device.
    - To install the app, open the folder on the Android with the file downloaded in the previous step and tap it.
  6. Once the app is installed and running:
    - After a while you should see the temperature displayed on Android (See in Figure 1).
    - Data is periodically updated. To verify that, touch the DS1820 sensor and you should see some new values.

If you'd like to adapt the Android app to your taste

  • Install Android Studio onto your computer (Window, Mac, Linux). It's a fantastic IDE from Google for free.
  • Download the Android app project to your computer's folder of choice and unzip.
  • Start Android Studio, open the project downloaded in the previous step and have fun.

I have learnt a lot about Android and Bluetooth Low Energy here:
https://developer.android.com/guide/topics/connectivity/bluetooth-le.html,
https://thenewcircle.com/s/post/1553/bluetooth_smart_le_android_tutorial

The Android app is based on:
https://github.com/devunwired/accessory-samples/tree/master/BluetoothGatt.
Thank you Dave!

Revision:
3:96153a5d95f6
Parent:
2:4f285d1d5c1f
Child:
4:b3c5c54cfd21
--- a/main.cpp	Sat Mar 14 15:35:43 2015 +0000
+++ b/main.cpp	Sun Mar 15 14:47:45 2015 +0000
@@ -1,8 +1,8 @@
 /*
-nRF24L01+ as a Bluetooth Low Energy Broadcaster/Beacon
-by hacking an nRF24L01+ module (which is under $1 per unit on eBay).
+Using nRF24L01(+) as a Bluetooth Low Energy Advertiser/Broadcaster/Beacon
+by hacking an nRF24L01(+) module (which is under $1 per unit on eBay).
 
-Note: It works also with the older nRF24L01 modules (without the +).
+Note: It works with both nRF24L01 and nRF24L01+ modules.
 
 In this project we broadcast temperature readings measured by a DS1820 chip.
 (You can easily modify the code to broadcast some other custom data.
@@ -38,46 +38,56 @@
 SPI         spi(p11, p12, p13);     // MOSI, MISO, SCK
 DigitalOut  cs(p8);                 // CSN  (select SPI chip/slave)
 DigitalOut  ce(p14);                // CE   (enable nRF24L01+ chip)
-DS1820      ds1820(p15);
+DS1820      ds1820(p15);            // creates a ds1820 sensor
 #elif defined(TARGET_FRDM_KL25Z)
 SPI         spi(PTD2, PTD3, PTD1);  // MOSI, MISO, SCK
 DigitalOut  cs(PTD0);               // CSN  (select SPI chip/slave)
 DigitalOut  ce(PTD5);               // CE   (enable nRF24L01+ chip)
-DS1820      ds1820(PTA13);
+DS1820      ds1820(PTA13);          // creates a ds1820 sensor
 #elif defined(TARGET_FRDM_KL46Z)
 SPI         spi(PTD2, PTD3, PTD1);  // MOSI, MISO, SCK
 DigitalOut  cs(PTD0);               // CSN  (select SPI chip/slave)
 DigitalOut  ce(PTD5);               // CE   (enable nRF24L01+ chip)
-DS1820      ds1820(PTA13);
+DS1820      ds1820(PTA13);          // creates a ds1820 sensor
 #elif defined(TARGET_LPC11U24)
 SPI         spi(P16, P15, P13);     // MOSI, MISO, SCK
 DigitalOut  cs(P17);                // CSN  (select SPI chip/slave)
 DigitalOut  ce(P18);                // CE   (enable nRF24L01+ chip)
-DS1820      ds1820(P10);
+DS1820      ds1820(P10);            // creates a ds1820 sensor
+#elif defined(TARGET_NUCLEO_F030R8)
+SPI         spi(PB_5, PB_4, PB_3);  // MOSI, MISO, SCK
+DigitalOut  cs(PB_10);              // CSN  (select SPI chip/slave)
+DigitalOut  ce(PA_8);               // CE   (enable nRF24L01+ chip)
+DS1820      ds1820(PA_9);           // creates a ds1820 sensor
+#elif defined(TARGET_NUCLEO_F072RB)
+SPI         spi(PB_5, PB_4, PB_3);  // MOSI, MISO, SCK
+DigitalOut  cs(PB_10);              // CSN  (select SPI chip/slave)
+DigitalOut  ce(PA_8);               // CE   (enable nRF24L01+ chip)
+DS1820      ds1820(PA_9);           // creates a ds1820 sensor
 #elif defined(TARGET_NUCLEO_F103RB)
 SPI         spi(PB_5, PB_4, PB_3);  // MOSI, MISO, SCK
 DigitalOut  cs(PB_10);              // CSN  (select SPI chip/slave)
 DigitalOut  ce(PA_8);               // CE   (enable nRF24L01+ chip)
-DS1820      ds1820(PA_9);
+DS1820      ds1820(PA_9);           // creates a ds1820 sensor
 #elif defined(TARGET_NUCLEO_F401RE)
 SPI         spi(PB_5, PB_4, PB_3);  // MOSI, MISO, SCK
 DigitalOut  cs(PB_10);              // CSN  (select SPI chip/slave)
 DigitalOut  ce(PA_8);               // CE   (enable nRF24L01+ chip)
-DS1820      ds1820(PA_9);
+DS1820      ds1820(PA_9);           // creates a ds1820 sensor
 #elif defined(TARGET_NUCLEO_F411RE)
 SPI         spi(PB_5, PB_4, PB_3);  // MOSI, MISO, SCK
 DigitalOut  cs(PB_10);              // CSN  (select SPI chip/slave)
 DigitalOut  ce(PA_8);               // CE   (enable nRF24L01+ chip)
-DS1820      ds1820(PA_9);
+DS1820      ds1820(PA_9);           // creates a ds1820 sensor
 
 // If your board/plaform is not present yet then uncomment
-// the following four lines and replace TARGET_YOUR_BOARD and CE_PIN as appropriate.
+// the following four lines and replace TARGET_YOUR_BOARD, SPI_MOSI, SPI_MISO, SPI_SCK, SPIS_CS, CE_PIN and DS1820_DATA_PIN as appropriate.
 
 //#elif defined(TARGET_YOUR_BOARD)
 //SPI         spi(SPI_MOSI, SPI_MISO, SPI_SCK);
 //DigitalOut  cs(SPI_CS);             // CSN  (select SPI chip/slave)
 //DigitalOut  cs(CE_PIN);             // CE   (enable nRF24L01+ chip)
-//DS1820      ds1820(DS1820_PIN);
+//DS1820      ds1820(DS1820_DATA_PIN);// creates a ds1820 sensor
 
 #endif
 
@@ -257,7 +267,6 @@
     spi.format(8,0);
     spi.frequency(10000000);
  
-    cs = 1;
     ce = 0;
 
     // Initialize nRF24L01+, setting general parameters
@@ -283,7 +292,12 @@
     nrfWriteBytes(buf, 5);
     buf[0] = 0x2A;          // set RX address in nRF24L01, doesn't matter because RX is ignored in this case
     nrfWriteBytes(buf, 5);
-    ds1820.begin();
+    if(!ds1820.begin()) {
+#if DEBUG        
+        serial.printf("No DS1820 sensor found!\r\n");
+#endif
+    }
+        
     
     while(1) {
         static const uint8_t    chRf[] = { 2, 26, 80 };
@@ -357,6 +371,6 @@
         wait_ms(50);    
         ce = 0;                     // (in preparation of switching to RX quickly)
         ds1820.startConversion();   // Start temperature conversion
-        wait(1);                    // Broadcasting interval (change to your needs)
+        wait(1);                    // Broadcasting interval (shall be greater than ds1820 temperture converion time)
     }
 }