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