MESAFLASH(1)

💖 MESAFLASH 💖

okay bestie, so this is mesaflash — it's the little utility in the General Commands Manual that flashes Mesa Electronics FPGA cards. yes. literally that. she reads, she writes, she configures. she does it all. 💅

---

✨ NAME ✨

MesaFlash — the utility that flashes Mesa Electronics FPGA Cards 🦋

---

🌸 SYNOPSIS 🌸

mesaflash [options] [commands]

---

🎀 DESCRIPTION 🎀

mesaflash reads, writes, and configures Mesa Electronics FPGA cards. that's the whole vibe. no cap. 💖

---

👑 OPTIONS 👑

• --device name — pick which device is the active one, bestie. if you don't hand it a command, it's gonna detect the board with that given name and print info about it. 🌈

the special values "ETHER", "SPI" and "AUTO" will attempt to detect a device on ethernet, SPI, or any interface — but heads up, --addr still needs to be specified for non-PCI devices. not optional. periodt. 💅

• --addr [ip]|[device] — use an ip or a device name to look for <name> (IP address for Ethernet boards, serial device name for USB boards and serial boards, SPI device name for SPI boards). 🫶
• --addr_hi — sets the high register address for the EPP interface. ✨
• --epp — use the EPP interface to connect to the board. only for boards with multiple interfaces (7c80, 7c81, 7i43, 7i90, 7i64). 🔥
• --usb — use the USB interface to connect to the board. again, only for boards with multiple interfaces (7c80, 7c81, 7i43, 7i90, 7i64). 🌸
• --spi — use the SPI interface to connect to the board. you guessed it, only for boards with multiple interfaces (7c80, 7c81, 7i43, 7i90, 7i64). ⭐
• --serial — use the serial interface to connect to the board. only for boards with multiple interfaces (7i43, 7i90, 7i64). 💜
• --fallback — use the fallback area of the FLASH memory while executing commands. 🙈
• --recover — access the board using the PCI bridge GPIO (currently only 6I24/6I25). 🧚
• --xml — formats the output from the readhmid command into XML. iconic. ✨
• --dbname# name — set the daughter board name to name for FPGA connector N. this lets readhmid include daughterboard terminal names, where # can be in the range 1 to 6 (1 means first FPGA connector). 🎀
• --verbose — prints detailed information while running commands. she's chatty, we love her. 💬

---

🌈 COMMANDS 🌈

• --write filename — writes a standard bitfile filename configuration to the userarea of the FLASH memory. IMPORTANT! filename must be a VALID FPGA configuration file. don't play with her. 💀
• --fix-boot-block — if a write operation does not detect a valid boot block, write one. 🛠️
• --no-auto-verify — don't automatically verify after writing. living dangerously, i see you. 🙈
• --verify filename — verifies the FLASH memory configuration against the bitfile filename. 🫶
• --program filename — writes a standard bitfile filename configuration to the FPGA. IMPORTANT! filename must be a VALID FPGA configuration file. same energy as --write, different destination, bestie. ⭐
• --backup-flash filename|dirname — backup all content of the FLASH memory to the file filename or to the directory dirname with auto naming dump file. 💾
• --restore-flash filename — restore all content of the FLASH memory from a file filename.

IMPORTANT! can't use a dump file from different types of boards. unacceptable to interrupt the restoring process. if the restoring process was interrupted, do not turn off the board power and do not reload the board, and run the restore process again. required SHA256 checksum file filename.sha256. 😭

• --sha256-check — integrity check the FPGA configuration bitfile before writing. required SHA256 checksum file filename.sha256. 🔒
• --readhmid — print hostmot2 configuration in PIN file format. 📌
• --print-pd — print hostmot2 Pin Descriptors. 🌸
• --reload — do a full FPGA reload from FLASH memory (only Ethernet, SPI and PCI boards). 🔄
• --reset — do a full firmware reset (only Ethernet and serial boards). 💫
• --sserial — print full information about all sserial remote boards. 🦋
• --rpo address — read hostmot2 variable directly at address. 👀
• --wpo address value — write hostmot2 variable directly at address with value. ✍️
• --setip="n.n.n.n" — set the board IP address in EEPROM memory to n.n.n.n (only Ethernet boards). 🌐
• --info filename — print info about configuration in filename. ℹ️
• --help — print the help message. she's helpful, she's humble, she's everything. 💅

---

💀 BUGS 💀

no known bugs. she's flawless. not me being obsessed with a perfectly behaved utility fr fr. 👑

---

🫶 AUTHOR 🫶

• LinuxCNC Developer Community <emc-developers@lists.sourceforge.net>
• Michael Geszkiewicz <micges@wp.pl>
• Peter Wallace <tech@mesanet.com>

---

💜 COPYRIGHT 💜

GNU GPL v2+ License 🌈

• Copyright (c) 2020 Sebastian Kuzminsky
• Copyright (c) 2019 Peter Wallace
• Copyright (c) 2013-2015 Michael Geszkiewicz

---

okay that's the whole page, bestie!! this was version 3.4.6, dated November 5 2022, and she lives in the General Commands Manual — go flash something iconic, ily, bye!! 🎀✨💖