Hubitat™ Dashboard

From Hubitat Documentation
Revision as of 22:51, 14 September 2018 by Hubipete (talk | contribs)
Jump to: navigation, search

Hubitat Dashboard gives you remote access to monitor and control your devices from your phone, tablet or desktop. This is a highly customizable dashboard that lets your choose the devices and layout you want to see. You can even set up multiple dashboards if you want to provide custom dashboards for each member of your house. Here's how to set it up.


Creating Your Dashboard

  1. Load the Hubitat Dashboard App in the Hubitat Web Interface.
  2. Click on Create a New Dashboard
    DB1.png
  3. Give your dashboard a name. This name will appear at the top of the HTML dashboard. Pick something descriptive such as the room this dashboard is controlling or its main purpose.
    DB2.png
  4. Next, decide if you want to authorize all devices to the dashboard or just a select few devices. You can choose to use all devices by toggling the Use all your devices switch to On. If you want to pick only a few devices, select Choose Devices and check the devices you want to see on your dashboard.
    DB3.png
  5. Now pick your layout. If you want to use the default layout, just click Next. Click the Layout Options button to configure grid to customize your dashboard layout.
ADD SCREENSHOT
  1. Hubitat™ Dashboard uses a grid system for populating your devices in the dashboard. In the Layout Options section you can select one of the default grids or specify the exact number of Rows and Columns you want. Don’t worry; you can change all of this later, even in the actual dashboard interface.
    DB4.png
  2. If you want all the devices you selected to be displayed on your dashboard, toggle on Auto Populate Dashboard. The dashboard automatically assign a tile for each device and place it on the dashboard. If you have more devices than grid spots, it will fill all the open spots and you can change them in the dashboard. Once your dashboard is created (or if you leave this toggle off), devices can be added/removed devices in the dashboard itself.
    DB5.png
  3. Toggle the Read-Only Dashboard on if you do not want to allow the user to change the dashboard in the Dashboard interface. You will want to leave this off until you have set up the dashboard to your liking, then come back in here and toggle it off.
    DB6.png
  4. Finally you need to select your Background Options. Use the dropdown menu to select one of the background colors. You can also select a background image by directing the dashboard to its web address. A default “Hubitat” logo is included, but you can change or remove this to your liking. These two options are also configurable in the Dashboard Interface, once the dashboard is set up.
    DB7.png
  5. Click “Done” and your first dashboard is installed.

Import/Export Dashboard Layout

At the bottom of the layout options page you will see the option to Import/Export Layout. Click on this tab and you will see the current layout “json” code and a box to paste in new “json” layout code and override your existing layout. Copying the current code, then creating a new dashboard and pasting the code in this box is a fast way to duplicate any dashboard.

WARNING: pasting code into the Import text box could break your dashboard. Make sure you have a copy of your current layout (above) before pasting in a new layout.

DB68.png

Once you have pasted in a different layout, tab out of the box and you will see this:

DB69.png

This means your new layout is now imported. If not, restore your old layout or you might have to start a new dashboard and paste your backup into this.

You can share this layout “json” in the community or with others if you have designed a cool layout. Only your device IDs are stored in the layout, along with any images, links or dashboard IDs. It is pretty safe to share this, but if you want to edit the text, change each device Id to 1.

When importing someone else’s layout, exercise caution and realize you will need to update each tile with your own devices.

Overall, Hubitat™ Dashboard is a very powerful, fast grid-based tile solution. We hope you enjoy using your dashboards. More tile templates are in the works and please provide your feedback in the community thread for dashboard tiles and we can see what we can do to accomodate your needs.


Loading and Editing Your Dashboard

Loading Your Dashboard(s)

  1. In your Dashboard App, you will now see a link to the “Dashboards Menu”. Click on this and a new window/tab will open in your browser. Bookmark this URL / Link for quick access all your dashboards. Each dashboard has a Cloud and Local LAN Link. The Cloud Link allows your dashboard to be viewed from anywhere with internet access. The Local LAN link allows your dashboard to only be accessed on your home network. The Local LAN Dashboard will be faster to load and update. When you are on your local / home network, use this link.
    DB8.png

Customizing Your dashboard

  1. Click on the Local LAN Dashboard link for the dashboard your created. If you had chosen the populate dashboard option at setup the grid would be full of devices you authorized. Otherwise you will see the default empty dashboard.
  2. Tap the three dots in the upper right hand corner to open the dynamic “Side Menu”. Here you can change the Grid Layout Settings, Add, Edit or Remove Tiles.
    DB10.png

Change the Grid Size

  1. Your dashboard is broken up into a Grid. This grid is defined by Rows and Columns. This was set when you created your dashboard but can be changed here in the dashboard. Tap the arrows next to each number to adjust the number of rows/columns. You will notice a real-time preview of expanding or shrinking grid.
    DB12.png
  2. You can change the Background Color, Background Image and change the font size as well. The little “I” icon in the bottom right corner of the side menu has a popup with the code for your layout and devices.
    DB13.png
    DB14.png
  3. Tap Update Grid to save your changes and see them on the dashboard.

Add A Tile

  1. Below the Grid Size Section is the Add Tile section. This will not appear if the grid is already full. You may need to add a row/column or delete a tile to make space.
  2. You can add a tile anywhere in the grid. Use the arrow keys to adjust the row/column you want the tile place. It will default to the first available space from Left to Right, Top to Bottom.
  3. Each tile can also “Span” Rows and Columns, allowing you to create larger tiles then the default 1x1 size. Set this using the arrows.
    DB15.png
  4. Next you will select the Tile Options for this new tile. Use the dropdown to select the device you want repressed. This dropdown list contains all of your authorized devices with initialized attributes. If a new device doesn’t show up here,

remember to update the device in the device view so that a state/attribute is set.

  1. DB16.png
  2. Next you select the template for the device most template match up with a specific device. However, some templates are single attribute focused. Like “battery” or “temperature”. These single attribute templates will just show that attribute of a device (if for example you just want to see the temperature reading of your motion sensor). Other templates are multi attribute capable and can show you more information or give you multiple options for control. For example, the “dimmer” template will give you the option to turn on/off the dimmer but also includes a slider to adjust the dim level.
    • NOTE 1:There are two special “devices” called “Dashboards” and “Modes”. The “Dashboard” device allows you to pick any other dashboard you have configured and it will create a “dashboard” tile that when clicked, will take you to that dashboard. The “Modes” device allows you to create a tile that has the ability to display and select any mode for your location / hub. Both these special “devices” must also be used in conjunction with their corresponding “template” called “dashboard” and “mode”.
    • NOTE 2 The “image” and “link” templates do not require a device. Both of these will ignore the device selection, instead will show another input box that will allow you to paste in a link or a link to any image and that will be displayed in the tile.
    DB17.png


Edit a Tile

Once your tile is added you can edit the location, device type, template and colors.

  1. Open the tile editor by tapping the three dots in the upper righthand corner of the tile.
  2. You can edit the position, size and type just as your did when you added the tile.

Adjust the Template Colors

  1. Tap template colors button near the top of the side menu.
    DB18.png
  2. In the pop-up window, select the template you would like to edit.
    DB20.png
  3. Select the state of the device you would like to edit. Each device state can have a different color palette for quick visual reference.
    DB21.png
  4. The icon color and background color of each template can be edited. Tap on the color you want to change, then use the color wheel and slider to select the color. When you have select the icon and background colors, tap Save Custom Color
    DB22.png
  5. Repeat for any other templates and states you want to change. These settings are saved in your layout.
    • NOTE: If you use the populate all devices in the Layout Section of the Child Dashboard App, you will remove your custom colors. This option can be used to reset your custom colors.

As you can see, this grid layout is very flexible and allows precise placement of your tiles without the need to add spacers, and will not change regardless of the resolution of your device. This is a departure from other dashboard solutions out there, as they flow the tiles based on landscape or portrait modes.

You can create specific layouts for specific screens, devices, etc. In fact. You can even share your layouts with others or use that layout to create other dashboards based on that layout. Even restore your dashboards if something were to go wrong.



Advanced Options

In the Dashboard app there are a handful of options for advanced users to fine-tune their dashboards.

Refresh Rate Here you can specify the refresh rate (in seconds) for your LAN and cloud-connected dashboards. LAN connections are faster so it recommend you set that faster than your cloud-based dashboard links.

Clock AM/FM Toggle this on for your dashboard to display time in AM/FM format (default). Toggle this off to display in 24-hour format.

Security This allows you to create a PIN that will be required for anyone attempting to load the dashboard. Simply enter the PIN of your choice in the blank field. Next, toggle whether you want this PIN to be required for the LAN dashboard and/or the cloud dashboard. When you are finished, click done.


Helpful Hints:

  • Hubitat™ Dashboard has a built in refresh rate of 2 seconds for local lan dashboards and 5 seconds for cloud based links. You can adjust this in the Advanced Section of the Dashboard Child App.
  • The tile sends the command, but doesn’t assume it is changed until after we get a message back that the device state has changed. This can cause a small delay and a loading icon for your cursor and a slight fade out and back in of the tile when command is confirmed.


Device Templates:

Acceleration

This is a single use tile that displays acceleration status of any device with the acceleration attribute.

DB24.png


Attribute

This is a custom tile that will display the text value of any attribute name. Just enter the name below the drop down.

DB25.png
DB26.png


Battery

This is a single use tile that displays the battery status of any device with the battery attribute.

DB27.png


Bulb

This is a multi use tile that displays the current state of the switch and level of a bulb. You can move the slider to change the level.

DB28.png


Button

This is a single use tile that uses a device that has one or more pushable Buttons. Once you choose the button template, you will then be able to enter the number of the button to send the pushed command.

DB29.png


Carbon-dioxide

This is a single use tile that displays the reported carbon dioxide (CO2) levels in parts per million (ppm)

DB30.png


Carbon-monoxide

This is a single use tile that displays if Carbon Monoxide is detected or not. The green cloudy icon indicates the presence of Carbon monoxide as reported by the device.

DB31.png


Clock-date

This is a special tile that displays your local browser time with seconds along with the current date.

DB32.png


Clock

This is a special tile that displays your local browser time with seconds.

DB33.png


Contact

This is a single use tile that displays the contact attribute of a device. Green means open, gray means closed.

DB34.png


Dashboard

This is a special tile that allows you to create a “link” to another dashboard on your current dashboard. This tile is smart enough to know if it is cloud or local based link based on what dashboard link is currently in use.

DB35.png


Dimmer

This is similar to the Bulb tile. Click to turn on/off the Dimmer and the arrow icons to change the level.

DB36.png


Door

This is similar to the Contact tile and indicates if a door is open (green) or closed (gray) to be used with the contact attribute of a device.

DB37.png


Door-control

This is similar to the Contact tile and indicates if a door is open (green) or closed (gray) to be used with the contact attribute of a device. Taping the tile will send the open or closed command after a confirmation dialog box.

DB37.png


Energy

This is a single use tile that displays the energy attribute reported from the device.

DB38.png


Garage

This is a single use tile that displays the contact attribute closed is gray and pointing down, and open is green and pointing up.

DB39.png


Garage-control

This is a single use tile that displays the contact attribute closed is gray and pointing down, and open is green and pointing up.Taping the tile will send the open or closed command after a confirmation dialog box.

DB39.png


Humidity

This is a single use tile that displays the humidity attribute as a percentage.

DB40.png


Illuminance

This is a single use tile that displays the light level in lux from the device.

DB41.png


Image

This is a special tile that allows you to insert a link to any image. This will be refreshed every 5 minutes. Once you choose the image template, a box will display allowing you to add the link.

DB42.jpg


Link

This is a special tile that allows you to create a clickable link to any website that will open up in a new tab. Currently, you can not rename the link. This will be added in a later version.

DB43.png


Lock

This is a multipurpose tile that shows the lock state and battery. Clicking on the lock will lock (green) or unlock (gray) the lock.

DB44.png


Mode

This is a special tile that will allow you to view the current mode and select a new mode for your hub / location.

DB45.png


Momentary

This is a single purpose tile that takes a device with the push attribute but will only send “on” (green) and it will return back to gray after the push command has been sent.

DB46.jpg


Motion

This is a multipurpose tile showing motion detected (green eye) or not (gray) and the values of the temperature sensor and battery level.

DB47.png


Multi

This is a multipurpose tile showing contact sensor open (green) or closed (gray) and the values of the temperature sensor and battery level.

DB48.png


Music-player

This is a multipurpose tile allowing for control of the music player commands, play, pause, previous, next, mute and set volume. It also displays the current track information.

DB49.png


Outlet

This is a single use tile that turns on (green) or off (gray) the device via the switch attribute.

DB50.png


Presence

This is a multipurpose tile that shows the presence (green) or not (gray) of a device and the battery level.

DB51.png


Relay

This is a single use tile that shows the current state of a relay device. On is (green) and off is (gray). Taping the tile will send on/off.

File:DB52.png


Shades

This is a single use tile that shows the current state of a shade device. Open is (green) and closed (gray). Taping the tile will send on/off.

DB53.png


Smoke

This is a single use tile that shows if Smoke is detected by the device. The gray heart means everything is good, and the green “!” means smoke is detected.

DB54.png


Switch

This is a single use tile that shows the current state of a switch, on (green) off (gray) and you can click the tile anywhere to turn the switch on/off.

DB55.png


Temperature

This is a single use tile that shows the current temperature reported by the device assigned to it.

DB56.png


Water

This is a multipurpose tile that shows a water sensor wet (green) or dry (gray) and the reported battery level and temperature

DB57.png


Window

This is a single use tile that shows the open or closed state of a window.

DB58.png