background image

 

NINA-B1 series - System integration manual 

UBX-15026175 - R16 

Software

  

Page 21 of 63 

C1-Public 

 

 

 

Getting started with the Arm Mbed OS  

A list of prerequisites for  getting started with Arm Mbed OS 5 development on EVK-NINA-B1 is 
available at 

https://github.com/ARMmbed/mbed-os-example-ble#getting-started

. 

Mbed CLI is the name of the Arm Mbed command line tool, which enables the full Mbed workflow, such 
as repositories version control, maintaining dependencies, updating from remotely hosted 
repositories (GitHub, GitLab and mbed.org), and invoking Arm Mbed's own build system. The 
document  describes the installation and usage of the Mbed CLI and is available at 

https://github.com/ARMmbed/mbed-cli#introduction

.  

For information describing how to create a build target for EVK-NINA-B1, see section 2.2.3.2.3. 

Bluetooth low energy examples from Arm Mbed are available at 

https://github.com/ARMmbed/mbed-

os-example-ble

. 

 

Create a custom target for Arm Mbed 

2.2.3.2.1

 

Add target 

Add a new JSON object to the 

targets.json

 

file located in the 

\mbed-os\targets\

 folder. Figure 8 

shows an example of the JSON object for EVK-NINA-B1. A list of the properties known to the Arm 
Mbed build system are described in the Standard properties section in reference [5]. 

 

The given folder location 

\mbed-os\targets\

 is standard in Arm Mbed OS release 5.6. 

 

Figure 8: Example of EVK-NINA-B1 target object 

 

 

"EVK_NINA_B1": { 

    "supported_form_factors": ["ARDUINO"], 

    "inherits": ["MCU_NRF52"], 

    "macros_add": [ 

        "BOARD_PCA10040", 

        "NRF52_PAN_12", 

        "NRF52_PAN_15", 

        "NRF52_PAN_58", 

        "NRF52_PAN_55", 

        "NRF52_PAN_54", 

        "NRF52_PAN_31", 

        "NRF52_PAN_30", 

        "NRF52_PAN_51", 

        "NRF52_PAN_36", 

        "NRF52_PAN_53", 

        "S132", 

        "CONFIG_GPIO_AS_PINRESET", 

        "BLE_STACK_SUPPORT_REQD", 

        "SWI_DISABLE0", 

        "NRF52_PAN_20", 

        "NRF52_PAN_64", 

        "NRF52_PAN_62", 

        "NRF52_PAN_63"], 

    "device_has": [ 

        "ANALOGIN", 

        "ERROR_PATTERN",  

        "I2C",  

        "I2C_ASYNCH", 

        "INTERRUPTIN", 

        "LOWPOWERTIMER", 

        "PORTIN", 

        "PORTINOUT", 

        "PORTOUT",  

        "PWMOUT", 

        "RTC", 

        "SERIAL", 

        "SERIAL_ASYNCH", 

        "SLEEP", 

        "SPI", 

        "SPI_ASYNCH", 

        "SPISLAVE"], 

    "release_versions": ["2", "5"] 
}  

Summary of Contents for NINA-B1 Series

Page 1: ...n of NINA B1 series stand alone Bluetooth low energy modules With embedded Bluetooth low energy stack and u connectXpress software these modules are tailored for OEMs who wish to have the shortest tim...

Page 2: ...nal product specification This document applies to the following products Product name Document status NINA B111 Production information NINA B112 Production information For information about the relat...

Page 3: ...eset 10 1 5 2 Internal temperature sensor 10 1 6 Debug Serial Wire Debug SWD 10 1 7 Serial interfaces 10 1 7 1 Universal Asynchronous Serial Interface UART 10 1 7 2 Serial Peripheral Interface SPI 11...

Page 4: ...Battery protection 43 3 7 General High Speed layout guidelines 43 3 7 1 General considerations for schematic design and PCB floor planning 43 3 7 2 Module placement 43 3 7 3 Layout and manufacturing...

Page 5: ...D 1 Upgrading the boot loader 58 D 1 1 Using s center 58 D 1 2 Using the nrfutil utility from the command prompt 59 D 1 3 Using an embedded MCU 59 D 2 Upgrading the application SW 60 D 2 1 Using s cen...

Page 6: ...With 512 kB flash and 64 kB RAM it offers the best in class capacity for customer applications running on top of the Bluetooth low energy stack using the Software Development Kit SDK from Nordic Semi...

Page 7: ...NINA B1 series System integration manual UBX 15026175 R16 System description Page 7 of 63 C1 Public 1 2 Product features Table 1 NINA B1 series main features summary...

Page 8: ...B1 See also section 2 u connectXpress comes with separate mesh software and is available for download from the NINA B1 product page on the u blox website 1 3 Pin configuration and function See the NI...

Page 9: ...as higher value than the operating supply voltage of the NINA B1 series modules The use of an SMPS provides the best power efficiency for the overall application and minimizes current drawn from the m...

Page 10: ...n CPU based application the available interfaces and pin mapping can differ NINA B1 pin configurations and module functions are described in the data sheet 2 1 7 1 Universal Asynchronous Serial Interf...

Page 11: ...eeds The interface uses SCL to clock instructions and SDA to clock data External pull up resistors are required for the I2C interface The value of the resistors depends on the speed and capacitance of...

Page 12: ...aximum source impedance It supports 8 10 12 bit resolution Any of the 8 analog inputs can be used as single ended inputs and differential pairs to measure the input voltage The ADC supports the full 0...

Page 13: ...al performance The enclosure shields components and surrounding environment impact the return loss seen at the antenna port Matching components are often required to re tune the antenna to bring the r...

Page 14: ...56 MHz NFC tag at a bit rate of 106 kbps As an NFC tag data can be read from or written to NINA B1 using an NFC reader however NINA B1 modules are not capable of reading other tags or initiating NFC...

Page 15: ...ctXpress software 2 1 1 Standard edition NINA B1 series modules are delivered with pre flashed u connectXpress software The u connectXpress software enables the use of Bluetooth Low Energy functions t...

Page 16: ...low energy nRF5 SDK Download and extract the latest nRF5 SDK to the directory you want to use with the nRF5 SDK 4 Read the available SDK release notes and nRF5 Software Development Kit documentation f...

Page 17: ...IST LED_1 LED_2 define BSP_LED_0 LED_1 define BSP_LED_1 LED_2 define LEDS_INV_MASK LEDS_MASK define BUTTONS_NUMBER 2 define BUTTON_1 16 SW1 define BUTTON_2 30 SW2 define BUTTON_PULL NRF_GPIO_PIN_PULLU...

Page 18: ...ts from the same Segger Studio project Use the following procedure to build from both your custom board and EVK NINA B1 and run your code on both a u blox EVK and your custom board 1 Add a build confi...

Page 19: ...he NINA B1 module To get started with Zephyr 1 Install the Toolchain Manager from the nRF Connect for Desktop application and from there install the nRF Connect SDK For more information see the nRF Co...

Page 20: ...can be included in your local documentation The files are in reStructuredText format For information on how to generate HTML or PDF output from these files refer to the Zephyr Project documentation 18...

Page 21: ...re available at https github com ARMmbed mbed os example ble Create a custom target for Arm Mbed 2 2 3 2 1 Add target Add a new JSON object to the targets json file located in the mbed os targets fold...

Page 22: ...clares and defines a couple of enumerations to configure the custom pin mapping Figure 6 and Figure 7 show the contents of the PinNames h file in the case of EVK NINA B1 Figure 10 Example code of PinN...

Page 23: ...9 p10 EVK NINA B1 board LED1 NINA_B1_GPIO_1 Red LED2 NINA_B1_GPIO_7 Green SW1 LED3 NINA_B1_GPIO_8 Blue LED4 NC SW1 NINA_B1_GPIO_7 SW2 NINA_B1_GPIO_18 D0 NINA_B1_GPIO_23 D1 NINA_B1_GPIO_22 D2 NINA_B1_G...

Page 24: ...t reading the Bluetooth device address see also chapter 2 3 2 2 for additional information The MAC address is programmed in the CUSTOMER 0 and CUSTOMER 1 registers in the UICR region of the nRF52832 c...

Page 25: ...re v1 0 0 can be flashed using the SWD interface only and not the UART interface See section 2 3 2 for flashing instructions The u connectXpress software uses an updated flashing protocol from version...

Page 26: ...0 0 and above requires s center software version 4 2 0 or later To flash the module with s center 1 Select Tools Software Update 2 Select the json file 3 Set the correct COM port ensure that the Norma...

Page 27: ...onnect to the module using Tera Term and set the serial settings as shown in Figure 13 Figure 13 Screenshot that shows serial settings 2 Start the bootloader mode using either AT command AT UFWUPD 1 1...

Page 28: ...3 C1 Public Figure 15 Screenshot showing file the transfer mode 4 When the bootloader displays ccc as shown in Figure 15 it is ready to receive the SoftDevice bin file Send the file using XMODEM proto...

Page 29: ...ntegration manual UBX 15026175 R16 Software Page 29 of 63 C1 Public Figure 17 Screenshot shown during file transfer An OK response indicates a successful file transfer Figure 18 Screenshot shown on su...

Page 30: ...of SoftDevice information from the json configuration file An OK response indicates a successfully flashed SoftDevice Figure 20 Screenshot shown on successful verification of the transferred file Fla...

Page 31: ...age 31 of 63 C1 Public Figure 22 File transfer mode 2 When the bootloader displays ccc as shown in Figure 22 it is ready to receive the application bin file Send the file using XMODEM protocol Figure...

Page 32: ...igure 24 Screenshot shown during file transfer An OK response indicates a successful file transfer Figure 25 Screenshot shown on successful file transfer The application software does not require veri...

Page 33: ...top Programmer or other Nordic tools such as the nrfjprog command line utility or J Flash from the Segger J Link Suite The external debugger SEGGER J Link BASE has been verified to work with NINA B1 m...

Page 34: ...MAC address Reading the Bluetooth device address Flashing the software will erase the Bluetooth device address which must be manually rewritten to the module after flashing Ensure that you make a not...

Page 35: ...address to the flash memory of the device and reset the device execute the following commands Bluetooth device address is marked in bold below replace with your own AT UPRODPW 1 D4CA6EB00613 OK AT CPW...

Page 36: ...ins High speed interfaces can be a source of radiated noise and can affect compliance with regulatory standards for radiated emissions Follow the recommendations provided in sections 3 5 1 and 2 4 2 f...

Page 37: ...planes separated by dielectric material Figure 27 Transmission line trace design To properly design a 50 transmission line the following remarks should be taken into account The designer should provi...

Page 38: ...decision as the RF compliance of the device integrating NINA B1 module with all the applicable required certification schemes heavily depends on the radiating performance of the antennas The designer...

Page 39: ...antenna RF connection matches the 50 characteristic impedance of the ANT pin The impedance of the antenna termination must match as much as possible the 50 nominal impedance of the ANT pin over the o...

Page 40: ...oaxial cable may be relatively fragile compared to other types of cables To increase application ruggedness connect U FL connector to a more robust connector such as SMA fixed on panel A de facto stan...

Page 41: ...acturer for the design in guidelines and plan the validation activities on the final prototypes like tuning matching and performance measures see Table 7 RF section may be affected by noise sources li...

Page 42: ...flow control with RTS CTS to prevent temporary UART buffer overrun If CTS is 1 then the Host Host Controller is allowed to send If CTS is 0 then the Host Host Controller is not allowed to send 3 5 2 S...

Page 43: ...or layout One exception is represented by High Impedance traces such as signals driven by weak pull resistors that may be affected by crosstalk For those traces a supplementary isolation of 4w from ot...

Page 44: ...uld be referenced to the ground plane In this case if the designer needs to change the ground reference an adequate number of GND vias must be added in the area of transition to provide a low impedanc...

Page 45: ...on as defined by ETSI EN 301 489 1 Applicability of ESD immunity test to the related device ports or the related interconnecting cables to auxiliary equipment depends on device accessible interfaces a...

Page 46: ...ND and PCB GND Before mounting an antenna patch connect ground of the device When handling the RF pin do not come into contact with any charged capacitors and be careful when contacting materials that...

Page 47: ...ering cycles 1 Table 10 Recommended reflow profile Figure 31 Reflow profile Lower value of TP and slower ramp down rate 2 3 C sec is preferred After reflow soldering optical inspection of the modules...

Page 48: ...ed for boards populated with the modules Miniature Wave Selective Solder process is preferred over traditional wave soldering process Hand soldering is not recommended Rework is not recommended Confor...

Page 49: ...NA B1 series System integration manual UBX 15026175 R16 Qualifications and approvals Page 49 of 63 C1 Public 5 Qualifications and approvals For regulatory information see the NINA B1 series datasheet...

Page 50: ...ess programming Measurement of currents Functional tests Digital I O tests Measurement of RF characteristics in all supported bands such as receiver sensitivity transmitter power levels and so on Figu...

Page 51: ...s test can be performed after establishing a connection with an external device A very simple test can be performed by just scanning for a known Bluetooth low energy device and checking the signal lev...

Page 52: ...Circuit JSON JavaScript Object Notation LDO Low Drop Out LED Light Emitting Diode MAC Media Access Control MSL Moisture Sensitivity Level NSMD Non Solder Mask Defined PCB Printed Circuit Board RF Rad...

Page 53: ...idated parts for antenna matching PCB layout must be identical to the one provided by u blox please implement one of the reference designs included in this section or contact u blox The designer must...

Page 54: ...a solid GND inner layer under and around the RF components vias and small openings are allowed 4 RF trace Antenna coplanar microstrip matched to 50 5 GND trace Green Minimum required top layer GND tra...

Page 55: ...quired around the RF trace and pins GND stitching vias should be used around the RF trace to ensure a proper GND connection No other components are allowed within this area The solid GND layer beneath...

Page 56: ...t Read block 3 128 blockCnt block 0 1 block 1 blockCnt block 2 byte 255 blockCnt ushort crc xmodemCalcrc block 3 128 block 131 Byte crc 8 0xFF block 132 Byte crc 0xFF try this Write block 0 block Leng...

Page 57: ...yte data buffer in the xmodem block count number of data bytes offset where to start the calculation private ushort xmodemCalcrc byte buffer int offset int count ushort crc i int j crc 0 for j offset...

Page 58: ...te requires flow control on the UART D 1 Upgrading the boot loader D 1 1 Using s center The flashing protocol is implemented in the bootloader When upgrading the u connectXpress software from version...

Page 59: ...nd AT UFWUPD 0 115200 2 To enter bootloader mode close the UART port and run nrfutil 4 C Program Files u blox s center nrfutil exe dfu serial pkg C NINA B1 Firmware NINA B11X_4 0 0 NINA B11X_4 0 0 NIN...

Page 60: ...shed as in section 2 3 1 1 D 2 2 Using an embedded MCU The bootloader included in the u connectXpress software version 4 0 0 or later supports the XMODEM protocol The XMODEM protocol uses the standard...

Page 61: ...nic devices from electrostatic phenomena General requirements 10 ETSI EN 60950 1 2006 Information technology equipment Safety Part 1 General requirements 11 FCC Regulatory Information Title 47 Telecom...

Page 62: ...document based on the latest brand guidelines of Arm Mbed R10 24 Apr 2018 apet kgom Added new software version 4 0 0 new ordering codes type numbers in the table on page 2 Updated Table 1 with new fe...

Page 63: ...com Regional Office China Beijing Phone 86 10 68 133 545 E mail info_cn u blox com Support support_cn u blox com Regional Office China Chongqing Phone 86 23 6815 1588 E mail info_cn u blox com Suppor...

Reviews: