Akos Kiss 02ba19f24d Introduce the Termination Port API
* Moved the error codes to jerry-port.h and declared port function
  `jerry_port_fatal`.

* Moved "exit or abort on fail" functionality to the newly added
  jerry-port-default-fatal.c.

* This implied that a default port-specific API had to be introduced:
  functions `jerry_port_default_set_abort_on_fail` and
  `jerry_port_default_is_abort_on_fail` declared in jerry-port-default.h
  control the fatal exit behaviour.

* For the sake of clarity, renamed jerry-port.c to
  jerry-port-default-io.c.

* Adapted CMakeLists to deal with port implementations consisting of
  more then one source file and exposing headers. This also required
  the renaming of `EXTERNAL_PORT_FILE` cmake option to
  `EXTERNAL_PORT_DIR`.

* Adapted main sources to use the default port header for the
  abort-on-fail functionality, as that is not part of the core jerry
  API anymore.

* Added default port implementation to the static source code checker
  tools.

JerryScript-DCO-1.0-Signed-off-by: Akos Kiss akiss@inf.u-szeged.hu
2016-04-19 14:10:18 +02:00
..

About

This folder contains files to run JerryScript on NuttX with STM32F4-Discovery with BB

How to build

1. Preface

1, Directory structure

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

harmony
  + jerryscript
  |  + targets
  |      + nuttx-stm32f4
  + nuttx
  |  + nuttx
  |      + lib
  + st-link

2, Target board

Assume STM32F4-Discovery with BB as the target board.

3, Micro SD-Card memory for Script source files

2. Prepare NuttX

Follow this page to get NuttX source and do the first build. When it stops with and error, change default project from IoT.js to JerryScript as follows;

2-1) run menuconfig

# assume you are in nuttx folder where .config exist
make menuconfig

2-2) Select Application Configuration --> Interpreters

2-3) Check [*] JerryScript interpreter (Move cursor to the line and press Space)

2-4) < Exit > once on the bottom of the sceen (Press Right arrow and Enter)

2-5) Select System Libraries and NSH Add-Ons

2-6) Un-Check [ ] iotjs program (Move cursor to the line and press Space)

2-7) < Exit > till menuconfig ends. Save new configugation when asked.

2-7) make again

make

It'll show the last error but it's ok. Nows the time to build JerryScript.

3. Build JerryScript for NuttX

# assume you are in harmony folder
cd jerryscript
make -f ./targets/nuttx-stm32f4/Makefile.nuttx

If you have NuttX at another path than described above, you can give the absolute path with NUTTX variable , for example,

NUTTX=/home/user/work/nuttx make -f ./targets/nuttx-stm32f4/Makefile.nuttx

Make will copy three library files to nuttx/nuttx/lib folder

libjerryentry.a
libjerrycore.a
libjerrylibm.a

In NuttX, if you run make clean, above library files are also removed so you may have to build JerryScript again.

4. Continue build NuttX

# asssume you are in harmony folder
cd nuttx/nuttx
make

5. Flashing

Connect Mini-USB for power supply and connect Micro-USB for NSH console.

Please refer this link to prepare stlink utility.

To flash with Makefile.nuttx,

# assume you are in jerryscript folder
make -f ./targets/nuttx-stm32f4/Makefile.nuttx flash

6. Cleaning

To clean the build result,

make -f ./targets/nuttx-stm32f4/Makefile.nuttx clean

Running JerryScript

Prepare a micro SD-card and prepare hello.js like this in the root directory of SD-card.

print("Hello JerryScript!");

Power Off(unplug both USB cables), plug the memory card to BB, and power on again.

You can use minicom for terminal program, or any other you may like, but match baud rate to 115200.

minicom --device=/dev/ttyACM0 --baud=115200

You may have to press RESET on the board and press Enter keys on the console several times to make nsh prompt to appear.

If the prompt shows like this,

NuttShell (NSH)
               nsh>
                    nsh>
                         nsh>

please set Add Carriage Ret option by CTRL-A > Z > U at the console, if you're using minicom.

Run jerryscript with hello.js

NuttShell (NSH)
nsh>
nsh>
nsh> jerryscript /mnt/sdcard/hello.js
PARAM 1 : [/mnt/sdcard/hello.js]
Hello JerryScript!

Please give absolute path of the script file or may get an error like this.

nsh> cd /mnt/sdcard
nsh> jerryscript ./hello.js
PARAM 1 : [./hello.js]
Failed to fopen [./hello.js]
JERRY_STANDALONE_EXIT_CODE_FAIL
nsh>
nsh>
nsh> jerryscript /mnt/sdcard/hello.js
PARAM 1 : [/mnt/sdcard/hello.js]
Hello JerryScript!