The XCDL.py first run

From XCDL (eXtensible Component Definition Language) Wiki
Revision as of 14:57, 16 January 2013 by Ilg (Talk | contribs) (Created page with "== Introduction == This page describes how to give XCDL a first try, using the µOS++ SE repository running on a synthetic OS X platform. == Prerequisites == This procedure...")

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Introduction

This page describes how to give XCDL a first try, using the µOS++ SE repository running on a synthetic OS X platform.

Prerequisites

This procedure was created and tested with

  • OS X 10.8.2
  • Xcode Command Line Tools

Purpose

The goal is to run a test that exercises all possible conversions defined in the µOS++ Debug class. Since the class is portable, it does not need any specific hardware, and on Posix platforms the class output can be easily redirected file descriptor 1, making the debug output visible on the terminal used to start the test.

Test steps

The first step is to create a temporary folder for this test and change directory to it: 

 mkdir -p $HOME/tmp/xcdl-test
 cd $HOME/tmp/xcdl-test

The second step is to checkout the XCDL Git repository and the µOS++ SE Git repository. In the above folder, run the following commands 

 git clone git://git.code.sf.net/p/xcdl/python xcdl-python.git
 git clone git://git.code.sf.net/p/micro-os-plus/second micro-os-plus-second.git

If the Xcode Command Line Tools were properly installed, the git executable should already be available, otherwise an error will occur.

The next step is to run the XCDL configMakefiles tool, to create the build folder. 

 sh xcdl-python.git/scripts/configMakefiles.sh \
 --config="micro-os-plus-se.git/packages/portable/devices/debug/tests/conversions/meta/config.py" \
 --id=config.os.portable.devices.debug.tests.conversions.osx.cl-sjlj.debug \
 --build="build" --linearise --verbose

In addition to the long, verbose, output, this program should create a folder build/osx_cl-sjlj_debug_conversions_Debug where all the interesting stuff is stored.

The next step is to build the generated Make files. For this go to this new folder and run make. 

 cd build/osx_cl-sjlj_debug_conversions_Debug
 make

The final step is to run the freshly compiled project: 

  ./conversions

The result should be a list of lines, generated from various methods of the Debug class, performing conversion of all useful types (strings, chars, hex numbers, decimal numbers, etc).

Retrieved from "http://xcdl.sourceforge.net/mw/index.php?title=The_XCDL.py_first_run&oldid=147"