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인 경우maxLengthNULL일 수 있습니다.maxLength받을 최대 바이트 수입니다. 값은 0일 수 있습니다.
오류
오류가 발생하고 를 오류 값으로 설정 errno 하면 -1을 반환합니다.
EBUSY: 인터페이스가 사용 중이거나 I2C SCL(클록 라인)이 낮게 유지되고 있습니다.
ENXIO: 작업이 하위 디바이스에서 ACK를 받지 못했습니다.
ETIMEDOUT: 작업이 완료되기 전에 시간이 초과되었습니다. I2CMaster_SetTimeout 함수를 사용하여 시간 제한 기간을 조정할 수 있습니다.
다른 errno 모든 오류도 지정할 수 있습니다. 이러한 오류는 결정적이지 않으며 시스템 업데이트를 통해 동일한 동작이 유지되지 않을 수 있습니다.
반환 값
성공적으로 읽은 바이트 수를 반환합니다. 오류의 경우 또는 -1입니다. 이 경우 errno 오류 값으로 설정됩니다. 0바이트 읽기를 포함한 부분 읽기 작업은 성공으로 간주됩니다.
애플리케이션 매니페스트 요구 사항
I2c 인터페이스에 액세스하려면 애플리케이션 매니페스트의 I2cMaster 필드에서 해당 인터페이스를 식별해야 합니다.