2017年4月29日 星期六

[NodeMCU] Lab1 點亮 8-Bit 2812 RGB LED

之前我們介紹過如何用 Arduino 點亮 8-Bit 2812 RGB LED 燈板,詳

http://pizgchen.blogspot.tw/2017/04/ws2812-8-bit-2812-rgb-led.html

這兒我們要改用 NodeMCU 點亮它。



準備材料

1. 8-Bit 2812 RGB LED 燈板 *1
2. 公排針(間距2.54mm) 4P *1
請先依 http://pizgchen.blogspot.tw/2017/04/ws2812-8-bit-2812-rgb-led.html 文中描述焊妥排針。
3. NodeMCU 開發板 *1
4. 杜邦線母母頭 3P *1


電路接線

用杜邦線依下表將 NodeMCU 與燈板連接起來:

NodeMCU      燈板
5V                   VDC
Gnd                 Gnd
D1                   DI


下載函式庫

1. 點選右側網址下載函式庫 https://github.com/adafruit/Adafruit_NeoPixel
2. 將下載的檔案解壓縮,複製到 Arduino IDE 的 libraries 資料夾裏。
3. 更改名稱為「Adafruit_NeoPixel」。


程式碼

#include <Adafruit_NeoPixel.h>
#ifdef __AVR__
  #include <avr/power.h>
#endif

#define PIN D1  //GPIO5

// Parameter 1 = number of pixels in strip
// Parameter 2 = Arduino pin number (most are valid)
// Parameter 3 = pixel type flags, add together as needed:
//   NEO_KHZ800  800 KHz bitstream (most NeoPixel products w/WS2812 LEDs)
//   NEO_KHZ400  400 KHz (classic 'v1' (not v2) FLORA pixels, WS2811 drivers)
//   NEO_GRB     Pixels are wired for GRB bitstream (most NeoPixel products)
//   NEO_RGB     Pixels are wired for RGB bitstream (v1 FLORA pixels, not v2)
//   NEO_RGBW    Pixels are wired for RGBW bitstream (NeoPixel RGBW products)
Adafruit_NeoPixel strip = Adafruit_NeoPixel(8, PIN, NEO_GRB + NEO_KHZ800);

// IMPORTANT: To reduce NeoPixel burnout risk, add 1000 uF capacitor across
// pixel power leads, add 300 - 500 Ohm resistor on first pixel's data input
// and minimize distance between Arduino and first pixel.  Avoid connecting
// on a live circuit...if you must, connect GND first.

void setup() {
  // This is for Trinket 5V 16MHz, you can remove these three lines if you are not using a Trinket
  #if defined (__AVR_ATtiny85__)
    if (F_CPU == 16000000) clock_prescale_set(clock_div_1);
  #endif
  // End of trinket special code


  strip.begin();
  strip.show(); // Initialize all pixels to 'off'
}

void loop() {
  // Some example procedures showing how to display to the pixels:
  colorWipe(strip.Color(255, 0, 0), 50); // Red
  colorWipe(strip.Color(0, 255, 0), 50); // Green
  colorWipe(strip.Color(0, 0, 255), 50); // Blue
//colorWipe(strip.Color(0, 0, 0, 255), 50); // White RGBW
  // Send a theater pixel chase in...
  theaterChase(strip.Color(127, 127, 127), 50); // White
  theaterChase(strip.Color(127, 0, 0), 50); // Red
  theaterChase(strip.Color(0, 0, 127), 50); // Blue

  rainbow(20);
  rainbowCycle(20);
  theaterChaseRainbow(50);
}

// Fill the dots one after the other with a color
void colorWipe(uint32_t c, uint8_t wait) {
  for(uint16_t i=0; i<strip.numPixels(); i++) {
    strip.setPixelColor(i, c);
    strip.show();
    delay(wait);
  }
}

void rainbow(uint8_t wait) {
  uint16_t i, j;

  for(j=0; j<256; j++) {
    for(i=0; i<strip.numPixels(); i++) {
      strip.setPixelColor(i, Wheel((i+j) & 255));
    }
    strip.show();
    delay(wait);
  }
}

// Slightly different, this makes the rainbow equally distributed throughout
void rainbowCycle(uint8_t wait) {
  uint16_t i, j;

  for(j=0; j<256*5; j++) { // 5 cycles of all colors on wheel
    for(i=0; i< strip.numPixels(); i++) {
      strip.setPixelColor(i, Wheel(((i * 256 / strip.numPixels()) + j) & 255));
    }
    strip.show();
    delay(wait);
  }
}

//Theatre-style crawling lights.
void theaterChase(uint32_t c, uint8_t wait) {
  for (int j=0; j<10; j++) {  //do 10 cycles of chasing
    for (int q=0; q < 3; q++) {
      for (uint16_t i=0; i < strip.numPixels(); i=i+3) {
        strip.setPixelColor(i+q, c);    //turn every third pixel on
      }
      strip.show();

      delay(wait);

      for (uint16_t i=0; i < strip.numPixels(); i=i+3) {
        strip.setPixelColor(i+q, 0);        //turn every third pixel off
      }
    }
  }
}

//Theatre-style crawling lights with rainbow effect
void theaterChaseRainbow(uint8_t wait) {
  for (int j=0; j < 256; j++) {     // cycle all 256 colors in the wheel
    for (int q=0; q < 3; q++) {
      for (uint16_t i=0; i < strip.numPixels(); i=i+3) {
        strip.setPixelColor(i+q, Wheel( (i+j) % 255));    //turn every third pixel on
      }
      strip.show();

      delay(wait);

      for (uint16_t i=0; i < strip.numPixels(); i=i+3) {
        strip.setPixelColor(i+q, 0);        //turn every third pixel off
      }
    }
  }
}

// Input a value 0 to 255 to get a color value.
// The colours are a transition r - g - b - back to r.
uint32_t Wheel(byte WheelPos) {
  WheelPos = 255 - WheelPos;
  if(WheelPos < 85) {
    return strip.Color(255 - WheelPos * 3, 0, WheelPos * 3);
  }
  if(WheelPos < 170) {
    WheelPos -= 85;
    return strip.Color(0, WheelPos * 3, 255 - WheelPos * 3);
  }
  WheelPos -= 170;
  return strip.Color(WheelPos * 3, 255 - WheelPos * 3, 0);
}


相關連結

NodeMCU 文件 https://nodemcu.readthedocs.io/en/master/en/modules/pwm/
Adafruit https://www.adafruit.com/product/1426


採購資訊

1. 8-Bit 2812 RGB LED http://goods.ruten.com.tw/item/show?21715791439863
2. NodeMCU Lua Wifi 開發板 http://goods.ruten.com.tw/item/show?21716910606278
3. 公排針 http://goods.ruten.com.tw/item/show?21646385415847
4. 杜邦線 母母頭 http://goods.ruten.com.tw/item/show?21629159825718


[NodeMCU] Lab0 安裝與設定

有別於 Arduino 開發板,NodeMCU 開發套件本身就可以連網,它是一款以 ESP8266 模塊作為基礎的開發板,它將 ESP8266 所有的腳位分別引出,可以讓您作為多種用途使用。

目前的 NodeMCU 開發板有兩種版本,其 USB 轉 TTL 一款是 CP2102,如下圖


另一款是 CH340G,這一款號稱 V3 版,如下圖




NodeMCU 與 ESP8266 的主要差異

  • NodeMCU 包含一個 USB to serial 晶片,可隨插即用
  • NodeMCU firmware 可使用 Lua script 撰寫程式

NodeMCU 開發板使用 Lua 來程式設計,而 ESP8266 系列模塊的使用者,只要把 firmware 更新為 NodeMCU,也可以使用 Lua 來撰寫程式。


本文是使用 NodeMCU 基於 CP2102 開發板來作說明。

如果你是首次使用 NodeMCU,在您將 NodeMCU 插入電腦時,它會要求你安裝 CP2102 驅動程式,因為它使用 CP2102 晶片當作 USB 與 UART 的溝通橋樑。

下載 CP2102 驅動程式 http://www.silabs.com/products/development-tools/software/usb-to-uart-bridge-vcp-drivers

下載後解壓縮,並且依照您的作業系統分別執行

CP210xVCPInstaller_x86.exe (32位元)

CP210xVCPInstaller_x64.exe (64位元)


檢查 NodeMCU 是否已和電腦正確連接

開啟「控制台」>「裝置管理員」>「連接埠(COM 和 LPT)」。
檢視序列埠是否有被啟用(你我的埠可能會不同),如下圖



使用 Arduino IDE 撰寫程式

為了讓我們可以使用 Arduino IDE 來編寫程式,需要做一些設定,這個步驟只需做一次即可,以後啟動 Arduino IDE 都無需重覆設定。

Step1 開啟 Arduino IDE。

Step2 點擊「檔案」>「偏好設定」,將底下那一行字貼到「Additional Boards Manager URLs:」右側欄位內

http://arduino.esp8266.com/stable/package_esp8266com_index.json

Step3 點擊「確定」鈕,並關閉 Arduino IDE。

Step4 再次開啟 Arduino IDE。

Step5 安裝 ESP8266 工具,點擊「工具」>「板子」>「Boards Manager...」。
(出現「Boards Manager」對話窗)

Step6 捲動右側拉桿到下方,點擊「esp8266 by ESP8266 Community」那一欄,再點擊「Install」鈕。

Step7 點擊「關閉」鈕。



開啟範例程式

在自己編寫程式之前,我們先來執行內建的範例程式。這個程式會讓 NodeMCU 板載的 LED 閃爍。

Step1 開啟 Arduino IDE。

Step2 點擊「工具」>「板子」,選擇「NodeMCU 1.0 (ESP-12E Module)」。

Step3 點擊「序列埠」,選擇正確的埠。

Step4 點擊「檔案」>「範例」>「ESP8266」>「Blink」。

Step5 點擊「上傳」。

此時你可以看到 Arduino IDE 下方的訊息欄有陸續出現許多紅點與上傳的百分比,等待顯示上傳完畢,你就可以看到 NodeMCU 板子上面的 LED 閃爍。



圖片中 NodeMCU 下方那一個是電機驅動板,它可以驅動 2 只馬達。


程式說明

1. 我們可以看到 NodeMCU 板子上面的 LED 在閃爍,可是為什麼我們在程式中的腳位是寫著 "LED_BUILTIN" 呢? 這是因為 "LED_BUILTIN" 是 ESP8266 的關鍵字,它其實是等於 "D0",也就是 D0 腳。


接著我們來看看底下這張 NodeMCU 的腳位圖


由圖中我們可以看到 D0 就是 GPIO16,所以如果我們把程式中的「LED_BUILTIN」改成「GPIO16」,你猜 LED 還會正常閃爍嗎?

答案是否定的。正確的寫法如下:

int ledPin = 16; // GPIO16

void setup() {
  pinMode(ledPin, OUTPUT);
}

void loop() {
  digitalWrite(ledPin, LOW);
  delay(1000);
  digitalWrite(ledPin, HIGH);
  delay(2000);
}


2. 不知您是否有發現 LED 閃爍的頻率有點怪怪的,程式中明明寫著 LOW 的時間是 1秒,HIGH 的時間是 2 秒,可為什麼 LED 卻是亮 1 秒、暗 2 秒?那是因為 NodeMCU 板子在電路設計上就是 LOW 時才可以點亮該腳位的 LED。

3. D9 腳位可以點亮 ESP8266 板載 LED,但它也是輸出 LOW 時被點亮,HIGH 就熄滅。


Lua 編輯器

除了使用 Arduino IDE 來編寫程式之外,我們也可以在 ESPlorer 編輯器上用 Lua 語言來寫程式。

點擊右側網址下載並安裝 ESPlorer http://esp8266.ru/esplorer-latest/?f=ESPlorer.zip

用滑鼠右鍵點擊「ESPlorer.bat」。此時會出現命令列畫面,隨後就出現 ESPlorer IDE 視窗。



選擇正確的 COM 埠,並設定 UART 通訊的 Baudrate 為 9600。


點擊「Open」鈕







下方清單框內會出現連線訊息,



我的第一支 Lua 程式

NodeMCU 的特色之一,就是能使用 Lua 來撰寫程式。在 ESPlorer 畫面左側的編輯區,輸入第一個 Hello World 程式碼如下:

print("hello world")

完成後,按下 Send to ESP 按紐,即可將程式碼傳送至 NodeMCU 上執行。


相關連結

NodeMCU 官網 http://nodemcu.com/index_cn.html
NodeMCU 參考文件 https://github.com/nodemcu/nodemcu-firmware/wiki/nodemcu_api_cn
Instruceables http://www.instructables.com/id/Programming-ESP8266-ESP-12E-NodeMCU-Using-Arduino-/
ESPlorer 編輯器 http://esp8266.ru/esplorer/
Lua 編譯器的用法 http://yhhuang1966.blogspot.tw/2015/07/lua.html


採購資訊

NodeMCU Lua Wifi 開發板基於 CP2102 http://goods.ruten.com.tw/item/show?21716910606278
NodeMCU Lua Wifi 開發板基於 CP2102 電機驅動板 http://goods.ruten.com.tw/item/show?21716910640647
NodeMCU Lua Wifi 開發板基於 CH340G http://goods.ruten.com.tw/item/show?21721367978126
NodeMCU Lua Wifi 開發板基於 CH340G 底板 http://goods.ruten.com.tw/item/show?21718168558530










2017年4月13日 星期四

[WS2812] 8-Bit 2812 RGB LED

傳統方式要控制多顆 RGB LED 在電路接線和程式控制方面是非常煩雜的,然而使用內建 WS2812 晶片的 RGB LED 卻是簡單又方便,不管你要控制幾顆 RGB LED,都只要使用 Arduino 3 支腳位就足夠了。

在這兒我使用 2 串 8-Bit RGB LED 燈條來作示範



準備材料

1. 8-Bit 2812 RGB LED *2



2. 排針 4P(腳距2.54mm) *2
3. 排母 4P(腳距2.54mm) *2


4. 杜邦線母母頭 3P *1
5. Arduino Uno or Nano *1


焊接

1. 將排針焊到燈條的 DI 端。
2. 將排母焊到燈條的 DO 端。
3. 如步驟1 & 2 焊接另一燈條。



電路接線

1. 將兩只燈條連接起來,也就是將燈條的公排針插入另一燈條的母排針。
2. 用杜邦線依下表將 Arduino 與燈條連接起來:

Arduino      燈條
5V               VDC
Gnd             Gnd
D6               DI


下載函式庫

1. 點選右側網址下載函式庫 https://github.com/adafruit/Adafruit_NeoPixel
2. 將下載的檔案解壓縮,複製到 Arduino IDE 的 libraries 資料夾裏。
3. 更改名稱為「Adafruit_NeoPixel」。


執行範例程式

1. 啟動 Arduino IDE。
2. 點擊「檔案」>「範例」>「Adafruit_NeoPixel」>「strandtest」。
3. 找到這一行
Adafruit_NeoPixel strip = Adafruit_NeoPixel(60, PIN, NEO_GRB + NEO_KHZ800);
修改為
Adafruit_NeoPixel strip = Adafruit_NeoPixel(16, PIN, NEO_GRB + NEO_KHZ800);

4. 上傳程式。


影片



採購資訊

1. 8-Bit 2812 RGB LED http://goods.ruten.com.tw/item/show?21715791439863
2. 排針 http://goods.ruten.com.tw/item/show?21646385415847
3. 排母 http://goods.ruten.com.tw/item/show?21646384889087
4. 杜邦線 母母頭 http://goods.ruten.com.tw/item/show?21629159825718
5. Arduino Nano http://goods.ruten.com.tw/item/show?21642069565073
6. Arduino Nano & Uno 兩用擴展板 http://goods.ruten.com.tw/item/show?21628077602506