https://github.com/markspanbroek/nim-platformio

Nim support in PlatformIO
https://github.com/markspanbroek/nim-platformio

Last synced: about 2 months ago
JSON representation

Nim support in PlatformIO

• Host: GitHub
• URL: https://github.com/markspanbroek/nim-platformio
• Owner: markspanbroek
• Created: 2021-01-10T15:39:04.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2021-05-28T09:02:21.000Z (over 3 years ago)
• Last Synced: 2024-06-09T22:42:15.894Z (4 months ago)
• Language: Python
• Size: 7.81 KB
• Stars: 17
• Watchers: 2
• Forks: 5
• Open Issues: 0
• Metadata Files:
  • Readme: readme.md

Awesome Lists containing this project

README

        
Nim for PlatformIO

==================

A plugin for [PlatformIO][2] that allows you to use the [Nim][1] programming

language for embedded development.

Installation

------------

To add Nim support to a PlatformIO project, edit `platformio.ini` and add the

following dependency:

```ini

lib_deps =

  https://github.com/markspanbroek/nim-platformio

```

Also, make sure that [Nim][1] is installed, and that the `nim` executable is

visible on the `PATH`.

Usage

-----

Add a file `main.nim` to the `src` folder of the PlatformIO project. Write your

embedded code in this file.

A file `panicoverride.nim` is also required. If it's not present, then this

plugin will create it.

Compilation of `main.nim` happens in two steps: first Nim is compiled to C++,

and then these C++ files are compiled for your device. The intermediate C++

files are generated in the `src/nimcache` folder, so you might want to add that

folder to your `.gitignore` file.

For an example using Arduino, check out [Arduino for Nim][3].

[1]: https://nim-lang.org

[2]: https://platformio.org

[3]: https://github.com/markspanbroek/nim-arduino