|metaonly config Defaults.noRuntimeCommon$ // module-wide
Defaults inherited by the target modules that do not need the runtime
Modules for which the attribute @NoRuntime is set cannot use any
functionality controlled by the parameters in their common$
structures. For such modules, these parameters are set to the
following values, and cannot be changed. This ensures that
@NoRuntime modules not used in situations where the normal
module runtime features are required.
|metaonly config Defaults.common$ // module-wide
Defaults inherited by all target modules
All modules have this configuration parameter. Its name
contains the '$' character to ensure it does not conflict with
configuration parameters declared by the module. This allows
new configuration parameters to be added in the future without
any chance of breaking existing modules.
This structure defines the default values for the configuration
parameters shared by all modules in a system. Unless otherwise
noted, setting one of the fields defined below will set the
corresponding value for all modules in the system which have not
been explicitly set; i.e., it will establish a default value for
However, the modules from this package (xdc.runtime) are an
exception. The values from Default.common$ are not copied to
logger and diags_ properties of common$ in xdc.runtime
modules. The property diags_ASSERT is an exception to that exception.
Its value from Default.common$ is copied to all modules for which
diags_ASSERT has not been explicitly set.
Enables asserts at runtime. Default is ALWAYS_ON
Enables entry trace for all functions. Default is ALWAYS_OFF
Enables exit trace for all functions. Default is ALWAYS_OFF
Enables internal asserts. Default is ALWAYS_OFF. When set to
ALWAYS_ON, requires diags_ASSERT to be ALWAYS_ON.
Enables logging of lifecycle events. These events are logged during
creates and deletes. Default is ALWAYS_OFF.
Enables logging of status events, such as error and warning events.
Default is ALWAYS_ON. Note that this does not mean that logging will
occur by default--a logger instance must also be configured for the
module in order for events to be logged.
Enables logging of generic informational events. Default is
Enables logging of analysis events, such as benchmarking events.
Default is ALWAYS_OFF.
Each diags_USER field controls a separate user-defined
logging level. Default is ALWAYS_OFF for all diags_USER fileds.
Default gate used by all modules which are declared as being @Gated
By default, this parameter points to an instance of GateNull
which means there is no protection.
The default parameters used to create gates at runtime. See
. Default is null
Specify heap to be used for module instances. Default is null
, instances will be allocated from
the heap specified by Memory.defaultHeapInstance
Specify section to be used to place module instances. Default is
Default logger used by modules to write logs. By default there is
Used to specify type of application. Types.STATIC_POLICY is used when
all objects are created statically. Types.CREATE_POLICY is used when
the application creates objects at runtime. Types.DELETE_POLICY is
used when the application creates and deletes objects at runtime. This
helps eliminate unwanted create and delete code.
This parameter should be set to true if space needs to be allocated in
instance objects for instance names. Allocating space for a name
allows object view tools to display the names. The runtime functions
Mod_Handle_name() and Mod_Handle_label() defined for each module
Mod can be used to retrieve the name at runtime.
This field allows the name of the module to be retained on the target.
Setting this to false will save space but will also prevent
the target from being able to display the module names appearing
in Log events and Errors.
causes all modules, except for
to be unnamed by default. To
eliminate the string names for these modules you must explicitly
set their common$.namedModule
parameters to false
; without these
two names, target-side display of error messages is somewhat cryptic.
Specify whether modules that are allocated to ROM are patchable.
|metaonly Defaults.getCommon() // module-wide
Get a specified common parameter from a module
module whose parameter is queried
string naming the queried parameter
Get the value of a member of the structure common$ based on
defaults and the current value of the parameter. If the current value
of param is undefined, the function returns the default value
for that parameter from Default.common$.
Returns the value of the parameter named param from the module