Integration Model to CinC Generation

From PHENOM Portal Knowledgebase
Revision as of 10:50, 23 August 2024 by Shawn (talk | contribs) (→‎Add a TPM)
Jump to navigation Jump to search

This sample workflow will lead the user to generate FACE 3 CinC after creating necessary Mains, UoP Instances, and UoPs.

Create a UoP

First, create a UoP to be used by a UoP Instance within the model. A new UoP can be created by selecting the corresponding option in the 'Create>Integration' dropdown and then saving after inputting the necessary data.

Once the user has created their UoP it is now time to create the UoP Instance that will be used in CinC generation. This UoP Instance is going to be very important for later steps.

Create a UoP Instance

Similarly, A new UoP Instance can be created by selecting the corresponding option in the 'Create>Integration' dropdown and then saving after inputting the required data .

Create a Context

The context is a visual diagram of the interactions between a UoP and the configurable elements of CinC.

  1. Add UoP Instance to the context.
    1. Find the UoP Instance in the navigation tree and select it
    2. Drag it onto the context.
  2. Add a Transporter to the context.
    1. In the horizontal toolbar on the left side of the diagram find and select the transporter block
    2. Drag the transporter block onto the diagram.
  3. Create a Transport Channel
    1. With the transporter block selected, on the right side find the Transport Channel control and click on the '+' to add a new channel
    2. Give the channel a name and click the save icon.
    3. Once the save completes, click on the transport channel drop down and select the name of the channel you just created.
  4. Connect the blocks
    1. Select the Uop Instance block in the diagram
    2. click on the up arrow at the upper right corner of the block and drag it over to the transporter block.
    3. A popup dialog will allow you to select the UoP port to connect to the transporter, select the port from the drop down list and click on save.
  5. Commit the changes.
    1. Click the Commit button under the heading Model on the diagram tool bar. This saves the changes to the Integration Model (IM) elements but does NOT save the diagram.
  6. Save the diagram
    1. click the middle disk icon under diagram in order to save the layout of the elements in the diagram. This saves the layout of the items in the diagram but does NOT save changes to the Integration or Deployment models that may have been made while editing the diagram elements.

Create a main

The Main Program represents the executable program containing one (or more) UoPs and CinC.

  1. A new Main Program can be created by selecting the corresponding option in the 'Create>Deployment' dropdown and then saving after inputting the needed data including the UoP Instance.

Add a TPM (OPTIONAL*)

The transport protocol module is responsible for the serialization and deserialization of messages and their transport from one TPM to another or another system.

* Phenom will generate a UDP tpm by default so this step may be skipped.

  1. Within the Main detail page, after saving the main, click on the Create TPM button.
  2. Give the tpm a name ('tpm' is fine).
  3. click the save button.
  4. Commit the changes to the main by clicking the disk icon in the upper right.

Generate CINC

  1. Next the user needs to open the 'Generate' section and click on the CinC submenu.
  2. The user should select 'CinC' as the artifact.
  3. Select the version of CinC you would like to generate
  4. Select include CinC Source and choose Yes.
  5. Select the Main and UoP Instances for the context we created above and make sure they are both checked
  6. Select the appropriate license.
  7. Click on the Generate button and a zip file will be created. The .zip file will contain the cinc source, the data modeled FACE types used by the UoP and the CinC configuration files. Save the file and extract the generated code.