Integrate Applications with PHENOM & CinC: Difference between revisions

From PHENOM Portal Knowledgebase
Jump to navigation Jump to search
Created page with "This tutorial will walk a user through the compilation and execution of a CinC-based application. The CinC compilation portion of this tutorial is done using WSL (Windows Subsystem for Linux 2). == Create a Data Model == A UoP (Unit of Portability) represents your application. It defines all the inputs and outputs of the application by associating the data types (the queries and views defined in the data model) with the UoP. Start by creating a UoP. CREATE >> INT..."
 
No edit summary
Line 1: Line 1:
This tutorial will walk a user through the compilation and execution of a CinC-based application.   
This tutorial will walk a user through the compilation and execution of a CinC-based application.  It builds upon other tutorials in PHENOM.  As such, it uses the same principles as [[Integration Model to CinC Generation]], but the content is different.


The CinC compilation portion of this tutorial is done using WSL (Windows Subsystem for Linux 2).
{{Info|heading=Windows Subsystem for Linux | 1=This tutorial is written to use Windows Subsystem for Linux (WSL 2).}}


== Create a Data Model ==
==Preparing PHENOM==
In this tutorial, you will integrate two software applications.  For the sake of simplicity, they will be integrated into a single executable.  This will allow you to see the result of the integration by running a single file.  This tutorial uses the Integration Model as shown in a previous tutorial.


A UoP (Unit of Portability) represents your application.  It defines all the inputs and outputs of the application by associating the data types (the queries and views defined in the data model) with the UoP.
Start by downloading this data model: [[File:robot_model_with_integration_model.skayl]]


Start by creating a UoPCREATE >> INTEGRATION >> UOP
{{Info|heading=Skayl File | 1=The FACE Technical Standard only defines the elements of an integration model.  The details of each element are left to integrators.  As a result, such details are not effectively stored in a .face modelA .skayl file is provided here to maintain this information.}}


== Create an Integration Model ==
If you need help loading the project file, please view this tutorial: [[Creating a Project from an Existing Model]].
'''TODO'''
 
== Export a CinC Package ==
Log into PHENOM and click on the GENERATE icon in the vertical bar on the left-hand side of the screen.
 
[[File:Phenom navigation bar 4.png|thumb|none]]
 
Select the CINC tab.
 
[[File:generate_menu_cinc_selected.png|thumb|none]]
 
Please make the following choices:
* '''CinC Artifact''' CinC
* '''CinC Version''' CinC 2.2.3 (note, other versions may work, this was tested with v2.2.3)
* '''FACE Version''' 3.0
* '''Language''' c++
* '''Override namespaces?''' Not Selected
* '''System Directory''' Test_System
* '''Include CinC Source?''' Selected
* '''Include Model files?''' Selected
* '''Selection Type''' Mains and UoPs
 
There is a prompt to '''Select your Mains and UoPs'''.  Since the project was setup to have both applications in a single executable, both UoPs are listed under a single main.  Ensure all three elements are selected, like this:
 
[[File:C:\Users\chris\Downloads\generate_cinc_select_mains_and_uops.png|thumb|none]]
 
Next, select a license.  For this tutorial, you should choose '''Evaluation'''.
 
And finally, click '''GENERATE'''.  PHENOM will start creating your source package and your browser will automatically download it once complete.


== Prepare the Environment ==
== Prepare the Environment ==

Revision as of 10:25, 16 January 2026

This tutorial will walk a user through the compilation and execution of a CinC-based application. It builds upon other tutorials in PHENOM. As such, it uses the same principles as Integration Model to CinC Generation, but the content is different.

Preparing PHENOM

In this tutorial, you will integrate two software applications. For the sake of simplicity, they will be integrated into a single executable. This will allow you to see the result of the integration by running a single file. This tutorial uses the Integration Model as shown in a previous tutorial.

Start by downloading this data model: File:Robot model with integration model.skayl

If you need help loading the project file, please view this tutorial: Creating a Project from an Existing Model.

Export a CinC Package

Log into PHENOM and click on the GENERATE icon in the vertical bar on the left-hand side of the screen.

Select the CINC tab.

Please make the following choices:

  • CinC Artifact CinC
  • CinC Version CinC 2.2.3 (note, other versions may work, this was tested with v2.2.3)
  • FACE Version 3.0
  • Language c++
  • Override namespaces? Not Selected
  • System Directory Test_System
  • Include CinC Source? Selected
  • Include Model files? Selected
  • Selection Type Mains and UoPs

There is a prompt to Select your Mains and UoPs. Since the project was setup to have both applications in a single executable, both UoPs are listed under a single main. Ensure all three elements are selected, like this:

File:C:\Users\chris\Downloads\generate cinc select mains and uops.png

Next, select a license. For this tutorial, you should choose Evaluation.

And finally, click GENERATE. PHENOM will start creating your source package and your browser will automatically download it once complete.

Prepare the Environment

In your Windows user folder (typically C:\Users\<username>), create (or edit) the .wslconfig file.

Make sure the file contains the following entries:

[wsl2]
networkingMode=mirrored

[experimental]
hostAddressLoopback=true