]> git.sesse.net Git - bmusb/commitdiff
Update README; UltraStudio SDI works fine, if you just change the USB ID.
authorSteinar H. Gunderson <sgunderson@bigfoot.com>
Sat, 19 Sep 2015 23:00:37 +0000 (01:00 +0200)
committerSteinar H. Gunderson <sgunderson@bigfoot.com>
Sat, 19 Sep 2015 23:00:37 +0000 (01:00 +0200)
README

diff --git a/README b/README
index d26ca1223e3817bac3960885a8bcf77c41be3f59..be87ec869d64d475f67096291fd28d5522c0e2fa 100644 (file)
--- a/README
+++ b/README
@@ -1,17 +1,20 @@
-bmusb is a free driver for BlackMagic's Intensity Shuttle USB3 card,
-which has no official Linux driver. It runs in userspace through usbfs,
-which may mean it could also probably run on FreeBSD, but it's untested.
+bmusb is a free driver for BlackMagic's Intensity Shuttle and
+UltraStudio SDI USB3 cards, which have no official Linux driver.
+(The two seem to speak exactly the same protocol.) It runs in userspace
+through usbfs, which may mean it could also probably run on FreeBSD,
+but it's untested.
 
-Current tested features:
+Current tested features (note, some of these are not exposed in the
+driver except by changing the source code):
 
- * HDMI capture on 576p60, 720p60, 1080i60 (1080p60 is unfortunately not
-   supported in newer firmwares; I haven't tried older), plus 24, 50
+ * HDMI and SDI capture on 576p60, 720p60, 1080i60 (1080p60 is unfortunately
+   not supported in newer firmwares; I haven't tried older), plus 24, 50
    and 59.97 Hz
  * 8-channel 24-bit 48 kHz locked audio capture
  * Analog audio capture, including setting levels
  * 8-bit 4:2:2 and 10-bit 4:2:2 capture
 
-The Intensity Shuttle follows a protocol whose exact format is still
+The BlackMagic cards follow a protocol whose exact format is still
 unknown, and the driver is still in alpha stage. (There is no API or
 ABI stability, for one, and everything is really messy and uncommented.)
 In particular, it will often do something on init that makes the card
@@ -29,8 +32,9 @@ client that just checks for frame continuity. It's recommended to run
 as root or some other user that can run the USB thread at realtime
 priority, as USB3 isochronous transfers are very timing sensitive.
 
-The driver has only been tested with the 10.4.3 firmware, and there is
-currently no tool to upgrade or downgrade the firmware on the card.
+The driver has only been tested with the firmware from the 10.4.3/10.5.0
+series (seemingly the same), and there is currently no tool to
+upgrade or downgrade the firmware on the card.
 
 bmusb is Copyright 2015 Steinar H. Gunderson <sgunderson@bigfoot.com>
 and licensed under the GNU General Public License, version 2, or at your