Hassbian 1.1 Toy-box. Blog post and updates to getting-started-image (#1957)

* Update installation-raspberry-pi-image.markdown

Update to reflect changes done in the new base-image and included hassbian-scripts.

* Create 2017-02-03-hassbian-toybox.markdown

Release blogpost.

* Update installation-raspberry-pi-image.markdown

Added more information about the hassbian-scripts.

* Update 2017-02-03-hassbian-toybox.markdown

Add in @arsaboo 's suggestions. Thanks 🍪

* Update 2017-02-03-hassbian-toybox.markdown

Fix typos and standardized use of terms.
Thanks @fabaff for the feedback.

* Update installation-raspberry-pi-image.markdown

Fix typos and standardized use of terms.
This commit is contained in:
Fredrik Lindqvist 2017-02-04 20:02:39 +01:00 committed by Fabian Affolter
parent b5de2d5471
commit 095bbebd20
2 changed files with 80 additions and 13 deletions

View File

@ -0,0 +1,62 @@
---
layout: post
title: "HASSbian 1.1 - The Toy-box"
description: "New release of the HASSbian Raspberry Pi Image for Home Assistant"
date: 2017-02-04 05:00:00 -0400
date_formatted: "February 4, 2017"
author: Fredrik Lindqvist
comments: true
categories: Technology
---
Tonight I'm happy to announce a new release of the our Raspberry Pi image, **HASSbian 1.1 - The Toy-box.**
Why Toy-box you wonder? Because it encompass the changes pretty well.
Changes from previous image are big and small but lets start with the interesting things.
### {% linkable_title Hassbian-scripts %}
A set of script written to add extra functionality to your Raspberry Pi installation.
This scripts are run as the `pi` user and installs a set of tools or packages.
Currently includes:
- Install Libcec. Adds local [HDMI CEC support][cec].
- Install Mossquitto. Installs the latest Mosquitto package and client tools from the Mosquitto projects official repository. Now includes websocket support.
- Install OpenZWave. Installs OpenZWave and prepares for using a USB or GPIO ZWave controller.
- Install Samba. Installs the Samba packages and shares your configuration over smb to be available to edit on any computer without the need for separate file transfer software. This share is unsecured and it's usage is not recommended if your installation is publicly available.
All of these scripts are available in the directory `/home/pi/hassbian-scripts/`. This directory is actually a cloned git repository that's cloned on first boot and can be updated to the latest release with ease after.
To update the hassbian-scripts directory execute the following command as the `pi` user.
```bash
$ cd hassbian-scripts
$ git pull
```
To use any of the hassbian-scripts, execute the following command as the `pi` user. Here we use the libcec script as an example.
```bash
$ sudo ./hassbian-scripts/install_libcec.sh
```
For more information about these scripts have a look a the [hassbian-scripts repository][hassbian-repo].
### {% linkable_title Spring cleaning %}
With this image there also quite a bit of cleaning of the base system and the script that generates our Raspberry Pi image.
- Update pi-gen. Our build script has been upgraded to follow the Raspbian image closer. This image is basically a Raspbian lite image with Home Assistant, dependencies and a small set of changes to the base system.
- Removed Mosquitto. Not as bad as it sounds since it's installation has been move to one of our new hassbian-scripts.
- Added rng-tools. Let's your HASSbian installation use the hardware support in the Raspberry Pi for entropy generation.
- Added avahi-daemon package. Your Raspberry Pi should now be available at [hassbian.local][hassbian-avahi].
- Added htop. User friendly interactive process monitor.
- Added tmux. A great terminal multiplexer that makes working with the command line over ssh.
- Added the `homeassistant` user to the `dialout` group. Simplifies use of hardware such as ZWave USB controllers that requires this permission.
### {% linkable_title On the horizon %}
There's of course more on the horizon and there's even more plans and wishes for how this image will function in the future.
On the close horizon from [@Landrash][landrash-github] there a few more script in the works and for tellstick, emulated_hue and for controlling Home Assistant.
To follow discussions about the development of the HASSbian image or to contribute join the [HASSbian gitter chat][hassbian-gitter].
To get started with the new image, check out the installation instructions in the [getting started section][gs-image].
[cec]: /components/hdmi_cec/
[hassbian-repo]: https://github.com/home-assistant/hassbian-scripts
[hassbian-avahi]: hassbian.local
[hassbian-gitter]: https://gitter.im/home-assistant/hassbian
[landarsh-github]: https://github.com/Landrash
[gs-image]: /getting-started/installation-raspberry-pi-image/

View File

@ -9,7 +9,7 @@ sharing: true
footer: true
---
The easiest way to install Home Assistant on your Raspberry Pi is by using HASSbian: a Raspberry Pi image with Home Assistant built-in. The image will install the latest version of Home Assistant on initial boot (~5 minutes).
The easiest way to install Home Assistant on your Raspberry Pi is by using HASSbian: a Raspberry Pi image with Home Assistant built-in. The image will install the latest version of Home Assistant on initial boot (~10 minutes).
1. [Download the latest image][image-download]
2. Flash the image to an SD card:
@ -26,13 +26,25 @@ Home Assistant will now be available by navigating with a browser to `http://ip-
The following extras are included on the image:
- GPIO pins are ready to use.
- Mosquitto MQTT broker is installed (not activated by default).
- Bluetooth is ready to use (supported models only, no Bluetooth LE).
- Hassbian-scripts. A set of script written to add extra functionality to your Raspberry Pi installation.
Currently includes:
- Install Libcec. Adds local [HDMI CEC support][cec].
- Install Mossquitto. Installs the latest Mosquitto package and client tools from the Mosquitto projects offical repository. Now includes websocket support.
- Install OpenZWave. Installs OpenZWave and prepares for using a USB or GPIO ZWave controller.
- Install Samba. Installs the Samba packages and shares you configuration over smb to be available to edit on any computer without the need for separate file transfer software. This share is unsecured and it's usage is not recommended if your installation is publicly available.
All of these scripts are available in the directory `/home/pi/hassbian-scripts/`. This directory is actually a cloned git repository that's clone on first boot and can be updated to the latest release with ease after.
To update the hassbian-scripts directory execute the following command as the `pi` user.
```bash
$ cd hassbian-scripts
$ git pull
```
For more information about these scripts have a look at the [hassbian-scripts repository][hassbian-repo].
Some extra tips:
- Check out the list of [Raspberry Pi hardware specific components][pi-components].
- Z-Wave support can be installed by following the [Getting started instructions for Z-Wave][install-zwave].
- Run `sudo raspi-config` to change the locale, timezone and keyboard layout.
### {% linkable_title Technical Details %}
@ -160,14 +172,6 @@ $ sudo apt-get upgrade
Press `Y` to confirm that you would like to continue.
### {% linkable_title USB device permissions %}
When using some USB devices users have to give dialout permission to the user `homeassistant` and restart.
```shell
$ sudo usermod -a -G dialout homeassistant
$ sudo reboot
```
### {% linkable_title Troubleshooting %}
If you run into any issues, please see [the troubleshooting page](/getting-started/troubleshooting/). It contains solutions to many of the more commonly encountered issues.
@ -179,14 +183,15 @@ In addition to this site, check out these sources for additional help:
- [GitHub Page](https://github.com/home-assistant/home-assistant/issues) for issue reporting.
### [Next step: Configuring Home Assistant »](/getting-started/configuration/)
[image-download]: https://github.com/home-assistant/pi-gen/releases
[flash-linux]: https://www.raspberrypi.org/documentation/installation/installing-images/linux.md
[flash-macos]: https://www.raspberrypi.org/documentation/installation/installing-images/mac.md
[flash-windows]: https://www.raspberrypi.org/documentation/installation/installing-images/windows.md
[cec]: /components/hdmi_cec/
[pi-components]: /getting-started/installation-raspberry-pi/#raspberry-pi-hardware-specific-components
[hassbian-repo]: https://github.com/home-assistant/hassbian-scripts
[ssh-putty]: http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html
[stop-homeassistant]: /getting-started/installation-raspberry-pi-image/#startstoprestart-home-assistant-on-hassbian
[configuring-homeassistant]: /getting-started/configuration/
[bash-windows]: https://msdn.microsoft.com/en-us/commandline/wsl/about
[install-zwave]: /getting-started/z-wave/