BLE-Smart-LED-application-nRF52

Let’s face it…

One of the hardest things when working with BLE is simply getting started.

Whether it’s the setup of the IDE, the configuration of the project, or the implementation the BLE application.

I’ve been there… I’ve felt lost, not knowing where and how to start… This is especially true since I was trying to learn the technology itself (BLE) in addition to learning an SDK, platform, and IDE all at once! It just felt overwhelming and way too many things to learn at one time.

Lately, I’ve been focusing on one platform/chipset: Nordic’s nRF52. This is due to one main reason: I’ve found it to be the most developer-friendly platform out there. (It also helps that you get a FREE commercial license for a professional IDE: Segger Embedded Studio (SES)!)

There’s nothing wrong with the other platforms and chipsets, but it also helps if you stick to one platform that you feel comfortable with (at least for a given period of time, especially in the beginning of your journey in learning a technology).

Ok, enough with the rant, and let’s get into what this post is all about:

To guide you through setting up and developing the most basic BLE peripheral application: a smart BLE lightbulb application you can control from your smartphone.

In the previous blog post (The complete cross-platform nRF development tutorial), we went over how to set up the IDE of choice for developing nRF52 applications (Segger Embedded Studio) on any platform (macOS, Windows, Linux). In this post, we’ll focus on developing the BLE peripheral application, building it, debugging it, and finally testing it from a mobile phone application.

The simplest BLE Peripheral application

We’re going to build a very simple BLE lightbulb application that allows you to turn ON/OFF an LED on the nRF52840 development kit. The Peripheral application will also expose the battery level of a coin-cell battery installed in the development kit. The peripheral will notify the Central (mobile phone application in our case) when the battery level gets updated.

Keeping the example dead-simple is extremely important. You can always customize and expand your application once you’ve learned the basics.

But if you start with a complex application, you can get lost, and ultimately become frustrated before you get something working.

…which is why we’re keeping it simple in this application!

Prerequisites

To follow along with this example, you’ll need to know the basics of BLE. It does not require you to have in-depth knowledge of BLE. In fact, I recommend you do not spend too much time going through the theory and skip right into developing a BLE application and getting your hands dirty once you’ve gone through learning the basics.

If you’re looking to learn the basics, or simply need a refresher, I recommend checking out my FREE 7-day crash course on the Basics of Bluetooth Low Energy (BLE). Sign up by filling out the form in the bottom right-hand corner of the webpage:

Alternatively, you can sign up at the following link: FREE 7-day crash course on Bluetooth Low Energy (BLE).

So, what hardware & software do I need?

For this tutorial, you’ll need the following:

  • nRF52840 development kit (although any nRF5x development will work, with some modifications)
  • A PC running either Windows, Linux, or macOS (for development)
  • Segger Embedded Studio
  • nRF5 SDK (in our case, we’re using the latest SDK provided by Nordic: nRF5 SDK version 15.0.0)
  • A mobile phone
  • BLE client application running on the mobile phone (such as Nordic’s nRF Connect or LightBlue)

Getting Started

Installing the SDK

We’ve already covered how to install Segger Embedded Studio (the FREE License IDE used for nRF5x development) in a previous post. Here, we’ll focus on the steps that follow the installation.

Next, let’s download the latest nRF5 SDK (version 15.0.0) from Nordic’s website.

Once you have it downloaded, place it in a new folder. To make things easier, we’ll put it in a folder alongside the application we’ll be developing.

In my setup, I’ll be creating a new folder named “BLE Projects” which contains the SDK folder as well as another folder for the application.

Folder Structure Setup

Create a new folder to hold the SDK as well as the application (I named it “BLE Projects“):

  • Copy the SDK folder to the “BLE Projects” folder
  • [Optional] Rename the SDK folder to “nRF5_SDK_Current”. This way, if I need to migrate to a newer SDK, all I have to do is place it in that folder, and my current projects will not have to be updated (other than any changes needed for the APIs to work with the newer SDK)
  • Navigate to the folder examples/ble_peripheral/ and copy the folder ble_app_template to the BLE Projects folder
  • Copying the example application folder outside of the SDK makes it easier to keep it self-contained and independent of any changes you make to the SDK folder (such as installing a newer SDK)
  • Rename ble_app_template to another meaningful name that describes our simple application: ble_lightbulb

Now, it’s time for a little clean-up!

The example application folder contains a few unnecessary files and folders (related to other IDEs). I also find that it contains too many nested folders that make it harder to find important files. We’ll do the following:

  • Move the sdk_config.h file to the root folder of the application (located under pca10056/s140/config)
  • Move the SES Solution file (ble_app_template_pca10056_s140.emProject) along with the flash_placement.xml file to the root application folder (both of these files are located under pca10056/s140/ses).
  • You can also move the *.jlink and *.emSession files, but those are not necessary as SES will re-create them once you open the Solution.
  • Delete the ble_app_template.eww file
  • Delete the pca* folders (don’t forget to move the files listed above before you do this!)

Here is what the resulting folder looks like for me:

SES Project File Configuration

Now that we’ve got the folder structure set up, we need to update the SES project file to reflect these changes (this is something we’ll only have to do once).

First, rename the file “ble_app_template_pca10056_s140.emProject” to “”ble_lightbulb_pca10056_s140.emProject“.

Next, open the file in your text editor of choice.

Here are the modifications we’re going to make to the project file (I’ve already made all the changes and provided the full source code available for you to download if you want to skip these steps, at the end of this post):

  • Rename the Solution and Project names:

    to:
  • Replace any references to the SDK (since we copied the application folder outside the SDK).
    Replace “../../../../..” with “nRF5_SDK_current”
    E.g.:


    replaced with:

Next, open the Solution (*.emProject file) in SES.

Now, make the following changes to the Project and the source files:

  • In main.c, change the advertised name:
  • Also in main.c, add the following lines (highlighted):
  • Also, make sure you add the code to instantiate the LED Service object. This is done by calling a macro as following (macro will be defined later in led_service.h):
  • Remove any peer manager references (only needed for security features):
    • Change

      to:
    • Remove the following block of code:
    • Delete the following block:
    • Change

      to
    • Remove the highlighted line:
    • Change

      to
    • Modify the following (we are not using any buttons in our application, so we only need to initialize the LEDs):

      to
    • In main(), modify

      to
  • Change the debug print out for the main application:

    to
  • We need to add a write handler for the LED settings in main.c. This function will get used for the custom service and characteristic we’ll be implementing in our application.

BLE Lightbulb Application Design

Let’s talk about the design of our application, and what elements we need to add to implement our smart BLE-controlled lightbulb.

The application allows the user to:

  • Discover the BLE Peripheral named “BLE_Lightbulb” from a BLE Central application
  • Connect to the Peripheral and discover the Services and Characteristics exposed by the Peripheral
  • Turn ON/OFF LED2 on the nRF52840 development kit as well as read the status of the LED (whether ON or OFF)
  • Subscribe to Notifications to the Battery Level Characteristic exposed by the Peripheral inside the Battery Service

LED Service + LED 2 Characteristic

To be able to control the LED on the development kit from a BLE client (a smartphone application in our case), we’ll need to implement a custom service and characteristic for the LED.

iIn a previous post (Custom Services and Characteristics [BLE MIDI use case]), we described how to create custom services and characteristics, but here’s all you need to know:

  • We need to create one service. We’ll call it led_service.
  • In that service, we’ll add a single characteristic dedicated to LED 2 on our development kit (LED 1 will be used to indicate the state of the BLE peripheral: Advertising or Connected). Let’s call this characteristic: led_2_char.
  • For each (service and characteristic), we’ll need to choose a custom UUID (to learn more about custom/vendor-specific UUIDs and how to pick them, refer to this blog post (Creating custom UUIDs).
  • We’ll define the UUIDs as following:
    • LED Service UUID: E54B0001-67F5-479E-8711-B3B99198CE6C
    • LED 2 Characteristic UUID: E54B0002-67F5-479E-8711-B3B99198CE6C
  • The LED 2 Characteristic will have the following permissions:
    • Write-enabled
    • Read-enabled
    • NO Notifications or Indications enabled (since we’ll be controlling the LED from the BLE client)

Implementation

Instead of including the implementation of the LED service in the main.c file, we’ll be including them in a separate folder and files.

Let’s create two files: led_service.h & led_service.c.

We’ll be placing these in a separate folder named Services.

  • Create a folder named Services in the root folder of the application (from your Operating System’s file explorer)
  • Right-click on Project ‘ble_lightbulb’
  • Click New Folder
    Create new project folder SES
  • Rename New Folder to Services
  • Now you should have an empty Services folder
  • Right-click on Services and choose to Add New File
  • Choose C File (.c), and type led_service.c in the Name field
  • Under Location, click Browse and navigate to the Services folder
  • Select Services and click Choose

  • Click OK
  • Repeat the steps above but choose Header File (.h) instead and enter led_service.h in the Name field

Here are the contents of the source files. We’ll list the full source code first and then go through the content explaining it.

led_service.h

led_service.c

Let’s explain the most important elements of the implementation:

led_service.h

  • Lines 33-39: define a macro that will be used in main.c to instantiate the LED service data structure
  • Lines 41-53: define the UUIDs for the LED Service and the LED 2 Characteristic
  •  Lines 55-65: define the led write handler function prototype and the LED service initialization data structure
  • Lines 67-79: define the main LED service data structure that stores all the information relevant to the service
  • Lines 81-100: declare the functions needed for initializing the service as well as the event handler

led_service.c

  • Lines 18-23: include the necessary header files as well as define the string
  • Lines 25-44: define the functions for handling the connection and disconnection events
  • Lines 46-61: define the function for handling the BLE write event
  •  Lines 63-112: define the function for adding the LED 2 Characteristic
  • Lines 114-153: define the function used to initialize the LED Service
  • Lines 155-177: define the BLE event handler that gets called by the SoftDevice (to handle the different events such as connection, disconnection, and write events)

Battery Service

In addition to the custom Service and Characteristic, we’ll be using the Bluetooth SIG defined Battery Service, which includes a Battery Level Characteristic. (No need to create our own custom since we can reuse the SIG-defined Service).

Nordic’s SDK already has this Service implemented, so all we need to do is:

  • Enable the Battery Service in sdk_config.h. You can do so by setting the following macro to 1:
  • Add the ble_bas.c file:
    • Right-click on the folder named nRF_BLE under the Project in the Project Explorer window
    • Click on Add Existing File
    • Locate the ble_bas.c file under <SDK folder>/components/ble/ble_services/ble_bas
    • Click on ble_bas.c and hit Add
  • Update NRF_SDH_BLE_VS_UUID_COUNT in sdk_config.h to reflect the number of custom UUIDs (2 in our case: one for the LED Service and one for the LED 2 Characteristic)

Now that we have the Battery Service enabled, we need to implement the actual reading of the battery voltage level from the coin-cell battery installed in the development kit.

The good thing is we don’t have to implement this from scratch. In fact, one of the components within the nRF5 SDK provides exactly what we need!

The component we’ll be borrowing the code from is the Eddystone component (used for a beacon standard called Eddystone).

Navigate to the folder <SDK folder>/components/ble/ble_services/eddystone

There you will find the files:

es_battery_voltage.h
es_battery_voltage_saadc.c

We’ll copy these files into our project folder “ble_lightbulb” under a newly created folder named Battery Level.

Then rename them to “battery_voltage.c” and “battery_voltage.h“:

Now, you’ll need to add this folder to the Project in SES. Follow the same steps we did before with the LED Service files (creating a folder named Battery Level, but then using the Add Existing File option instead of creating a new one).

We’ll make a few slight modifications to functions names and such:

battery_voltage.h

battery_voltage.c

To be able to read the battery level, we have to set up a timer to trigger the reading of the battery voltage in the application’s main.c file.

Here are the changes we need to make to implement this functionality:

  • Define the battery timer and the battery level update period:
  • Declare two functions for handling the timeout and another for updating the battery level:

  • Next, we need to add the timer that triggers the battery level read operation. We add this to the timers_init() function:
  • Add a function to start the timer, and then call it from main()
  • Enable the SAADC (Analog to digital converter), needed for reading the battery voltage level. Open sdk_config.h and enable the SAADC in two locations:

  • Add the SAADC driver file. Right-click on “nRF_Drivers” and click on “Add Existing File“. Then navigate to “nRF5_SDK_current/modules/nrfx/drivers/src/” and select the file “nrfx_saadc.c“

Initializing the Services

Finally, we need to initialize the LED and Battery Services in the main file (main.c).

To do that, we implement the following function:

The function initializes both Services as well as defines the permissions of the Battery Service and Battery Level Characteristic.

This function already gets called from the main function main() :

Flashing and debugging

Before we build and flash our program to the development kit (nRF52840), we want to enable logging first so we can better follow the state of events and the state of our application.

To get this working:

  • Open sdk_config.h and make sure the following macros are set to the correct debug level (4). This level will enable all debug statements in the debug terminal within SES when you run your application.

Now, we can flash the application to the development kit.

To do this:

  • Right click on “Project ‘ble_lightbulb’“
  • Select “Build“
  • Right-click again on “Project ‘ble_lightbulb’“
  • Select “Debug → Start Debugging“
  • The application will start and stop at main() waiting for you to continue execution
  • You should now see the output in the debug terminal similar to the following:

Testing

Our next and final step is to test our application and make sure it’s working fine. For this, we will use a mobile phone app that acts as a BLE Central.

For this example, we’ll be using an app called LightBlue (available for iOS and Android).

Here’s a video showing the application running on the development kit:

Summary

In this post, we went over how to build a full BLE peripheral application that you can use as a starting point for developing any BLE application on the nRF52 platform. We went over:

  • Setting up the Project and Solution file for the application
  • Fully implementing a BLE application that allows you to turn ON/OFF an LED on the nRF52840 development kit
  • Building, flashing, and debugging the application on the nRF52840 development kit
  • Testing the application from a mobile phone app to make sure it is functioning correctly

To be notified when future blog posts are published here on the Novel Bits blog, be sure to enter your email address in the form below!

If you would like to download the code used in this post, please enter your email address in the form below. You’ll get a .zip containing all the source code, and I will also send you a FREE 9-page Report on the Essential Bluetooth Developer Tools. In addition to that, you will receive exclusive content, tips, and tricks that I don’t post to the blog!

Posted in BLE technology, Tutorials and tagged , , ,

40 Comments

  1. Avatar Andhika Tidar Prasetyo on October 30, 2019 at

    Hi Mohammed, thanks for the Tutorial i did all of the step but here I encounter a few Problem literely all of battery service doesn’t work
    >battery_level_meas_timeout_handler’ undecleared(first use in this function) did you mean ‘app_timer_timeout_handler_t’?
    >led_write_handler’ undeclared(first use in this function) did you mean ‘app_error_handler’?
    >’ble_bas_init_t’ {aka ‘struct ‘} has no member named ‘battery_level_char_attr_md’
    >’ble_bas_init_t’ {aka ‘struct ‘} has no member named ‘battery_level_char_attr_md’
    >’ble_bas_init_t’ {aka ‘struct ‘} has no member named ‘battery_level_char_attr_md’
    >’ble_bas_init_t’ {aka ‘struct ‘} has no member named ‘battery_level_char_attr_md’
    >’ble_bas_init_t’ {aka ‘struct ‘} has no member named ‘battery_level_char_attr_md’
    >’ble_bas_init_t’ {aka ‘struct ‘} has no member named ‘battery_level_char_attr_md’
    >’ble_bas_init_t’ {aka ‘struct ‘} has no member named ‘battery_level_report_read_perm’
    >’ble_bas_init_t’ {aka ‘struct ‘} has no member named ‘battery_level_report_read_perm’
    >err_code = ble_bas_init(&m_bas, &bas_init);
    >static void battery_level_update(void)
    { err_code = ble_bas_battery_level_update(&m_bas, battery_level, m_conn_handle);}
    >’m_bas’ undeclared (first use in this function)

    I don’t know why is still undeclared, even though I do exactly what in this post said.

    Reply
    • Mohammad Afaneh Mohammad Afaneh on October 31, 2019 at

      Hi Andhika,

      Can you check if you have the following set up?
      – ble_bas.c is included in the project
      – BLE_BAS_DEF(m_bas); is added to main.c (Looking back at my post, I may have missed including this in the steps)
      – Make sure #define BLE_BAS_ENABLED 1 is defined in the appropriate sdk_config.h

      Let me know what you find out.

      Reply
  2. Avatar chandra shekhar on October 24, 2019 at

    Hi Mohammad Afaneh,

    how can i migrate the code from nrf52840 to nrf52832.

    Thanks

    Reply
    • Mohammad Afaneh Mohammad Afaneh on October 25, 2019 at

      Hi Chandra,

      Here are the steps needed to migrate an SES project from using the nRF52840 to the nRF52832 development kit:

      1- Replace the flash_placement.xml file in your project with a copy from an example for the nRF52832 in the nRF5 SDK (e.g. examples/ble_peripheral/ble_app_blinky/pca10040/s132/ses/flash_placement.xml)

      2- Edit the SES project/solution file (*.emProject file) in a text editor of choice and make the following modifications:

      – Replace the following within the arm_target_device_name definition: nRF52840_xxAA with nRF52832_xxAA. NRF52840_XXAA with NRF52832_XXAA. S140 with S132.

      – Change c_preprocessor_definitions=”BOARD_PCA10056 to c_preprocessor_definitions=”BOARD_PCA10040

      – In the c_user_include_directories definition, replace components/softdevice/s140/headers with components/softdevice/s132/headers and components/softdevice/s140/headers/nrf52 with components/softdevice/s132/headers/nrf52

      – Replace debug_additional_load_file=”../nRF5_SDK_current/components/softdevice/s140/hex/s140_nrf52_6.1.0_softdevice.hex” with debug_additional_load_file=”../nRF5_SDK_current/components/softdevice/s132/hex/s132_nrf52_6.1.0_softdevice.hex”.

      – Replace debug_register_definition_file=”../nRF5_SDK_current/modules/nrfx/mdk/nrf52840.svd” with debug_register_definition_file=”../nRF5_SDK_current/modules/nrfx/mdk/nrf52.svd”

      – Replace
      linker_section_placement_macros=”FLASH_PH_START=0x0;FLASH_PH_SIZE=0x100000;RAM_PH_START=0x20000000;RAM_PH_SIZE=0x40000;FLASH_START=0x26000;FLASH_SIZE=0xda000;…” with linker_section_placement_macros=”FLASH_PH_START=0x0;FLASH_PH_SIZE=0x80000;RAM_PH_START=0x20000000;RAM_PH_SIZE=0x10000;FLASH_START=0x26000;FLASH_SIZE=0x5a000;…”. Make sure you do not change the portion of linker_section_placement_macros at the end which lists RAM_start and RAM_size (indicated by “…” above). Those can stay the same.

      – Replace linker_section_placements_segments=”FLASH RX 0x0 0x100000;RAM RWX 0x20000000 0x40000″ with linker_section_placements_segments=”FLASH RX 0x0 0x80000;RAM RWX 0x20000000 0x10000″

      In the file listings, change:
      – ses_startup_nrf52840.s to ses_startup_nrf52.s
      – system_nrf52840.c to system_nrf52.c

      Reply
  3. Avatar Felix Bors on September 9, 2019 at

    I can not compile this with SDK 15.3.0 and pca10040 (basically the nrf52 DK ) on ubuntu 18.04. I think modifying the emProject file is a very fragile solution which stops working as soon as you change anything in the steps you provide. It seems like a great starting point though. I needed to add
    ../ble_projects/nRF5_SDK_15… to every path inside emProject. Maybe a makefile would work better? Or maybe some kind of variables inside this emproject crap pointing to SDK and toolchain. quite frustrating

    Reply
    • Mohammad Afaneh Mohammad Afaneh on September 9, 2019 at

      Hey Felix,

      Thanks for your comment.

      Yes, I totally agree that the solution is a bit kludgy and fragile. I must admit, I haven’t spent a lot of time trying to perfect it or make it more portable across platforms and examples. Now that you mention it, what I did may have been overkill. The easiest would be to just create all of the projects from within the SDK (even though I do not like having my code inside the SDK folder). I will take a look and see if anything can be done there in terms of creating a variable that points to the SDK folder.

      Makefiles are available for all (I believe) of the nRF52 examples under the armgcc folder. The benefit of using the emProject files and SES is having access to all the features of a full-fledged IDE (though that may be controversial as well!).

      Reply
  4. Avatar Vishal on September 5, 2019 at

    Hey Mohammad,
    You missed a step in the tutorial to define an instance of the LED service in main.c.
    The following line should be in main.c:
    BLE_LED_SERVICE_DEF(m_led_service);

    Thanks for the BLE tutorials by the way, much appreciated.
    Cheers!

    Reply
    • Mohammad Afaneh Mohammad Afaneh on September 5, 2019 at

      Hey Vishal, yes you’re right! Thanks for pointing that out 🙂 I’ll make sure to add it.

      Reply
  5. Avatar Sunil on August 13, 2019 at

    I also got the same issue as Kamlesh Kushwah said.
    Please check this link : https://devzone.nordicsemi.com/f/nordic-q-a/50899/build-issue-in-ses-nrf52832
    and
    give me solution where i am stuck

    Reply
  6. Avatar sunil on August 12, 2019 at

    I have post my problem here
    please refer
    https://devzone.nordicsemi.com/f/nordic-q-a/50899/build-issue-in-ses-nrf52832

    Reply
  7. Avatar Kamlesh Kushwah on June 27, 2019 at

    Hello Mohammad,

    I am using Nordic 15.03 SDK and so many methods are changed please guide how we can solve this.
    I am also using 15.0 but it’s not working. I got SDKcommon.h error

    Reply
  8. Avatar Samid on June 13, 2019 at

    Sorry I forgot to give the output for question 2.

    Building ‘main.c’ from project ‘ble_lightbulb’ from solution ‘ble_lightbulb_pca10056_s140’ in configuration ‘Debug’
    1> Compiling ‘main.c’
    1> /Users/samid/Desktop/BLE_Projects/ble_lightbulb/ble_lightbulb/main.c:58:10: fatal error: nordic_common.h: No such file or directory
    1> compilation terminated.
    Build failed

    Reply
  9. Avatar Samid on June 13, 2019 at

    Hey Mohammad,

    Firstly thank you so much for this tutorial. I had a couple of problems though.

    1. During the steps where I had to change main.c and sdk_config.h I couldn’t by default access those files. So I made copies of those files and opened up the copies. Is this okay?

    2. While compiling the project the first time, about mid way through the project, I had an error that said nerf.h could not be found in the include statement.
    I ignored it and finished the project hoping it would get fixed, however now when I compile it says nordic_common.h could not be found. Is this related to the first question, or did I mess something up when I set up my environment.

    3. Is there an API/Documentation for the ble files, I found myself getting incredibly lost working on this project because I had no Idea where to look.

    Thank you so much for your time!

    Samid

    Reply
  10. Avatar Li on May 31, 2019 at

    Hi Mohammad:

    I follow this tutorial exactly except I replace all the nRF5_SDK_current with nRF5_SDK_15.3.0_59ac345, because I think it is more clear for myself to leave the version there. I replaced one in the config, .h file as well.

    I encountered the following errors while building the application:

    1> /Users/edisonee/Documents/Software/ble_lightbulb/main.c:196:30: error: ‘nrf_qwr_error_handler’ undeclared (first use in this function); did you mean ‘app_error_handler’?
    1> /Users/edisonee/Documents/Software/ble_lightbulb/main.c:196:30: note: each undeclared identifier is reported only once for each function it appears in
    1> /Users/edisonee/Documents/Software/ble_lightbulb/main.c:204:38: error: ‘m_led_service’ undeclared (first use in this function); did you mean ‘ble_led_service_t’?
    1> In file included from ../nRF5_SDK_15.3.0_59ac345/components/softdevice/s140/headers/ble.h:56,
    1> from /Users/edisonee/Documents/Software/ble_lightbulb/main.c:61:
    1> /Users/edisonee/Documents/Software/ble_lightbulb/main.c:211:45: error: ‘ble_bas_init_t’ {aka ‘struct ‘} has no member named ‘battery_level_char_attr_md’
    1> ../nRF5_SDK_15.3.0_59ac345/components/softdevice/s140/headers/ble_gap.h:560:64: note: in definition of macro ‘BLE_GAP_CONN_SEC_MODE_SET_OPEN’
    1> /Users/edisonee/Documents/Software/ble_lightbulb/main.c:211:45: error: ‘ble_bas_init_t’ {aka ‘struct ‘} has no member named ‘battery_level_char_attr_md’
    1> ../nRF5_SDK_15.3.0_59ac345/components/softdevice/s140/headers/ble_gap.h:560:79: note: in definition of macro ‘BLE_GAP_CONN_SEC_MODE_SET_OPEN’
    1> /Users/edisonee/Documents/Software/ble_lightbulb/main.c:212:45: error: ‘ble_bas_init_t’ {aka ‘struct ‘} has no member named ‘battery_level_char_attr_md’
    1> ../nRF5_SDK_15.3.0_59ac345/components/softdevice/s140/headers/ble_gap.h:560:64: note: in definition of macro ‘BLE_GAP_CONN_SEC_MODE_SET_OPEN’
    1> /Users/edisonee/Documents/Software/ble_lightbulb/main.c:212:45: error: ‘ble_bas_init_t’ {aka ‘struct ‘} has no member named ‘battery_level_char_attr_md’
    1> ../nRF5_SDK_15.3.0_59ac345/components/softdevice/s140/headers/ble_gap.h:560:79: note: in definition of macro ‘BLE_GAP_CONN_SEC_MODE_SET_OPEN’
    1> /Users/edisonee/Documents/Software/ble_lightbulb/main.c:213:50: error: ‘ble_bas_init_t’ {aka ‘struct ‘} has no member named ‘battery_level_char_attr_md’
    1> ../nRF5_SDK_15.3.0_59ac345/components/softdevice/s140/headers/ble_gap.h:558:64: note: in definition of macro ‘BLE_GAP_CONN_SEC_MODE_SET_NO_ACCESS’
    1> /Users/edisonee/Documents/Software/ble_lightbulb/main.c:213:50: error: ‘ble_bas_init_t’ {aka ‘struct ‘} has no member named ‘battery_level_char_attr_md’
    1> ../nRF5_SDK_15.3.0_59ac345/components/softdevice/s140/headers/ble_gap.h:558:79: note: in definition of macro ‘BLE_GAP_CONN_SEC_MODE_SET_NO_ACCESS’
    1> /Users/edisonee/Documents/Software/ble_lightbulb/main.c:215:45: error: ‘ble_bas_init_t’ {aka ‘struct ‘} has no member named ‘battery_level_report_read_perm’
    1> ../nRF5_SDK_15.3.0_59ac345/components/softdevice/s140/headers/ble_gap.h:560:64: note: in definition of macro ‘BLE_GAP_CONN_SEC_MODE_SET_OPEN’
    1> /Users/edisonee/Documents/Software/ble_lightbulb/main.c:215:45: error: ‘ble_bas_init_t’ {aka ‘struct ‘} has no member named ‘battery_level_report_read_perm’
    1> ../nRF5_SDK_15.3.0_59ac345/components/softdevice/s140/headers/ble_gap.h:560:79: note: in definition of macro ‘BLE_GAP_CONN_SEC_MODE_SET_OPEN’
    1> /Users/edisonee/Documents/Software/ble_lightbulb/main.c:222:30: error: ‘m_bas’ undeclared (first use in this function)
    1> /Users/edisonee/Documents/Software/ble_lightbulb/main.c:240:9: warning: implicit declaration of function ‘battery_level_update’; did you mean ‘ble_bas_battery_level_update’? [-Wimplicit-function-declaration]
    1> /Users/edisonee/Documents/Software/ble_lightbulb/main.c:245:13: warning: conflicting types for ‘battery_level_update’
    1> /Users/edisonee/Documents/Software/ble_lightbulb/main.c:245:13: error: static declaration of ‘battery_level_update’ follows non-static declaration
    1> /Users/edisonee/Documents/Software/ble_lightbulb/main.c:240:9: note: previous implicit declaration of ‘battery_level_update’ was here
    1> /Users/edisonee/Documents/Software/ble_lightbulb/main.c:256:46: error: ‘m_bas’ undeclared (first use in this function)

    Could you help provide any clue?

    Thank you!

    Li

    Reply
    • Avatar Sunil on August 13, 2019 at

      Hi Li,
      Did you solve your problem?
      I am getting the same problem
      Building ‘ble_lightbulb’ from solution ‘ble_lightbulb_pca10040_s132’ in configuration ‘Debug’
      1> Compiling ‘main.c’
      2> Compiling ‘ble_advertising.c’
      4> Compiling ‘ble_conn_state.c’
      3> Compiling ‘gatt_cache_manager.c’
      1> In file included from ../../../../../../components/softdevice/s132/headers/ble.h:56,
      1> from F:\1.nRF52\nRF5_SDK_current\examples\L-SPoT\ble_lightbulb\main.c:61:
      1> F:\1.nRF52\nRF5_SDK_current\examples\L-SPoT\ble_lightbulb\main.c:319:45: error: ‘ble_bas_init_t’ {aka ‘struct ‘} has no member named ‘battery_level_char_attr_md’
      1> ../../../../../../components/softdevice/s132/headers/ble_gap.h:560:64: note: in definition of macro ‘BLE_GAP_CONN_SEC_MODE_SET_OPEN’
      1> F:\1.nRF52\nRF5_SDK_current\examples\L-SPoT\ble_lightbulb\main.c:319:45: error: ‘ble_bas_init_t’ {aka ‘struct ‘} has no member named ‘battery_level_char_attr_md’
      1> ../../../../../../components/softdevice/s132/headers/ble_gap.h:560:79: note: in definition of macro ‘BLE_GAP_CONN_SEC_MODE_SET_OPEN’
      1> F:\1.nRF52\nRF5_SDK_current\examples\L-SPoT\ble_lightbulb\main.c:320:45: error: ‘ble_bas_init_t’ {aka ‘struct ‘} has no member named ‘battery_level_char_attr_md’
      1> ../../../../../../components/softdevice/s132/headers/ble_gap.h:560:64: note: in definition of macro ‘BLE_GAP_CONN_SEC_MODE_SET_OPEN’
      1> F:\1.nRF52\nRF5_SDK_current\examples\L-SPoT\ble_lightbulb\main.c:320:45: error: ‘ble_bas_init_t’ {aka ‘struct ‘} has no member named ‘battery_level_char_attr_md’
      1> ../../../../../../components/softdevice/s132/headers/ble_gap.h:560:79: note: in definition of macro ‘BLE_GAP_CONN_SEC_MODE_SET_OPEN’
      1> F:\1.nRF52\nRF5_SDK_current\examples\L-SPoT\ble_lightbulb\main.c:321:50: error: ‘ble_bas_init_t’ {aka ‘struct ‘} has no member named ‘battery_level_char_attr_md’
      1> ../../../../../../components/softdevice/s132/headers/ble_gap.h:558:64: note: in definition of macro ‘BLE_GAP_CONN_SEC_MODE_SET_NO_ACCESS’
      1> F:\1.nRF52\nRF5_SDK_current\examples\L-SPoT\ble_lightbulb\main.c:321:50: error: ‘ble_bas_init_t’ {aka ‘struct ‘} has no member named ‘battery_level_char_attr_md’
      1> ../../../../../../components/softdevice/s132/headers/ble_gap.h:558:79: note: in definition of macro ‘BLE_GAP_CONN_SEC_MODE_SET_NO_ACCESS’
      1> F:\1.nRF52\nRF5_SDK_current\examples\L-SPoT\ble_lightbulb\main.c:323:45: error: ‘ble_bas_init_t’ {aka ‘struct ‘} has no member named ‘battery_level_report_read_perm’
      1> ../../../../../../components/softdevice/s132/headers/ble_gap.h:560:64: note: in definition of macro ‘BLE_GAP_CONN_SEC_MODE_SET_OPEN’
      1> F:\1.nRF52\nRF5_SDK_current\examples\L-SPoT\ble_lightbulb\main.c:323:45: error: ‘ble_bas_init_t’ {aka ‘struct ‘} has no member named ‘battery_level_report_read_perm’
      1> ../../../../../../components/softdevice/s132/headers/ble_gap.h:560:79: note: in definition of macro ‘BLE_GAP_CONN_SEC_MODE_SET_OPEN’
      Build failed

      Reply
  11. Avatar Don B. Schwartz on May 27, 2019 at

    Great blog post, this was the most helpful article on BLE I have found (by far). I now have my basic app running, thanks so much.

    The only issues I had were:

    – there are some inconsistencies between the blog post and the downloaded source code
    – I needed to change the memory settings in the Segger Common options for the Linker

    Here is a discussion about the latter: https://devzone.nordicsemi.com/f/nordic-q-a/30790/sd_ble_uuid_vs_add-error-code-4

    Great work, thanks again!

    Cory

    Reply
    • Mohammad Afaneh Mohammad Afaneh on May 27, 2019 at

      Thanks, Cory! and thanks for providing the feedback. I’ll follow up with you to learn more about the inconsistencies to address them.

      -Mohammad

      Reply
  12. Avatar Bo Chen on November 19, 2018 at

    Hi,

    Since Nordic published the new version of SDK (15.2.0), I find a lot of problem while trying to compile the code downloaded from your link. Mainly two problems : 1) directory path error, which is may caused by the path changing of the SDK; 2) Function and structure elements name error, which is also may caused by the declaration/definition differences between the new version SDK and the old one you used. I cannot attach the bug logout here because the number of errors is too too many. Maybe the project can work before, but I really spend a lot of time on fixing the bugs, and finally give up because I can’t quiet understand what the code try to do whiling using the SDK especially with so many directory path and definition errors . I’m a new guy for using the nRF52840 kit, and really thanks for your instruction of how to start a simple BLE application. If convenient, please update the source code with new version SDK (I cannot find the old version 15.0.0 from the website), or combine the code and the SDK used for the code in one file. Thanks a lot.

    Best

    Bo

    Reply
    • Mohammad Afaneh Mohammad Afaneh on November 19, 2018 at

      Hi Bo,

      Thanks for your feedback. I’ll work on updating the examples for SDK version 15.2.0. In the meantime, you can actually download the 15.0.0 SDK at https://developer.nordicsemi.com/nRF5_SDK/nRF5_SDK_v15.x.x/
      Thanks,
      Mohammad

      Reply
      • Avatar Robert on November 22, 2018 at

        Hi Mohammad,

        I have project code ported to the current version of Nordic SDK (15.2.0). I can share it on my Github account.

        Reply
        • Mohammad Afaneh Mohammad Afaneh on November 22, 2018 at

          Thanks, Robert! That would be great!

          Reply
        • Avatar David on January 15, 2020 at

          Here is a version ported to SDK 16.0.0

          https://github.com/gooligumelec/nrf52test-led-battery

          The only code change needed was setting security for the battery service – see the commits.
          Everything else is changing references to files, adding some new required config symbols and updating memory allocation.

          Reply
          • Mohammad Afaneh Mohammad Afaneh on January 15, 2020 at

            Thanks, David!



  13. Avatar rahmat dwi putra on October 15, 2018 at

    Hi,

    Thanks for the code. I tried a few things extra in this exercise like adding LED3 and LED4 into the code. I duplicated the format to initiate the LED2 for LED3 and LED4. The code compiled however The service did not come up on the app. Is there something I did wrong? I literally just copied the format for LED 3 and LED 4.

    Thanks,
    Rahmat

    Reply
  14. Avatar Walter on August 17, 2018 at

    Modify the Project file (ble_lightbulb_pca10056_s140.emProject) to
    “ c_user_include_directories=”.;../nRF5_SDK_current/component”

    Instead of

    “ c_user_include_directories=”./;../nRF5_SDK_current/component”

    So, basically just remove the trailer “/” after the “.”. For some reason, Windows does not like it.

    Reply
  15. Avatar Walter on August 17, 2018 at

    Same problem

    Building ‘ble_lightbulb’ from solution ‘ble_lightbulb_pca10056_s140’ in configuration ‘Debug’
    1> Compiling ‘nrf_log_backend_serial.c’
    2> Compiling ‘nrf_log_backend_rtt.c’
    1> In file included from C:\BLE Projects\nRF5_SDK_current\components\libraries\experimental_log\src\nrf_log_backend_serial.c:40:0:
    1> ../nRF5_SDK_current/components/libraries/util/sdk_common.h:56:10: fatal error: sdk_config.h: No such file or directory
    1> compilation terminated.
    3> Compiling ‘nrf_log_backend_uart.c’
    2> In file included from C:\BLE Projects\nRF5_SDK_current\components\libraries\experimental_log\src\nrf_log_backend_rtt.c:40:0:
    2> ../nRF5_SDK_current/components/libraries/util/sdk_common.h:56:10: fatal error: sdk_config.h: No such file or directory
    2> compilation terminated.
    3> In file included from C:\BLE Projects\nRF5_SDK_current\components\libraries\experimental_log\src\nrf_log_backend_uart.c:40:0:
    3> ../nRF5_SDK_current/components/libraries/util/sdk_common.h:56:10: fatal error: sdk_config.h: No such file or directory
    3> compilation terminated.
    Build failed

    Reply
    • Avatar Sunil on August 12, 2019 at

      Same Problem occur

      I am using nRF5_SDK_15.3

      please give your solution.

      Reply
  16. Avatar Jawed Sayed on June 26, 2018 at

    Hi Mohammad, Thanks again.

    What you mentioned in your email is not possible because my project is exact copy of yours. So you would have see these issues before I. Anyway.. I was able to move forward and compile your project without errors.
    To solve my previous problem, I had to:
    a. create a sub-directory call “config” same level as my main.c file.
    b. move the sdk_config.h file in the new config directory.
    c. add “./config” in the emProject file.
    I have tried but I don’t know why sdk_config.h needs to be under the config directory.
    it does not work without it, even after you change all the paths (2 path). Even if you hard code the paths.
    I am okay with a config directory infact I prefer it. so i call this issue resolved.

    Now I have issues in the main.c file, linker cannot find functions. (see below) I will work on it later today
    and let you know, most probably some additional path issues in my environment.
    Do you know – when I installed the Sagger Embedded studio, do I need to set some paths in window 10?

    Thanks
    …jsayed

    — Errors ——
    1> Output/ble_itaalaLock Debug/Obj/main.o:C:\Users\jsaye\Desktop\nordic_BLE_Dev\ble_itaalaLock/main.c:140: undefined reference to ble_bas_on_ble_evt'
    1> Output/ble_itaalaLock Debug/Obj/main.o: In function     services_init’:
    1> C:\Users\jsaye\Desktop\nordic_BLE_Dev\ble_itaalaLock/main.c:292: undefined reference to ble_bas_init'
    1> Output/ble_itaalaLock Debug/Obj/main.o: In function     battery_level_update’:
    1> C:\Users\jsaye\Desktop\nordic_BLE_Dev\ble_itaalaLock/main.c:670: undefined reference to ble_bas_battery_level_update'
    1> Output/ble_itaalaLock Debug/Obj/battery_voltage.o: In function     nrf_drv_saadc_init’:
    1> C:\Users\jsaye\Desktop\nordic_BLE_Dev\ble_itaalaLock/../nRF5_SDK_current/integration/nrfx/legacy/nrf_drv_saadc.h:134: undefined reference to nrfx_saadc_init'
    1> Output/ble_itaalaLock Debug/Obj/battery_voltage.o: In function     battery_voltage_init’:
    1> C:\Users\jsaye\Desktop\nordic_BLE_Dev\ble_itaalaLock\Battery Level/battery_voltage.c:82: undefined reference to nrfx_saadc_channel_init'
    1> C:\Users\jsaye\Desktop\nordic_BLE_Dev\ble_itaalaLock\Battery Level/battery_voltage.c:85: undefined reference to     nrfx_saadc_buffer_convert’
    1> C:\Users\jsaye\Desktop\nordic_BLE_Dev\ble_itaalaLock\Battery Level/battery_voltage.c:88: undefined reference to nrfx_saadc_sample'
    1> Output/ble_itaalaLock Debug/Obj/battery_voltage.o: In function     battery_voltage_get’:
    1> C:\Users\jsaye\Desktop\nordic_BLE_Dev\ble_itaalaLock\Battery Level/battery_voltage.c:97: undefined reference to nrfx_saadc_is_busy'
    1> C:\Users\jsaye\Desktop\nordic_BLE_Dev\ble_itaalaLock\Battery Level/battery_voltage.c:99: undefined reference to     nrfx_saadc_buffer_convert’
    1> C:\Users\jsaye\Desktop\nordic_BLE_Dev\ble_itaalaLock\Battery Level/battery_voltage.c:102: undefined reference to `nrfx_saadc_sample’
    Build failed

    Reply
  17. Avatar Jawed Sayed on June 26, 2018 at

    Hi Mohammad, Thank you for your quick response.

    1. I am using nR5_SDK_15.0.0_a53641a

    2. Yes sdk_config.h file exists under the main lightbulb folder.

    Here is what I did:
    a. create a directory named nordic_BLE_Dev
    b. downloaded the SDK_15.0,0_a53641a under nordic_BLE_Dev directory
    c. renamed the SDK to nRF5_SDK_current
    d. downloaded lightblub from your code link, unzipped it and copied it under nordic_BLE_Dev
    e. As it is exact downloaded copy of your code – it has sdk_config.h under the main lightbulb directory
    .f. run the project file and got errors. I tried it again and still got same errors.

    Building ‘ble_lightbulb’ from solution ‘ble_lightbulb_pca10056_s140’ in configuration ‘Debug’
    1> Assembling ‘thumb_crt0.s’
    2> Compiling ‘nrf_log_backend_rtt.c’
    3> Compiling ‘nrf_log_backend_serial.c’
    2> In file included from C:\Users\jsaye\Desktop\nordic_BLE_Dev\nRF5_SDK_current\components\libraries\experimental_log\src\nrf_log_backend_rtt.c:40:0:
    2> ../nRF5_SDK_current/components/libraries/util/sdk_common.h:56:10: fatal error: sdk_config.h: No such file or directory
    2> compilation terminated.
    4> Compiling ‘nrf_log_backend_uart.c’
    3> In file included from C:\Users\jsaye\Desktop\nordic_BLE_Dev\nRF5_SDK_current\components\libraries\experimental_log\src\nrf_log_backend_serial.c:40:0:
    3> ../nRF5_SDK_current/components/libraries/util/sdk_common.h:56:10: fatal error: sdk_config.h: No such file or directory
    3> compilation terminated.
    4> In file included from C:\Users\jsaye\Desktop\nordic_BLE_Dev\nRF5_SDK_current\components\libraries\experimental_log\src\nrf_log_backend_uart.c:40:0:
    4> ../nRF5_SDK_current/components/libraries/util/sdk_common.h:56:10: fatal error: sdk_config.h: No such file or directory
    4> compilation terminated.
    Build failed

    Reply
    • Mohammad Afaneh Mohammad Afaneh on June 26, 2018 at

      Hi Jawed,

      The only thing I can think of is that the include path for the project does not include the root path for the project. Can you open the solution file (*.emProject file) in a text editor and check if the following exists:

      c_user_include_directories=”./

      You can also try changing it to use the full absolute path instead of the relative one. Also, make sure the file is included in the Project in SES.

      -Mohammad

      Reply
      • Avatar Carl Looper on August 17, 2018 at

        I added the following to the list of directories and the compiler was able to find the sdk_config.h file and sucessfully compile.

        c_user_include_directories = “../ble_lightbulb;

        Reply
        • Mohammad Afaneh Mohammad Afaneh on August 17, 2018 at

          Thanks, Walter and Carl.

          The issue seems to occur on Windows only. Here’s the fix: (I’ll fix this in the downloadable project as well)

          Modify the Project file (ble_lightbulb_pca10056_s140.emProject) to

          “ c_user_include_directories=”.;../nRF5_SDK_current/component”

          Instead of

          “ c_user_include_directories=”./;../nRF5_SDK_current/component”

          So, basically just remove the trailing “/” after the “.”. For some reason, Windows does not like it.

          Thanks again.

          -Mohammad

          Reply
  18. Avatar Jawed Sayed on June 25, 2018 at

    Hi Mohammad, Looks like my previous comment was removed, Any reason or so? -thx

    Reply
  19. Avatar Jawed Sayed on June 24, 2018 at

    hi Mohammad, I was excited to find your article and step-by-step tutorial as I am new to Nordic BLE.
    Unfortunately I am stuck in your “How to build the simplest nRF52 BLE Peripheral application (Lightbulb”
    use case) lesson. I downloaded your code. Created the similar environment per your lesson. But cannot
    compile your exact code. I am getting following errors and need some help….Thank you
    I did not do any modification to your code or environment setting but duplicated exactly per your lesson

    ————————————————————————————————————
    Building ‘ble_lightbulb’ from solution ‘ble_lightbulb_pca10056_s140’ in configuration ‘Debug’
    1> Compiling ‘nrf_log_backend_serial.c’
    2> Compiling ‘nrf_log_backend_rtt.c’
    1> In file included from C:\Users\jsaye\Desktop\nordic-BLE-5-Dev\nRF5_SDK_current\components\libraries\experimental_log\src\nrf_log_backend_serial.c:40:0:
    1> ../nRF5_SDK_current/components/libraries/util/sdk_common.h:56:10: fatal error: sdk_config.h: No such file or directory
    1> compilation terminated.
    3> Compiling ‘nrf_log_backend_uart.c’
    2> In file included from C:\Users\jsaye\Desktop\nordic-BLE-5-Dev\nRF5_SDK_current\components\libraries\experimental_log\src\nrf_log_backend_rtt.c:40:0:
    2> ../nRF5_SDK_current/components/libraries/util/sdk_common.h:56:10: fatal error: sdk_config.h: No such file or directory
    2> compilation terminated.
    3> In file included from C:\Users\jsaye\Desktop\nordic-BLE-5-Dev\nRF5_SDK_current\components\libraries\experimental_log\src\nrf_log_backend_uart.c:40:0:
    3> ../nRF5_SDK_current/components/libraries/util/sdk_common.h:56:10: fatal error: sdk_config.h: No such file or directory
    3> compilation terminated.
    Build failed

    Reply
    • Mohammad Afaneh Mohammad Afaneh on June 25, 2018 at

      Hi Jawed,

      Did you check if the sdk_config.h file exists in the main lightbulb folder? What SDK version are you using?

      Reply
  20. Avatar Jim on June 9, 2018 at

    Nice work, but I think you need to double check your code samples: I found several missing definitions and the source for the led_service.c file does not match the sections you split out for explanations (e.g. check for LED2 vs LED1), making me wonder if you used the wrong versions at some point.

    Likewise, you missed documenting a few steps in editing the project file,like making sure the current directory is in the include path.

    That said, I really appreciate an extensive example. Thanks.

    Reply
    • Mohammad Afaneh Mohammad Afaneh on June 10, 2018 at

      Jim, thanks for the feedback.

      I updated the listed source code to match the downloadable code — I had at some point fixed some issues (such as the LED1 vs. LED2 mismatch) in the source code but forgot to update the post to include the changes.

      I don’t see any missing definitions locally on my computer, can you tell me which ones you found missing so I could include them? Also, I didn’t have to do anything with the include path, can you list the changes you had to make to the project file?

      Thanks again!

      Reply

Leave a Comment