diff options
Diffstat (limited to 'targets/nuttx-stm32f4/README.md')
-rw-r--r-- | targets/nuttx-stm32f4/README.md | 165 |
1 files changed, 51 insertions, 114 deletions
diff --git a/targets/nuttx-stm32f4/README.md b/targets/nuttx-stm32f4/README.md index 22761741..bfbcb46d 100644 --- a/targets/nuttx-stm32f4/README.md +++ b/targets/nuttx-stm32f4/README.md @@ -1,143 +1,91 @@ ### About -This folder contains files to run JerryScript on NuttX with -[STM32F4-Discovery with BB](http://www.st.com/web/en/catalog/tools/FM116/SC959/SS1532/LN1199/PF255417) - +This folder contains files to run JerryScript on +[STM32F4-Discovery board](http://www.st.com/content/st_com/en/products/evaluation-tools/product-evaluation-tools/mcu-eval-tools/stm32-mcu-eval-tools/stm32-mcu-discovery-kits/stm32f4discovery.html) with [NuttX](http://nuttx.org/) ### How to build -#### 1. Preface +#### 1. Setting up the build environment for STM32F4-Discovery board + +Clone JerryScript and NuttX into jerry-nuttx directory -1, Directory structure +``` +mkdir jerry-nuttx +cd jerry-nuttx +git clone https://github.com/Samsung/jerryscript.git +git clone https://bitbucket.org/nuttx/nuttx.git +git clone https://bitbucket.org/nuttx/apps.git +git clone https://github.com/texane/stlink.git +``` -Assume `harmony` as the root folder to the projects to build. -The folder tree related would look like this. +The following directory structure is created after these commands ``` -harmony +jerry-nuttx + + apps + jerryscript | + targets | + nuttx-stm32f4 + nuttx - | + nuttx - | + lib - + st-link -``` - - -2, Target board - -Assume [STM32F4-Discovery with BB](http://www.st.com/web/en/catalog/tools/FM116/SC959/SS1532/LN1199/PF255417) -as the target board. - - -3, Micro SD-Card memory for Script source files - - -#### 2. Prepare NuttX - -Follow [this](https://bitbucket.org/seanshpark/nuttx/wiki/Home) 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 + + stlink ``` -# 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. Adding JerryScript as an interpreter for NuttX -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 +cd apps/interpreters +mkdir jerryscript +cp ../../jerryscript/targets/nuttx-stm32f4/* ./jerryscript/ ``` -It'll show the last error but it's ok. Nows the time to build JerryScript. - +#### 3. Configure NuttX -#### 3. Build JerryScript for NuttX - -``` -# assume you are in harmony folder -cd jerryscript -make -f ./targets/nuttx-stm32f4/Makefile.nuttx ``` +# assuming you are in jerry-nuttx folder +cd nuttx/tools -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 -``` +# configure NuttX USB console shell +./configure.sh stm32f4discovery/usbnsh -Make will copy three library files to `nuttx/nuttx/lib` folder -``` -libjerryentry.a -libjerrycore.a -libjerrylibm.a +cd .. +# might require to run "make menuconfig" twice +make menuconfig ``` -In NuttX, if you run `make clean`, above library files are also removed so you -may have to build JerryScript again. +Change "Build Setup" -> "Build Host Platform" from "Windows" to "Linux" +Enable "System Type" -> "FPU support" +Enable "Library Routines" -> "Standard Math library" +Enable "Application Configuration" -> "Interpreters->JerryScript" -#### 4. Continue build NuttX +#### 4. Build JerryScript for NuttX ``` -# asssume you are in harmony folder -cd nuttx/nuttx +# assuming you are in jerry-nuttx folder +cd nuttx/ make ``` - #### 5. Flashing Connect Mini-USB for power supply and connect Micro-USB for `NSH` console. -Please refer [this](https://github.com/Samsung/iotjs/wiki/Build-for-NuttX#prepare-flashing-to-target-board) -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 configure `stlink` utility for flashing, follow the instructions [here](https://github.com/texane/stlink#build-from-sources). -To clean the build result, +To flash, ``` -make -f ./targets/nuttx-stm32f4/Makefile.nuttx clean +# assuming you are in nuttx folder +sudo ../stlink/build/st-flash write nuttx.bin 0x8000000 ``` - ### 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 +You can use `minicom` for terminal program, or any other you may like, but set baud rate to `115200`. ``` -minicom --device=/dev/ttyACM0 --baud=115200 +sudo 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. @@ -152,27 +100,16 @@ please set `Add Carriage Ret` option by `CTRL-A` > `Z` > `U` at the console, if you're using `minicom`. -Run `jerryscript` with `hello.js` +Run `jerry` with javascript file(s) ``` 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! +nsh> jerry full_path/any.js +``` + +Without argument it prints: +``` +nsh> jerry +No input files, running a hello world demo: +Hello world 5 times from JerryScript ``` |