1MESAFLASH(1)                General Commands Manual               MESAFLASH(1)
2
3
4

NAME

6       MesaFlash - utility to flash Mesa Electronics FPGA Cards
7

SYNOPSIS

9       mesaflash [options] [commands]
10

DESCRIPTION

12       mesaflash Read, write, configure Mesa Electronics FPGA cards.
13

OPTIONS

15       --device name
16              Select active device name. If no command is given it will detect
17              board with given name and print info about it.
18
19              The special values "ETHER", "SPI" and "AUTO" will attempt to de‐
20              tect  a  device on ethernet, SPI, or any interface; --addr still
21              needs to be specified for non-PCI devices.
22
23       --addr [ip]|[device]
24              Use ip or device name to look for <name> (IP address for  Ether‐
25              net boards, serial device name for USB boards and serial boards,
26              SPI device name for SPI boards)
27
28       --addr_hi
29              Set the high register address for the EPP interface.
30
31       --epp  Use EPP interface to connect to board, only for boards with mul‐
32              tiple interfaces (7c80, 7c81, 7i43, 7i90, 7i64).
33
34       --usb  Use USB interface to connect to board, only for boards with mul‐
35              tiple interfaces (7c80, 7c81, 7i43, 7i90, 7i64).
36
37       --spi  Use SPI interface to connect to board, only for boards with mul‐
38              tiple interfaces (7c80, 7c81, 7i43, 7i90, 7i64).
39
40       --serial
41              Use  serial  interface to connect to board, only for boards with
42              multiple interfaces (7i43, 7i90, 7i64).
43
44       --fallback
45              Use the fallback area of the FLASH memory while  executing  com‐
46              mands.
47
48       --recover
49              Access board using PCI bridge GPIO (currently only 6I24/6I25).
50
51       --xml  Format output from 'readhmid' command into XML.
52
53       --dbname# name
54              Set  daughter  board name to 'name' for FPGA connector 'N'.  Al‐
55              lows readhmid to include daughterboard terminal names,  where  #
56              can be in the range 1 to 6 (1 means first FPGA connector).
57
58       --verbose
59              Print detailed information while running commands.
60

COMMANDS

62       --write filename
63              Writes  a standard bitfile 'filename' configuration to the user‐
64              area of the FLASH memory (IMPORTANT! 'filename'  must  be  VALID
65              FPGA configuration file).
66
67       --fix-boot-block
68              If  a  write operation does not detect a valid boot block, write
69              one.
70
71       --no-auto-verify
72              Don't automatically verify after writing.
73
74       --verify filename
75              Verifies the FLASH  memory  configuration  against  the  bitfile
76              'filename'.
77
78       --program filename
79              Writes  a  standard bitfile 'filename' configuration to the FPGA
80              (IMPORTANT! 'filename' must be VALID FPGA configuration file).
81
82       --backup-flash filename|dirname
83              Backup all content the FLASH memory to the file 'filename' or to
84              the directory 'dirname' with auto naming dump file.
85
86       --restore-flash filename
87              Restore all content the FLASH memory from a file 'filename' (IM‐
88              PORTANT! Can't use a dump file from different types  of  boards.
89              Unacceptable  interrupt the restoring process.  If the restoring
90              process was interrupted, do not turn off the board power and  do
91              not  reload  board,  and  run  restore  process again). Required
92              SHA256 checksum file 'filename.sha256'.
93
94       --sha256-check
95              Integrity check FPGA configuration bitfile before writing.   Re‐
96              quired SHA256 checksum file 'filename.sha256'.
97
98       --readhmid
99              Print hostmot2 configuration in PIN file format.
100
101       --print-pd
102              Print hostmot2 Pin Descriptors.
103
104       --reload
105              Do  full  FPGA  reload from FLASH memory (only Ethernet, SPI and
106              PCI boards).
107
108       --reset
109              Do full firmware reset (only Ethernet and serial boards).
110
111       --sserial
112              Print full information about all sserial remote boards.
113
114       --rpo address
115              Read hostmot2 variable directly at 'address'.
116
117       --wpo address value
118              Write hostmot2 variable directly at 'address' with 'value'.
119
120       --setip="n.n.n.n"
121              Set board IP address in EEPROM memory to n.n.n.n (only  Ethernet
122              boards).
123
124       --info filename
125              Print info about configuration in 'filename'.
126
127       --help Print the help message
128

BUGS

130       No known bugs.
131

AUTHOR

133       LinuxCNC Developer Community <emc-developers@lists.sourceforge.net>
134
135       Michael Geszkiewicz <micges@wp.pl>
136
137       Peter Wallace <tech@mesanet.com>
138

140       GNU GPL v2+ License
141
142       Copyright (c) 2020 Sebastian Kuzminsky
143
144       Copyright (c) 2019 Peter Wallace
145
146       Copyright (c) 2013-2015 Michael Geszkiewicz
147
148
149
150version 3.4.6                   November 5 2022                   MESAFLASH(1)
Impressum