blackmagic/driver
Piotr Esden-Tempski 470f66f387 rtt: Cleaned up updated and improved the RTT usage documentation.
This resulted in a small addition to the drivers readme adding some
basic udev rule installation instructions.
2022-08-22 20:36:20 -04:00
..
99-blackmagic-plugdev.rules driver/udev: Fixed a couple of other small issues with the rules 2022-06-12 16:07:07 -07:00
99-blackmagic-uucp.rules driver/udev: Fixed a couple of other small issues with the rules 2022-06-12 16:07:07 -07:00
README.md rtt: Cleaned up updated and improved the RTT usage documentation. 2022-08-22 20:36:20 -04:00
blackmagic.inf driver: Updated vendor name to Black Magic Debug. Closes #1009 2022-05-30 14:30:00 -07:00
blackmagic_upgrade.inf driver: Updated vendor name to Black Magic Debug. Closes #1009 2022-05-30 14:30:00 -07:00

README.md

Driver and access files for BMP

This directory contains a few different important files described in the sections below. These are:

udev rules installation

Depending on the specific distribution you can choose either the plugdev or uucp versions of udev rules. For more information about the distributions and what the differences are refer to the following sections.

Independent of which udev rule file is used, the selected file has to be copied into /etc/udev/rules.d directory. The udev rules can then be reloaded with sudo udevadm control --reload-rules. After that the Black Magic Probe can be connected to the system and the new rules should apply to the connected device.

99-blackmagic-plugdev.rules

This file contains udev rules for Linux systems that use 'plugdev' as the access group for plug-in devices. This allows GDB, dfu-util, and other utilities access to your Black Magic Probe hardware without needing sudo / root on the computer you're trying to access the hardware from.

Distros that use 'plugdev' for this purpose include:

  • Debian
  • Ubuntu
  • Linux Mint

99-blackmagic-uucp.rules

This file contains udev rules for Linux systems that use 'uucp' as the access group for plug-in devices. This allows GDB, dfu-util, and other utilities access to your Black Magic Probe hardware without needing sudo / root on the computer you're trying to access the hardware from.

Distros that use 'uucp' for this purpose include:

  • Arch
  • Manjaro

Notes about udev rules

Our udev rules include use of the 'uaccess' tag which means either rules file should just work on any modern distro that uses systemd. The specific user access group only matters when not using systemd, or on older distros that predate the user access tag.

blackmagic.inf

This is a windows driver "installation" (actually binding) information file which when right-clicked and after clicking Install will name the serial ports Black Magic Probe provides properly and provide them their proper vendor names.

blackmagic_upgrade.inf

This is a windows driver "installation" (binding) information file which when right-clicked and after clicking Install will bind suitable drivers and names to the DFU (firmware upgrade) and Trace/Capture interfaces that Black Magic Probe provides + give them their proper vendor names.