/** * Copyright (c) 2015 - 2018, Nordic Semiconductor ASA * * All rights reserved. * * Redistribution and use in source and binary forms, with or without modification, * are permitted provided that the following conditions are met: * * 1. Redistributions of source code must retain the above copyright notice, this * list of conditions and the following disclaimer. * * 2. Redistributions in binary form, except as embedded into a Nordic * Semiconductor ASA integrated circuit in a product or a software update for * such product, 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. * * 3. Neither the name of Nordic Semiconductor ASA nor the names of its * contributors may be used to endorse or promote products derived from this * software without specific prior written permission. * * 4. This software, with or without modification, must only be used with a * Nordic Semiconductor ASA integrated circuit. * * 5. Any software provided in binary form under this license must not be reverse * engineered, decompiled, modified and/or disassembled. * * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA 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 ANT_BSC_UTILS_H__ #define ANT_BSC_UTILS_H__ #include "nrf.h" #ifdef __cplusplus extern "C" { #endif /** @file * * @defgroup ant_sdk_profiles_bsc_utils Bicycle Speed and Cadence profile utilities * @{ * @ingroup ant_bsc * @brief This module implements utilities for the Bicycle Speed and Cadence profile. * */ /**@brief Unit for BSC operating time. * * @details According to the ANT BSC specification, the operating time unit is 2 seconds. */ #define ANT_BSC_OPERATING_TIME_UNIT 2u /**@brief This macro should be used to get the seconds part of the operating time. */ #define ANT_BSC_OPERATING_SECONDS(OPERATING_TIME) (((OPERATING_TIME) * ANT_BSC_OPERATING_TIME_UNIT) % 60) /**@brief This macro should be used to get the minutes part of the operating time. */ #define ANT_BSC_OPERATING_MINUTES(OPERATING_TIME) ((((OPERATING_TIME) * ANT_BSC_OPERATING_TIME_UNIT) / 60) % 60) /**@brief This macro should be used to get the hours part of the operating time. */ #define ANT_BSC_OPERATING_HOURS(OPERATING_TIME) ((((OPERATING_TIME) * ANT_BSC_OPERATING_TIME_UNIT) / (60 * 60)) % 24) /**@brief This macro should be used to get the days part of the operating time. */ #define ANT_BSC_OPERATING_DAYS(OPERATING_TIME) ((((OPERATING_TIME) * ANT_BSC_OPERATING_TIME_UNIT) / (60 * 60)) / 24) /**@brief Number of Bicycle Speed or Cadence event time counts per second. * * @details According to the ANT BSC specification, the speed or cadence event time unit is 1/1024 of a second. */ #define ANT_BSC_EVENT_TIME_COUNTS_PER_SEC 1024u /**@brief BSC event time display required precision. * * @details This value is used to decode the number of milliseconds. */ #define ANT_BSC_EVENT_TIME_PRECISION 1000u /**@brief This macro should be used to get the seconds part of the BSC event time. */ #define ANT_BSC_EVENT_TIME_SEC(EVENT_TIME) ((EVENT_TIME) / ANT_BSC_EVENT_TIME_COUNTS_PER_SEC) /**@brief This macro should be used to get the milliseconds part of the BSC event time. */ #define ANT_BSC_EVENT_TIME_MSEC(EVENT_TIME) (((((EVENT_TIME) % ANT_BSC_EVENT_TIME_COUNTS_PER_SEC) * ANT_BSC_EVENT_TIME_PRECISION) \ + ANT_BSC_EVENT_TIME_COUNTS_PER_SEC / 2) \ / ANT_BSC_EVENT_TIME_COUNTS_PER_SEC) /**@brief Battery voltage display required precision. * * @details This value is used to decode the number of mV. */ #define ANT_BSC_BAT_VOLTAGE_PRECISION 1000u /**@brief Bike Speed and Cadence profile, unit divisor of the fractional part of the battery voltage. * * @details According to the ANT BSC specification, the battery voltage fraction unit is (1/256) V. */ #define ANT_BSC_BAT_VOLTAGE_FRACTION_PER_VOLT 256u /**@brief This macro should be used to get the mV part of the BSC battery voltage. */ #define ANT_BSC_BAT_VOLTAGE_FRACTION_MV(VOLT_FRACT) ((((VOLT_FRACT) * ANT_BSC_BAT_VOLTAGE_PRECISION) \ + ANT_BSC_BAT_VOLTAGE_FRACTION_PER_VOLT / 2) \ / ANT_BSC_BAT_VOLTAGE_FRACTION_PER_VOLT) /** @} */ #ifdef __cplusplus } #endif #endif // ANT_BSC_UTILS_H__