From: Uwe Hermann Date: Wed, 2 Nov 2016 07:56:03 +0000 (+0100) Subject: Add sigrok-fwextract-dreamsourcelab-dslogic script and manpage. X-Git-Url: https://sigrok.org/gitweb/?p=sigrok-util.git;a=commitdiff_plain;h=61e867bbad4ed9d9253f834ede1705f1188be8b2 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 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 +## +## 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 . +## + +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 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//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 f560e5a..8ce61a8 100644 --- 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 b86c239..e65dda5 100644 --- 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 98bd74e..b022428 100644 --- 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 aff029a..883012a 100644 --- 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 c8c1bb0..5649f8e 100644 --- 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)