5.15.5 Event source IRIS_BREAKPOINT_HIT

This event is generated whenever a breakpoint is hit.

Breakpoints can only be hit while the simulation time is running. Normally the simulation time is stopped when a breakpoint is hit, unless dontStop=true was set on breakpoint_set(). In this case, the IRIS_BREAKPOINT_HIT event is generated but the simulation time continues running.

To receive this event from an instance, clients must explicitly call eventStream_create(IRIS_BREAKPOINT_HIT) once on that instance.

Multiple breakpoints might be hit before the simulation time is stopped. It is guaranteed that all IRIS_BREAKPOINT_HIT callbacks are called, and therefore all breakpoint hit information is present, before IRIS_SIMULATION_TIME_EVENT(running=False) is called.

This event source is instance-specific, unlike IRIS_SIMULATION_TIME_EVENT, which is global.

Table 5-9 Event source IRIS_BREAKPOINT_HIT

Field Type Description
BPT_ID NumberU64 Breakpoint id of the breakpoint that was hit.
PC NumberU64 PC value when the breakpoint was hit.
PC_SPACE_ID NumberU64 Memory space id of the PC value when the breakpoint was hit.
ACCESS_ADDR NumberU64 Optional. Address of the access that hit a data breakpoint. Mandatory for data breakpoints. Not present for other breakpoint types.
ACCESS_SIZE NumberU64 Optional. Size in bytes of the access that hit a data breakpoint. Mandatory for data breakpoints. Not present for other breakpoint types.
ACCESS_RW String Optional. Either "r" or "w". The rwMode of the access that hit a data or register breakpoint. Mandatory for these breakpoint types. Not present for other breakpoint types.
ACCESS_DATA NumberU64[] Optional. Transferred read data or write data of the access that hit a data or register breakpoint. Mandatory for these breakpoint types. Not present for other breakpoint types.
TYPE String Breakpoint type. One of:
  • code
  • data
  • register
See breakpoint_set().
DONTSTOP Boolean Optional. If and only if present and True, the simulation time did not stop because of this breakpoint hit, although it might be stopped because of other breakpoints that were hit.
Non-ConfidentialPDF file icon PDF version101196_0100_03_en
Copyright © 2018, 2019 Arm Limited or its affiliates. All rights reserved.