Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/apexskier/blind-minder

Automated, internet connected, esp8266/arduino blind controller
https://github.com/apexskier/blind-minder

3d-printing arduino esp8266 iot

Last synced: about 1 month ago
JSON representation

Automated, internet connected, esp8266/arduino blind controller

Awesome Lists containing this project

README

        

# Blind Minder

Part of my ongoing quest to automate my house.

Blinds open up in the morning to help wake me up and close in the evening before bed.

Most of that's controlled [via HomeKit](https://github.com/apexskier/my-homebridge). A simple
http interface is exposed, and feedback servos allow normal manual control.

## [Parts list](https://www.adafruit.com/wishlists?wid=417600)

## HTTP interface

### POST `/?v={val}[&f=*]`

Angles blinds to `val` degrees. `val` is an int between -180 and 180. set f to
force.

**202** success, blinds will move to specified value

**400** invalid request, extra, missing, or invalid parameters

**409** can't complete operation, already moving (won't happen if you force)

### GET `/`

Returns a JSON blob of data with the current status of the blinds.

**200** success

JSON fields
- **target** _int_ Current target angle
- **current** _int_ Current angle
- **obstructed** _boolean_ The blinds have detected an obstruction
- **moving** _boolean_ If the blinds are moving to the current target angle
- **luminance** _float_ Luminance in lux, intended to be outside luminance

### [ANY] `/stop`

**202** success, servo will be stopped