Roy Want / Mbed OS beaconCompileReadyFork

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.

source/EventQueue/util/NordicCriticalSectionLock.h@0:ed0152b5c495, 2016-09-19 (annotated)

Committer:
roywant
Date:
Mon Sep 19 00:59:11 2016 +0000
Revision:
0:ed0152b5c495
Initial commit

Who changed what in which revision?

UserRevisionLine numberNew contents of line
roywant 0:ed0152b5c495 1 /*
roywant 0:ed0152b5c495 2 * PackageLicenseDeclared: Apache-2.0
roywant 0:ed0152b5c495 3 * Copyright (c) 2015 ARM Limited
roywant 0:ed0152b5c495 4 *
roywant 0:ed0152b5c495 5 * Licensed under the Apache License, Version 2.0 (the "License");
roywant 0:ed0152b5c495 6 * you may not use this file except in compliance with the License.
roywant 0:ed0152b5c495 7 * You may obtain a copy of the License at
roywant 0:ed0152b5c495 8 *
roywant 0:ed0152b5c495 9 * http://www.apache.org/licenses/LICENSE-2.0
roywant 0:ed0152b5c495 10 *
roywant 0:ed0152b5c495 11 * Unless required by applicable law or agreed to in writing, software
roywant 0:ed0152b5c495 12 * distributed under the License is distributed on an "AS IS" BASIS,
roywant 0:ed0152b5c495 13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
roywant 0:ed0152b5c495 14 * See the License for the specific language governing permissions and
roywant 0:ed0152b5c495 15 * limitations under the License.
roywant 0:ed0152b5c495 16 */
roywant 0:ed0152b5c495 17
roywant 0:ed0152b5c495 18 /**
roywant 0:ed0152b5c495 19 * NOTE: THIS FILE IS A WORKAROUND FOR mbed::util::CriticalSectionLock implementation
roywant 0:ed0152b5c495 20 * it should be removed as soon as https://github.com/ARMmbed/core-util/pull/50 is
roywant 0:ed0152b5c495 21 * accepted and published.
roywant 0:ed0152b5c495 22 */
roywant 0:ed0152b5c495 23
roywant 0:ed0152b5c495 24 #ifndef BLE_CLIAPP_UTIL_NORDIC_CRITICAL_SECTION_LOCK_H__
roywant 0:ed0152b5c495 25 #define BLE_CLIAPP_UTIL_NORDIC_CRITICAL_SECTION_LOCK_H__
roywant 0:ed0152b5c495 26
roywant 0:ed0152b5c495 27 #include <stdint.h>
roywant 0:ed0152b5c495 28 #include "cmsis.h"
roywant 0:ed0152b5c495 29 #include "nrf_soc.h"
roywant 0:ed0152b5c495 30 #include "nrf_sdm.h"
roywant 0:ed0152b5c495 31 #include "nrf_nvic.h"
roywant 0:ed0152b5c495 32 extern "C" {
roywant 0:ed0152b5c495 33 #include "softdevice_handler.h"
roywant 0:ed0152b5c495 34 }
roywant 0:ed0152b5c495 35 namespace util {
roywant 0:ed0152b5c495 36
roywant 0:ed0152b5c495 37 /** RAII object for disabling, then restoring, interrupt state
roywant 0:ed0152b5c495 38 * Usage:
roywant 0:ed0152b5c495 39 * @code
roywant 0:ed0152b5c495 40 *
roywant 0:ed0152b5c495 41 * void f() {
roywant 0:ed0152b5c495 42 * // some code here
roywant 0:ed0152b5c495 43 * {
roywant 0:ed0152b5c495 44 * NordicCriticalSectionLock lock;
roywant 0:ed0152b5c495 45 * // Code in this block will run with interrupts disabled
roywant 0:ed0152b5c495 46 * }
roywant 0:ed0152b5c495 47 * // interrupts will be restored to their previous state
roywant 0:ed0152b5c495 48 * }
roywant 0:ed0152b5c495 49 * @endcode
roywant 0:ed0152b5c495 50 */
roywant 0:ed0152b5c495 51 class NordicCriticalSectionLock {
roywant 0:ed0152b5c495 52 public:
roywant 0:ed0152b5c495 53
roywant 0:ed0152b5c495 54 /**
roywant 0:ed0152b5c495 55 * Start a critical section, the critical section will end when the
roywant 0:ed0152b5c495 56 * destructor is invoked.
roywant 0:ed0152b5c495 57 */
roywant 0:ed0152b5c495 58 NordicCriticalSectionLock() {
roywant 0:ed0152b5c495 59 // get the state of exceptions for the CPU
roywant 0:ed0152b5c495 60 _PRIMASK_state = __get_PRIMASK();
roywant 0:ed0152b5c495 61
roywant 0:ed0152b5c495 62 // if exceptions are not enabled, there is nothing more to do
roywant 0:ed0152b5c495 63 if(_PRIMASK_state == 1) {
roywant 0:ed0152b5c495 64 _use_softdevice_routine = false;
roywant 0:ed0152b5c495 65 } else {
roywant 0:ed0152b5c495 66 // otherwise, use soft device routine if softdevice is running or disable
roywant 0:ed0152b5c495 67 // the irq if softdevice is not running
roywant 0:ed0152b5c495 68 if(softdevice_handler_isEnabled()) {
roywant 0:ed0152b5c495 69 _use_softdevice_routine = true;
roywant 0:ed0152b5c495 70 sd_nvic_critical_region_enter(&_sd_state);
roywant 0:ed0152b5c495 71 } else {
roywant 0:ed0152b5c495 72 _use_softdevice_routine = false;
roywant 0:ed0152b5c495 73 __disable_irq();
roywant 0:ed0152b5c495 74 }
roywant 0:ed0152b5c495 75 }
roywant 0:ed0152b5c495 76 }
roywant 0:ed0152b5c495 77
roywant 0:ed0152b5c495 78 /**
roywant 0:ed0152b5c495 79 * eqnd a critical section
roywant 0:ed0152b5c495 80 */
roywant 0:ed0152b5c495 81 ~NordicCriticalSectionLock() {
roywant 0:ed0152b5c495 82 if(_use_softdevice_routine) {
roywant 0:ed0152b5c495 83 sd_nvic_critical_region_exit(_sd_state);
roywant 0:ed0152b5c495 84 } else {
roywant 0:ed0152b5c495 85 __set_PRIMASK(_PRIMASK_state);
roywant 0:ed0152b5c495 86 }
roywant 0:ed0152b5c495 87 }
roywant 0:ed0152b5c495 88
roywant 0:ed0152b5c495 89 private:
roywant 0:ed0152b5c495 90 union {
roywant 0:ed0152b5c495 91 uint32_t _PRIMASK_state;
roywant 0:ed0152b5c495 92 uint8_t _sd_state;
roywant 0:ed0152b5c495 93 };
roywant 0:ed0152b5c495 94 bool _use_softdevice_routine;
roywant 0:ed0152b5c495 95 };
roywant 0:ed0152b5c495 96
roywant 0:ed0152b5c495 97 } // namespace util
roywant 0:ed0152b5c495 98
roywant 0:ed0152b5c495 99 #endif // #ifndef BLE_CLIAPP_UTIL_NORDIC_CRITICAL_SECTION_LOCK_H__