Merge remote-tracking branch 'origin/unstable' into rettichschnidi
[libam7xxx.git] / README.asciidoc
index 8f40a1f..133c13b 100644 (file)
@@ -8,9 +8,12 @@ non-Windows Operating Systems like GNU/Linux or Android/Linux just to name
 a few, and on non-PC platforms like for instance mobile phones, tablets or
 game consoles.
 
-The first driver supporting these devices was acerc11xdrv from Reto Schneider:
+The first driver supporting these devices was _acerc11xdrv_ from Reto Schneider:
 https://github.com/rettichschnidi/acerc11xdrv
 
+Another project with the same purpose is _acerc110_ from Thomas Baquet:
+https://github.com/lordblackfox/acerc110
+
 == AM7XXX
 
 An overview of some AM7XXX chips (AM7211A AM7212 AM7212P AM7318 AM7213D
@@ -21,19 +24,29 @@ is at: http://wenku.baidu.com/view/543c8b4d852458fb770b56ee.html
 
 == Supported devices
 
-The devices supported by libam7xxx use USB bulk trasfers and a simple packet
+The devices supported by libam7xxx use USB bulk transfers and a simple packet
 based protocol to exchange data and commands to and from a host system and the
 AM7XXX chip.
 
-Those with USB VendorID ''1de1'' are devices based on Actions Micro/Action Media
-designs, usually having two modes:
+Devices based on Actions Micro/Action Media designs generally use the USB
+VendorID +1de1+, and they can have two operational modes:
+
+ - USB Mass Storage mode (e.g. ProductID: +1101+)
+ - Generic bulk data transfer mode, or Display mode (e.g. ProductID: +c101+)
+
+On recent GNU/Linux systems the switch from Mass Storage mode to Display mode
+is performed automatically by
+http://www.draisberghof.de/usb_modeswitch/[USB_ModeSwitch], or can be done
+manually with the command:
 
- - USB Mass Storage mode (ProductID: ''1101'')
- - Generic bulk data transfer mode (ProductID: ''c101'')
+ $ sudo usb_modeswitch \
+   --default-vendor 0x1de1 \
+   --default-product 0x1101 \
+   --message-content 55534243087052890000000000000cff020000000000000000000000000000
 
 Examples of devices based on AM7XXX are:
 
-  - Acer Series C pico projectors (C20 C110 C112 C120):
+  - Acer Series C pico projectors (C20, C110, C112):
       * http://www.acer.it/ac/it/IT/content/models/projector-c
       * http://support.acer.com/product/default.aspx?modelId=3888