contrib: add AppStream metadata
[libam7xxx.git] / README.asciidoc
index 96cc972..839a19e 100644 (file)
@@ -44,8 +44,8 @@ manually with the command:
    --default-product 0x1101 \
    --message-content 55534243087052890000000000000cff020000000000000000000000000000
 
    --default-product 0x1101 \
    --message-content 55534243087052890000000000000cff020000000000000000000000000000
 
-Alternatively, on systems where libusb works but 'usb_mode_switch' is not
-easily available, the switch can be performed using the 'am7xxx_mode_switch'
+Alternatively, on systems where libusb works but 'usb-modeswitch' is not
+easily available, the switch can be performed using the 'am7xxx-modeswitch'
 example program from libam7xxx.
 
 Examples of devices based on AM7XXX are:
 example program from libam7xxx.
 
 Examples of devices based on AM7XXX are:
@@ -55,13 +55,22 @@ Examples of devices based on AM7XXX are:
       * http://support.acer.com/product/default.aspx?modelId=3888
 
   - Philips/SagemCom PicoPix projectors (PPX 1020, PPX 1230, PPX 1430, PPX
       * http://support.acer.com/product/default.aspx?modelId=3888
 
   - Philips/SagemCom PicoPix projectors (PPX 1020, PPX 1230, PPX 1430, PPX
-    1630):
+    1630, PPX 2055, PPX 2330):
       * http://www.philips.co.uk/c/pocket-projector/179840/cat/
       * http://www.sagemcom.com/EN/products/image-sound/pico-video-projectors.html
 
   - CEL-TEC MP-01:
       * http://www.kabelmanie.cz/miniprojektor-cel-tec-mp-01/
 
       * http://www.philips.co.uk/c/pocket-projector/179840/cat/
       * http://www.sagemcom.com/EN/products/image-sound/pico-video-projectors.html
 
   - CEL-TEC MP-01:
       * http://www.kabelmanie.cz/miniprojektor-cel-tec-mp-01/
 
+  - Top-Height/TEC PP700
+      * http://www.ishopiwin.com/en/appliances-electronics/electronics/projectors/pico-projector-pp-700.html
+
+  - Royaltek PJU-2100:
+      * http://www.royaltek.com/index.php/pju-2100-pico-projector
+
+  - Aiptek PocketCinema T25:
+      * http://www.aiptek.eu/index.php/en/products/pico-projectors/pocketcinema-t25
+
   - Other unbranded projectors:
       * http://www.dealextreme.com/p/portable-home-office-mini-usb-2-0-lcos-projector-16-9-45019
 
   - Other unbranded projectors:
       * http://www.dealextreme.com/p/portable-home-office-mini-usb-2-0-lcos-projector-16-9-45019
 
@@ -76,15 +85,20 @@ this needs still needs to be verified.
 
 == Testing libam7xxx on MS Windows
 
 
 == Testing libam7xxx on MS Windows
 
-All the needed files need to be in the same location:
-  
-  - 'libusb-1.0.dll' from http://sourceforge.net/projects/libusbx/files/releases/1.0.11/Windows/libusbx-1.0.11-win.7z
+All the needed files below must be in the same location:
+
+  - 'MinGW32/dll/libusb-1.0.dll' from
+    https://github.com/libusb/libusb/releases/download/v1.0.21/libusb-1.0.21.7z
 
   - 'libssp-0.dll' from MinGW;
 
 
   - 'libssp-0.dll' from MinGW;
 
-  - 'am7xxx_mode_switch.exe', 'libam7xxx.dll' and 'picoproj.exe' which can all
-    be built by following the instructions in the HACKING.asciidoc document
-    from libam7xxx.
+  - all the '*.dll' files in the 'bin/' directory from
+    https://ffmpeg.zeranoe.com/builds/win32/shared/ffmpeg-3.4.2-win32-shared.zip
+    
+
+  - 'am7xxx-modeswitch.exe', 'am7xxx-play.exe', 'libam7xxx.dll' and
+    'picoproj.exe' which can all be built by following the instructions in the
+    HACKING.asciidoc document from libam7xxx.
 
 In order to use the device on MS Windows the WinUSB drivers must be installed
 for both the mass storage device and the display device:
 
 In order to use the device on MS Windows the WinUSB drivers must be installed
 for both the mass storage device and the display device:
@@ -97,9 +111,9 @@ for both the mass storage device and the display device:
     from now on the virtual CD-ROM can't be accessed anymore until the
     +USBSTOR+ Driver is restored.
 
     from now on the virtual CD-ROM can't be accessed anymore until the
     +USBSTOR+ Driver is restored.
 
-  - Run 'am7xxx_mode_switch.exe'
+  - Run 'am7xxx-modeswitch.exe'
 
   - When the new (display) device shows up, run Zadig and install the +WinUSB+
     driver for it too.
 
 
   - When the new (display) device shows up, run Zadig and install the +WinUSB+
     driver for it too.
 
-Now it is possible to run 'picoproj.exe' on Windows.
+Now it is possible to run 'picoproj.exe' or 'am7xxx-play.exe' on Windows.