Symbols ![]()
loading...
Files ![]()
loading...
spi_bus_lock_bg_exit() function
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.
Syntax
Implemented in ![]()
spi_bus_lock.c:776
Return value
false if retry is required, indicating that there is pending BG request. otherwise true and quit ISR is allowed.
Notes
This function will not change acquiring device. The ISR call `spi_bus_lock_bg_update_acquiring` to check for new acquiring device, when acquiring devices need to be served before other devices.
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
Check whether there is device asking for the acquiring device, and the desired device for the next operation is also recommended.
Bus attributes Set bus lock for the main bus, called by startup code.
Check if there is any active BG requests.