Introduction
YAMAICA is an acronym for Yet Another Model And Interface Conversion Application. It is a collection of Eclipse features which implement transformations between different interface description languages, editors and code generators. These plugins can be integrated together in one tool for convenient use and to avoid version conflicts.
The official project home page is https://at.projects.genivi.org/wiki/display/YAM/YAMAICA+Home
Downloads
Eclipse Update Site: http://docs.projects.genivi.org/yamaica-update-site/yamaica/updatesite/
The source code can be downloaded from the public GENIVI git repositories:
- YAMAICA core features: http://git.projects.genivi.org/?p=yamaica.git;a=summary
- YAMAICA Enterprise Architect transformation features: http://git.projects.genivi.org/?p=yamaica-ea.git;a=summary
Platform Requirements and Feature Versions
YAMAICA Version | Java Version | Franca Version | IPC CommonAPI C++ Version |
---|---|---|---|
0.11 | Java 7+ | 0.9.1 | n/a |
0.10.0 | Java 7+ | 0.8.10 | 2.1.6 |
0.9.1 | Java 6+ | 0.8.10 | 2.1.6 |
0.9.0 | Java 6+ | 0.8.10 | 2.1.4 |
Note: The Sparx Enterprise Architect features of YAMAICA only work running with a 32bit Windows version of Eclipse/Java!
Documentation
- YAMAICA installation HowTo
- The UML profile/methodology is described at the Franca2EA wiki page.
Step by Step EA to Franca using YAMAICA
Introduction
This is a quick guide for anyone who is just starting with GENIVI's fully automated workflow for definition and transformation of software interfaces using EA, Franca and Yamaica Toolset.
For designing and transforming software interfaces, following tools are required:
1. EA: Sparx Systems Enterprise Architect is a visual modelling and design tool for designing interfaces
2. Franca: Framework for definition and transformation of software interfaces
3. YAMAICA: An Eclipse based tool to provide easy usability of various features around usage of the Franca Interface Description Language (IDL) and IPC CommonAPI C++
Follow the below steps to install EA, Franca and YAMAICA toolset
Step - 1. Install Enterprise Architect (from Sparx System)
Step - 2. Install Franca update site
Franca Quick Install Guide [1]
Step - 3. Install YAMAICA Toolset
YAMAICA Quick Installation Guide[2]
Here you are almost ready with the basic setup which is required for designing & transforming your software interfaces.
Now, you can start design of your software interface in EA but before that there is one guideline below that you should go through at least once.
Recommendation: UML Interface Standardization Guideline [3]
Step By Step Guideline
Now, it is assumed that you are ready with the basic setup of EA, Franca and YAMAICA, so, now you are just 3 steps away for designing and transforming your first software interfaces to Franca interface definition Language (FIDL) file.
Step – 1. Create EAP file & design your interface in EA
For creating EAP file follow the below steps:
File -> New Project
Reference: For more details visit Getting Started with EA [4]
Step – 2. Create YAMAICA project in eclipse
For creating YAMAICA project select File -> New -> others -> yamaica -> yamaica project
Step – 3. Import EAP file in your YAMAICA project
For importing EA file select “Import”
and now just browse your EA model from your file system.
Your FIDL file will be automatically generated as soon as your EAP is loaded into Yamaica.
You can see a 'sample.fidl' file bellow which is generated from our test.eap model.
Common API and Franca options
Generate D-Bus XML File
Recent space activity
Space contributors
1 Comment
Vinay Kumar B
Link for "YAMAICA Enterprise Architect transformation features" seems to be broken... Any update in the link?