| BlueNRG-1 Peripherals drivers Examples

- Main Page
- Modules
- Classes
- Files

- File List
- File Members

Macros | Functions
RTC_TimeBasePattern_main.c File Reference

This example demonstrates how to use the RTC timer for periodic interrupt generation with use of patterns. More...

`#include "BlueNRG1.h"`
`#include "BlueNRG1_conf.h"`
`#include "SDK_EVAL_Config.h"`

Go to the source code of this file.

## Macros

#define | RTC_PERIOD_1s (32767)
#define | RTC_PERIOD_100ms ((32767)/10)

## Functions

void | RTC_Configuration (void)
| RTC0 Configuration. More...
int | main (void)
| Main program code. More...

## Detailed Description

This example demonstrates how to use the RTC timer for periodic interrupt generation with use of patterns.

# ATOLLIC project

To use the project with ATOLLIC TrueSTUDIO for ARM, please follow the instructions below:

1. Open the ATOLLIC TrueSTUDIO for ARM and select File->Import... Project menu.
2. Select Existing Projects into Workspace.
3. Select the ATOLLIC project
4. Select desired configuration to build from Project->Manage Configurations
5. Select Project->Rebuild Project. This will recompile and link the entire application
6. To download the binary image, please connect STLink to JTAG connector in your board (if available).
7. Select Project->Download to download the related binary image.
8. Alternatively, open the BlueNRG1 GUI, put the board in bootloader mode and download the built binary image.

# KEIL project

To use the project with KEIL uVision 5 for ARM, please follow the instructions below:

1. Open the KEIL uVision 5 for ARM and select Project->Open Project menu.
2. Open the KEIL project `...\Project\BlueNRG1_Periph_Examples\RTC\Clockwatch\MDK-ARM\Clockwatch.uvprojx`
3. Select desired configuration to build
4. Select Project->Rebuild all target files. This will recompile and link the entire application
5. To download the binary image, please connect STLink to JTAG connector in your board (if available).
6. Select Project->Download to download the related binary image.
7. Alternatively, open the BlueNRG1 GUI, put the board in bootloader mode and download the built binary image.

# IAR project

To use the project with IAR Embedded Workbench for ARM, please follow the instructions below:

1. Open the Embedded Workbench for ARM and select File->Open->Workspace menu.
2. Open the IAR project `...\Project\BlueNRG1_Periph_Examples\RTC\Clockwatch\EWARM\Clockwatch.eww`
3. Select desired configuration to build
4. Select Project->Rebuild All. This will recompile and link the entire application
5. To download the binary image, please connect STLink to JTAG connector in your board (if available).
6. Select Project->Download and Debug to download the related binary image.
7. Alternatively, open the BlueNRG1 GUI, put the board in bootloader mode and download the built binary image.

## Project configurations

- `Release` - Release configuration

# Boards supported

- `STEVAL-IDB007V1`

# Power configuration settings

STEVAL-IDB007V1
Jumper name |  | Description
JP1 | JP2 |
ON 1-2 | ON 2-3 | USB supply power
ON 2-3 | ON 1-2 | The supply voltage must be provided through battery pins.
ON 1-2 |  | USB supply power to STM32L1, JP2 pin 2 external power to BlueNRG1

# Jumper settings

STEVAL-IDB007V1
Jumper name | Description
JP1 | 1-2: to provide power from USB (JP2:2-3). 2-3: to provide power from battery holder (JP2:1-2)
JP2 | 1-2: to provide power from battery holder (JP1:2-3). 2-3: to provide power from USB (JP1:1-2). Pin2 to VDD to provide external power supply to BlueNRG-1 (JP1: 1-2)
JP3 | pin 1 and 2 UART RX and TX of MCU. pin 3 GND.
JP4 | Fitted: to provide VBLUE to BlueNRG1. It can be used also for current measurement.
JP5 | Fitted : TEST pin to VBLUE. Not fitted: TEST pin to GND

# Pin settings

PIN name | STEVAL-IDB007V1
ADC1 | Not Used
ADC2 | Not Used
IO0 | Not Used
IO1 | Not Used
IO11 | Not Used
IO12 | Not Used
IO13 | Not Used
IO14 | Not Used
IO2 | Not Used
IO3 | Not Used
IO4 | Not Used
IO5 | Not Used
IO6 | Drive the LED DL1
IO7 | Not Used
IO8 | Not Used
TEST1 | Not Used

# LEDs description

LED name | STEVAL-IDB007V1
DL1 | Toggle
DL2 | Not Used
DL3 | Not Used
DL4 | Power

# Buttons description

BUTTON name | STEVAL-IDB007V1
PUSH1 | Not Used
PUSH2 | Not Used
RESET | Reset BlueNRG1

# Usage

The BlueNRG1 embeds a real-time counter RTC clocked by the RC32K and can still run in low-power modes. The RTC provides to the user real-time clockwatch functionality and a real-time clock timer. The RTC clockwatch consists of two counters and two alarm registers that have the following features.

Two counters:

- Counts seconds, minutes, hours, days of the week, days of the month.
- Counts years.

Two alarm registers:

- Can be used to trigger an interrupt or device wake-up at an exact date and time.

The RTC timer is a 32-bit free-running counter, clocked by the 32 kHz clock signal (from an embedded 32 kHz RC), that could work in periodic or single shot mode.

In this example, the periodic mode is used together with a pattern configuration. The RTC is configured in the periodic timer mode and the load value to registers RTC_TLR1 and RTC_TLR2 value is set. The RTC_TLR1 is set to generate time period of 1s, the RTC_TLR2 is set to generate time period of 100ms. Then the RTC is enabled. Each time the RTC timer reach value 0x00 it generates an interrupt and the timer value is automatically re-loaded from register RTC_TLR1 or RTC_TLR2 register depending on the pattern register setting.

The pattern size is set to 8 bits and the pattern is set to 0b11110010. This means that the RTC generates 4 periods defined by RTC_TLR1 value followed by 2 periods defined by RTC_TLR2, 1 periods defined by RTC_TLR1 and 1 periods defined by RTC_TLR2. Once the pattern is finished it is repeated again.

Within the RTC interrupt routine the LED DL1 (IO6) is toggled.

Definition in file RTC_TimeBasePattern_main.c.