GithubHelp home page GithubHelp logo

m5panel's Introduction

m5Panel for OpenHAB

m5paper

Introduction

This is a preliminary release of using a m5paper as an automation panel for OpenHAB.

I want it to be as simple as possible : it queries OpenHAB items through REST API, so much of the configuration will be on the OpenHAB side. I don't want "yet another interface to configure with its cryptic syntax".

Actually, it just displays the 6 specified OpenHAB item's Label and Status.

While the is no power optimizations, it can already run several hours on battery.

It has been tested with OpenHAB 2.5 and 3.0

See Also

Visit https://github.com/TAKeanice/m5panel for a more advanced fork

How to

  • Clone and open in PlatformIO
  • Copy defs-sample.h to defs.h
  • Edit defs.h and customize:
    • Wifi settings
    • Openhab host and port
    • Sitemap to use (default: m5paper)
  • Upload filesystem image (from PlatformIO menu, or "pio run -t uploadfs")
  • Compile and upload to m5paper
  • Monitor through serial port

Then, a sitemap containing the items to be displayed must be created. Here is a sample sitemap :

sitemap m5panel label="m5panel" {
	Default item=HueSensor1Temperature      label="Outside[%.1f°]" 
	Default item=SondeTH4_Temperature 	label="Cellar[%.1f]"
	Default item=AqaraTemp02Temperature     label="Bedroom[%.1f]" icon=""
	Default item=SonoffRelay2Power          label="Cellar[%s]" icon="light"
	Default item=gd_currstate               label="Garage[%s]" icon=""
}

Sitemap rules :

  • Use sitemap label formatting
  • Label is used as the button title
  • The state is extracted from the label value enclosed in [brackets]
  • Dynamic icons (light, switch, ...) are based on this state
  • If no icon is specified (icon=""), the item state will be displayed in the center of the button
  • Else, it will be displayed at the bottom, in a smaller font, under the icon location
  • 6 items max are supported for now
  • Don't use other sitemap features (frames, ...)

If you're in trouble :

  • Check serial log
  • Display your sitemap at http://<OPENHAB_HOST>:<OPENHAB_PORT>/basicui/app?sitemap=<OPENHAB_SITEMAP>
  • Check you can reach REST API at http://<OPENHAB_HOST>:<OPENHAB_PORT>/rest/sitemaps/<OPENHAB_SITEMAP>

Known issues

  • First displays are slow (due to font caching)
  • No touch screen support

Todo

  • Nice font and correct encoding
  • Dynamic updates
  • Basic icon set
  • Touch screen support for commands (switchs, ...)
  • WifiManager for Wifi and items setup
  • Support https connection to OpenHAB
  • Provide binary releases
  • Advanced widgets (gauge, weather, ...)
  • Multi-page navigation
  • Advanced configuration method (for widgets, fonts ...)

m5panel's People

Contributors

cyrilpawelko avatar

Stargazers

 avatar 王晓峰 avatar  avatar Ugo Meda avatar  avatar vad babushkin avatar Sam A avatar  avatar Amarin avatar  avatar Mauro Risonho de Paula Assumpção avatar  avatar  avatar matqua avatar Henrique avatar Andrey avatar  avatar  avatar Ruslan Gainutdinov avatar tigattack avatar  avatar  avatar Bram Wubs avatar han avatar  avatar

Watchers

 avatar Joep Piscaer avatar  avatar  avatar  avatar  avatar  avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.