multicore.h

Go to the documentation of this file.

/*
 * Copyright (c) 2020 Raspberry Pi (Trading) Ltd.
 *
 * SPDX-License-Identifier: BSD-3-Clause
 */
 
#ifndef _PICO_MULTICORE_H
#define _PICO_MULTICORE_H
 
#include "pico/types.h"
#include "pico/sync.h"
#include "hardware/structs/sio.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
// PICO_CONFIG: PICO_CORE1_STACK_SIZE, Stack size for core 1, min=0x100, max=0x10000, default=PICO_STACK_SIZE (0x800), group=pico_multicore
#ifndef PICO_CORE1_STACK_SIZE
#ifdef PICO_STACK_SIZE
#define PICO_CORE1_STACK_SIZE PICO_STACK_SIZE
#else
#define PICO_CORE1_STACK_SIZE 0x800
#endif
#endif
 
void multicore_reset_core1(void);
 
void multicore_launch_core1(void (*entry)(void));
 
void multicore_launch_core1_with_stack(void (*entry)(void), uint32_t *stack_bottom, size_t stack_size_bytes);
 
void multicore_launch_core1_raw(void (*entry)(void), uint32_t *sp, uint32_t vector_table);
 
static inline bool multicore_fifo_rvalid(void) {
    return !!(sio_hw->fifo_st & SIO_FIFO_ST_VLD_BITS);
}
 
static inline bool multicore_fifo_wready(void) {
    return !!(sio_hw->fifo_st & SIO_FIFO_ST_RDY_BITS);
}
 
void multicore_fifo_push_blocking(uint32_t data);
 
bool multicore_fifo_push_timeout_us(uint32_t data, uint64_t timeout_us);
 
uint32_t multicore_fifo_pop_blocking(void);
 
bool multicore_fifo_pop_timeout_us(uint64_t timeout_us, uint32_t *out);
 
static inline void multicore_fifo_drain(void) {
    while (multicore_fifo_rvalid())
        (void) sio_hw->fifo_rd;
}
 
static inline void multicore_fifo_clear_irq(void) {
    // Write any value to clear the error flags
    sio_hw->fifo_st = 0xff;
}
 
static inline uint32_t multicore_fifo_get_status(void) {
    return sio_hw->fifo_st;
}
 
void multicore_lockout_victim_init(void);
 
bool multicore_lockout_victim_is_initialized(uint core_num);
 
void multicore_lockout_start_blocking(void);
 
bool multicore_lockout_start_timeout_us(uint64_t timeout_us);
 
void multicore_lockout_end_blocking(void);
 
bool multicore_lockout_end_timeout_us(uint64_t timeout_us);
 
#ifdef __cplusplus
}
#endif
#endif