No Description

funshine df3c82391f add spi, and some minor fix 9 years ago
.settings df3c82391f add spi, and some minor fix 9 years ago
app df3c82391f add spi, and some minor fix 9 years ago
bin ee2e791282 serial input now accept non-ascii chars 9 years ago
examples 617574d441 fix eclipse project 9 years ago
include c04f2578ec Updated SDK to v0.9.5 and optimized memory. 9 years ago
ld 617574d441 fix eclipse project 9 years ago
lib c04f2578ec Updated SDK to v0.9.5 and optimized memory. 9 years ago
lua_examples 82f7407f69 add example webap_toggle_pin.lua from #53. fix #53 9 years ago
lua_modules 6525747859 DS18B20 module examples 9 years ago
pre_build df3c82391f add spi, and some minor fix 9 years ago
tools 2709258c44 using esptool.py in all platform, fix makefile on windows 9 years ago
.cproject a2d1e5ff2b move eclipse project file to root, now eclipse can see all files 9 years ago
.project a2d1e5ff2b move eclipse project file to root, now eclipse can see all files 9 years ago
LICENSE b249b8d5fe update doc 9 years ago
Makefile cf4a4f2a9d Windows doesn't like forward slash as input to esptool.py 9 years ago
README.md df3c82391f add spi, and some minor fix 9 years ago

README.md

NodeMcu

version 0.9.5 ###A lua based firmware for wifi-soc esp8266 Build on ESP8266 sdk 0.9.5
Lua core based on eLua project
File system based on spiffs
Open source development kit for NodeMCU nodemcu-devkit
Flash tool for NodeMCU nodemcu-flasher

wiki: nodemcu wiki
home: nodemcu.com
bbs: 中文论坛Chinese bbs
Tencent QQ group QQ群: 309957875

Summary

  • Easy to access wireless router
  • Based on Lua 5.1.4 (without io, math, debug, os module.)
  • Event-Drive programming preferred.
  • Build-in file, timer, pwm, i2c, 1-wire, net, gpio, wifi, adc, uart and system api.
  • GPIO pin re-mapped, use the index to access gpio, i2c, pwm.

To Do List (pull requests are very welcomed)

  • fix wifi smart connect
  • add spi module
  • add mqtt module
  • add coap module

Change log

2015-01-18
merge mqtt module to new branch mqtt from https://github.com/tuanpmt/esp_mqtt.
merge spi module from iabdalkader:spi.
fix #110,set local port to random in client mode.
modify gpio.read to NOT set pin to input mode automatic.
add PATH env with C:\MinGW\bin;C:\MinGW\msys\1.0\bin;C:\Python27 in eclipse project. resolve #103.

2015-01-08
fix net.socket:send() issue when multi sends are called.
NOTE: if data length is bigger than 1460, send next packet AFTER «sent» callback is called.
fix file.read() api, take 0xFF as a regular byte, not EOF.
pre_build/latest/nodemcu_512k_latest.bin is removed. use pre_build/latest/nodemcu_latest.bin instead.

more change log
更多变更日志

##GPIO NEW TABLE ( Build 20141219 and later)

<th scope="col">IO index</th><th scope="col">ESP8266 pin</th><th scope="col">IO index</th><th scope="col">ESP8266 pin</th>

<td>0 [*]</td><td>GPIO16</td><td>8</td><td>GPIO15</td>

<td>1</td><td>GPIO5</td><td>9</td><td>GPIO3</td>

<td>2</td><td>GPIO4</td><td>10</td><td>GPIO1</td>

<td>3</td><td>GPIO0</td><td>11</td><td>GPIO9</td>

<td>4</td><td>GPIO2</td><td>12</td><td>GPIO10</td>

<td>5</td><td>GPIO14</td><td></td><td></td>

<td>6</td><td>GPIO12</td><td></td><td></td>

<td>7</td><td>GPIO13</td<td></td><td></td>

[*] D0(GPIO16) can only be used as gpio read/write. no interrupt supported. no pwm/i2c/ow supported.

##GPIO OLD TABLE (Before build 20141212)

<th scope="col">IO index</th><th scope="col">ESP8266 pin</th><th scope="col">IO index</th><th scope="col">ESP8266 pin</th>

<td>0</td><td>GPIO12</td><td>8</td><td>GPIO0</td>

<td>1</td><td>GPIO13</td><td>9</td><td>GPIO2</td>

<td>2</td><td>GPIO14</td><td>10</td><td>GPIO4</td>

<td>3</td><td>GPIO15</td><td>11</td><td>GPIO5</td>

<td>4</td><td>GPIO3</td><td></td><td></td>

<td>5</td><td>GPIO1</td><td></td><td></td>

<td>6</td><td>GPIO9</td><td></td><td></td>

<td>7</td><td>GPIO10</td<td></td><td></td>

#Build option ####file ./app/include/user_config.h

// #define FLASH_512K
// #define FLASH_1M
// #define FLASH_2M
// #define FLASH_4M
#define FLASH_AUTOSIZE
...
#define LUA_USE_MODULES
#ifdef LUA_USE_MODULES
#define LUA_USE_MODULES_NODE
#define LUA_USE_MODULES_FILE
#define LUA_USE_MODULES_GPIO
#define LUA_USE_MODULES_WIFI
#define LUA_USE_MODULES_NET
#define LUA_USE_MODULES_PWM
#define LUA_USE_MODULES_I2C
#define LUA_USE_MODULES_TMR
#define LUA_USE_MODULES_ADC
#define LUA_USE_MODULES_UART
#define LUA_USE_MODULES_OW
#define LUA_USE_MODULES_BIT
#endif /* LUA_USE_MODULES */

#Flash the firmware nodemcu_latest.bin: 0x00000
for most esp8266 modules, just pull GPIO0 down and restart.
You can use the nodemcu-flasher to burn the firmware.

Or, if you build your own bin from source code.
eagle.app.v6.flash.bin: 0x00000
eagle.app.v6.irom0text.bin: 0x10000
esp_init_data_default.bin: 0x7c000
blank.bin: 0x7e000

Better run file.format() after flash

#Connect the hardware in serial baudrate:9600

#Start play

####Connect to your ap

    ip = wifi.sta.getip()
    print(ip)
    --nil
    wifi.setmode(wifi.STATION)
    wifi.sta.config("SSID","password")
    ip = wifi.sta.getip()
    print(ip)
    --192.168.18.110

####Manipulate hardware like a arduino

    pin = 1
    gpio.mode(pin,gpio.OUTPUT)
    gpio.write(pin,gpio.HIGH)
    print(gpio.read(pin))

####Write network application in nodejs style

    -- A simple http client
    conn=net.createConnection(net.TCP, 0) 
    conn:on("receive", function(conn, payload) print(payload) end )
    conn:connect(80,"115.239.210.27")
    conn:send("GET / HTTP/1.1\r\nHost: www.baidu.com\r\n"
        .."Connection: keep-alive\r\nAccept: */*\r\n\r\n")

####Or a simple http server

    -- A simple http server
    srv=net.createServer(net.TCP) 
    srv:listen(80,function(conn) 
      conn:on("receive",function(conn,payload) 
        print(payload) 
        conn:send("<h1> Hello, NodeMcu.</h1>")
      end) 
      conn:on("sent",function(conn) conn:close() end)
    end)

####Do something shining

  function led(r,g,b) 
    pwm.setduty(1,r) 
    pwm.setduty(2,g) 
    pwm.setduty(3,b) 
  end
  pwm.setup(1,500,512) 
  pwm.setup(2,500,512) 
  pwm.setup(3,500,512)
  pwm.start(1) 
  pwm.start(2) 
  pwm.start(3)
  led(512,0,0) -- red
  led(0,0,512) -- blue

####And blink it

  lighton=0
  tmr.alarm(1,1000,1,function()
    if lighton==0 then 
      lighton=1 
      led(512,512,512) 
    else 
      lighton=0 
      led(0,0,0) 
    end 
  end)

####If you want to run something when system started

  --init.lua will be excuted
  file.open("init.lua","w")
  file.writeline([[print("Hello, do this at the beginning.")]])
  file.close()
  node.restart()  -- this will restart the module.

####With below code, you can telnet to your esp8266 now

    -- a simple telnet server
    s=net.createServer(net.TCP,180) 
    s:listen(2323,function(c) 
       function s_output(str) 
          if(c~=nil) 
             then c:send(str) 
          end 
       end 
       node.output(s_output, 0)   -- re-direct output to function s_ouput.
       c:on("receive",function(c,l) 
          node.input(l)           -- works like pcall(loadstring(l)) but support multiple separate line
       end) 
       c:on("disconnection",function(c) 
          node.output(nil)        -- un-regist the redirect output function, output goes to serial
       end) 
       print("Welcome to NodeMcu world.")
    end)

####Use DS18B20 module extends your esp8266

    -- read temperature with DS18B20
    t=require("ds18b20")
    t.setup(9)
    addrs=t.addrs()
    -- Total DS18B20 numbers, assume it is 2
    print(table.getn(addrs))
    -- The first DS18B20
    print(t.read(addrs[1],t.C))
    print(t.read(addrs[1],t.F))
    print(t.read(addrs[1],t.K))
    -- The second DS18B20
    print(t.read(addrs[2],t.C))
    print(t.read(addrs[2],t.F))
    print(t.read(addrs[2],t.K))
    -- Just read
    print(t.read())
    -- Just read as centigrade
    print(t.read(nil,t.C))
    -- Don't forget to release it after use
    t = nil
	ds18b20 = nil
    package.loaded["ds18b20"]=nil