Connector Parameters File

User's Guide > Production Applications: Cabling > Connector Parameters File

! Enter or modify parameters for the connector. You may use the help
! functionality of Pro/TABLE to enter pre-defined parameters.
! Ref DescrREF_DES MOTOR
! Conn ModelMODEL_NAME MOTOR
! Num Of PinsNUM_OF_PINS 2
! TypeTYPE CONNECTOR
! Entry Port
! TYPE INT_LENGTH
ENTRY_PORT ENTRY1 ROUND 0.2
ENTRY_PORT ENTRY2 ROUND 0.2 !
Signal!
PIN_ID SIGNAL_NAME SIGNAL_VALUE ENTRY_PORT
SIGNAL 1 ENTRY1
SIGNAL 2
! Pin
! PIN_ID CABLE_NAME COND_ID
PIN_ASSIGN 2 WIRE_1
PIN_ASSIGN 1 WIRE_2
! Enter or modify parameters for the connector. You may use the help
! functionality of Pro/TABLE to enter pre-defined parameters.
! Ref Descr REF_DES MOTOR
! Conn Model MODEL_NAME MOTOR
! Num Of Pins NUM_OF_PINS 2
! Type TYPE CONNECTOR
! Entry Port
! TYPE INT_LENGTH
ENTRY_PORT ENTRY1 ROUND 0.2
ENTRY_PORT ENTRY2 ROUND 0.2
! Signal
! PIN_ID SIGNAL_NAME SIGNAL_VALUE ENTRY_PORT
SIGNAL 1 ENTRY1
SIGNAL 2
! Pin
! PIN_ID CABLE_NAME COND_ID
PIN_ASSIGN 2 WIRE_1
PIN_ASSIGN 1 WIRE_2

Note that this file is not free-format. Each parameter name and value is followed by a tab character, and each empty value is represented by a tab character. Therefore, the line in the example that assigns the first parameter, SIGNAL, contains three tab characters between the value of the PIN_ID and the value of ENTRY_PORT: the first tab belongs to the PIN_ID value, and next two tabs provide null values for SIGNAL_NAME and SIGNAL_VALUE.

The function ProInputFileRead() imports a file in this format, so you can use it in conjunction with ProOutputFileMdlnameWrite() to edit the parameters on connectors and their entry ports. To identify the connector, both functions use the following arguments:

• arg1—Represents the memb_id_tab

• arg2—Represents the memb_num

The function ProConnectorDesignate() designates a component in the assembly as a cabling connector. It takes as input the component path that identifies the part in the cabling assembly, and an optional name that will be the reference descriptor (REF_DES) of the connector.

When a new connector has been designated, it has only the two parameters REF_DES and MODEL_NAME. The MODEL_NAME is set to be the name of the part designated, and the REF_DES is set to the value provided as input to the function ProConnectorDesignate(), if any, or to the MODEL_NAME otherwise. After you designate a connector, you must call ProOutputFileMdlnameWrite() and ProInputFileRead() to set up the necessary parameters.

The function ProConnectorWithAllParamsDesignate() designates a component in the assembly as a cabling connector using all the logical parameters. The input arguments are:

• p_connector—Specifies the component path that identifies the part in the cabling assembly.

• name—Specifies the reference descriptor (REF_DES) of the connector. The argument can be NULL when the designation is not from a logical reference.

• from_logical—Specifies if the component must be designated using logical references.

To undesignate a connector, call the function ProConnectorUndesignate().

Function ProConnectorParamGet() retrieves a single parameter for the specified connector. This function supports only single-valued parameters. If you specify a multivalued parameter, the function returns PRO_TK_E_NOT_FOUND.

Use function ProConnectorParamDelete() to remove a single parameter from the specified connector. This function deletes both single- and multi-valued parameters.

Function ProConnectorParamsCollect() retrieves all parameters of the specified connector. This function supports both single- and multi-valued parameters.

Function ProConnectorParamsSet() sets all parameters of the specified connector. This function overwrites all existing parameter values with the values in the input parameter array. This function supports both single- and multi-valued parameters.

Function ProConnectorsFromLogicalGet() returns a list of connector names in the specified assembly for which data has been imported from a logical reference but which have not yet been created. Refer to the Creo+ Cabling Help and Creo+ Harness Help for more information on logical references.

È stato utile?