Skip to content

Commit 559e250

Browse files
committed
docs: note that PnCconf requires pre-flashed Mesa firmware
PnCconf only reads the firmware already on the card; it never flashes. State this explicitly along with the mesaflash command and the consequence of a mismatch, a recurring point of confusion for users.
1 parent bc3248e commit 559e250

1 file changed

Lines changed: 4 additions & 0 deletions

File tree

docs/src/config/pncconf.adoc

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -82,6 +82,10 @@ Parallel ports can only be used for simple low speed (servo rate) I/O.
8282
Mesa::
8383
You must choose at least one Mesa board as PnCconf will not configure the parallel ports to count encoders or output step or PWM signals.
8484
The mesa cards available in the selection box are based on what PnCconf finds for firmware on the systems.
85+
PnCconf does not load firmware onto the card - it only reads the firmware already present to learn which pins and components exist, and writes the HAL/INI files to match.
86+
The card must already run the firmware you intend to configure.
87+
Firmware is loaded beforehand with the `mesaflash` utility, e.g. `mesaflash --device 7i92 --write 7i92t_xxx.bit`; the card must be power-cycled after flashing.
88+
Selecting a firmware in PnCconf that differs from the one actually flashed results in HAL load errors or wrong pin names.
8589
There are options to add custom firmware and/or 'blacklist' (ignore) some firmware or boards using a preference file.
8690
If no firmware is found PnCconf will show a warning and use internal sample firmware - no testing will be possible.
8791
One point to note is that if you choose two PCI Mesa cards there currently is no way to predict which card is 0 and which is 1 - you must test - moving the cards could change their order.

0 commit comments

Comments
 (0)