spi_bus_lock_set_bg_control() function

Handle to the lock to set

The enabling function

The disabling function, set to NULL if not required

Argument to pass to the enabling/disabling function.

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.

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.

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.