Symbols ![]()
loading...
Files ![]()
loading...
spi_bus_lock_bg_check_dev_acq() function
Check whether there is device asking for the acquiring device, and the desired device for the next operation is also recommended.
Syntax
bool spi_bus_lock_bg_check_dev_acq(spi_bus_lock_handle_t lock,
spi_bus_lock_dev_handle_t *out_dev_lock);
Implemented in ![]()
spi_bus_lock.c:821
Return value
true if the ISR need to quit (new acquiring device has no active BG request, or no active BG requests for all devices when there is no acquiring device), otherwise false.
Notes
Must be called when the ISR is acting as the acquiring processor, and there is no acquiring device.
Related Functions
Found 21 other functions taking a ![]()
spi_bus_lock_t
argument:
Function
Description
atomic operations to the status
Attach a device onto an SPI bus lock. The returning handle is used to perform following requests for the attached device.
Free the resources used by an SPI bus lock.
Get the device acquiring the bus.
Configure how the SPI bus lock enable the background operation.
Initialization & Deinitialization
Find the next acquiring processor according to the status. Will directly change the acquiring device if new one found. Cases: - BG should still be the acquiring processor (Return false): 1. Acquiring device has active BG bits: out_desired_dev = new acquiring device 2. No acquiring device, but BG active: out_desired_dev = randomly pick one device with active BG bits - BG should yield to the task (Return true): 3. Acquiring device has no active BG bits: out_desired_dev = new acquiring device 4. No acquiring device while no active BG bits: out_desired_dev=NULL Acquiring device task need to be resumed only when case 3. This scheduling can happen in either task or ISR, so `in_isr` or `bg_active` not touched.
BG (background operation) service
Handle the scheduling of other acquiring devices, and control of HW operation status. If no BG request is found, call with `wip=false`. This function will return false, indicating there is incoming BG requests for the current acquiring device (or for all devices if there is no acquiring device) and the ISR needs retry. Otherwise may schedule a new acquiring processor (unblock the task) if there is, and return true. Otherwise if a BG request is started in this ISR, call with `wip=true` and the function will enable the interrupt to make the ISR be called again when the request is done. This function is safe and should still be called when the ISR just lost its acquiring processor role, but hasn't quit.
Bus attributes Set bus lock for the main bus, called by startup code.
Check if there is any active BG requests.