Lua-libusb Binding.
Authors
=======
Jorge Visca <xxopxe@gmail.com>
Andres Aguirre <aguirrea@gmail.com>
Copyright 2008 MINA Group, Facultad de Ingenieria, Universidad de la
Republica, Uruguay.
See LICENSE
Intro
=====
For sample usage, see test.lua Tested on Linux, with libusb 0.1.12
Functions
==========
The following correspond to functions in libusb.h . For reference, see http://libusb.sourceforge.net/doc/functions.html
find_busses()
Returns a number
find_devices(bus)
Returns a number
get_busses()
Returns a dirname->bus_handler map
get_devices(bus_handler)
Returns a filename->device map
open(device)
Returns a dev_handle
close(dev_handle)
Returns true if success. In case of failure returns nil followed by error code.
set_configuration(dev_handle, configuration)
configuration is a number
Returns true if success. In case of failure returns nil followed by error code.
set_altinterface(dev_handle, alternative)
configuration is a number
Returns true if success. In case of failure returns nil followed by error code.
clear_halt(dev_handle, ep)
ep is a number
Returns true if success. In case of failure returns nil followed by error code.
reset(dev_handle)
Returns true if success. In case of failure returns nil followed by error code.
claim_interface(dev_handle, interface)
interface is a number
Returns true if success. In case of failure returns nil followed by error code.
release_interface(dev_handle, interface)
interface is a number
Returns true if success. In case of failure returns nil followed by error code.
control_msg(dev_handle,requesttype,request,value,index,bytes,timeout)
requesttype,request,value,index and timeout are numbers
bytes is a string
Returns a number if success. In case of failure returns nil followed by error code.
get_string_simple(dev_handle,index,buflen)
index is a number
buflen is a number, if missing or 0 defaults to 255
Returns a string. In case of failure returns nil followed by error code.
TODO: usb_get_string
get_descriptor(dev_handle,type,index,size)
type and index are numbers (0..255)
size is a number, if missing or 0 defaults to 255
Returns a string. In case of failure returns nil followed by error code.
get_descriptor_by_endpoint(dev_handle,ep,type,index,size)
type and index are numbers (0..255)
ep is a numbers
size is a number, if missing or 0 defaults to 255
Returns a string. In case of failure returns nil followed by error code.
bulk_write(dev_handle,ep,bytes,timeout)
ep and timeout are numbers
bytes is a string
Returns a number. In case of failure returns nil followed by error code.
bulk_read(dev_handle,ep,size,timeout)
ep, size and timeout are numbers
Returns a string. In case of failure returns nil followed by error code.
interrupt_write(dev_handle,ep,bytes,timeout)
ep and timeout are numbers
bytes is a string
Returns a number. In case of failure returns nil followed by error code.
interrupt_read(dev_handle,ep,size,timeout)
ep, size and timeout are numbers
Returns a string. In case of failure returns nil followed by error code.
Data
====
The following functions access data in libusb.h structs. For reference, see http://libusb.sourceforge.net/api-1.0/annotated.html . device_descriptor, device_config and endpoint_descriptor return a table that maps the name of the attribute to it's value. interface_alt_settings returns an array of tables (a table for each alternative), where each table maps the name of the attribute to it's value.
Most of these values are numbers, except the "extra"'s, which are strings, and "endpoint" and "interface" which are handlers. device_descriptor(device)
device_config(device)
interface_alt_settings(interface)
endpoint_descriptor(endpoint_handler)
Constants
=========
The library exports the #defined constants from libusb.h . For your convenience. ===
END