Pocket

[How to use Argo Embetics]

Argo Embetics is a structured modeling tool.
It is possible to build software with visualized information such as sequence, selection, repetition: the control flow of structured programing.
Data Flow Diagram makes possible to build up software structure and timing design all together.
Argo Embetics generates C language source code from Model.

Models in Argo Embetics has various feature for optimaizing embedded software development.

This tutorial simply describes how to use Argo Embetics.

The main contents in this tutorial are as below.

  • Key Words
  • Operation
  • How to make Model
    (From making Project to source code generation)

First, install Argo Embetics under the step of “Installation Guider.pdf”.

Key Words

  • Project
    The development unit on Argo Embetics. One project can be developed by one Argo Embetics IDE.
  • Model, Model Data
    On Argo Embetics, project is developed by making information, which is called “Model Data”. There are five group of Model in Arog Embetics and each group has some kind of elements. The detail of Model group and Model element is described below. When Model or Model Data is used in this tutorial, it does not mean a single information unit, it means the entire information of the Model or the kind of Model.
  • Element, Model Element
    A kind of data/record of Model.
  • Platform
    The running environment of the software and the access information of the environment. It is used in both software and hardware.

Operation

The main form of Argo Embetics are generally composed of the following parts.

  • Main Menu Bar

    Perform new/open project and source code generation.

  • Model Management Form

    Manage the Project, import the existed Model and show the feature of the Model. Edit or add an Element of any Model.

  • Model Element Edit Form

    There is different Element Edit form for each Model Element in Argo Embetics. The edit form of Model Element can be opened from Model Management Form or other edit form of releated Element.

  • Message Form

    The list of system output result message when generating source code or searching Data. It will be generated automatically.

Here, introduce some simple operation on the following images.

Main Menu

The popular main memu are as below.

  • File
    Some common operation of project, like “New”, “Save”, etc. These operatio also can be performed by the buttons on tool bar.
    The Model import is performed from this menu…
  • Edit
    Text operation for Model like “Find”, “Replace”, etc. are performed from this menu.
    This function is limited in “Basic Edition”
  • Generate
    Source code generation and Platform Reset, etc. are performed from this menu.
    Build/Load commond can also be done from here. This function is limited in “Basic Edition”.

 

Model Management Form

The construction of Model is displayed as tree structure on Model Management form.
It is composed of the following three kinds of tree structure.

The available menu will be displayed by right-click the icon of the Element on Model Management form.
In the right-click menu, click “Edit” menu to show the edit form of the selected Element.
An Element can be exported if there is “Export” menu the right-click menu list of it.

Model of Argo Embetics is composed of the following five kinds of group and its contents.
For details of Model contents, refer to help.

  • Context Model
  • Requirement Model
  • Feature Model
  • Timing Model
  • Platform Model

 

Model Element Edit Form

There are list form and edit form in Model Element Form. And there are five kinds of edit form.
Commonly, use “Update”, “OK” button to update data, “X” button to close the form.

  • Model Element Common Edit Form
    Click “Update” button to update the edit form, the form will not be closed.
    The edit form which has a “Add as” button can be copied and add a Element with the same content.

  • Model Element Detail Edit Form

    The edit form of the Model Element value.
    Click “OK” button to update the content on this form and the form will be colsed after the update.

  • Model Element List Form
    Select “list” menu on the right-click menu list of the class name of the Element on Model Management Form to open the list form.
    On this kind of form, “add”, “deleted”, “edit” and “copy” button can be used to edit Element.
  • Platform Model Link Form

    The logic link between External I/O Data, Task (Virtual Information) and Platform Model (Real Environment Information). The link of each Element can be edit on its own edit form or on this link list form.
    The Platform Model Link Form can be opened from the main menu “View – Platform Model Link”.

  • Project Configuration Form

    Project Configuration Form is used to manage the high level information of the Project but not Model Element, just like how to generate source code.
    The Project Configuration Form can be opened from the right-click menu of the Project name on the top of Model Management form.

There are five kinds of edit forms.

  • Common Input

    Edit the Element by text input and pull-down menu selection on this kind of form.

  • Chart Input

    The Context Diagram, DFD, STD, Inter-Task DFD are edited on their own edit chart.                                                                                                                                                                                                                

  • Table Input
    The table input are used in Value Group and Parameter. Commonly, it can be inputted in the table directly and also can be edit on Detail Edit Form.

  • Special Table Input
    Special table input is applied for general-purpose Logic expression.

Code Input
Input the C programming language source code.
Commonly, the code of a function can be edited by selecting the function name in the function list.
The “Insert” menu can be used to input the Element Data or function that defined in other Model.

 

How to make Model
(From making Project to source code generation)

Make Project

Now, let’s start to make a simple Project.

First, run Argo Embetics.

The image above shows if first time to run Argo Embetics. File menu: “New Project” will show this form. Once a project has been opened, Argo Embetics will open the last closed project.

Follow the steps below.

  1. Set Up New Project
  2. Make Model
    1. Make Logic
  3. Generate Source Code
    1. Generate Source Code
    2. Build
    3. Load

1. Set up a new Project

First, click the button on the following image to open the dialog, set up a new Project.

 

“New Project” dialogue will be displayed. Specify the path for the new Project folder and select the way of creating project.

Specify the path for the new Project folder as you wish. But it is not possible to specify a folder that has existing project.
The name will be the Project name and Project file will be created.
Select “Create void project” for “How to create”.

Try other way if you used to make project.

After the Project has been set up, the following file/folder will be generated.

  • Project name.eprj
    This is the Project file, select this file to open this Project.
  • mdl
    The Model Data content file, do not change it directly.
  • gen
    The default target folder of the source code generation. It can also be reconfigured from the “Project Configuration”.

In Argo Embetics, software development is done with project unit.

4. Make Model

This tutorial describes making of Code Logic only.
For making the other kind of Model, refer to other tutorial, users’gide or help.

  1. Make New Logic

    Right-click at the “Logic” on the Model Management form and select “New” to display new Logic form.

      

    Edit Logic

    Though new Logic is created as Code Logic expression, it is possible to express Logic by visual item as the following figure.

    Logic is generated as function. Because its ID becomes function name, ID must be appropriate name.
    It name is used by display name of Model element.

    Double-click the code panel to be editable.

    After editing, click “Update” to register the element.

    Model is made.

5. Generate Source Code

After the Model Data has been completed, the source code can be generated by only one button click. Here is the introduction from source code generation to build/load.

i. Generate Source Code

Source code can be generated from the main menu “Generate – Generate Source Code” or the toolbar button in the following image.
(Note)The button is unavailable for Basic Edition.

After the generation, an output message will be displayed as below.

Check on the box and click the “OK” button, the folder of the generated source file can be opened.

Logic is generated as function in generated source code.

If there are some errors on generating process, the output message will be displayed as below.
Double-click an error message to open edit form where the error was found.

The Source Code Generation can be configured on the “Project Configuration” form.
The path of the source file can also be configured on the “Environment Configuration” tab.


On “Source generation setting” tab, configure the particulars about how to generate the source.

On “Start Process” tab, the independent start process can be add.

 ii. Build

Build the generated source code.
In “Standard Edition” or superior edition of Argo Embetics, a build commond can be configured on “Build Commond” tab of “Project Configuration” form and source code can be built by build menu of Argo Embetics.

The build commond can be ran from the menu “Generate” or the button on tool bar.
 i. Load

Next, load the hex file to the target board (MPU)
If a command load is available, load command can be configured on “Load commond” tab in “Project Configuration” form in the same way as build command. After that, the hex file can be loaded by load menu of Argo Embetics.
If the load commond is not available or the Argo Embetics is Basic Edition, use some other tool to load the hex file.

This tutorial has simply described the developping flow from form operation to project building.
For details, refer to other tutorial, user’s guide or help.

Available Platform Model are provied from the Argo Solutions web site.
The re-configurable Module and Logic are also provied there. Make use of them with Argo Embetics for various development.

Please send an e-mail to argo-embetics@argo-s.com to connect with us when you have any question about Argo Embetics or our company.

Latest information about Argo Embetics is on:

http://www.argo-s.com/ae_en/