jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-23 17:27:19 +00:00
Code Issues Packages Projects Releases Wiki Activity

Adds docs for enabling I2C on Hass.io (#8144)

Browse Source 
* Create enable_i2c.markdown

* Update sensor.bme680.markdown

* Update hassio_navigation.html

* ✏️ Tweaks

* ✏️ Tweaks
This commit is contained in:
ctborg 2019-02-27 04:17:03 -05:00 committed by Franck Nijhof
parent f9198a036d
commit 08fad39c0c
3 changed files with 56 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
source/_components/sensor.bme680.markdown
View File

@ -13,7 +13,6 @@ ha_release: 0.62
ha_iot_class: "Local Push"
---
The `bme680` sensor platform allows you to read temperature, humidity, pressure and gas resistance values of a [Bosch BME680 Environmental sensor](https://cdn-shop.adafruit.com/product-files/3660/BME680.pdf) connected via an [I2C](https://en.wikipedia.org/wiki/I²C) bus (SDA, SCL pins). It allows you to use all the operation modes of the sensor described in its datasheet. In addition, it includes a basic air quality calculation that uses gas resistance and humidity measurements to calculate a percentage based air quality measurement.
Tested devices:
@ -186,6 +185,10 @@ group:
- sensor.bme680_sensor_air_quality
```
## {% linkable_title Directions for enabling I2C interface on Hass.io %}
Follow the instructions here to [enable I2C on Hass.io.](/hassio/enable_i2c/).
## {% linkable_title Directions for installing SMBus support on Raspberry Pi %}
Enable I2C interface with the Raspberry Pi configuration utility:

1
source/_includes/asides/hassio_navigation.html
View File

@ -19,6 +19,7 @@
<li>{% active_link /hassio/zwave/ Z-Wave %}</li>
<li>{% active_link /hassio/external_storage/ External storage %}</li>
<li>{% active_link /hassio/run_local/ Execute local things %}</li>
<li>{% active_link /hassio/enable_i2c/ Enable I2C %}</li>
</ul>
</li>
</ul>

51
source/hassio/enable_i2c.markdown Normal file
View File

@ -0,0 +1,51 @@
---
layout: page
title: "Enable HassOS i2c"
description: "Instructions on how to enable I2C on a Raspberry PI for Hass.io."
date: 2018-01-11 20:08
sidebar: true
comments: false
sharing: true
footer: true
---
Hass.io is a managed environment, which means you can't use existing methods to enable the I2C bus on a Raspberry Pi.
If you're attempting to add an external sensor, you will have to [enable the I2C interface in the Hass.io configuration](https://github.com/home-assistant/hassos/blob/dev/Documentation/boards/raspberrypi.md#i2c) using a USB stick.
## {% linkable_title Step by step instructions %}
You will need:
- USB drive
- A way to add files to the USB drive
- A way to connect the drive to your Raspberry Pi
### {% linkable_title Step 1 - Prepare the USB drive %}
Connect the USB drive to a device capable of adding and editing files to the USB drive.
Format a USB stick with FAT32/EXT4/NTFS and name the drive `CONFIG` (uppercase).
### {% linkable_title Step 2 - Add files to enable I2C %}
- In the root of the USB drive add a folder called `/modules`.
- Inside that folder add a text file called `rpi-i2c.conf` with the following contents:
```
i2c-bcm2708
i2c-dev
```
- In the root of the USB drive add a file called `config.txt` with the following contents:
```
dtparam=i2c1=on
dtparam=i2c_arm=on
```
### {% linkable_title Step 3 - Load the new USB config %}
- Insert the USB drive into your Raspberry PI.
- Now go to your Home Assistant web interface, in the sidebar click **Hass.io** > **System**.
- Now click `Import from USB`.
- This will restart your Hass.io instance, and load the new USB configuration.
When the service has restarted, you will have a working I2C interface.