modularmx/openocd repository overview

⁠Quick Reference

• Maintained by Modular MX⁠

⁠Supported tags

• 12.x, latest
• 12.0.4

⁠How to use this image

The image has been prepared to run OpenOCD only with the goal to keep the container as small as possible. it is build from source but using the stm32 version with the goal to support the STM32 family of microcontrollers.

By default to container will run the cotnianer with a root user, but this will change in the future. To run the container make sure to use the --device flag to map the USB ports to the container, and the -p flag to map the port 3333 to the host computer.

docker run -it --rm --device=/dev/bus/usb:/dev/bus/usb -p 3333:3333 modularmx/openocd:latest

Once the container is running, you can connect to the OpenOCD server as you usualy do with OpenOCD installed in a host computer the only thing to taken into account is the IP address assigned to the container. for instance with the following line OpenOCD will wait a GDB connection on the port 3333 and the IP address 172.17.0.3

openocd -f board/st_nucleo_g0.cfg -c "bindto 172.17.0.3"

⁠Using compose

You can also check our nice tutorial How to run images with compose⁠

networks:
  static_net:          # network name to be used by containers
    driver: bridge    # network driver
    ipam:     
      config:         # network configuration
        - subnet: 172.25.0.0/16 # network subnet
          gateway: 172.25.0.1   # network gateway

services:
  open_server:      # container name been used by the image to connect to openocd
    image: modularmx/openocd:latest
    ports:          # port mapping
      - 3333:3333
    devices:        # device mapping to usb ports
      - /dev/bus/usb:/dev/bus/usb
    networks:
      static_net:         # use network static_net
        ipv4_address: 172.25.0.3  # assing ip address to container
    command: openocd -f board/st_nucleo_g0.cfg -c "bindto 172.17.0.3"