1MINIPRO(1) General Commands Manual MINIPRO(1)
2
6 minipro - programs various chips using the Minipro TL866XX series of
7 programmers.
8
10 minipro -l | -L search | -d device | -D | [-p device] [-c
11 code|data|config] [-o option ... ] [-r|-w filename]
12 [-e][-u][-P][-i|-I][-v][-s|-S][-x][-y][-V][-t] [-f ihex|srec] [-F file‐
13 name] [-h]
14 miniprohex [-p device] [-c code|data|config] [-r|-w filename]
16 [-e][-u][-P][-i|-I]
17
20 minipro is an Open Source tool intended to become a complete cross-
21 platform replacement for the proprietary utility from Autoelectric.
22 Currently it supports more than 13000 of target devices - including
23 AVRs, PICs as well as a huge number of other microcontrollers and vari‐
24 ous memory chips.
25
29 -l Get a list of supported devices.
30 -L <search>
33 List devices beginning with this string.
34 -d <device>
37 Show device information.
38 -D Just read the chip ID and do nothing else (like reading the
41 whole chip contents). This is for use in scripts where you have
42 for example several similar chips with different IDs and want to
43 check if the currently inserted chip is one in your list of
44 allowed ones. Also useful to detect if a chip is inserted at all
45 when using the -y option.
46 -p <device>
49 Specify the device name. If the desired device name contains a
50 space, parenthesis, or at sign; the device name MUST be sur‐
51 rounded by quotes.
52 -c <type>
55 Optionally specify memory type. Possible values include "code",
56 "data", and "config". The "config" memory type is used to access
57 fuses, see FUSES below.
58 -o <option>
61 Specify various programming options. For multiple options use -o
63 multiple times. Valid options are:
64 · vpp=<value>
67 Set the programming voltage (10, 12.5, 13.5, 14, 16, 18,
69 21).
70 · vdd=<value>
73 Set the VDD write voltage (3.3, 4, 4.5, 5, 5.5, 6.25).
75 · vcc=<value>
78 Set the VCC verify voltage (3.3, 4, 4.5, 5, 5.5, 6.25).
80 · pulse=<value>
83 Set the programming pulse delay (0-65535 usec).
85 -r <filename>
88 Read from the device and write the contents to this file.
89 -w <filename>
92 Write to the device using this file.
93 -e Do NOT erase device.
96 -u Do NOT disable write-protect.
99 -P Do NOT enable write-protect.
102 -v Do NOT verify after write.
105 -i Use ICSP.
108 -I Use ICSP (without enabling Vcc).
111 -s Do NOT error on file size mismatch (only a warning).
114 -S No warning message for file size mismatch (can't combine with
117 -s).
118 -x Do NOT attempt to read ID (only valid in read mode). Avoids
121 sending high Chip ID read voltages to unknown pins.
122 -y Do NOT error on ID mismatch.
125 -V Show version information.
128 -t Start hardware check.
131 -f <ihex | srec>
134 Specify the file format: either Intel ihex or Motorola srecord.
135 When writing chips, this is not necessary because the file for‐
137 mat is automatically detected. There is no need to specify the
138 exact Intex hex format (ihex8, ihex16, or ihex32) as the format
139 is automatically detected. If this option is not used, then the
140 file will be saved as a raw binary file.
141 When reading chips and the ihex format is chosen, if the data
143 size is up to 64Kb the file will be saved in ihex8 format. Just
144 plain hex records are used -- no segment/linear address records
145 are inserted. If the data size exceeds 64Kb then the ihex32
146 format is used. The ihex16 format is not used when reading
147 chips. The same strategy is used for the Motorola srecord for‐
148 mat.
149 -F <filename>
152 Update firmware (should be update.dat).
153 -h Show help and quit.
156
159 If -c is omitted and -r is specified then the code, data (if applica‐
160 ble) and config (if applicable) will be written to filename.$ext, file‐
161 name.eeprom.bin and filename.fuses.conf correspondingly. If -c is omit‐
162 ted and -w is specified, then -c code is assumed.
163 The -i and -I options enable use of ICSP port for TL866A and TL866II+
165 models. The former enables the voltage supply on the Vcc pin of the
166 ICSP port while the latter leaves it off. These options are of no use
167 for the TL866CS.
168 The Minipro TL866xx series of chip programmers is distributed by Auto‐
170 electric. Their website is http://www.autoelectric.cn.
171
174 Minipro supports reading and writing to standard input and output. To
175 do this, use a dash (-) as a filename for the -w or -r options.
176 For example:
178 head -c 256k < /dev/urandom | srec_cat - -bin -o - -intel
180 -Address_Length=4 -obs=16 | minipro -p w49f002u -w-
181 This is how the hex/srec parsers were tested for reading from stdin.
183 256kb of random binary data is generated then converted from binary to
184 intel hex by the srec_cat utility. Finally the converted data is passed
185 to our minipro which will read this data, convert it to binary by
186 decoding the intel hex format from stdin and write it to the specified
187 chip. Note the -r- which tells to read from stdin instead from a regu‐
188 lar file. This is just a test command to test the ihex/srec parsers.
189 Don't use this in real life (convert from binary to ihex then from ihex
190 to binary).
191 You can also read a chip and write the data to the stdout like this:
193 minipro -p w49f002u -r- -f ihex.
195 You can then pass the output to another command line tool with | for
197 other processing, etc.
198
201 Fuses can be read and written with the -c config option. Fuse data is
202 exchanged in a text format. When writing fuses all fuses on your device
203 must be assigned a value. To see what fuses are supported by your
204 device use -r with -c config to get your current fuse values. This also
205 shows you what the text format looks like.
206
209 minipro was written by Valentin Dudouyt and is copyright 2014. Many
210 others have contributed code and bug reports. Development is currently
211 coordinated by David Griffith.
212
215 The canonical repository for minipro is at Gitlab:
216 https://gitlab.com/DavidGriffith/minipro/
217 It is distributed under the GNU General Public License version 3 or (at
218 your option) any later version.
219 https://www.gnu.org/licenses/gpl-3.0.en.html
220 This software is offered as-is with no warranty or liability. If you
221 find a bug or would like minipro to do something it doesn't currently
222 do, please visit the above Gitlab website and report your concerns.
223 14 August 2018 (v0.3) MINIPRO(1)