Class OpenOCDServerController

src/openocd.ts:52–494

}

export class OpenOCDServerController extends EventEmitter implements GDBServerController {
    // We wont need all of these ports but reserve them anyways
    public portsNeeded = ['gdbPort', 'tclPort', 'telnetPort', 'swoPort'];
    public name = 'OpenOCD';
    private args: ConfigurationArguments;
    private ports: { [name: string]: number };
    private rttHelper: RTTServerHelper = new RTTServerHelper();

    constructor() {
        super();
    }

    public setPorts(ports: { [name: string]: number }): void {
        this.ports = ports;
    }

    public setArguments(args: ConfigurationArguments): void {
        this.args = args;
        if (args.pvtOpenOCDDebug) {
            doLog = true;
        }
    }

    public customRequest(command: string, response: DebugProtocol.Response, args: any): boolean {
        return false;
    }

    public initCommands(): string[] {
        const gdbport = this.ports[createPortName(this.args.targetProcessor)];

        return [
            `target-select extended-remote localhost:${gdbport}`
        ];
    }

    public liveGdbInitCommands(): string[] {
        return this.initCommands();
    }

    // ST/OpenOCD HACK: There are two problems.
    // ST with their release on Dec 31 2021, released their FW/SW where it no longer works
    // when any configuring is done after reset. It is more than likely something that
    // was done with OpenOCD. As such, SWO config. fails. Basically, you cannot write to
    // memory/registers before at least a fake stepi is done.
    //
    // OpenOCD itself has issues that it does not report a proper stack until you do a fake
    // step. So, in some cases, your PC an the stack don't match resulting in wrong source
    // being shown.
    //
    // OpenOCD provides a hack to synchronize gdb and itself by issuing 'monitor gdb_sync' followed
    // by a 'stepi' which doesn't really do a stepi but can emulate a break due to a step that
    // gdb expects
    public launchCommands(): string[] {
        const commands = [
            ...genDownloadCommands(this.args, ['interpreter-exec console "monitor reset halt"']),
            'interpreter-exec console "monitor reset halt"'
        ];
        return commands;