mbed-os
Fork of mbed-os by
Diff: targets/TARGET_ONSEMI/TARGET_NCS36510/clock.h
- Revision:
- 0:f269e3021894
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/targets/TARGET_ONSEMI/TARGET_NCS36510/clock.h Sun Oct 23 15:10:02 2016 +0000 @@ -0,0 +1,133 @@ +/** +****************************************************************************** +* @file clock.h +* @brief Header of clock hw module functions +* @internal +* @author ON Semiconductor +* $Rev: 3414 $ +* $Date: 2015-06-05 13:27:04 +0530 (Fri, 05 Jun 2015) $ +****************************************************************************** + * Copyright 2016 Semiconductor Components Industries LLC (d/b/a ON Semiconductor). + * All rights reserved. This software and/or documentation is licensed by ON Semiconductor + * under limited terms and conditions. The terms and conditions pertaining to the software + * and/or documentation are available at http://www.onsemi.com/site/pdf/ONSEMI_T&C.pdf + * (ON Semiconductor Standard Terms and Conditions of Sale, Section 8 Software) and + * if applicable the software license agreement. Do not use this software and/or + * documentation unless you have carefully read and you agree to the limited terms and + * conditions. By using this software and/or documentation, you agree to the limited + * terms and conditions. +* +* THIS SOFTWARE IS PROVIDED "AS IS". NO WARRANTIES, WHETHER EXPRESS, IMPLIED +* OR STATUTORY, INCLUDING, BUT NOT LIMITED TO, IMPLIED WARRANTIES OF +* MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE APPLY TO THIS SOFTWARE. +* ON SEMICONDUCTOR SHALL NOT, IN ANY CIRCUMSTANCES, BE LIABLE FOR SPECIAL, +* INCIDENTAL, OR CONSEQUENTIAL DAMAGES, FOR ANY REASON WHATSOEVER. +* @endinternal +* +* @ingroup clock +*/ + +#ifndef CLOCK_H_ +#define CLOCK_H_ + +/************************************************************************************************* +* * +* Header files * +* * +*************************************************************************************************/ + +#include "types.h" + +/************************************************************************************************* +* * +* Symbolic Constants * +* * +*************************************************************************************************/ + +/** Peripherals clock disable defines / + * @details + */ +#define CLOCK_TIMER0 (0x0) /**< <b> Timer 0 clock enable offset </b>*/ +#define CLOCK_TIMER1 (0x1) /**< <b> Timer 1 clock enable offset </b>: */ +#define CLOCK_TIMER2 (0x2) /**< <b> Timer 2 clock enable offset </b>: */ +#define CLOCK_PAD0_0 (0x3) /**< <b> Unused offset </b> */ +#define CLOCK_PAD0_1 (0x4) /**< <b> Unused offset </b> */ +#define CLOCK_UART1 (0x5) /**< <b> UART 1 clock enable offset </b> */ +#define CLOCK_SPI (0x6) /**< <b> SPI clock enable offset </b> */ +#define CLOCK_I2C (0x7) /**< <b> I2C clock enable offset </b> */ +#define CLOCK_UART2 (0x8) /**< <b> UART 2 clock enable offset </b> */ +#define CLOCK_SPI2 (0x9) /**< <b> Unused offset </b>: */ +#define CLOCK_WDOG (0xA) /**< <b> Watchdog clock enable offset </b> */ +#define CLOCK_PWM (0xB) /**< <b> PWM clock enable offset </b> */ +#define CLOCK_GPIO (0xC) /**< <b> GPIO clock enable offset </b> */ +#define CLOCK_I2C2 (0xD) /**< <b> Unused offset </b> */ +#define CLOCK_PAD2_1 (0xE) /**< <b> Unused offset </b> */ +#define CLOCK_RTC (0xF) /**< <b> RTC clock enable offset </b> */ +#define CLOCK_CROSSB (0x10) /**< <b> Crossbar clock enable offset </b> */ +#define CLOCK_RAND (0x11) /**< <b> Randomizer clock enable offset </b> */ +#define CLOCK_PAD3_0 (0x12) /**< <b> Unused offset </b> */ +#define CLOCK_PAD3_1 (0x13) /**< <b> Unused offset </b> */ +#define CLOCK_MACHW (0x14) /**< <b> macHw clock enable offset </b> */ +#define CLOCK_ADC (0x15) /**< <b> ADC clock enable offset </b> */ +#define CLOCK_AES (0x16) /**< <b> AES clock enable offset </b> */ +#define CLOCK_FLASH (0x17) /**< <b> Flash controller clock enable offset</b> */ +#define CLOCK_PAD4_0 (0x18) /**< <b> Unused offset </b> */ +#define CLOCK_RFANA (0x19) /**< <b> rfAna clock enable offset </b> */ +#define CLOCK_IO (0x1A) /**< <b> IO clock enable offset </b> */ +#define CLOCK_PAD5_0 (0x1B) /**< <b> Unused offset </b> */ +#define CLOCK_PAD (0x1C) /**< <b> Pad clock enable offset </b> */ +#define CLOCK_PMU (0x1D) /**< <b> Pmu clock enable offset </b> */ +#define CLOCK_DMA (0x1E) /**< <b> DMA clock enable offset </b> */ +#define CLOCK_TEST (0x1F) /**< <b> Test controller clock enable offset </b> */ + +#define CLOCK_ENABLE(a) CLOCKREG->PDIS.WORD &= ~(1 << a) +#define CLOCK_DISABLE(a) CLOCKREG->PDIS.WORD |= (uint32_t)(1 << a) + +/************************************************************************************************* +* * +* Functions * +* * +*************************************************************************************************/ + +/** Function to initialize clocks + * @details + * The function initializes clocks. + * This initialization includes: + * - Enable of external 32mHz oscillator + * - Disable of all peripheral clocks (to be turned on selectively when used later in the application) + * - Setting core frequency + */ +void fClockInit(void); + +/** Function to get peripheral clock frequency + * @details + * The function checks and returns peripheral clock frequency + * @return Peripheral clock frequency + */ +uint32_t fClockGetPeriphClockfrequency(); + +/** Function to get peripheral clock frequency + * @details + * The function checks which input clock is sourcing 32kHz clock domain. + * This domain can be either sourced by: + * - Internal 32kHz oscillator + * - External 32.768kHz oscillator + * @return 32kHz clock domain frequency + */ +uint16_t fClockGet32kClockfrequency(); + +/** Function to enable peripheral clock + * @details + * The function enables clock of peripheral indicated by parameter + * @param deviceId Peripheral ID whose clock must be enabled. + */ +void fClockEnablePeriph(uint8_t deviceId); + +/** Function to disable peripheral clock + * @details + * The function disables clock of peripheral indicated by parameter + * @param deviceId ID Peripheral whose clock must be disabled. + */ +void fClockDisablePeriph(uint8_t deviceId); + +#endif /* CLOCK_H_ */