mirror of
https://github.com/DarkFlippers/unleashed-firmware
synced 2024-11-30 08:20:21 +00:00
acc39a4bc0
* Api Symbols: replace asserts with checks * Api Symbols: replace asserts with checks part 2 * Update no args function signatures with void, to help compiler to track incorrect usage * More unavoidable void * Update PVS config and code to make it happy * Format sources * nfc: fix checks * dead code cleanup & include fixes Co-authored-by: gornekich <n.gorbadey@gmail.com> Co-authored-by: hedger <hedger@users.noreply.github.com> Co-authored-by: hedger <hedger@nanode.su>
128 lines
3.2 KiB
C
128 lines
3.2 KiB
C
#pragma once
|
|
|
|
#include <furi_hal_spi_config.h>
|
|
#include <stdbool.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/** Early initialize SPI HAL */
|
|
void furi_hal_spi_config_init_early(void);
|
|
|
|
/** Early deinitialize SPI HAL */
|
|
void furi_hal_spi_config_deinit_early(void);
|
|
|
|
/** Initialize SPI HAL */
|
|
void furi_hal_spi_config_init(void);
|
|
|
|
/** Initialize SPI DMA HAL */
|
|
void furi_hal_spi_dma_init(void);
|
|
|
|
/** Initialize SPI Bus
|
|
*
|
|
* @param handle pointer to FuriHalSpiBus instance
|
|
*/
|
|
void furi_hal_spi_bus_init(FuriHalSpiBus* bus);
|
|
|
|
/** Deinitialize SPI Bus
|
|
*
|
|
* @param handle pointer to FuriHalSpiBus instance
|
|
*/
|
|
void furi_hal_spi_bus_deinit(FuriHalSpiBus* bus);
|
|
|
|
/** Initialize SPI Bus Handle
|
|
*
|
|
* @param handle pointer to FuriHalSpiBusHandle instance
|
|
*/
|
|
void furi_hal_spi_bus_handle_init(FuriHalSpiBusHandle* handle);
|
|
|
|
/** Deinitialize SPI Bus Handle
|
|
*
|
|
* @param handle pointer to FuriHalSpiBusHandle instance
|
|
*/
|
|
void furi_hal_spi_bus_handle_deinit(FuriHalSpiBusHandle* handle);
|
|
|
|
/** Acquire SPI bus
|
|
*
|
|
* @warning blocking, calls `furi_crash` on programming error, CS transition is up to handler event routine
|
|
*
|
|
* @param handle pointer to FuriHalSpiBusHandle instance
|
|
*/
|
|
void furi_hal_spi_acquire(FuriHalSpiBusHandle* handle);
|
|
|
|
/** Release SPI bus
|
|
*
|
|
* @warning calls `furi_crash` on programming error, CS transition is up to handler event routine
|
|
*
|
|
* @param handle pointer to FuriHalSpiBusHandle instance
|
|
*/
|
|
void furi_hal_spi_release(FuriHalSpiBusHandle* handle);
|
|
|
|
/** SPI Receive
|
|
*
|
|
* @param handle pointer to FuriHalSpiBusHandle instance
|
|
* @param buffer receive buffer
|
|
* @param size transaction size (buffer size)
|
|
* @param timeout operation timeout in ms
|
|
*
|
|
* @return true on sucess
|
|
*/
|
|
bool furi_hal_spi_bus_rx(
|
|
FuriHalSpiBusHandle* handle,
|
|
uint8_t* buffer,
|
|
size_t size,
|
|
uint32_t timeout);
|
|
|
|
/** SPI Transmit
|
|
*
|
|
* @param handle pointer to FuriHalSpiBusHandle instance
|
|
* @param buffer transmit buffer
|
|
* @param size transaction size (buffer size)
|
|
* @param timeout operation timeout in ms
|
|
*
|
|
* @return true on success
|
|
*/
|
|
bool furi_hal_spi_bus_tx(
|
|
FuriHalSpiBusHandle* handle,
|
|
const uint8_t* buffer,
|
|
size_t size,
|
|
uint32_t timeout);
|
|
|
|
/** SPI Transmit and Receive
|
|
*
|
|
* @param handle pointer to FuriHalSpiBusHandle instance
|
|
* @param tx_buffer pointer to tx buffer
|
|
* @param rx_buffer pointer to rx buffer
|
|
* @param size transaction size (buffer size)
|
|
* @param timeout operation timeout in ms
|
|
*
|
|
* @return true on success
|
|
*/
|
|
bool furi_hal_spi_bus_trx(
|
|
FuriHalSpiBusHandle* handle,
|
|
const uint8_t* tx_buffer,
|
|
uint8_t* rx_buffer,
|
|
size_t size,
|
|
uint32_t timeout);
|
|
|
|
/** SPI Transmit and Receive with DMA
|
|
*
|
|
* @param handle pointer to FuriHalSpiBusHandle instance
|
|
* @param tx_buffer pointer to tx buffer
|
|
* @param rx_buffer pointer to rx buffer
|
|
* @param size transaction size (buffer size)
|
|
* @param timeout_ms operation timeout in ms
|
|
*
|
|
* @return true on success
|
|
*/
|
|
bool furi_hal_spi_bus_trx_dma(
|
|
FuriHalSpiBusHandle* handle,
|
|
uint8_t* tx_buffer,
|
|
uint8_t* rx_buffer,
|
|
size_t size,
|
|
uint32_t timeout_ms);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|