Add sigrok-fwextract-dreamsourcelab-dslogic script and manpage.

diff --git a/firmware/dreamsourcelab-dslogic/sigrok-fwextract-dreamsourcelab-dslogic b/firmware/dreamsourcelab-dslogic/sigrok-fwextract-dreamsourcelab-dslogic
new file mode 100755 (executable)
index 0000000..5929be9
--- /dev/null
+++ b/firmware/dreamsourcelab-dslogic/sigrok-fwextract-dreamsourcelab-dslogic
@@ -0,0 +1,42 @@
+#!/bin/sh
+##
+## This file is part of the sigrok-util project.
+##
+## Copyright (C) 2016 Uwe Hermann <uwe@hermann-uwe.de>
+##
+## This program is free software; you can redistribute it and/or modify
+## it under the terms of the GNU General Public License as published by
+## the Free Software Foundation; either version 3 of the License, or
+## (at your option) any later version.
+##
+## This program is distributed in the hope that it will be useful,
+## but WITHOUT ANY WARRANTY; without even the implied warranty of
+## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+## GNU General Public License for more details.
+##
+## You should have received a copy of the GNU General Public License
+## along with this program; if not, see <http://www.gnu.org/licenses/>.
+##
+
+umask 022
+
+WGET="wget -c -q"
+if [ -z $PREFIX ]; then
+       PREFIX="/usr/local"
+fi
+FWDIR="$PREFIX/share/sigrok-firmware"
+FWURL="https://github.com/DreamSourceLab/DSView/raw/master/DSView/res"
+
+echo "Installing into: $FWDIR"
+
+mkdir -p $FWDIR
+
+$WGET $FWURL/DSLogic50.bin -O $FWDIR/dreamsourcelab-dslogic-fpga-5v.fw
+$WGET $FWURL/DSLogic33.bin -O $FWDIR/dreamsourcelab-dslogic-fpga-3v3.fw
+$WGET $FWURL/DSLogic.fw -O $FWDIR/dreamsourcelab-dslogic-fx2.fw
+
+$WGET $FWURL/DSCope.bin -O $FWDIR/dreamsourcelab-dscope-fpga.fw
+$WGET $FWURL/DSCope.fw -O $FWDIR/dreamsourcelab-dscope-fx2.fw
+
+$WGET $FWURL/DSLogicPro.bin -O $FWDIR/dreamsourcelab-dslogic-pro-fpga.fw
+$WGET $FWURL/DSLogicPro.fw -O $FWDIR/dreamsourcelab-dslogic-pro-fx2.fw

diff --git a/firmware/dreamsourcelab-dslogic/sigrok-fwextract-dreamsourcelab-dslogic.1 b/firmware/dreamsourcelab-dslogic/sigrok-fwextract-dreamsourcelab-dslogic.1
new file mode 100644 (file)
index 0000000..74f6624
--- /dev/null
+++ b/firmware/dreamsourcelab-dslogic/sigrok-fwextract-dreamsourcelab-dslogic.1
@@ -0,0 +1,53 @@
+.TH SIGROK\-FWEXTRACT\-DREAMSOURCELAB\-DSLOGIC 1 "Nov 02, 2016"
+.SH "NAME"
+sigrok\-fwextract\-dreamsourcelab\-dslogic \- Extract DreamSourceLab DSLogic / DSLogic Pro / DScope firmware
+.SH "SYNOPSIS"
+.B [PREFIX=...] sigrok\-fwextract\-dreamsourcelab\-dslogic
+.SH "DESCRIPTION"
+This tool downloads the vendor FX2 firmware and FPGA bitstreams
+for the DreamSourceLab DSLogic / DSLogic Pro / DScope devices from the
+vendor's GitHub repository and installs them in the specified location.
+.PP
+In order to download/install the firmware/bitstreams, run the following command:
+.PP
+.B "  $ sudo sigrok-fwextract-dreamsourcelab-dslogic"
+.br
+.RB "  Installing into: /usr/local/share/sigrok-firmware"
+.br
+.PP
+This will download and install the files to the location where libsigrok
+expects to find its firmware files. By default this is
+.BR /usr/local/share/sigrok-firmware .
+.PP
+You can override the
+.B PREFIX
+variable to install the files elsewhere:
+.PP
+.B "  $ PREFIX=$HOME/sr sigrok-fwextract-dreamsourcelab-dslogic"
+.br
+.RB "  Installing into: /home/<user>/sr/share/sigrok-firmware"
+.PP
+.SH OPTIONS
+None.
+.SH "EXIT STATUS"
+Exits with 0 on success, 1 on most failures.
+.SH "SEE ALSO"
+\fBsigrok\-fwextract\-hantek\-dso\fP(1)
+.br
+\fBsigrok\-fwextract\-lecroy\-logicstudio\fP(1)
+.br
+\fBsigrok\-fwextract\-saleae\-logic16\fP(1)
+.br
+\fBsigrok\-fwextract\-sysclk\-lwla1016\fP(1)
+.br
+\fBsigrok\-fwextract\-sysclk\-lwla1034\fP(1)
+.SH "BUGS"
+Please report any bugs via Bugzilla
+.RB "(" http://sigrok.org/bugzilla ")"
+or on the sigrok\-devel mailing list
+.RB "(" sigrok\-devel@lists.souceforge.net ")."
+.SH "LICENSE"
+This program is covered by the GNU General Public License (GPL),
+version 3 or later.
+.SH "AUTHORS"
+Please see the individual source code files.

diff --git a/firmware/hantek-dso/sigrok-fwextract-hantek-dso.1 b/firmware/hantek-dso/sigrok-fwextract-hantek-dso.1
index f560e5ae071f4f51eecdd148ba8e28de65952df6..8ce61a8c8e8b70cbac00c6729849554870f8b2ca 100644 (file)
--- a/firmware/hantek-dso/sigrok-fwextract-hantek-dso.1
+++ b/firmware/hantek-dso/sigrok-fwextract-hantek-dso.1
@@ -26,6 +26,8 @@ None.
 .SH "EXIT STATUS"
 Exits with 0 on success, 1 on most failures.
 .SH "SEE ALSO"
+\fBsigrok\-fwextract\-dreamsourcelab\-dslogic\fP(1)
+.br
 \fBsigrok\-fwextract\-lecroy\-logicstudio\fP(1)
 .br
 \fBsigrok\-fwextract\-saleae\-logic16\fP(1)

diff --git a/firmware/lecroy-logicstudio/sigrok-fwextract-lecroy-logicstudio.1 b/firmware/lecroy-logicstudio/sigrok-fwextract-lecroy-logicstudio.1
index b86c239a740c6d6777b1cec3c528c32cbb693771..e65dda5df61a6426c59b1e3413d7b3ba7b6dc95c 100644 (file)
--- a/firmware/lecroy-logicstudio/sigrok-fwextract-lecroy-logicstudio.1
+++ b/firmware/lecroy-logicstudio/sigrok-fwextract-lecroy-logicstudio.1
@@ -19,6 +19,8 @@ None.
 .SH "EXIT STATUS"
 Exits with 0 on success, 1 on most failures.
 .SH "SEE ALSO"
+\fBsigrok\-fwextract\-dreamsourcelab\-dslogic\fP(1)
+.br
 \fBsigrok\-fwextract\-hantek\-dso\fP(1)
 .br
 \fBsigrok\-fwextract\-saleae\-logic16\fP(1)

diff --git a/firmware/saleae-logic16/sigrok-fwextract-saleae-logic16.1 b/firmware/saleae-logic16/sigrok-fwextract-saleae-logic16.1
index 98bd74e98eab2785673a2b4d1111f427de29d010..b02242876960336ed260c6c6b6989eb40b8bd335 100644 (file)
--- a/firmware/saleae-logic16/sigrok-fwextract-saleae-logic16.1
+++ b/firmware/saleae-logic16/sigrok-fwextract-saleae-logic16.1
@@ -27,6 +27,8 @@ None.
 .SH "EXIT STATUS"
 Exits with 0 on success, 1 on most failures.
 .SH "SEE ALSO"
+\fBsigrok\-fwextract\-dreamsourcelab\-dslogic\fP(1)
+.br
 \fBsigrok\-fwextract\-hantek\-dso\fP(1)
 .br
 \fBsigrok\-fwextract\-lecroy\-logicstudio\fP(1)

diff --git a/firmware/sysclk-lwla/sigrok-fwextract-sysclk-lwla1016.1 b/firmware/sysclk-lwla/sigrok-fwextract-sysclk-lwla1016.1
index aff029a8460b7f0bc37c70889f6166510d6d7eca..883012a2cee41472702b2c62103c39276df74b28 100644 (file)
--- a/firmware/sysclk-lwla/sigrok-fwextract-sysclk-lwla1016.1
+++ b/firmware/sysclk-lwla/sigrok-fwextract-sysclk-lwla1016.1
@@ -20,6 +20,8 @@ None.
 .SH "EXIT STATUS"
 Exits with 0 on success, 1 on most failures.
 .SH "SEE ALSO"
+\fBsigrok\-fwextract\-dreamsourcelab\-dslogic\fP(1)
+.br
 \fBsigrok\-fwextract\-hantek\-dso\fP(1)
 .br
 \fBsigrok\-fwextract\-lecroy\-logicstudio\fP(1)

diff --git a/firmware/sysclk-lwla/sigrok-fwextract-sysclk-lwla1034.1 b/firmware/sysclk-lwla/sigrok-fwextract-sysclk-lwla1034.1
index c8c1bb009953972ce552015e1d82b900417d4595..5649f8eeee84770163673ba5d877f88c5f22727a 100644 (file)
--- a/firmware/sysclk-lwla/sigrok-fwextract-sysclk-lwla1034.1
+++ b/firmware/sysclk-lwla/sigrok-fwextract-sysclk-lwla1034.1
@@ -20,6 +20,8 @@ None.
 .SH "EXIT STATUS"
 Exits with 0 on success, 1 on most failures.
 .SH "SEE ALSO"
+\fBsigrok\-fwextract\-dreamsourcelab\-dslogic\fP(1)
+.br
 \fBsigrok\-fwextract\-hantek\-dso\fP(1)
 .br
 \fBsigrok\-fwextract\-lecroy\-logicstudio\fP(1)