hires.h

Go to the documentation of this file.

/* Copyright 2015, Peter A. Bigot
 *
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are met:
 *
 * * Redistributions of source code must retain the above copyright notice,
 *   this list of conditions and the following disclaimer.
 *
 * * Redistributions in binary form must reproduce the above copyright notice,
 *   this list of conditions and the following disclaimer in the documentation
 *   and/or other materials provided with the distribution.
 *
 * * Neither the name of the software nor the names of its contributors may be
 *   used to endorse or promote products derived from this software without
 *   specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 * POSSIBILITY OF SUCH DAMAGE.
 */

#ifndef BSPACM_DEVICE_NRF51_INTERNAL_UTILITY_HIRES_H
#define BSPACM_DEVICE_NRF51_INTERNAL_UTILITY_HIRES_H

#include <bspacm/core.h>

#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */

#ifndef BSPACM_HIRES_TIMER_BASE

#define BSPACM_HIRES_TIMER_BASE NRF_TIMER1_BASE
#endif /* BSPACM_HIRES_TIMER_BASE */

#if NRF_TIMER0_BASE == BSPACM_HIRES_TIMER_BASE
#define BSPACM_HIRES_TIMER NRF_TIMER0
#elif NRF_TIMER1_BASE == BSPACM_HIRES_TIMER_BASE
#define BSPACM_HIRES_TIMER NRF_TIMER1
#elif NRF_TIMER2_BASE == BSPACM_HIRES_TIMER_BASE
#define BSPACM_HIRES_TIMER NRF_TIMER2
#else  /* BSPACM_HIRES_TIMER_BASE */
#error Unrecognized high-resolution timer
#endif /* BSPACM_HIRES_TIMER_BASE */

int
iBSPACMhiresInitialize (unsigned int freq_Hz);

bool
bBSPACMhiresEnabled (void);

int
iBSPACMhiresSetEnabled (bool enabled);

inline
unsigned int
uiBSPACMhires (void)
{
  BSPACM_HIRES_TIMER->TASKS_CAPTURE[0] = 1;
  return BSPACM_HIRES_TIMER->CC[0];
}

inline
unsigned int
uiBSPACMhiresConvert_hfclk_hrt (unsigned int dur_hfclk)
{
  return dur_hfclk >> BSPACM_HIRES_TIMER->PRESCALER;
}

inline
unsigned int
uiBSPACMhiresConvert_hrt_hfclk (unsigned int dur_hrt)
{
  return dur_hrt << BSPACM_HIRES_TIMER->PRESCALER;
}

inline
unsigned int
uiBSPACMhiresConvert_us_hfclk (unsigned int dur_us)
{
  return dur_us << 4;
}

inline
unsigned int
uiBSPACMhiresConvert_us_hrt (unsigned int dur_us)
{
  int shift = 4 - (int)BSPACM_HIRES_TIMER->PRESCALER;
  if (0 < shift) {
    return dur_us << shift;
  }
  return dur_us >> -shift;
}

inline
unsigned int
uiBSPACMhiresConvert_hrt_us (unsigned int dur_hrt)
{
  int shift = 4 - (int)BSPACM_HIRES_TIMER->PRESCALER;
  if (0 < shift) {
    return dur_hrt >> shift;
  }
  return dur_hrt << -shift;
}

void
vBSPACMhiresSleep_us (unsigned long count_us);

inline void
vBSPACMhiresSleep_ms (unsigned long count_ms)
{
  vBSPACMhiresSleep_us(1000 * count_ms);
}

#ifdef __cplusplus
}
#endif /* __cplusplus */

#endif /* BSPACM_DEVICE_NRF51_INTERNAL_UTILITY_HIRES_H */