Skip to content
Firmware Oficial BH OnOfre
C C++ JavaScript HTML
Branch: master
Clone or download

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
EasyIot7 Alexa Skill Intregation and CloudIO Jan 15, 2020
html 7.848 Jan 6, 2020
screenshots new firmware in platformIO Aug 19, 2019
.gitignore no message Jul 8, 2019
LICENCE.md Versão 2.91 Nov 16, 2018
README.md Update README.md Jul 11, 2019

README.md

BH OnOfre

AP Password

EasyIot@

Intro

O projeto BH Easy Iot, é o firmware oficial para todas as boards BH, no entanto tambem é compativel com todas as boards baseadas em ESP8266 tem o objetivo de tornar a automação domiciliar muito mais simples, de forma aberta e sem restrições. Todo o código fonte é aberto.

Bibliotecas necessárias

Nome Link Versão
JustWifi GIT last
Timming GIT last
Async Mqtt Client GIT last
ESP Async TCP GIT last
ESP Async Webserver GIT last
DebounceEvent GIT last
DHT Async GIT last
Arduino Json ARDUINO IDE 5.*
OneWire ARDUINO IDE last
PZEM004T GIT last
Arduino-Temperature-Control-Library GIT last

Painel de Controlo

dash devices wifi mqtt update

Hardware

  • BH OnOfre Dev Board 3.4 dev_board_3.4

Software necessário

  • Arduino Ide (caso seja para alterar o codigo fonte)
  • Upload do Firmware para o ESP8266 (dentro de cada projeto o firmware está dentro da pasta binarios)
  • Aceder ao AP SSID:BH_ONFFRE_NODE_ID e configurar a Rede Wi-Fi
  • Navegar até http://<bh-onofre name>.local ou http://<bh-onofre IP address> ou http://192.168.4.1 ligado directamente ao módulo
  • Configurar o Wi-Fi broker, MQTT broker entre outras coisas como integração automática com Home Assistant
  • E tá feito, agora é só curtir :)

Donativos

Se gostaste do projeto podes fazer o teu donativo :).

Donativo

API

h1. EasyIot Api This api allows you to control all your devices that have the EasyIot Firmware installed.

Version: 1.0.0


{toc:printable=true|style=square|minLevel=2|maxLevel=3|type=list|outline=false|include=.*}

h2. Endpoints

h3. addInventory
{status:colour=Yellow|title=post|subtle=false}
{code}
post /config
{code}
*Summary:* adds an inventory item
*Description:* Adds an item to the system


h4. Parameters

    h5. Body Parameter
    ||Name||Description||Required||Default||Pattern||
    |inventoryItem |Inventory item to add |(x) | |  |







h4. Responses
    *Status Code:* 201
    *Message:*     item created
    {code:title=Response Type}

    {code}
    See [#models]



    {code:title=Response Schema |collapse=true}

{ "description" : "item created" } {code} Status Code: 400 Message: invalid input, object invalid {code:title=Response Type}

    {code}
    See [#models]



    {code:title=Response Schema |collapse=true}

{ "description" : "invalid input, object invalid" } {code} Status Code: 409 Message: an existing item already exists {code:title=Response Type}

    {code}
    See [#models]



    {code:title=Response Schema |collapse=true}

{ "description" : "an existing item already exists" } {code} ----

h3. getconfig
{status:colour=Yellow|title=get|subtle=false}
{code}
get /config
{code}
*Summary:* get current config
*Description:* Return the current config in use 


h4. Parameters







h4. Responses
    *Status Code:* 200
    *Message:*     configuration
    {code:title=Response Type}

Config {code} See [#models]

    {code:title=Response Schema |collapse=true}

{ "description" : "configuration", "schema" : { "$ref" : "#/definitions/Config" } } {code} ----

h2. Models

    h3. Config
    ||Field Name||Required||Type||Description||
     |nodeId | |String | |

|homeAssistantAutoDiscoveryPrefix | |String | | |mqttIpDns | |String | | |mqttPort | |BigDecimal | | |mqttUsername | |String | | |mqttPassword | |String | | |wifiSSID | |String | | |wifiSSID2 | |String | | |wifiSecret | |String | | |wifiSecret2 | |String | | |wifiIp | |String | | |wifiMask | |String | | |wifiGw | |String | | |staticIp | |Boolean | | |apSecret | |String | | |configTime | |BigDecimal | | |configkey | |String | | |hostname | |String | | |apName | |String | | |firmware | |BigDecimal | |

You can’t perform that action at this time.