I2CMaster_Read 함수

  • 아티클

헤더: #include <applibs/i2c.h>

I2C master 인터페이스에서 읽기 작업을 수행합니다. 이 함수는 작업의 대상인 하위 I2C 디바이스의 주소를 지정한다는 점을 제외하고 POSIX read(2) 함수와 동일한 기능을 제공합니다.

ssize_t I2CMaster_Read(int fd, I2C_DeviceAddress address, uint8_t *buffer, size_t maxLength);

매개 변수

  • fdI2C master 인터페이스의 파일 설명자입니다.

  • address 읽기 작업의 원본인 하위 I2C 디바이스의 주소 입니다.

  • buffer 하위 디바이스에서 데이터를 수신하는 출력 버퍼입니다. 이 버퍼는 바이트를 받을 maxLength 수 있는 충분한 공간을 포함해야 합니다. 가 0인 경우 maxLength NULL일 수 있습니다.

  • maxLength 받을 최대 바이트 수입니다. 값은 0일 수 있습니다.

오류

오류가 발생하고 를 오류 값으로 설정 errno 하면 -1을 반환합니다.

  • EBUSY: 인터페이스가 사용 중이거나 I2C SCL(클록 라인)이 낮게 유지되고 있습니다.

  • ENXIO: 작업이 하위 디바이스에서 ACK를 받지 못했습니다.

  • ETIMEDOUT: 작업이 완료되기 전에 시간이 초과되었습니다. I2CMaster_SetTimeout 함수를 사용하여 시간 제한 기간을 조정할 수 있습니다.

다른 errno 모든 오류도 지정할 수 있습니다. 이러한 오류는 결정적이지 않으며 시스템 업데이트를 통해 동일한 동작이 유지되지 않을 수 있습니다.

반환 값

성공적으로 읽은 바이트 수를 반환합니다. 오류의 경우 또는 -1입니다. 이 경우 errno 오류 값으로 설정됩니다. 0바이트 읽기를 포함한 부분 읽기 작업은 성공으로 간주됩니다.

애플리케이션 매니페스트 요구 사항

I2c 인터페이스에 액세스하려면 애플리케이션 매니페스트의 I2cMaster 필드에서 해당 인터페이스를 식별해야 합니다.