syncio.go

// Copyright (c) 2015-2025 The libusb developers. All rights reserved.
// Project site: https://github.com/gotmc/libusb
// Use of this source code is governed by a MIT-style license that
// can be found in the LICENSE.txt file for the project.

package libusb

// #cgo pkg-config: libusb-1.0
// #include <libusb.h>
import "C"
import "unsafe"

// BulkTransfer implements libusb_bulk_transfer to perform a USB bulk transfer.
func (dh *DeviceHandle) BulkTransfer(
	endpoint endpointAddress,
	data []byte,
	length int,
	timeout int,
) (int, error) {
	var transferred C.int
	err := C.libusb_bulk_transfer(
		dh.libusbDeviceHandle,
		C.uchar(endpoint),
		(*C.uchar)(unsafe.Pointer(&data[0])),
		C.int(length),
		&transferred,
		C.uint(timeout),
	)
	if err != 0 {
		return 0, ErrorCode(err)
	}
	return int(transferred), nil
}

// BulkTransferOut is a helper method that performs a USB bulk output transfer.
func (dh *DeviceHandle) BulkTransferOut(
	endpoint endpointAddress,
	data []byte,
	timeout int,
) (int, error) {
	return dh.BulkTransfer(
		endpoint,
		data,
		len(data),
		timeout,
	)
}

// BulkTransferIn is a helper method that performs a USB bulk input transfer.
func (dh *DeviceHandle) BulkTransferIn(
	endpoint endpointAddress,
	maxReceiveBytes int,
	timeout int,
) ([]byte, int, error) {
	data := make([]byte, maxReceiveBytes)
	transferred, err := dh.BulkTransfer(
		endpoint,
		data,
		maxReceiveBytes,
		timeout,
	)
	if err != nil {
		return nil, 0, err
	}
	return data, int(transferred), nil
}

// ControlTransfer sends a transfer using a control endpoint for the given
// device handle.
func (dh *DeviceHandle) ControlTransfer(
	requestType byte,
	request byte,
	value uint16,
	index uint16,
	data []byte,
	length int,
	timeout int,
) (int, error) {
	if dh == nil || dh.libusbDeviceHandle == nil {
		return 0, ErrorCode(errorInvalidParam)
	}

	ret := C.libusb_control_transfer(
		dh.libusbDeviceHandle,
		C.uint8_t(requestType),
		C.uint8_t(request),
		C.uint16_t(value),
		C.uint16_t(index),
		(*C.uchar)(unsafe.Pointer(&data[0])),
		C.uint16_t(length),
		C.uint(timeout),
	)
	if ret < 0 {
		return 0, ErrorCode(ret)
	}
	return int(ret), nil
}

// ControlTransferWithTypes is a more type-safe version of ControlTransfer that accepts
// TransferDirection, RequestType, and RequestRecipient components to build the bmRequestType.
// This allows for more readable and maintainable code when using constant values.
func (dh *DeviceHandle) ControlTransferWithTypes(
	direction TransferDirection,
	reqType RequestType,
	recipient RequestRecipient,
	request byte,
	value uint16,
	index uint16,
	data []byte,
	length int,
	timeout int,
) (int, error) {
	requestType := BitmapRequestType(direction, reqType, recipient)
	return dh.ControlTransfer(
		requestType,
		request,
		value,
		index,
		data,
		length,
		timeout,
	)
}

// ControlOut is a helper method for control OUT transfers (host to device)
func (dh *DeviceHandle) ControlOut(
	reqType RequestType,
	recipient RequestRecipient,
	request byte,
	value uint16,
	index uint16,
	data []byte,
	timeout int,
) (int, error) {
	return dh.ControlTransferWithTypes(
		HostToDevice,
		reqType,
		recipient,
		request,
		value,
		index,
		data,
		len(data),
		timeout,
	)
}

// ControlIn is a helper method for control IN transfers (device to host)
func (dh *DeviceHandle) ControlIn(
	reqType RequestType,
	recipient RequestRecipient,
	request byte,
	value uint16,
	index uint16,
	data []byte,
	maxReceiveLength int,
	timeout int,
) (int, error) {
	return dh.ControlTransferWithTypes(
		DeviceToHost,
		reqType,
		recipient,
		request,
		value,
		index,
		data,
		maxReceiveLength,
		timeout,
	)
}

// InterruptTransfer performs a USB interrupt transfer.
func (dh *DeviceHandle) InterruptTransfer(
	endpoint endpointAddress,
	data []byte,
	length int,
	timeout int,
) (int, error) {
	var transferred C.int
	err := C.libusb_interrupt_transfer(
		dh.libusbDeviceHandle,
		C.uchar(endpoint),
		(*C.uchar)(unsafe.Pointer(&data[0])),
		C.int(length),
		&transferred,
		C.uint(timeout),
	)
	if err != 0 {
		return 0, ErrorCode(err)
	}
	return int(transferred), nil
}