Visualizza wikitesto di Ottenere mediante le funzioni esterne della libreria Libudev un elenco degli oggetti hidraw collegati al sistema

I dispositivi HID (''human interface device'') sono quei dispositivi esterni che si relazionano direttamente con gli utenti (ad esempio il mouse).

Nella presente pagina sarà mostrato un codice per ottenere mediante le funzioni esterne della libreria Libudev un elenco degli oggetti ''hidraw'' collegati al sistema. E' necessario avere installata e richiamare in Gambas la libreria condivisa: "''libudev.so.1.3.5'' ".
 Library "libudev:1.3.5"
 
 <FONT Color=gray>' ''struct udev *udev_new(void)''
 ' ''Create udev library context.''</font>
 Private Extern udev_new() As Pointer
 
 <FONT Color=gray>' ''struct udev_enumerate *udev_enumerate_new(struct udev *udev)''
 ' ''Create, acquire and release a udev enumerate object.''</font>
 Private Extern udev_enumerate_new(udev As Pointer) As Pointer
 
 <FONT Color=gray>' ''int udev_enumerate_add_match_subsystem(struct udev_enumerate *udev_enumerate, const char *subsystem)''
 ' ''Filter for a subsystem of the device to include in the list.''</font>
 Private Extern udev_enumerate_add_match_subsystem(udev_enumerate As Pointer, subsystem As String) As Integer
 
 <FONT Color=gray>' ''int udev_enumerate_scan_devices(struct udev_enumerate *udev_enumerate)''
 ' ''Query or modify a udev enumerate object.''</font>
 Private Extern udev_enumerate_scan_devices(udev_enumerate As Pointer) As Integer
 
 <FONT Color=gray>' ''struct udev_list_entry *udev_enumerate_get_list_entry(struct udev_enumerate *udev_enumerate)''
 ' ''Query or modify a udev enumerate object.''</font>
 Private Extern udev_enumerate_get_list_entry(udev_enumerate As Pointer) As Pointer
 
 <FONT Color=gray>' ''struct udev_list_entry *udev_list_entry_get_next(struct udev_list_entry *list_entry)''
 ' ''Iterate and access udev lists.''</font>
 Private Extern udev_list_entry_get_next(list_entry As Pointer) As Pointer
 
 <FONT Color=gray>' ''const char *udev_list_entry_get_name(struct udev_list_entry *list_entry)''
 ' ''Iterate and access udev lists.''</font>
 Private Extern udev_list_entry_get_name(list_entry As Pointer) As String
 
 <FONT Color=gray>' ''struct udev_device *udev_device_new_from_syspath(struct udev *udev, const char *syspath)''
 ' ''Create, acquire and release a udev device object.''</font>
 Private Extern udev_device_new_from_syspath(udev As Pointer, syspath As String) As Pointer
 
 <FONT Color=gray>' ''const char *udev_device_get_devnode(struct udev_device *udev_device)''
 ' ''Returns the path to the device node itself in /dev.''</font>
 Private Extern udev_device_get_devnode(udev_device As Pointer) As String
 
 <FONT Color=gray>' ''struct udev_device *udev_device_get_parent_with_subsystem_devtype(struct udev_device *udev_device, const char *subsystem, const char *devtype)''
 ' ''Find the next parent device, with a matching subsystem and devtype value, and fill in information from the sys device and the udev database entry.''</font>
 Private Extern udev_device_get_parent_with_subsystem_devtype(udev_device As Pointer, subsystem As String, devtype As String) As Pointer
 
 <FONT Color=gray>' ''const char *udev_device_get_sysattr_value(struct udev_device *udev_device, const char *sysattr)''
 ' ''The retrieved value is cached in the device.''</font>
 Private Extern udev_device_get_sysattr_value(udev_device As Pointer, sysattr As String) As String
 
 <FONT Color=gray>' ''struct udev_device *udev_device_unref(struct udev_device *udev_device)''
 ' ''Drop a reference of a udev device.''</font>
 Private Extern udev_device_unref(udev_device As Pointer) As Pointer
 
 <FONT Color=gray>' ''struct udev_enumerate *udev_enumerate_unref(struct udev_enumerate *udev_enumerate)''
 ' ''Drop a reference of an enumeration context.''</font>
 Private Extern udev_enumerate_unref(udev_enumerate As Pointer) As Pointer
 
 <FONT Color=gray>' ''struct udev *udev_unref(struct udev *udev)''
 ' ''Drop a reference of the udev library context.''</font>
 Private Extern udev_unref(udev As Pointer) As Pointer
 
 
 '''Public''' Sub Main()
 
  Dim ud, en, ls, dev As Pointer
  Dim d, t As Pointer
  Dim path, node_path As String
  
 <FONT Color=gray>' ''Crea un contesto "udev":''</font>
  ud = udev_new()
  If ud == 0 Then Error.Raise("Impossibile creare un contesto 'udev' !")
    
 <FONT Color=gray>' ''Crea una lista di dispositivi nel sottosistema "scsi":''</font>
  en = udev_enumerate_new(ud)
  If en == 0 Then Error.Raise("Errore !")
   
  udev_enumerate_add_match_subsystem(en, "hidraw")
  udev_enumerate_scan_devices(en)
  ls = udev_enumerate_get_list_entry(en)
  If ls == 0 Then Error.Raise("Errore !")
  
 <FONT Color=gray>' ''Ottiene il file-descriptor per il monitor:''</font>
  dev = ls
   
  Repeat    
 <FONT Color=gray>' ''Ottiene il nome del file della voce "/sys" per il dispositivo:''</font>
    path = udev_list_entry_get_name(dev)
    d = udev_device_new_from_syspath(ud, path)
      
    node_path = udev_device_get_devnode(d)
    If Not IsNull(node_path) Then Print "Device Node Path: "; node_path
    
    t = udev_device_get_parent_with_subsystem_devtype(d, "usb", "usb_device")
    If t == 0 Then Break
    
    Print "  VID/PID:        "; udev_device_get_sysattr_value(t, "idVendor"); ":"; udev_device_get_sysattr_value(t, "idProduct")
    
    Print "                  "; udev_device_get_sysattr_value(t, "manufacturer"), udev_device_get_sysattr_value(t, "product")
    
    Print "  serial:         "; udev_device_get_sysattr_value(t, "serial")
    Print
     
    udev_device_unref(d)    
    dev = udev_list_entry_get_next(dev)
     
  Until dev == 0
   
 <FONT Color=gray>' ''Va in chiusura:''</font>
  udev_enumerate_unref(en)
  udev_unref(ud)
   
 '''End'''



=Riferimenti=
* https://en.wikipedia.org/wiki/Human_interface_device
* https://en.wikipedia.org/wiki/USB_human_interface_device_class
* http://www.signal11.us/oss/udev/
* http://sourcecodebrowser.com/udev/150/index.html
* http://www.freedesktop.org/software/systemd/man/libudev.html
* https://www.kernel.org/pub/linux/utils/kernel/hotplug/libudev/ch01.html
* /usr/include/libudev.h