resets.h

Go to the documentation of this file.

/*
 * Copyright (c) 2020 Raspberry Pi (Trading) Ltd.
 *
 * SPDX-License-Identifier: BSD-3-Clause
 */
 
#ifndef _HARDWARE_RESETS_H
#define _HARDWARE_RESETS_H
 
#include "pico.h"
#include "hardware/structs/resets.h"

 
// PICO_CONFIG: PARAM_ASSERTIONS_ENABLED_HARDWARE_RESETS, Enable/disable assertions in the hardware_resets module, type=bool, default=0, group=hardware_adc
#ifndef PARAM_ASSERTIONS_ENABLED_HARDWARE_RESETS
#ifdef PARAM_ASSERTIONS_ENABLED_RESET // backwards compatibility with SDK < 2.0.0
#define PARAM_ASSERTIONS_ENABLED_HARDWARE_RESETS PARAM_ASSERTIONS_ENABLED_RESET
#else
#define PARAM_ASSERTIONS_ENABLED_HARDWARE_RESETS 0
#endif
#endif
#ifdef __cplusplus
extern "C" {
#endif
 
static_assert(RESET_COUNT == NUM_RESETS, "");
 
static __force_inline  void reset_block_reg_mask(io_rw_32 *reset, uint32_t mask) {
    hw_set_bits(reset, mask);
}
 
static __force_inline  void unreset_block_reg_mask(io_rw_32 *reset, uint32_t mask) {
    hw_clear_bits(reset, mask);
}
 
static __force_inline void unreset_block_reg_mask_wait_blocking(io_rw_32 *reset, io_ro_32 *reset_done, uint32_t mask) {
    hw_clear_bits(reset, mask);
    while (~*reset_done & mask)
        tight_loop_contents();
}


static __force_inline void reset_block_mask(uint32_t bits) {
    reset_block_reg_mask(&resets_hw->reset, bits);
}

static __force_inline void unreset_block_mask(uint32_t bits) {
    unreset_block_reg_mask(&resets_hw->reset, bits);
}

static __force_inline void unreset_block_mask_wait_blocking(uint32_t bits) {
    unreset_block_reg_mask_wait_blocking(&resets_hw->reset, &resets_hw->reset_done, bits);
}

 
#ifndef HARDWARE_RESETS_ENABLE_SDK1XX_COMPATIBILITY
#define HARDWARE_RESETS_ENABLE_SDK1XX_COMPATIBILITY 1
#endif
 
#if HARDWARE_RESETS_ENABLE_SDK1XX_COMPATIBILITY
static __force_inline void reset_block(uint32_t bits) {
    reset_block_mask(bits);
}
 
static __force_inline void unreset_block(uint32_t bits) {
    unreset_block_mask(bits);
}
 
static __force_inline void unreset_block_wait(uint32_t bits) {
    return unreset_block_mask_wait_blocking(bits);
}
#endif

static inline void reset_block_num(reset_num_t block_num) {
    invalid_params_if(HARDWARE_RESETS, block_num >= RESET_COUNT);
    reset_block_reg_mask(&resets_hw->reset, 1u << block_num);
}

static inline void unreset_block_num(reset_num_t block_num) {
    invalid_params_if(HARDWARE_RESETS, block_num >= RESET_COUNT);
    unreset_block_reg_mask(&resets_hw->reset, 1u << block_num);
}

static inline void unreset_block_num_wait_blocking(reset_num_t block_num) {
    invalid_params_if(HARDWARE_RESETS, block_num >= RESET_COUNT);
    unreset_block_reg_mask_wait_blocking(&resets_hw->reset, &resets_hw->reset_done, 1u << block_num);
}

static inline void reset_unreset_block_num_wait_blocking(reset_num_t block_num) {
    invalid_params_if(HARDWARE_RESETS, block_num >= RESET_COUNT);
    reset_block_reg_mask(&resets_hw->reset, 1u << block_num);
    unreset_block_reg_mask_wait_blocking(&resets_hw->reset, &resets_hw->reset_done, 1u << block_num);
}
 
#ifdef __cplusplus
}
#endif
#endif