Interface Simultaneous

interface Simultaneous {
    asmStepInto(targets: string | string[]): void;
    halt(targets: string | string[]): void;
    run(targets: string | string[], waitForHalt?: boolean): void;
}

Methods

  • Simultaneously perform an assembly step-into operation on all targets specified.

    Parameters

    • targets: string | string[]

      A list of the targets to step.

    Returns void

    The targets should be specified by their full names. The full names of targets can be obtained from DebugSession.getName or {@DebuggerScripting.listCores}.

    Will throw if any target specified:

    • does not exist,
    • is not connected (see {@Target.connect}), or
    • is not halted.
    const session1 = ds.openSession("Cortex_R5_0_0");
    const session2 = ds.openSession("Cortex_R5_0_1");

    // In this case, the full names of each core is longer than what we provided to openSession
    const targets = [session1.getName(), session2.getName()];

    // Assume we have connected, loaded a program, etc. on both cores.

    // Step both targets simultaneously
    ds.simultaneous.asmStepInto(targets);
  • Simultaneously halt all targets specified.

    Parameters

    • targets: string | string[]

      A list of the targets to halt.

    Returns void

    The targets should be specified by their full names. The full names of targets can be obtained from DebugSession.getName or {@DebuggerScripting.listCores}.

    Will throw if any target specified:

    • does not exist, or
    • is not connected (see {@Target.connect}).
    const session1 = ds.openSession("Cortex_R5_0_0");
    const session2 = ds.openSession("Cortex_R5_0_1");

    // In this case, the full names of each core is longer than what we provided to openSession
    const targets = [session1.getName(), session2.getName()];

    // Assume we have connected, loaded a program, issued a run, etc. on both cores.

    // Halt both targets simultaneously
    ds.simultaneous.halt(targets);
  • Simultaneously run all targets specified.

    Parameters

    • targets: string | string[]

      A list of the targets to run.

    • OptionalwaitForHalt: boolean

      Whether the operation should wait for all targets to halt after running. Defaults to true.

    Returns void

    The targets should be specified by their full names. The full names of targets can be obtained from DebugSession.getName or {@DebuggerScripting.listCores}.

    Will throw if any target specified:

    • does not exist,
    • is not connected (see {@Target.connect}), or
    • is not halted.
    const session1 = ds.openSession("Cortex_R5_0_0");
    const session2 = ds.openSession("Cortex_R5_0_1");

    // In this case, the full names of each core is longer than what we provided to openSession
    const targets = [session1.getName(), session2.getName()];

    // Assume we have connected, loaded a program, etc. on both cores.

    // Run both targets simultaneously and wait for both to halt
    ds.simultaneous.run(targets);

    // Run both targets simultaneously return immediately once both are running
    ds.simultaneous.run(targets, false);