This project integrates NodeMCU support in Lua Development Tools (LDT) as an new Execution Environment.
As a result you will get an good NodeMCU IDE to write better code more easy.
No debugging support! Only autocompletion (autocomplete, code completion, content assist)!
LDT can be downloaded as an standalone IDE or as a part of Eclipse IDE.
More Infos at: https://eclipse.org/ldt/
The documentation is inherited from https://nodemcu.readthedocs.io/en/master/ and https://github.com/nodemcu/nodemcu-firmware (source files). Some parts have been removed or edited.
NodeMCU is a eLua based firmware for ESP8266 chips to run Lua programs. You can build your custom NodeMCU firmware at http://nodemcu-build.com (or use other methods https://nodemcu.readthedocs.io/en/dev/en/build/).
Download the zip file in the "release" directory of your desired NodeMCU Version of this repository or use the direct links:
Note: Old versions are usually not maintained anymore by this project.
Old (only minimal LDT integration):
NodeMCU 1.4.0: https://github.com/prikril/ldt-nodemcu/raw/master/lua5.1-nodemcu1.4.0/release/lua5.1-nodemcu1.4.0.zip
Old (last 1.5.x was 201612):
NodeMCU 1.5.x: https://github.com/prikril/ldt-nodemcu/raw/master/lua5.1-nodemcu1.5.x/release/lua5.1-nodemcu1.5.x.zip
Current (recommended version):
NodeMCU 2.1.x: https://github.com/prikril/ldt-nodemcu/raw/master/lua5.1-nodemcu2.1.x/release/lua5.1-nodemcu2.1.x.zip
Open LDT (or Eclipse) and go to Preferences. On the left side choose "Lua".
Click on "Execution Environment" and then the "Add..." button.
Select the downloaded zip file. Then you should see it in the list of the Execution Environments.
If you want, you can tick the Lua NodeMCU Execution Environment to make it the default one.
Click on "OK" to close the preferences window.
Now you can click on File->New->Lua Project and select the Lua NodeMCU Execution Environment.
If you want to add a new version of the NodeMCU Execution Environment, you need to remove the current one first.
Select the execution environment in the list as described above. Click the "Remove" button.
Then add the new zip. (Same steps as above.)
It may be necessary to restart the IDE.
If your project's Execution Environment is set correctly, you will get autocompletion support for NodeMCU specific functions.
Note: The default Lua modules "io" and "os" are not available in NodeMCU (http://nodemcu.readthedocs.io/en/dev/en/lua-developer-faq/#how-is-nodemcu-lua-different-to-standard-lua). I made a screenshot from ESPlorer to show which default Lua modules are available. (The romtable addresses may differ in your firmware.) Not all functions from "math" are available! Consider https://github.com/nodemcu/nodemcu-firmware/blob/master/app/lua/lmathlib.c to see which functions can be used.
The following table shows the progress of integration of the NodeMCU modules for LDT. In addition you see which modules are available in the specific NodeMCU versions as defined by the NodeMCU developers. (Select "master" or "dev" branch at http://nodemcu-build.com/ and compare the available modules for more information.)
Note: The IDE doesn't know which modules are included in your custom NodeMCU firmware build. You will always get displayed all modules and functions for autocompletion that are integrated in the selected Execution Environment!
The current (2017-07-23) version of NodeMCU Master branch is 2.1.x, the old versions are not supported by this project anymore.
Please use the latest version from NodeMCU to get the newest modules and functions.
| Module | Integration | 1.4.0 (old) | 1.5.x (old) | 2.1.x | Comment |
|---|---|---|---|---|---|
| am2320 | no | no | yes | yes | |
| bit | full | yes | yes | yes | |
| cjson | full | yes | yes | yes | |
| dht | full | yes | yes | yes | |
| enduser_setup | full | yes | yes | yes | |
| file | full | yes | yes | yes | *full, except: chdir, mount, on, stat |
| gpio | full | yes | yes | yes | |
| http | full | no | yes | yes | |
| i2c | full | yes | yes | yes | |
| mqtt | full | yes | yes | yes | has some overloaded functions |
| net | full* | yes | yes | yes | *full, except: on and send for UDP server |
| node | full* | yes | yes | yes | *full, except: osprint, stripdebug and deprecated functions |
| ow (1-Wire) | full | yes | yes | yes | |
| pwm | full | yes | yes | yes | |
| sjson | full | no | no | yes | replaces cjson since 2.x |
| tls | full | no | no | yes | |
| tmr | full | yes | yes | yes | |
| wifi | full* | yes | yes | yes | *full, except: eventmon, smart |
(Note: Some modules and functions are not available in old NodeMCU versions.)
-
You need a module that isn't already listed here?
-
You need a function that isn't already integrated?
-
You found a mistake in this project?
Open an issue on github! Or fix it yourself and send a pull request!
https://wiki.eclipse.org/LDT/User_Area/Tutorial/Create_a_simple_Execution_Environment
https://wiki.eclipse.org/LDT/User_Area/Execution_Environment_file_format
https://www.eclipse.org/forums/index.php/t/1065750/ (Possible to install NodeMCU in LDT)