feat(chip-wasm-guide): add guide for explaining how to compile custom chips to WASM

[krisjdev]

Ref #252

I've added sections on how to configure the Wokwi project properly (editing wokwi.toml and the chip .json file) and compilation methods with GH Actions, docker (including VS Code's dev containers) and how to do it locally.

I'm not 100% sure on whether the docker section is what you're expecting, I tried using this image at first (https://hub.docker.com/r/wokwi/builder-clang-wasm), but ran into the missing libclang_rt.builtins-wasm32.a error, which I saw you had rectified in wokwi-chip-clang-action.

[krisjdev]

Also is https://wokwi.com/api/chips/wokwi-api.h the correct link for the C API? Is there a GitHub repo I can link to instead?

[urish]

Thanks!

Yes, is https://wokwi.com/api/chips/wokwi-api.h is the correct link indeed. It always returns the most up to date version of the header file.

Docker - there is actually a published container, which is the same one we use for compiling the code in the online version of Wokwi: wokwi/builder-clang-wasm

We also use it in the dev container.

So I think it may be simpler for users to use that container instead of having the builder the container from scratch. Can you please try?

[krisjdev]

Strange, I had run into some errors with that container but I just did some testing and it started working - must've been something I had misconfigured on my end. I'll update the page to use wokwi/builder-clang-wasm instead.

[urish]

Thanks! The PR is marked as a draft, are you planning on making any additional revisions / changes?