cross-compile/macosx: install IRMP dylib in library directory (DMG creation)
[sigrok-util.git] / firmware / kingst-la / sigrok-fwextract-kingst-la2016.1
1 .TH SIGROK\-FWEXTRACT\-KINGST\-LA2016 1 "Mar 13, 2021"
2 .SH "NAME"
3 sigrok\-fwextract\-kingst\-la2016 \- Extract Kingst firmware from vendor software
4 .SH "SYNOPSIS"
5 .B sigrok\-fwextract\-kingst\-la2016 [FILE]
6 .SH "DESCRIPTION"
7 This tool extracts the FX2 MCU firmware and FPGA bitstreams for the Kingst
8 LA2016/LA1016 USB logic analyzers from the vendor software. These
9 analyzers share the same USB VID:PID and use the same FX2 firmware.
10 The correct FPGA bitstream is selected by the libsigrok driver after
11 loading the FX2 firmware and reading the device identifier from EEPROM.
12 .PP
13 Download the Linux version of the vendor software from [1], and unpack
14 it to find the main binary called "KingstVIS". To extract the
15 firmware and bitstreams, run the following commands:
16 .PP
17 .B "  $ tar -xzf KingstVIS_v3.5.0_linux.tar.gz KingstVIS"
18 .PP
19 .B "  $ sigrok-fwextract-kingst-la2016 KingstVIS/KingstVIS"
20 .br
21 .RB "  saved 5430 bytes to kingst-la-01a2.fw (crc32=720551a9)"
22 .br
23 .RB "  saved 178362 bytes to kingst-la2016a1-fpga.bitstream (crc32=7cc894fa)"
24 .br
25 .RB "  saved 178542 bytes to kingst-la2016-fpga.bitstream (crc32=20694ff1)"
26 .br
27 .RB "  saved 178379 bytes to kingst-la1016a1-fpga.bitstream (crc32=166866be)"
28 .br
29 .RB "  saved 178151 bytes to kingst-la1016-fpga.bitstream (crc32=7db70001)"
30 .PP
31 Copy the above firmware and bitstream files to the location where libsigrok
32 expects to find firmware files. By default this is
33 .BR /usr/local/share/sigrok-firmware .
34 .SH OPTIONS
35 None.
36 .SH "EXIT STATUS"
37 Exits with 0 on success, 1 on most failures.
38 .SH "SEE ALSO"
39 \fBsigrok\-fwextract\-dreamsourcelab\-dslogic\fP(1)
40 .br
41 \fBsigrok\-fwextract\-hantek\-dso\fP(1)
42 .br
43 \fBsigrok\-fwextract\-lecroy\-logicstudio\fP(1)
44 .br
45 \fBsigrok\-fwextract\-saleae\-logic16\fP(1)
46 .br
47 \fBsigrok\-fwextract\-sysclk\-lwla1016\fP(1)
48 .br
49 \fBsigrok\-fwextract\-sysclk\-lwla1034\fP(1)
50 .SH "BUGS"
51 Please report any bugs via Bugzilla
52 .RB "(" http://sigrok.org/bugzilla ")"
53 or on the sigrok\-devel mailing list
54 .RB "(" sigrok\-devel@lists.souceforge.net ")."
55 .SH "LICENSE"
56 This program is covered by the GNU General Public License (GPL),
57 version 3 or later.
58 .SH "AUTHORS"
59 Please see the individual source code files.
60 .SH "NOTES"
61 .IP " 1." 4
62 Vendor website
63 .RS 4
64 .RB http://www.qdkingst.com/download
65 .br
66 \%MD5 of v3.5.0: 812bbd37a16d315a489ca33ea2868a36