Add PlatformIO example

Author: vshymanskyy

examples_pio/Wasm_Advanced/.gitignore

@@ -0,0 +1 @@
+.pio

examples_pio/Wasm_Advanced/README.md

@@ -0,0 +1,16 @@
+## PlatformIO example (advanced)
+
+`./wasm_apps` contains sample apps in `C/C++`, `Rust`, `AssemblyScript`, `TinyGo`
+
+`./wasm_vm` contains the host interpreter/VM.  
+You can add your device type in `platformio.ini`.  
+Adjust the LED pin number with `-DLED_PIN` option.
+
+To run the example:
+```sh
+pio run -e <device> -t upload && pio device monitor
+```
+Where `<device>` is one of:  
+`ESP32`, `ESP8266`, `Arduino101`, `MKR1000`, `NucleoWB55RG`, `BluePill`, `TinyBLE`, `Teensy31`, `WildFireV3`
+
+**Note:** This example uses Wasm Linear Memory. You should be able to run it on any device that can afford to allocate 1-2 pages of Wasm Linear Memory (i.e. have >= 128KiB RAM).

examples_pio/Wasm_Advanced/platformio.ini

@@ -0,0 +1,120 @@
+; PlatformIO Project Configuration File
+;
+;   Build options: build flags, source filter
+;   Upload options: custom upload port, speed and extra flags
+;   Library options: dependencies, extra library storages
+;   Advanced options: extra scripting
+;
+; Please visit documentation for the other options and examples
+; https://docs.platformio.org/page/projectconf.html
+
+; Common configuration
+
+[platformio]
+src_dir = wasm_vm
+
+[env]
+framework = arduino
+monitor_speed = 115200
+
+lib_deps = Wasm3
+
+src_build_flags =
+  -Wno-unused-function -Wno-unused-variable -Wno-unused-parameter
+  -Wno-missing-field-initializers
+
+; Device-specific configuration
+
+[env:ESP32]
+platform = espressif32
+board = esp32dev
+board_build.f_cpu = 240000000L
+
+src_build_flags =
+  ${env.src_build_flags}
+  -DLED_PIN=19
+  -DESP32
+  -O3 -flto
+
+[env:ESP8266]
+platform = espressif8266
+board = nodemcuv2
+board_build.f_cpu = 160000000L
+
+upload_speed = 460800
+
+src_build_flags =
+  ${env.src_build_flags}
+  -DLED_PIN=13
+  -DESP8266 -Dd_m3FixedHeap=0x6000
+  -O3 -flto
+
+[env:Arduino101]
+platform = intel_arc32
+board = genuino101
+
+src_build_flags =
+  ${env.src_build_flags}
+  -DLED_PIN=13
+  -Os -flto
+
+[env:MKR1000]
+platform = atmelsam
+board = mkr1000USB
+
+src_build_flags =
+  ${env.src_build_flags}
+  -DLED_PIN=6
+  -O3 -flto
+
+[env:NucleoWB55RG]
+platform = ststm32
+board = nucleo_wb55rg_p
+upload_protocol = mbed
+
+src_build_flags =
+  ${env.src_build_flags}
+  -DLED_PIN=PB5
+  -O3 -flto
+
+[env:BluePill]
+platform = ststm32
+board = bluepill_f103c8
+upload_protocol = stlink
+
+src_build_flags =
+  ${env.src_build_flags}
+  -DLED_PIN=PC13
+  -Os -flto
+
+[env:TinyBLE]
+platform = nordicnrf51
+board = seeedTinyBLE
+
+src_build_flags =
+  ${env.src_build_flags}
+  -DLED_PIN=23
+  -Os -flto
+
+[env:Teensy31]
+platform = teensy
+board = teensy31
+upload_protocol = teensy-cli
+
+src_build_flags =
+  ${env.src_build_flags}
+  -DLED_PIN=13
+  -O3 -flto
+
+# d_m3SkipMemoryBoundsCheck was needed here,
+# as 64-bit operations seem to be broken on AVR
+[env:WildFireV3]
+platform = atmelavr
+board = wildfirev3
+
+src_build_flags =
+  ${env.src_build_flags}
+  -DLED_PIN=6
+  -Dd_m3SkipMemoryBoundsCheck=1
+  -Dd_m3CodePageAlignSize=512
+  -Os -flto

examples_pio/Wasm_Advanced/wasm_apps/assemblyscript/.gitignore

@@ -0,0 +1,2 @@
+node_modules/
+*.wat

examples_pio/Wasm_Advanced/wasm_apps/assemblyscript/app.ts

@@ -0,0 +1,37 @@
+import * as dev from "./arduino";
+
+let LED = dev.getPinLED();
+
+function cbk(size: usize): usize {
+  dev.println("!CBK!");
+  return 123;
+}
+
+function setup(): void {
+  dev.pinMode(LED, dev.OUTPUT);
+
+  dev.print('Hello from AssemblyScript 😊\n');
+}
+
+function run(): void {
+  const t = dev.millis();
+  dev.println('[' + t.toString() + '] ' + dev.getString());
+
+  //dev.testCallback(cbk);
+
+  dev.digitalWrite(LED, dev.HIGH);
+  dev.delay(100);
+  dev.digitalWrite(LED, dev.LOW);
+  dev.delay(900);
+}
+
+/*
+ * Entry point
+ */
+export function _start(): void {
+  setup();
+  while (1) {
+    run();
+  }
+}
+

examples_pio/Wasm_Advanced/wasm_apps/assemblyscript/app.wasm

@@ -0,0 +1,36 @@
+export const LOW  = 0;
+export const HIGH = 1;
+
+export const INPUT        = 0x0;
+export const OUTPUT       = 0x1;
+export const INPUT_PULLUP = 0x2;
+
+
+export declare function millis(): u32;
+export declare function delay(ms: u32): void;
+export declare function pinMode(pin: u32, mode: u32): void;
+export declare function digitalWrite(pin: u32, value: u32): void;
+export declare function getPinLED(): u32;
+
+@external("print")        declare function _print(ptr: usize): void;
+@external("getString")    declare function _getString(ptr: usize, len: i32): void;
+
+export function print(str: string): void {
+  _print(changetype<usize>(String.UTF8.encode(str, true)))
+}
+
+export function println(str: string): void {
+  print(str + '\n')
+}
+
+export function getString(): string {
+  const arr = new ArrayBuffer(64)
+  _getString(changetype<usize>(arr), 64)
+  return String.UTF8.decode(arr, true)
+}
+
+/*
+type testFunc = ((size: usize) => usize) | null;
+
+export declare function testCallback(f: testFunc): void;
+*/

examples_pio/Wasm_Advanced/wasm_apps/assemblyscript/app.wasm.h

@@ -0,0 +1,10 @@
+{
+  "license": "MIT",
+  "scripts": {
+    "build": "npm run asbuild:optimized && xxd -i app.wasm > app.wasm.h",
+    "asbuild:optimized": "npx asc app.ts -b app.wasm -t app.wat -O3z --runtime half --noAssert --use abort="
+  },
+  "devDependencies": {
+    "assemblyscript": "0.8.1-nightly.20200123"
+  }
+}