Sakari Poussa 88db00ae4b [zephyr] rename SOURCE_DIR to ZEPHYR_TARGET_SRC_DIR in Makefile.zephyr
In Makefile.zephyr the SOURCE_DIR variable was introduced recently.

However, the SOURCE_DIR variable is heavily used in zephyr. If you try to build
the jerryscript zephyr port from a zephyr project using the makefiles, the
SOURCE_DIR gets set by the zephyr build system and points to wrong place here.

This patch creates unique name to avoid the name clash.

JerryScript-DCO-1.0-Signed-off-by: Sakari Poussa sakari.poussa@intel.com
2016-06-30 14:48:47 +03:00
..

About

This folder contains files to integrate JerryScript with Zephyr RTOS to run on a number of supported boards (like Arduino 101 / Genuino 101, Zephyr Arduino 101).

How to build

1. Preface

  1. Directory structure

Assume harmony as the path to the projects to build. The folder tree related would look like this.

harmony
  + jerryscript
  |  + targets
  |      + zephyr
  + zephyr
  1. Target boards/emulations

Following Zephyr boards were tested: qemu_x86, qemu_cortex_m3, arduino_101.

2. Prepare Zephyr

Follow this page to get the Zephyr source and configure the environment.

If you just start with Zephyr, you may want to follow "Building a Sample Application" section in the doc above and check that you can flash your target board.

Remember to source the Zephyr environment:

source zephyr-env.sh

export ZEPHYR_GCC_VARIANT=zephyr

export ZEPHYR_SDK_INSTALL_DIR=<sdk installation directory>

3. Build JerryScript for Zephyr

The easiest way is to build and run on a QEMU emulator:

For x86 architecture:

make -f ./targets/zephyr/Makefile.zephyr BOARD=qemu_x86 qemu

For ARM (Cortex-M) architecture:

make -f ./targets/zephyr/Makefile.zephyr BOARD=qemu_cortex_m3 qemu

4. Build for Arduino 101

# assume you are in harmony folder
cd jerry
make -f ./targets/zephyr/Makefile.zephyr BOARD=arduino_101

This will generate the following libraries:

./build/arduino_101/librelease-cp_minimal.jerry-core.a
./build/arduino_101/librelease-cp_minimal.jerry-libm.lib.a
./build/arduino_101/librelease.external-cp_minimal-entry.a

The final Zephyr image will be located here:

./build/arduino_101/zephyr/zephyr.strip

5. Flashing

Details on how to flash the image can be found here: Flashing image (or similar page for other supported boards).

To be able to use this demo in hardware you will need the serial console which will be generating output to Pins 0 & 1

Some examples of building the software

make -f ./targets/zephyr/Makefile.zephyr clean
  • Not using a Jtag and having a factory stock Arduino 101.
make -f ./targets/zephyr/Makefile.zephyr BOARD=arduino_101_factory

Follow the Zephyr instructions to flash using the dfu-util command.

  • Using JTAG

There is a helper function to flash using the JTAG and Flywatter2

alt tag

make -f ./targets/zephyr/Makefile.zephyr BOARD=arduino_101 flash

6. Serial terminal

Test command line in a serial terminal.

You should see something similar to this:

Jerry Compilation May 26 2016 13:37:50
js>

Run the example javascript command test function

js> test
Script [var test=0; for (t=100; t<1000; t++) test+=t; print ('Hi JS World! '+test);]
Hi JS World! 494550

Try more complex functions:

js>function hello(t){t=t*10;return t}; print("result"+hello(10.5));

Help will provide a list of commands

> help

This program, is built in top of the Zephyr command line, so there is a limit of 10 spaces.