SPI 슬레이브

이 모듈에는 SPI 슬레이브 통신을 위한 플랫폼 추상화가 포함되어 있습니다.

요약

Typedef

otPlatSpiSlaveTransactionCompleteCallback)(void *aContext, uint8_t *aOutputBuf, uint16_t aOutputBufLen, uint8_t *aInputBuf, uint16_t aInputBufLen, uint16_t aTransactionLength) typedef
bool(*
SPI 거래가 지정된 길이로 완료되었음을 나타냅니다.
otPlatSpiSlaveTransactionProcessCallback)(void *aContext) typedef
void(*
트랜잭션 완료 콜백이 호출되고, 추가 처리를 위해 TRUE를 반환한 후에 호출됩니다.

함수

otPlatSpiSlaveDisable(void)
void
SPI 슬레이브 인터페이스를 종료하고 사용 중지합니다.
otPlatSpiSlaveEnable(otPlatSpiSlaveTransactionCompleteCallback aCompleteCallback, otPlatSpiSlaveTransactionProcessCallback aProcessCallback, void *aContext)
SPI 슬레이브 인터페이스를 초기화합니다.
otPlatSpiSlavePrepareTransaction(uint8_t *aOutputBuf, uint16_t aOutputBufLen, uint8_t *aInputBuf, uint16_t aInputBufLen, bool aRequestTransactionFlag)
다음 SPI 트랜잭션에 사용할 데이터를 준비합니다.

Typedef

otPlatSpiSlaveTransactionCompleteCallback 클래스의 생성자

bool(* otPlatSpiSlaveTransactionCompleteCallback)(void *aContext, uint8_t *aOutputBuf, uint16_t aOutputBufLen, uint8_t *aInputBuf, uint16_t aInputBufLen, uint16_t aTransactionLength)

SPI 거래가 지정된 길이로 완료되었음을 나타냅니다.

슬레이브에 기록된 데이터는 이전 otPlatSpiSlavePrepareTransaction() 호출의 aInputBuf 인수로 표시된 포인터에 기록되었습니다.

이 함수가 호출되면 otPlatSpiSlavePrepareTransaction()가 유효하지 않으며 다음 트랜잭션이 유효하려면 다시 호출해야 합니다.

이 함수는 otPlatSpiSlavePrepareTransaction()가 아직 호출되지 않은 경우에도 항상 트랜잭션이 종료될 때 호출됩니다. 이 경우 aOutputBufLenaInputBufLen는 0입니다.

이 콜백은 ISR 컨텍스트에서 호출할 수 있습니다. 이 함수의 반환 값은 추가 처리가 필요한지 여부를 나타냅니다. TRUE가 반환되면 플랫폼 spi-slave 드라이버 구현은 트랜잭션 프로세스 콜백 (otPlatSpiSlaveEnable()에 설정된 aProcessCallback)을 호출해야 합니다. 이 콜백은 다른 OpenThread API/콜백이 호출되는 동일한 OS 컨텍스트에서 호출되어야 합니다.

세부정보
매개변수
[in] aContext
컨텍스트 포인터가 otPlatSpiSlaveEnable()에 전달되었습니다.
[in] aOutputBuf
otPlatSpiSlavePrepareTransaction()에 대한 마지막 호출에서 aOutputBuf의 값입니다.
[in] aOutputBufLen
otPlatSpiSlavePrepareTransaction()에 대한 마지막 호출에서 aOutputBufLen의 값입니다.
[in] aInputBuf
otPlatSpiSlavePrepareTransaction()에 대한 마지막 호출에서 aInputBuf 값입니다.
[in] aInputBufLen
otPlatSpiSlavePrepareTransaction()에 대한 마지막 호출에서 aInputBufLen의 값
[in] aTransactionLength
완료된 트랜잭션의 길이(바이트)입니다.
반환
이 호출이 반환된 후 플랫폼에서 프로세스 콜백 aProcessCallback를 호출해야 하면 TRUE, 처리할 아무것도 없고 프로세스 콜백을 호출할 필요가 없으면 FALSE입니다.

otPlatSpiSlaveTransactionProcessCallback 클래스의 생성자

void(* otPlatSpiSlaveTransactionProcessCallback)(void *aContext)

트랜잭션 완료 콜백이 호출되고, 추가 처리를 위해 TRUE를 반환한 후에 호출됩니다.

otPlatSpiSlaveTransactionCompleteCallback ISR) 이 콜백은 다른 OpenThread API/콜백과 동일한 OS 컨텍스트에서 호출해야 합니다(MUST).

세부정보
매개변수
[in] aContext
컨텍스트 포인터가 otPlatSpiSlaveEnable()에 전달되었습니다.

함수

otPlatSpiSlaveDisable

void otPlatSpiSlaveDisable(
  void
)

SPI 슬레이브 인터페이스를 종료하고 사용 중지합니다.

otPlatSpiSlaveEnable

otError otPlatSpiSlaveEnable(
  otPlatSpiSlaveTransactionCompleteCallback aCompleteCallback,
  otPlatSpiSlaveTransactionProcessCallback aProcessCallback,
  void *aContext
)

SPI 슬레이브 인터페이스를 초기화합니다.

otPlatSPISlavePrepareTransaction()를 사용하여 트랜잭션이 준비될 때까지 SPI 슬레이브가 완전히 준비되지는 않습니다.

otPlatSPISlavePrepareTransaction() is not called before the master begins a transaction, the resulting SPI transaction will send all0xFF` 바이트인 경우 수신된 모든 바이트를 삭제합니다.

세부정보
매개변수
[in] aCompleteCallback
트랜잭션 완료 콜백을 가리키는 포인터입니다.
[in] aProcessCallback
콜백을 처리하기 위한 포인터입니다.
[in] aContext
콜백에 전달할 컨텍스트 포인터입니다.
반환 값
OT_ERROR_NONE
SPI 슬레이브 인터페이스를 사용 설정했습니다.
OT_ERROR_ALREADY
SPI 슬레이브 인터페이스가 이미 사용 설정되었습니다.
OT_ERROR_FAILED
SPI 슬레이브 인터페이스를 사용 설정할 수 없습니다.

otPlatSpiSlavePrepareTransaction

otError otPlatSpiSlavePrepareTransaction(
  uint8_t *aOutputBuf,
  uint16_t aOutputBufLen,
  uint8_t *aInputBuf,
  uint16_t aInputBufLen,
  bool aRequestTransactionFlag
)

다음 SPI 트랜잭션에 사용할 데이터를 준비합니다.

데이터 포인터는 트랜잭션 완료 콜백이 SPI 슬레이브 드라이버에 의해 호출되거나 otPlatSpiSlavePrepareTransaction()를 다음에 호출할 때까지 유효해야 합니다(MUST).

SPI 마스터가 트랜잭션을 시작하기 전에 두 번 이상 호출될 수 있습니다. 이 함수를 성공적으로 호출하면 이전 호출의 이전 값이 삭제됩니다.

완료된 트랜잭션 후 이 함수를 호출하지 않는 것은 이 함수가 이전에 두 버퍼 길이를 0으로 설정하고 aRequestTransactionFlagfalse로 설정하여 호출한 것과 같습니다.

aOutputBufaOutputBufLen바이트가 클록아웃되면 마스터가 SPI 트랜잭션을 완료할 때까지 MISO 핀이 높게 설정됩니다. aOutputBuf의 끝부분에 0xFF의 바이트를 트랜잭션 길이만큼 패딩하는 것과 기능적으로 동일합니다.

aInputBuf의 aInputBufLen바이트가 MOSI에서 클록되면 SPI 마스터가 트랜잭션을 완료할 때까지 MOSI 핀의 모든 후속 값이 무시됩니다.

SPI 마스터가 트랜잭션을 완료하기 전에 aInputBufLen 또는 aOutputBufLen (또는 둘 다)가 소진되더라도 트랜잭션의 진행 중인 크기를 계속 추적해야 트랜잭션 완료 콜백에 전달될 수 있습니다. 예를 들어 aInputBufLen가 10과 같고 aOutputBufLen가 20과 SPI 마스터가 30바이트를 클록하면 값 30이 트랜잭션 완료 콜백에 전달됩니다.

NULL 포인터가 aOutputBuf 또는 aInputBuf로 전달되면 버퍼 포인터가 이전/현재 값에서 변경되면 안 된다는 의미입니다. 이 경우 해당 길이 인수는 무시해야 합니다. 예를 들어 otPlatSpiSlavePrepareTransaction(NULL, 0, aInputBuf, aInputLen, false)는 입력 버퍼 포인터와 길이를 변경하지만 출력 버퍼 포인터는 이전과 동일하게 유지합니다.

트랜잭션이 진행되는 동안 이 함수를 호출하면 모든 인수가 무시되며 반환 값은 OT_ERROR_BUSY이 됩니다.

세부정보
매개변수
[in] aOutputBuf
MISO 핀에 쓸 데이터
[in] aOutputBufLen
출력 버퍼 크기(바이트)
[in] aInputBuf
MOSI 핀에서 읽을 데이터
[in] aInputBufLen
입력 버퍼의 크기(바이트)
[in] aRequestTransactionFlag
호스트 중단을 설정해야 하는 경우 true로 설정합니다.
반환 값
OT_ERROR_NONE
트랜잭션이 준비되었습니다.
OT_ERROR_BUSY
현재 트랜잭션이 진행 중입니다.
OT_ERROR_INVALID_STATE
otPlatSpiSlaveEnable()이 호출되지 않았습니다.

자료

OpenThread API 참조 주제는 GitHub에서 제공되는 소스 코드에서 비롯됩니다. 자세한 내용을 보거나 문서에 참여하려면 리소스를 참고하세요.