Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/vietquocnguyen/NodeMCU-ESP8266-Servo-Smart-Blinds

DIY Smart Blinds using NodeMCU V3/ESP8266 and an MG995 Servo
https://github.com/vietquocnguyen/NodeMCU-ESP8266-Servo-Smart-Blinds

3d-printing device-handler nodemcu servo smartthings

Last synced: 8 days ago
JSON representation

DIY Smart Blinds using NodeMCU V3/ESP8266 and an MG995 Servo

Host: GitHub
URL: https://github.com/vietquocnguyen/NodeMCU-ESP8266-Servo-Smart-Blinds
Owner: vietquocnguyen
License: mit
Created: 2018-04-05T13:32:37.000Z (over 6 years ago)
Default Branch: master
Last Pushed: 2018-06-12T02:51:23.000Z (over 6 years ago)
Last Synced: 2024-08-01T19:43:33.829Z (4 months ago)
Topics: 3d-printing, device-handler, nodemcu, servo, smartthings
Language: C++
Size: 1.96 MB
Stars: 45
Watchers: 6
Forks: 12
Open Issues: 3
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# NodeMCU-ESP8266-Servo-Smart-Blinds
DIY Smart Blinds using NodeMCU V3/ESP8266 and an MG995 Servo. Integration with SmartThings.

[Video Demo](https://www.youtube.com/watch?v=OtgRTiDLi0c)

![Example](img/example1.jpg)

**NOTE: I HAVE IMPLEMENTED ZERO SECURITY IN THIS CODE. USE AT YOUR OWN RISK**

## Parts

- [NodeMCU V3 / ESP-12E Development Board](https://www.aliexpress.com/item/ESP8266-CH340G-CH340-G-NodeMcu-V3-Lua-Wireless-WIFI-Module-Connector-Development-Board-Based-ESP-12E/32800966224.html) - $2.75
- [MG995 Servo](https://www.aliexpress.com/item/Free-shipping-1pcs-lot-MG995-55g-servos-Digital-Metal-Gear-rc-car-robot-Servo-MG945-MG946R/32270781027.html) - $3.08
- Micro USB Cable

## Modding the Servo for Continuous Rotation

The MG995 Servo can only rotate 180°. This [video](https://youtu.be/8bcYB-0bctE?t=1m14s) is a guide to mod the servo for continuous 360° rotation. At [1m 59s](https://youtu.be/8bcYB-0bctE?t=1m59s), he used a pair of needle nose pliers to remove the stop pin from the gear, but that did not work for me. I had to use a dremel to cut it off.

## Setting up NodeMCU with Arduino IDE

I used this [video](https://www.youtube.com/watch?v=NEo1WsT5T7s) to get started uploading code to the NodeMCU. I'm using a mac so I used these [drivers](https://github.com/MPParsley/ch340g-ch34g-ch34x-mac-os-x-driver).

## Uploading code to the NodeMCU

1. Clone this repo somewhere on your computer
2. Change the default wifi variables in the `smart-blinds.ino` sketch
```
#define DEFAULT_WIFI_SSID "My Wifi Nework 5G"
#define DEFAULT_WIFI_PASSWORD "MyWifiP@assword"
#define DEFAULT_HOSTNAME "esp8266-smart-blinds"
```
3. Connect the NodeMCU and upload the sketch
4. If you go to `Tools` > `Serial Monitor`, You will see something like this:

![Serial Monitor](img/serial-monitor.png)
5. From here you can access the website via `http://esp8266-smart-blinds.local/version` (or whatever you set your `DEFAULT_HOSTNAME` to be) or `http://IPHERE/version`
6. Now you need to clear your EEPROM by going to `http://esp8266-smart-blinds.local/clear`

## Connecting the Servo to the NodeMCU

For some reason, every time I flash the code while the servo is connected, it won't work. So many sure you disconnect when you upload your code using USB.

1. Connect the Servo connector so that the:
- ![#FF7323](https://placehold.it/15/FF7323/000000?text=+) Orange pin (PWM) is at `D4`
- ![#FF0000](https://placehold.it/15/FF0000/000000?text=+) Red (Vcc) pin is at `3V`
- ![#753800](https://placehold.it/15/753800/000000?text=+) Brown (Ground) is at `G`
- No jumper wires needed
2. Now go to `http://esp8266-smart-blinds.local/close` and `http://esp8266-smart-blinds.local/open` to watch the servo spin in two different directions
3. To view the speed / duration configuration: `http://esp8266-smart-blinds.local/config`
4. To change the speed / duration configuration: `http://esp8266-smart-blinds.local/config?speed=2&duration=5000`, then go back to `/open` or `/close` to see the changes
5. To view the wifi configuration: `http://esp8266-smart-blinds.local/wifi`
6. To change the wifi configuration: `http://esp8266-smart-blinds.local/wifi?ssid=NEW+Wifi&password=blah`. After this, the NodeMCU will reboot and try to connect to the new network. If it can't connect to the new network within 60 seconds, it'll revert back to the defaults defined in the sketch.

## Integration with SmartThings

The device handler is in `smart-blinds.groovy`. This [video](https://youtu.be/zNNGy9xhl34?t=13m51s) does a good job showing how to add a device handler. After you add the device handler, you just have to add a `New Device` and set the `serverIP` preference to your NodeMCU's IP Address. You'll understand once you watch the video.

## 3D Printing the Ball Chain Adapter

My blinds run on a ball chain, so I 3D printed this [adapter](https://www.thingiverse.com/thing:2850794) to attach to the servo motor arm.