Getting started with IBM Rational Rhapsody in Ada

Getting started with Rhapsody in ADA

Setup Rhapsody in Ada with AdaCore GPL

Frank Braun,

Managing Partner EVOCEAN Deutschland GmbH

2 - © EVOCEAN www.evocean.com

Let’s get started – Rhapsody in Ada

In this session we show you how to:

• 1) Select and install an appropriate Ada Compiler.

• 2) Install Setup IBM Rational Rhapsody 8.2 in Ada.

• 3) Build an initial Hello World Example.

1) Select and install Ada Compiler


Rhapsody 8.2 Ada Compiler support

The Rhapsody in Ada Code generator has been tested against the following

Ada compilers:

• GNAT 3.15p (freely available, however outdated: GCC 2.8.1)

• AdaCore’s GNAT Pro (commercial)

• AONIX ObjectAda Enterprise Edition (commercial )

Not officially supported but a good alternative is the free-of-charge and

fully-featured GNAT GPL 2016 EDITION which is based on GCC 4.9.4.

This edition is available for students and free Software developers from

http://libre.adacore.com/download and consists of:

• The GNAT Ada 95, Ada 2005 and Ada 2012 development environment.

• AdaCore’s GNAT Programming Studio IDE (GPS).

• A license suitable to develop Free Software (www.fsf.org).

http://libre.adacore.com/download


GNAT GPL installation steps

The installation of the GNAT GPL Edition is straight forward.

• Just re-call the installation folder (Required for Rhapsody installation

later on).

2.1) Install IBM Rational Rhapsody 8.2 in Ada


Download Rhapsody Evaluation

You can download the full featured Rhapsody evaluation edition + license

under IBM developerWorks.

• http://www.ibm.com/developerworks/downloads/r/rhapsodydeveloper/

(If not yet registered , register once with your email then login)

http://www.ibm.com/developerworks/downloads/r/rhapsodydeveloper/


Rhapsody Installation

Double click on the installation file to

launch Rhapsody installation Wizard:

Read and accept license agreement

then press Next>


Version and Language Settings

Select ‘IBM Rational Rhapsody

Developer’

Select Ada

Select „Development environment and

RTOS setting“

You will be able to also launch all other editions after the installation


Change Installation Path

Click Change to install Rhapsody to the following Path C:\Rhapsody\8.2

Having a central Rhapsody repository like this allows you to easily organise and install multiple Rhapsody releases underneath (i.e. 7.6, 8.0 etc)

Check “Install all Rhapsody

files in one location” • (will be underneath

C:\Rhapsody\8.2\Share)


Installed environments are detected by the installer and incorporated in

Rhapsody‘s environmental settings.

Existing environments

Before you continue, make sure that the Gnat Compiler path is pointing to the GPL 2016 installation Path.


Add-ons

Select any Rhapsody-AddOn’s as required.


Licence

Create a Folder flexlm and store your evaluation license file

With Browse point to that license file:


Installation

Press Install> to launch installation

process.

Press >Finish and launch Rhapsody

2.2) Setup IBM Rational Rhapsody 8.2 in Ada


Compiling Rhapsody Framework with GNAT GPL

Because we‘re using a different compiler than the officially supported one

we have to rebuild the Rhapsody Framework libraries once before we start.

The simplest way is to perform this inside Rhapsody:

• Launch Rhapsody in Ada and create a new Project HelloWorldPrj by

Selecting AdaCodeGeneration as Project Type


Build Framework

Select Code->Build Framework to

launch the Framework BuildProcess:

Observer the build log and make sure

that the build completes successfully:

3.) Hello World Project


Hello World with Rhapsody in Ada

Let’s build a first Rhapsody UML ADA-Model. The final generated code might

look like this:

• A package structure containing a simple procedure which prints “Hello World”

Ada Specification File

Ada Body File


Rhapsody Project and configuration structure

Generating Code from Model Elements

Adding own Code

Round Trip – To keep model and code in sync

Customize Code Generation

Generate and Build Component, Configuration, Packages Code

What you will learn


Create Project

Launch Rhapsody in Ada:

In Rhapsody select File->New:

Name the Project HelloWorldPrj

Press OK> and Yes> to create the new Project and its Project Directory:

Press No If you’re asked to enable the UML Perspective toolbar -


Rhapsody Projects

Observe the Browser structure:

Browser

Component

Packages

Configuration


Rename DefaultComponent to HelloWorldApp

and DefaultConfig to release:

Components, Configurations, Packages

A Component is a kind of physical Container, the Application (exe), or Library that we Build. Each Component consist of at least one Configuration

In the Configuration of the component we tell Rhapsody, how to build the Component (which compiler, setting etc).

A Package is a logical structural Element.

Right Click on the Component

HelloWorldApp to open its Feature Dialog:


Feature Dialog Component

Each Rhapsody model element has a Feature Dialog which allows further

settings.

At Component Level, general Build- (i.e. to build an executable or build a library) and Code-

generation- Settings (Scope of Code-generation) are defined in its Features.

Just observe the settings in the General and ScopeTab of the HelloWorldAppFeature Dialog


Feature Dialog Configuration

Click on release to change the context of the Feature Dialog to the

Configuration:

General configuration settings

(Object Initialisation, Environment

Settings like Compiler Settings)

are made in the Features Dialog of

the Configuration.


Main- and Make- File

The Main and Make Files of the Component HelloWorldApp

(Application) are organized at configuration level.

• Press CTRL+F7 or select Code->Generate->release to initiate the Code generator:

• Right Click on the release configuration and select Edit Configuration Main File

to open the main file:

Even if Ada does not require a main as entry point, most Ada programs have one and Rhapsody generates one as well.


Package Code Generation

Rename the Default Package

to HelloWorldPkg

Make sure that HelloWorldPkg is selected then Press ALT+2 to open the Active Code View Window:

• Observe the generated Code…

Active Code View is a dynamic and context sensitive code editor. Click on an Rhapsody UML element and you can see and edit its code

Note that Rhapsody generates an ADA Package for a UML Package


Add Function to Model

Right Click on the Package HelloWorldPkg ,

select Add New->Function:

Name the function sayHello ()

Observe the generated code for the specification- (ads) and body-flle (adb):


You can implement Code in two ways:

1) In the Model through the feature dialog.

2) Directly in the Source Code.

1) Implement Code through Features Dialog:

Open the Features Dialog of the sayHello Function and select the

Implementation Tab:

In Local Variables type:

c:character;

In Operation Body type:

Put_Line("Hello World");

Press OK> and observe the code Window:

Implement Function in Feature Dialog


Implement Function in Code Editor

2) Implement Code in Code Editor:

In the ActiveCode View Editor add a new line below Put_Line(“Hello World”) then type Get(c); to read some characters from the terminal:

Press CTRL+S and

observe the Log-Protocol

in the output window:

The Code gets round tripped into the model.


Rhapsody Properties

We have one missing step to perform:

• Including the IO dependencies.

There are several ways how to perform this, for example through modelling or by the

use of the Rhapsody Properties.

In this session we’re going to use the Properties.

Rhapsody Properties are a powerful mean to

customize Rhapsody Environment, Behaviour

and Code Generation.

• In the browser double click on the

HelloWordPkg to open its Feature Dialog

then select the Properties Tab:


CodeGeneration through properties

In the Property Ada_CG->Package->ImplementationProlog type the following text: with Ada.Text_IO; use Ada.Text_IO;

Observe the changes in the Code Editor Window:


Initialize Main

As we have learned in previous slides, the generated

code from the configuration underneath the Component

is the entry point (main) for each application.

Inside the Initialization code

field press CTRL+Space which

activates Rhapsody Intellisense

(Rhapsody auto complete):

To complete we need to call our sayHello function to the main.

• Open the Features Dialog of the release configuration:

Select the Initialization Tab:

Make sure that you have

HelloWorldPkg.sayHello; as

initialisation code:


Build and Run Application

In Rhapsody select Code-> Generate/Make/Run

or press :

Observe the build log and enjoy your result:

In case of a compilation error double click on the error message to navigate to the source of error.

You should now have all ingredients to complete or fix the model in order to make it running ;-)


Thank you - Do you want more ?

We periodically run the following Training Courses:

• IBM Rhapsody in C and C++ Training Course with UML (4 days)

• EVOCEAN Rhapsody in C++ Training Course with RaspberryPi (3 days)

• Rhapsody for System Engineers with SysML (4 days)

• Rhapsody MDSE with SysML ToolTraining (2 days)

Visit: www.evocean.com/events

World-Wide !

Project Support, In-house Trainings / Trainings in

Rhapsody in Autosar, Ada or Java , Design Manager ?

Send request to : [email protected]

http://www.evocean.com/events

mailto:[email protected]


THANK YOU

Are you interested in a specific topic ?

Just send an Email to:

[email protected]

or send “Newsletter” to

[email protected] to receive our

newsletter

mailto:[email protected]