Difference between revisions of "WebAssembly"

From Lazarus wiki
Jump to navigationJump to search
(Add links to demos implemented in Pascal.)
(→‎Free Pascal and WebAssembly: - more WASI packages/units now compile successfully)
(4 intermediate revisions by 3 users not shown)
Line 12: Line 12:
 
* fcl-base
 
* fcl-base
 
* fcl-css
 
* fcl-css
 +
* fcl-db
 
* fcl-hash
 
* fcl-hash
 +
* fcl-js
 +
* fcl-json
 +
* fcl-mustache
 +
* fcl-passrc
 
* fcl-registry
 
* fcl-registry
 +
* fcl-sdo
 
* fcl-sound
 
* fcl-sound
 
* fcl-stl
 
* fcl-stl
 
* fcl-xml
 
* fcl-xml
 
* hash
 
* hash
 +
* libtar
 
* regexpr
 
* regexpr
 
* rtl
 
* rtl
Line 23: Line 30:
 
* rtl-objpas
 
* rtl-objpas
 
* rtl-unicode
 
* rtl-unicode
 +
* symbolic
 
* tplylib
 
* tplylib
 +
* webidl
  
 
The FPC Wasm embedded RTL, in line with FPC's support for [[TARGET_Embedded|embedded targets]], consists of these units:
 
The FPC Wasm embedded RTL, in line with FPC's support for [[TARGET_Embedded|embedded targets]], consists of these units:
Line 37: Line 46:
  
 
== Running in Web Browsers ==
 
== Running in Web Browsers ==
In each demo, the driver program is transpiled from Pascal to Javascript using pas2js, and the worker program/library is compiled from Pascal to Wasm using FPC WASI target.
+
In each demo, the driver program is transpiled from Pascal to Javascript using [[pas2js]], and the worker program/library is compiled from Pascal to Wasm using FPC WASI target.
  
 
* [https://www.freepascal.org/~michael/pas2js-demos/wasienv/terminal/ Simulated terminal input and output]
 
* [https://www.freepascal.org/~michael/pas2js-demos/wasienv/terminal/ Simulated terminal input and output]
Line 45: Line 54:
 
== With Standalone Runtime ==
 
== With Standalone Runtime ==
  
Free Pascal's source tree contains examples embedding the [https://github.com/bytecodealliance/wasmtime wasmtime] standalone Wasm runtime in Pascal host programs.
+
Free Pascal's source tree contains [https://gitlab.com/freepascal.org/fpc/source/-/tree/main/packages/wasmtime/examples examples] embedding the [https://github.com/bytecodealliance/wasmtime wasmtime] standalone Wasm runtime in Pascal host programs.
  
 
=See Also=
 
=See Also=
* [[WebAssembly/Compiler]] - getting the compiler
+
* [[WebAssembly/Compiler]]
 
* [[WebAssembly/Roadmap]]
 
* [[WebAssembly/Roadmap]]
 
* [[WebAssembly/JS]]
 
* [[WebAssembly/JS]]
* [[WebAssembly/Internals]]
+
* [[WebAssembly/Files]]
* [[WebAssembly/Instructions]] - Instructions of the WASM code
+
* [[WebAssembly/DOM]]
* https://webassembly.org/ - the official site
+
* [[WebAssembly/Threads]]
* https://webassembly.github.io/spec/core/text/index.html - text format (S-Expression) specs
+
 
* https://webassembly.github.io/spec/core/binary/index.html - binary format specs
+
There is an external pet project to create a pascal interpreter, not related to Free Pascal:
* https://developer.mozilla.org/en-US/docs/WebAssembly/Understanding_the_text_format
+
* [https://faizilham.github.io/making-budget-pascal-compiler Making a budget Pascal compiler to WebAssembly]
  
* https://rsms.me/wasm-intro - introduction to webassembly
 
* https://blog.scottlogic.com/2018/04/26/webassembly-by-hand.html
 
 
[[Category:WebAssembly]]
 
[[Category:WebAssembly]]

Revision as of 03:06, 22 June 2022

WebAssembly

WebAssembly (abbreviated Wasm) is a binary instruction format for a stack-based virtual machine. Wasm is designed as a portable compilation target for programming languages, enabling deployment on the web for client and server applications. See the WebAssembly website for more information.

Free Pascal and WebAssembly

FPC supports two Wasm compilation targets: WASI and embedded. See WebAssembly/Compiler on how to build and install FPC for Wasm.

WASI - the WebAssembly System Interface - defines an API for operating system-like features, including files and filesystems, network sockets, clocks and random numbers. These features, when implemented in web browsers as well as standalone Wasm runtimes on desktops, servers, and serverless cloud computing units, are available to Pascal programs and libraries compiled by FPC to Wasm for the WASI target.

The FPC WASI RTL consists of these units:

  • fcl-base
  • fcl-css
  • fcl-db
  • fcl-hash
  • fcl-js
  • fcl-json
  • fcl-mustache
  • fcl-passrc
  • fcl-registry
  • fcl-sdo
  • fcl-sound
  • fcl-stl
  • fcl-xml
  • hash
  • libtar
  • regexpr
  • rtl
  • rtl-extra
  • rtl-objpas
  • rtl-unicode
  • symbolic
  • tplylib
  • webidl

The FPC Wasm embedded RTL, in line with FPC's support for embedded targets, consists of these units:

  • rtl
  • rtl-extra
  • tplylib

With respect to the embedded target, there are presently (2022) early efforts to create Wasm-related standards for cross-device/platform/architecture embedded applications.

Overall, FPC's Wasm support adds to FPC's already extensive list of compilation targets, potentially allowing Pascal programs to run in even more environments than they already do.

Demos

Running in Web Browsers

In each demo, the driver program is transpiled from Pascal to Javascript using pas2js, and the worker program/library is compiled from Pascal to Wasm using FPC WASI target.

With Standalone Runtime

Free Pascal's source tree contains examples embedding the wasmtime standalone Wasm runtime in Pascal host programs.

See Also

There is an external pet project to create a pascal interpreter, not related to Free Pascal: