DFAddressMapTarget¶
DFAddressMapTarget describes an target within an address map - i.e. a point where transactions exit a block towards their intended destination, having originated from a DFAddressMapInitiator.
A DFAddressMap can contain any number of initiators and targets, provided that there is at least one of each.
As with every tag, DFAddressMapTarget inherits from DFBase, so has support for all of the core attributes (id, description, and attributes).
{
"id": "my_target",
"description": "Free-form description",
"attributes": { },
"offset": 65536,
"aperture": 8192,
"port": {
"block": "my_root.my_sub.my_block.my_noc",
"port": "ram_t",
"index": 2
}
}
| Property | Usage |
|---|---|
| offset | Base of address window for accessing the target |
| aperture | Size of the address window for accessing the target |
| port | Details which port on the DFAddressMap's block acts as the target |
| port.block | The hierarchical path to the port's parent block |
| port.port | The name of the port acting as the target |
| port.index | Which signal index within the port acts as the target |
Note
While a DFPort usually carries only one signal, it is capable of carrying any number - this allows signal arrays with a common purpose to be referred to using one name and still separately selectable using an index.
You can define a unique target for every signal carried by a DFPort - allowing you to separately place them within the address map.
Python API¶
-
class
designformat.address_map.DFAddressMapTarget(port=None, port_index=0, offset=None, aperture=None, map=None)¶ DesignFormat description of a target within an address map, it defines the offset and aperture size where the target will be selected for handling the transaction.
-
__init__(port=None, port_index=0, offset=None, aperture=None, map=None)¶ Construct the address map target
- Parameters
port – The port accepting the transaction from the address map
port_index – The index of the initiator signal within the port
offset – The offset address of the aperture in the address map
aperture – The size of the aperture within the address map
map – The DFAddressMap containing this target
-
acceptsAddress(address)¶ Indicates whether or not this target’s aperture contains a specified address.
- Parameters
address – The address to test for
-
dumpObject(project)¶ Dump out this object into a plain JSON dictionary.
- Parameters
project – The project definition, used for calculating references
-
loadObject(obj, root)¶ Reload target from serialised object.
- Parameters
obj – Description of this node
root – Root object in the tree
types – Map from class name to class definition
-
Javascript API¶
-
class
DFAddressMapTarget(port, port_index, offset, aperture, map)¶ DesignFormat description of a target within an address map, it defines the offset and aperture size where the target will be selected for handling the transaction.
Construct the address map target
- Arguments
port (DFPort) – The port accepting the transaction from the address map
port_index (integer) – The index of the initiator signal within the port
offset (integer) – The offset address of the aperture in the address map
aperture (integer) – The size of the aperture within the address map
map (object) – The DFAddressMap containing this target
-
DFAddressMapTarget.acceptsAddress(address)¶ Indicates whether or not this target’s aperture contains a specified address.
- Arguments
address (integer) – The address to test for
-
DFAddressMapTarget.dumpObject(project)¶ Dump out this object into a plain JSON dictionary.
- Arguments
project (*) – The project definition, used for calculating references