new-bank-patch-tool ["name"] ([ banks ... ] | list of banks) [parent] [-connect-all] ["group"] offset size [value] [-inject]
Creates a new bank patch tool object which can be connected to register banks.
The optional name argument can be used to set a name of the created object. If no name is given, a default name patch_tool followed by a sequence number is generated (patch_tool0, patch_tool1,...).
The optional banks argument, supports connecting one or several banks directly. With the optional parent argument a hierarchical object can be specified and all banks below this object matching the provider requirements will be connected to the tool. The -connect-all flag can be given to add a connection to all supported banks in the configuration.
The optional argument group let a user specify a named instrumentation group to use for the connection. (See add-instrumentation-group for details on named groups.)
Each new connection to the patch tool may be configured by providing the instrumentation start address (offset), the instrumentation range (size), and the value to be read in place of a otherwise mapped register values (value).
Providing an offset and a size of 0 will instrument the entire bank. Access misses may also be injected using the -inject flag, which is disabled by default
bank-patch-tool