MSTMCRA(1)

✨ NAME ✨

mstmcra — the Mellanox Configuration Registers Access tool 💅 (yes that's the whole name, she's fancy like that)

This page lives in the User Commands manual as MSTMCRA(1) — welcome to the group chat, bestie 🫶

---

🌸 DESCRIPTION 🌸

Okay so, here's the whole vibe. mstmcra reads and writes a single word from/to a device configuration register space. That's the tea. ☕

Usage goes a little something like this:

mstmcra [-s <i2c-slave>] [-a <adb dump>] [-v] [-h] [-c] <device> <addr[.<bit offset>:<bit size>]|[,<bytes number>]> [data]

So you hand her a <device>, then an address shaped like <addr[.<bit offset>:<bit size>]|[,<bytes number>]>, and optionally some [data].

• If data is given → it's a write, periodt.
• If data is not given → it's a read, no cap. 🙈

🦋 when there's a bit range in the address 🦋

Like, if you give a bit range in the address (E.G.: 0xf0014.16:8):

For read

• Only the requested bits get printed. Nothing extra, she's not nosy. ✨

For write — this is a Read-Modify-Write situation, bestie.

• Only the requested bits get changed. The rest stay exactly as they were, iconic behaviour honestly. 👑

🎀 when there's a bytes number in the address 🎀

Like, if 'bytes number' is given in the address (E.G.: 0xf0014,16):

For read

• She'll read a block, and its size is the given bytes number.

For write

• You (the user) need to give a list of dwrods to write, and the number of dwords should be (bytes number/4).

🛠️ the flags, one by one 🛠️

• -s <i2c-slave> — the I2C slave address.
• -a <dump file> — adb dump file, used for access by path.
• -c — clears the device's PCI semaphore. 💀
• -h — prints this help message.
• -v — displays version info.

🌱 Environment Variables 🌱

• ADB_DUMP — holds the path to the adb dump, used for access by path. And yeah, it can be overridden by -a. She said "I contain multitudes" 💖

---

👀 SEE ALSO 👀

mstflint(1) — go read that one next, iykyk 🧚

---

mstflint · March 2020 — that's the source, the version and the date, and that's the whole page, bestie. slay, bye 💜🌸🦋