The Open On-Chip Debugger (OpenOCD) aims to provide debugging, in-system
programming and boundary-scan testing for embedded target devices. OpenOCD
uses a "hardware interface dongle" to communicate with the JTAG (IEEE 1149.1)
compliant taps on your target board. OpenOCD currently supports many types
of hardware dongles: USB based, parallel port based, and other standalone boxes
that run OpenOCD internally. It allows MIPS, ARM7, ARM9, XScale and Cortex
based cores to be debugged via the GDB protocol. Flash writing is supported
for external CFI compatible NOR flashes, NAND and several internal flashes.
===> The following configuration options are available for openocd-0.12.0_5:
====> Build with debugging support
VERBOSE_JTAGIO=off: Enable verbose JTAG I/O messages
VERBOSE_USBIO=off: Enable verbose USB I/O messages
VERBOSE_USBCOMM=off: Enable verbose USB communication messages
====> Hardware adapters/programmers/debuggers support
BITBANG_REMOTE=on: Remote bitbang driver
LIBUSB=on: Adapters using libusb
LIBHIDAPI=on: Adapters using libhidapi
LIBFTDI=on: Adapters using libftdi
SERIAL=on: Adapters using serial port
PARPORT=off: Adapters using parallel port
====> Jim Tcl interpreter: you have to select exactly one of them
JIMTCL_INTERNAL=on: Internal
JIMTCL_EXTERNAL=off: External
===> Use 'make config' to modify these settings
OpenOCD is now installed, this software can damage your hardware, enjoy!
User's guide is at:
http://openocd.sourceforge.net/documentation/online-docs/
Developer's guide is at:
http://openocd.sourceforge.net/documentation/openocd-reference-manual/
FreeBSD USB NOTE:
To allow an ordinary user to acces any of the the hotplug USB interface
add him/her to the operator group (pw groupmod operator -m username), then
setup the devfs subsystem by adding these lines to the following files:
***/etc/devfs.rules:
[localrules=10]
add path 'ugen*' mode 0660 group operator
add path 'usb/*' mode 0660 group operator
add path 'usb' mode 0770 group operator
***/etc/rc.conf:
devfs_system_ruleset="localrules"
devel/openocd: Unbreak aarch64 build
Working around an issue where upstream provided page size macros are
colliding with page size macros from <machine/param.h>.
PR: 283034
Reported by: Duane (parakleta@darkreality.org)
devel/openocd: Overhaul Makefile
Major overhaul after taking over maintainership.
Background information to understand some of the changes: OpenOCD is a piece
of software which talks to chip programming/debugging adapters (hardware).
Different adapters use different interface to connect to the host OS (such as
USB).
* Previously, the port provided one option per upstream supported adapter.
This was changed to a "per-interface" option as we mostly care about handling
dependencies rather than sequezing out every single byte of the resulting
binary size.
* Upstream's doxygen documentation has been removed from this port as this
(Only the first 15 lines of the commit message are shown above )
Remove WWW entries moved into port Makefiles
Commit b7f05445c00f has added WWW entries to port Makefiles based on
WWW: lines in pkg-descr files.
This commit removes the WWW: lines of moved-over URLs from these
pkg-descr files.
Approved by: portmgr (tcberner)
Add WWW entries to port Makefiles
It has been common practice to have one or more URLs at the end of the
ports' pkg-descr files, one per line and prefixed with "WWW:". These
URLs should point at a project website or other relevant resources.
Access to these URLs required processing of the pkg-descr files, and
they have often become stale over time. If more than one such URL was
present in a pkg-descr file, only the first one was tarnsfered into
the port INDEX, but for many ports only the last line did contain the
port specific URL to further information.
There have been several proposals to make a project URL available as
a macro in the ports' Makefiles, over time.
(Only the first 15 lines of the commit message are shown above )
devel/openocd: Fix build with -fno-common
Fix the build of devel/openocd with -fno-common. The patch is based on the
upstream fix.
MFH: 2020Q3 (implicit, -fno-common fixes, ok by joenum)
Install texinfo files (GNU info) into ${PREFIX}/share/info
After a discussion on the mailing list on moving manpages to
${PREFIX}/share/man for consistency with base where it is
installed in usr/share/man, it appeared the same should happen
to GNU info files which were installed under share in base and
not in ports.
Now texinfo is not in base on any of the supported version of FreeBSD
it is possible to proceed to this move and it is easier to do than
the manpage change.
Other benefit than consistency are less patching: all build tools but
cmake are expecting info files to be under share/info and cmake (patched here)
was having an exception for BSD so the patch makes FreeBSD case less
specific for them
Bump revision of all impacted ports
PR: 232907
exp-run by: antoine
Differential Revision: https://reviews.freebsd.org/D17816
Remove compatibility code for FreeBSD < 11.2 from all ports.
Simplify some ports where DragonFlyBSD no longer needs to be special-cased.
Submitted by: rene
Reviewed by: bapt, jbeich
Differential Revision: https://reviews.freebsd.org/D17724
Mark some ports failing on power64. In cases where the error message
was a stub, provide a real one.
While here, pet portlint.
Approved by: portmgr (tier-2 blanket)
Assume "pkg-config libusb*" works after 9.x EOL
FreeBSD appears to use different pkg-config name for 0.1.x API but it
doesn't matter much as 0.1, 1.0 and 2.0 share CFLAGS/LIBS.
In preparation of removing devel/libusb (expires 2013-04-30), remove it
from these ports.
Other changes:
- convert Makefile header
- convert to optionsNG
- remove indefinite article from comment
- drop support for FreeBSD < 8.0
- pet portlint (leave library ABI versions in LIB_DEPENDS)
- net-mgmt/spectools: change option name from GTK to GTK2 to use default
description from bsd.options.desc.mk
Approved by: portmgr (bapt)
The Open On-Chip Debugger (OpenOCD) aims to provide debugging, in-system
programming and boundary-scan testing for embedded target devices. OpenOCD uses
a "hardware interface dongle" to communicate with the JTAG (IEEE 1149.1)
compliant taps on your target board. OpenOCD currently supports many types
of hardware dongles: USB based, parallel port based, and other standalone boxes
that run OpenOCD internally. It allows ARM7 (ARM7TDMI and ARM720t),
ARM9 (ARM920T, ARM922T, ARM926EJ-S, ARM966E-S), XScale (PXA25x, IXP42x) and
Cortex-M3 (Luminary Stellaris LM3 and ST STM32) based cores to be debugged
via the GDB protocol. Flash writing is supported for external CFI compatible
NOR flashes (Intel and AMD/Spansion command set) and several internal flashes
(LPC2000, AT91SAM7, STR7x, STR9x, LM3, and STM32x). Preliminary support for
various NAND flash controllers (LPC3180, Orion, S3C24xx, more) controller is
included.
WWW: http://openocd.berlios.de/
PR: 135094
Submitted by: CeDeROM <tomek.cedro@gmail.com>