jerryscript

Files

T

Dániel Bátyai 9860d66a56 Rework the public API (#4829 )

Related to #4186.

Some notable changes:
  - The term 'Error' now strictly refers to native Error objects defined in
    the ECMA standard, which are ordinary objects. All other uses of
    'error' or 'error reference' where the term refers to a thrown value is
    now called 'exception'.

  - Simplified the naming scheme of many String API functions. These functions
    will now also take an 'encoding' argument to specify the desired
    encoding in which to operate.

  - Removed the substring-copy-to-buffer functions. These functions
    behaved awkwardly, as they use character index to specify the
    start/end positions, and were mostly used incorrectly with byte
    offsets instead. The functionality can still be replicated with
    other functions if necessary.

  - String-to-buffer functions will no longer fail if the buffer is not
    sufficiently large, the string will instead be cropped.

  - Fixed the usage of the '_sz' prefix in many API functions. The term
    'sz' means zero-terminated string in hungarian notation, this was
    used incorrectly in many cases.

  - Renamed most of the public API functions to have shorter, more on-point
    names, rather than the often too long descriptive names. Functions are now
    also grouped by the type of value they operate on, where this makes
    sense.

JerryScript-DCO-1.0-Signed-off-by: Dániel Bátyai dbatyai@inf.u-szeged.hu

2021-12-06 10:20:09 +01:00

src

Rework the public API (#4829 )

2021-12-06 10:20:09 +01:00

CMakeLists.txt

Update Zephyr target to 2.7.0 (#4838 )

2021-12-02 15:33:29 +01:00

Makefile.travis

Update Zephyr target to 2.7.0 (#4838 )

2021-12-02 15:33:29 +01:00

prj.conf

targets: zephyr: Update for Zephyr 2.x (#4731 )

2021-08-26 14:55:30 +02:00

README.md

Update Zephyr target to 2.7.0 (#4838 )

2021-12-02 15:33:29 +01:00

README.md

About

This folder contains files to run JerryScript on STM32F4-Discovery board with Zephyr. The document had been validated on Ubuntu 20.04 operating system.

1. Setup the build environment

Clone the necessary projects into a jerry-zephyr directory. The latest tested working version of Zephyr is v2.7.0.

mkdir jerry-zephyr && cd jerry-zephyr

git clone https://github.com/jerryscript-project/jerryscript.git
git clone https://github.com/zephyrproject-rtos/zephyr -b v2.7.0

# Zephyr requires its toolchain.
wget https://github.com/zephyrproject-rtos/sdk-ng/releases/download/v0.13.2/zephyr-toolchain-arm-0.13.2-linux-x86_64-setup.run

The following directory structure has been created:

jerry-zephyr
  + jerryscript
  |  + targets
  |     + zephyr
  + zephyr
  + zephyr-toolchain-arm-0.13.2-linux-x86_64-setup.run

2. Install dependencies of the projects

# Assuming you are in jerry-zephyr folder.
jerryscript/tools/apt-get-install-deps.sh

# Tool dependencies of Zephyr.
sudo apt install --no-install-recommends \
  git cmake ninja-build gperf ccache dfu-util device-tree-compiler \
  python3-dev python3-pip python3-setuptools python3-tk python3-wheel \
  xz-utils file make gcc gcc-multilib g++-multilib libsdl2-dev

# Install Python dependencies of Zephyr.
pip3 install --user -r zephyr/scripts/requirements.txt

# Install Zephyr toolchain.
chmod +x zephyr-toolchain-arm-0.13.2-linux-x86_64-setup.run
./zephyr-toolchain-arm-0.13.2-linux-x86_64-setup.run -- -y -d ${PWD}/zephyr-toolchain-0.13.2

Note: CMake 3.20 is required. If the installed CMake is older, upgrade it for example this way.

3. Initialize west meta-tool for Zephyr

# Assuming you are in jerry-zephyr folder.
west init -l zephyr
west update hal_stm32 cmsis
west zephyr-export

4. Build Zephyr (with JerryScript)

# Assuming you are in jerry-zephyr folder.
west build -p auto -b stm32f4_disco jerryscript/targets/zephyr/

The created binary is a zephyr.elf named file located in jerry-zephyr/build/zephyr/bin/ folder.

5. Flash

Install udev rules which allows to flash STM32F4-Discovery as a regular user:

# Assuming you are in jerry-zephyr folder.
sudo cp zephyr-toolchain-0.13.2/sysroots/x86_64-pokysdk-linux/usr/share/openocd/contrib/60-openocd.rules /etc/udev/rules.d
sudo udevadm control --reload

Connect Mini-USB for charging and flasing the device.

# Assuming you are in jerry-zephyr folder.
west flash

6. Connect to the device

Use USB To TTL Serial Converter for serial communication. STM32F4-Discovery pins are mapped by Zephyr as follows:

  STM32f4-Discovery PA2 pin is configured for TX.
  STM32f4-Discovery PA3 pin is configured for RX.

Connect STM32f4-Discovery PA2 pin to RX pin of USB To TTL Serial Converter
Connect STM32f4-Discovery PA3 pin to TX pin of USB To TTL Serial Converter
Connect STM32f4-Discovery GND pin to GND pin of USB To TTL Serial Converter

The device should be visible as /dev/ttyUSB0. Use minicom communication program with 115200.

In minicom, set Add Carriage Ret to off in by CTRL-A -> Z -> U key combinations.
In minicom, set Hardware Flow Control to no by CTRL-A -> Z -> O -> Serial port setup -> F key combinations.

sudo minicom --device=/dev/ttyUSB0 --baud=115200

Press RESET on the board to get the initial message with JerryScript command prompt:

*** Booting Zephyr OS build v2.7.99-1786-ga08b65ef42db  ***
JerryScript build: Nov 25 2021 14:17:17
JerryScript API 3.0.0
Zephyr version 2.7.99
js>

Run the following JavaScript example:

js> var test = 0; for (t = 100; t < 1000; t++) test += t; print ('Hello World! ' + test);
Hello World! 494550
undefined