* fbt: reworking targets & assets handling WIP * fbt: dist fixes * fbt: moved SD card resources to owning apps * unit_tests: moved resources to app folder * github: updated unit_tests paths * github: packaging fixes * unit_tests: fixes * fbt: assets: internal cleanup * fbt: reworked assets handling * github: unit_tests: reintroducing fixes * minor cleanup * fbt: naming changes to reflect private nature of scons tools * fbt: resources: fixed dist archive paths * docs: updated paths * docs: updated more paths * docs: included "resources" parameter in app manifest docs; updated assets readme * updated gitignore for assets * github: updated action versions * unit_tests: restored timeout; scripts: assets: logging changes * gh: don't upload desktop animations for unit test run Co-authored-by: あく <alleteam@gmail.com>
		
			
				
	
	
		
			129 lines
		
	
	
		
			3.2 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			129 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();
 | 
						|
 | 
						|
/** Early deinitialize SPI HAL */
 | 
						|
void furi_hal_spi_config_deinit_early();
 | 
						|
 | 
						|
/** Initialize SPI HAL */
 | 
						|
void furi_hal_spi_config_init();
 | 
						|
 | 
						|
/** Initialize SPI DMA HAL */
 | 
						|
void furi_hal_spi_dma_init();
 | 
						|
 | 
						|
/** 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
 |