FFI documentation

[hiperiondev]

First of all thank you very much for the excellent project!
I have created a simple port for esp32 in a couple of hours (https://github.com/hiperiondev/esp32-microvium) and the minimum test works perfectly. To facilitate the use it has littlefs and a small TFTP server.
I've seen quickly: https://github.com/coder-mike/microvium-ffi-example
The method is not very clear (especially because it is done in C++ and not in C)
I think that a small documentation on how the FFI process is carried out would be necessary

[coder-mike]

Hi. Great to hear you like it and thanks for linking your project!

To clarify, are you asking for how to use the low level FFI methods in microvium.h and vmImport/vmExport, or are you asking for how to create an FFI wrapper library like microvium-ffi-example, or documentation on how to use the microvium-ffi-example library (which is a C++ library)?

[hiperiondev]

Exactly. Microvium seems to me a good alternative to Lua as a "glue" language.
I would need a concrete example of how to access a function in C and how to use it with Javascript.

[hiperiondev]

microvium-ffi-example is an example of "autobuilder" code. Not a concrete example of an arbitrary function imported and used within the javascript program

[hiperiondev]

After read https://coder-mike.com/blog/2022/10/16/ffi-generator-library/ I understood a little how it would be implemented. It's a bit confusing though.
I'm going to try some tests, but a good C example would be much more beneficial and self-explanatory than an ffi "autogenerator".
On the other hand, you assume that C++ is the language used by default for microcontrollers, we could discuss it but it is much more common to use C, as well as any example being simpler and working for both C and C++.

[coder-mike]

Ok, I've now written a guide to how to interface between C and JavaScript. See doc/ffi-guide.md. Let me know if that helps!

I think perhaps you misunderstood the intention of the microvium-ffi-example. As you may have figured out, it's an example that demonstrates how to write an FFI generator library, and in particular it's an example that shows how the snapshotting and build-time execution model of Microvium makes it possible to write very powerful libraries that encapsulate a lot of the awkward detail and hazards of FFI in general. At some point, such a library may be baked into Microvium so that it's easier to use, but at the moment you either need to just the raw Microvium API or create your own library (which may be based on the one I threw together as an example or it may be completely different), or use someone else's library (of which I don't think there are any at the moment).

Hopefully the new FFI guide is more in line with what you're trying to achieve at the moment.

[hiperiondev]

THANKS A LOT!!!!
I have read the document and it is really very clear.
I will do some tests to implement some basic microcontroller functions.
Some kind of HAL would be useful to easily port to other uCs.
I'm going to approach the project that way.

[coder-mike]

A HAL would be great. Are you doing this as open source work?

[hiperiondev]

yes, MIT license.

[coder-mike]

Nice! Can you link it here?

[hiperiondev]

Of course!!
I found a generic BSD-licensed RTOS HAL library that looks interesting to implement.
When I have news I'll let you know.

[hiperiondev]

Of course!!
I found a generic BSD-licensed RTOS HAL library that looks interesting to implement (or maybe Driver Subsystem of FreeRTOS HAL)
When I have news I'll let you know.

[hiperiondev]

I'll start with: http://www.wsn.agh.edu.pl/download/public/halfred/0.2.0/

And then I'll expand on it as needed.

[hiperiondev]

I have added HAL structure and minimal functionality for wifi and filesystem. Not microvium integration for now.
You can see that at: https://github.com/hiperiondev/esp32-microvium/tree/main/components/uc-hal

[hiperiondev]

Ok...my first FFI :-)
I have added simple wifi connect to HAL.
Can you see the project ? Please destroy my horrible code!