JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 57
  • Score
    100M100P100Q62221F
  • License MIT

A compact, embeddable scripting engine for microcontrollers for executing small scripts written in a subset of JavaScript.

Package Exports

  • microvium
  • microvium/dist/lib.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (microvium) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Microvium

License

Microvium is a tiny JavaScript engine (less than 16kB compiled size) for microcontrollers for running a small but useful subset of the JavaScript language. The runtime engine is portable C code and easy to integrate.

Microvium takes the unique approach partially running the JS code at build time and deploying a snapshot, which leads to a number of advantages over other embedded JavaScript engines. See concepts.md.

Take a look at my blog (coder-mike.com) and Twitter account (@microvium) if you're interested in some of the behind-the-scenes thought processes and design decisions, and to stay updated with new developments.

See also microvium.com where an installer can be downloaded (for Windows only, at this time, and this is a bit out of date -- but contact me if you want the updated version).

Install and Get Started

Check out the Getting Started tutorial which explains the concepts, gives some examples, and shows how to get set up.

Features

See also the set of supported language features.

  • Run high-level scripts on an MCU (bare metal or RTOS).
  • The runtime engine is implemented in pure C and doesn't use any I/O functions such as fopen or printf.
  • Run the same script code on small microcontrollers and desktop-class machines (ideal for IoT applications with shared logic between device and server) -- the runtime engine is available as a C unit and as a node.js library.
  • Run JavaScript on very small devices, requiring less than 16 kB ROM and 64 B of idle RAM depending on the platform and enabled features (for more details, see here).
  • Script code is completely sand-boxed and isolated for security and safety.

There are a few similar alternatives floating around but Microvium takes a unique approach (see Alternatives).

Limitations

A Microvium VM cannot exceed 64 kB of ROM and/or RAM.

There is no standard library and only a subset of JavaScript is currently supported.

Usage

Microvium can be used in 3 ways:

  1. npm install -g microvium globally will install a CLI that runs microvium scripts (and by default produces a snapshot of the final state, in case you want to deploy it)

  2. npm install microvium will install Microvium as an npm library with TypeScript definitions. This is useful if you want to run Microvium on a custom node.js host and control the snapshotting and host API yourself.

  3. Integrate microvium.c into your C or C++ project to resume execution of a snapshot.

See Getting Started which walks you through all 3 of these.

Docs

Contributing

Check out ./doc/contribute.md.