// Copyright 2013 Google Inc. All rights reserved. // Copyright 2016 the gousb Authors. All rights reserved. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. // Package usb provides a wrapper around libusb-1.0. package usb // #cgo pkg-config: libusb-1.0 // #include import "C" type Context struct { ctx *libusbContext done chan struct{} } func (c *Context) Debug(level int) { libusb.setDebug(c.ctx, level) } func NewContext() *Context { c, err := libusb.init() if err != nil { panic(err) } ctx := &Context{ ctx: c, done: make(chan struct{}), } go libusb.handleEvents(ctx.ctx, ctx.done) return ctx } // ListDevices calls each with each enumerated device. // If the function returns true, the device is opened and a Device is returned if the operation succeeds. // Every Device returned (whether an error is also returned or not) must be closed. // If there are any errors enumerating the devices, // the final one is returned along with any successfully opened devices. func (c *Context) ListDevices(each func(desc *Descriptor) bool) ([]*Device, error) { list, err := libusb.getDevices(c.ctx) if err != nil { return nil, err } var reterr error var ret []*Device for _, dev := range list { desc, err := libusb.getDeviceDesc(dev) if err != nil { libusb.dereference(dev) reterr = err continue } if each(desc) { handle, err := libusb.open(dev) if err != nil { reterr = err continue } ret = append(ret, newDevice(handle, desc)) } else { libusb.dereference(dev) } } return ret, reterr } // OpenDeviceWithVidPid opens Device from specific VendorId and ProductId. // If there are any errors, it'll returns at second value. func (c *Context) OpenDeviceWithVidPid(vid, pid int) (*Device, error) { dev, handle, err := libusb.openVIDPID(c.ctx, vid, pid) if err != nil { return nil, err } desc, err := libusb.getDeviceDesc(dev) // return an error from nil-handle and nil-device if err != nil { libusb.dereference(dev) return nil, err } device := newDevice(handle, desc) return device, nil } func (c *Context) Close() error { close(c.done) if c.ctx != nil { libusb.exit(c.ctx) } c.ctx = nil return nil }