[c++] libusb를 활용한 에러 핸들링

21 Dec 2023

libusb는 USB 장치를 다루기 위한 C 라이브러리로, USB 장치와 통신하고 제어하는 데 사용됩니다. 때때로 USB 디바이스와의 통신에 문제가 발생할 수 있으므로, 어떻게 에러를 적절히 핸들링할지에 대해 알아보겠습니다.

libusb_error enum

libusb_error 열거형은 libusb 함수 호출에서 발생할 수 있는 다양한 에러를 정의합니다. 예를 들어, LIBUSB_ERROR_IO, LIBUSB_ERROR_ACCESS, LIBUSB_ERROR_NO_DEVICE 등이 있습니다. 이러한 에러를 처리하기 위해 libusb_error를 사용할 수 있습니다.

enum libusb_error {
    LIBUSB_SUCCESS = 0,
    LIBUSB_ERROR_IO = -1,
    LIBUSB_ERROR_INVALID_PARAM = -2,
    LIBUSB_ERROR_ACCESS = -3,
    LIBUSB_ERROR_NO_DEVICE = -4,
    ...
};

에러 핸들링 예제

아래는 libusb를 사용하여 USB 장치를 열고 읽는 함수에서 에러를 핸들링하는 예제 코드입니다.

libusb_device_handle* openDevice(libusb_device* dev) {
    libusb_device_handle* handle = NULL;
    int result = libusb_open(dev, &handle);
    if (result != LIBUSB_SUCCESS) {
        fprintf(stderr, "Failed to open device: %d\n", result);
        return NULL;
    }
    return handle;
}

int readData(libusb_device_handle* handle, unsigned char* data, int size) {
    int transferred;
    int result = libusb_bulk_transfer(handle, EP_IN, data, size, &transferred, TIMEOUT);
    if (result != LIBUSB_SUCCESS) {
        fprintf(stderr, "Error reading data: %d\n", result);
        return -1;
    }
    return transferred;
}

위 코드에서, libusb_open 및 libusb_bulk_transfer 함수의 반환값이 LIBUSB_SUCCESS가 아닌 경우, 에러가 발생한 것으로 간주하고 적절히 처리합니다.

결론

libusb를 사용할 때에는 함수 호출에서 반환되는 에러를 적절히 핸들링하여 안정적이고 오류 없는 USB 통신을 보장해야 합니다. 에러 핸들링을 통해 예기치 않은 상황에 대비하여 안정성을 높일 수 있습니다.

자세한 내용은 libusb 공식 문서를 참고하시기 바랍니다.