{des7:2}
The default implementation of the device mapper is a plugin called devmap.
-Devmap has three major features: slotting name translation
+Devmap has three major features: slotting name translation
(red), device mapping (green) and pin mapping (blue). The slotting translation
makes sure the resulting abstract component has the right amount of ports;
the device mapper loads the device-specific pin mapping and other
@@ -51,14 +51,14 @@
{des7:5}
-Devmap registers for the terminal-name-to-port-name
+Devmap registers for the terminal-name-to-port-name
translation.
{des7:6}
-If the slot attribute presents in a symbol, and the terminal does
-not have the "noslot" attribute, the translation is activated. The slot
-name is taken directly from the concrete symbol's slot attribute.
-All ports are then named as slot/terminal-name and the slot
+If the "slot" attribute presents in a symbol, and the terminal does
+not have the "noslot" attribute, the translation is activated. The slot
+name is taken directly from the concrete symbol's "slot" attribute.
+All ports are then named as "slot/terminal-name" and the slot
attribute is then removed from the abstract component to avoid
collisions.
@@ -67,28 +67,28 @@
| {des7:9} example opamp terminal attributes - | ||
|---|---|---|
| name | noslot | terminal description - |
| in_plus | (not present) | positive input pin - |
| in_minus | (not present) | negative input pin - |
| out | (not present) | output pin - |
| v_plus | "yes" | positive power rail - |
| v_minus | "yes" | negative power rail + |
| name | noslot | terminal description + |
in_plus | (not present) | positive input pin + |
in_minus | (not present) | negative input pin + |
out | (not present) | output pin + |
v_plus | "yes" | positive power rail + |
v_minus | "yes" | negative power rail |
{des7:10}
-In the above example v_plus and v_minus are never prefixed with "slot/" because
-of their noslot attribute. In case the symbol is used with the slot attribute
+In the above example "v_plus" and "v_minus" are never prefixed with "slot/" because
+of their "noslot" attribute. In case the symbol is used with the "slot" attribute
set, this means:
in_plus", "in_minus" and "out" will be copied/duplicated for each slot
+ (e.g. as "A/in_plus" for slot "A") for the abstract component
+ v_plus" and "v_minus" are kept common and only one copy of them will
exist in the abstract component
{des7:11}
Note: when the same symbol is used in a non-slotted use case, the symbol will
-not have the "slot" attribute; in this case no terminal name translation
+not have the "slot" attribute; in this case no terminal name translation
applied and the resulting abstract component will have the same port names
as the terminal names of the symbol.
@@ -110,7 +110,7 @@
slot/termname -> attribkey=value
-
{des7:14} E.g. "A/out -> pcb/pinnum=1" means "terminal with +
{des7:14} E.g. "A/out -> pcb/pinnum=1" means "terminal with
name=out in symbol tagged as slot=A shall get attribute
pcb/pinnum set to 1".
@@ -130,30 +130,30 @@
| {des7:18} pin mapping related symbol attributes - | ||
|---|---|---|
| attribute | value | description - |
| pinmap | array of map entries | the actual map, as described above - |
| slot | slot name | textual name of the slot the symbol provides + |
| attribute | value | description + |
pinmap | array of map entries | the actual map, as described above + |
slot | slot name | textual name of the slot the symbol provides |
{des7:19}
-The device mapper takes the devmap attribute of a symbol and looks it up
-in a database for finding a device map file. If the devmap attribute is an
+The device mapper takes the "devmap" attribute of a symbol and looks it up
+in a database for finding a device map file. If the "devmap" attribute is an
array, each devmap file is looked up and applied, in order of appearance.
{des7:20}
A device map file is a simple list of cschem attributes. The device mapper
takes each attribute from the device map file and apply it on the symbol that
-had the devmap attribute.
+had the "devmap" attribute.
{des7:21}
-A common device map file will usually have a pinmap attribute that will
+A common device map file will usually have a "pinmap" attribute that will
set at least one attributes on each terminal.
| {des7:22} device mapping related symbol attributes - | ||
|---|---|---|
| attribute | value | description - |
| devmap | name | name of the devmap file to use + |
| attribute | value | description + |
devmap | name | name of the devmap file to use |