---
name: "spi_async_locked"
section: "9"
platform: "linux"
package: "linux-manual-3.16"
version: "3.16.56-1+deb8u1"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/spi_async_locked"
---

# spi\_async\_locked(9)

version of spi\_async with exclusive bus usage

## NAME

spi\_async\_locked - version of spi\_async with exclusive bus usage

## SYNOPSIS

**int spi\_async\_locked(struct spi\_device \*** *spi***, struct spi\_message \*** *message***);**

## ARGUMENTS

*spi*

device with which data will be exchanged

*message*

describes the data transfers, including completion callback

## CONTEXT

any (irqs may be blocked, etc)

## DESCRIPTION

This call may be used in\_irq and other contexts which can't sleep, as well as from task contexts which can sleep.

The completion callback is invoked in a context which can't sleep. Before that invocation, the value of message-\>status is undefined. When the callback is issued, message-\>status holds either zero (to indicate complete success) or a negative error code. After that callback returns, the driver which issued the transfer request may deallocate the associated memory; it's no longer in use by any SPI core or controller driver code.

Note that although all messages to a spi\_device are handled in FIFO order, messages may go to different devices in other orders. Some device might be higher priority, or have various “hard” access time requirements, for example.

On detection of any fault during the transfer, processing of the entire message is aborted, and the device is deselected. Until returning from the associated message completion callback, no other spi\_message queued to that device will be processed. (This rule applies equally to all the synchronous transfer calls, which are wrappers around this core asynchronous primitive.)

## COPYRIGHT