77 lines
2.9 KiB
ReStructuredText
77 lines
2.9 KiB
ReStructuredText
MPU6886 Accelerometer/Gyroscope Sensor
|
|
======================================
|
|
|
|
.. seo::
|
|
:description: Instructions for setting up MPU6886 Accelerometer and Gyroscope sensors.
|
|
:image: mpu6886.jpg
|
|
|
|
The ``mpu6886`` sensor platform allows you to use your MPU6886 Accelerometer/Gyroscope
|
|
(`datasheet <https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/docs/datasheet/core/MPU-6886-000193%2Bv1.1_GHIC_en.pdf>`__,
|
|
`M5Stack`_) sensors with ESPHome. The :ref:`I²C Bus <i2c>` is required to be set up in your configuration for this
|
|
sensor to work.
|
|
|
|
This component only does some basic filtering and no calibration. Due to the complexity of this sensor and the amount
|
|
of possible configuration options, you should probably create an :doc:`external component</components/external_components>`
|
|
by copying and modifying the existing code if you want a specific new feature. Supporting all possible use cases would
|
|
be quite hard.
|
|
|
|
The MPU6886 is built-in in various M5Stack units (e.g., M5Stick C, ATOM Matrix or M5Stack Core2).
|
|
|
|
.. _M5Stack: https://docs.m5stack.com/en/unit/imu
|
|
|
|
.. figure:: images/mpu6886-ui.png
|
|
:align: center
|
|
:width: 80.0%
|
|
|
|
.. code-block:: yaml
|
|
|
|
# Example configuration entry
|
|
sensor:
|
|
- platform: mpu6886
|
|
address: 0x68
|
|
accel_x:
|
|
name: "MPU6886 Accel X"
|
|
accel_y:
|
|
name: "MPU6886 Accel Y"
|
|
accel_z:
|
|
name: "MPU6886 Accel z"
|
|
gyro_x:
|
|
name: "MPU6886 Gyro X"
|
|
gyro_y:
|
|
name: "MPU6886 Gyro Y"
|
|
gyro_z:
|
|
name: "MPU6886 Gyro z"
|
|
temperature:
|
|
name: "MPU6886 Temperature"
|
|
|
|
Configuration variables:
|
|
------------------------
|
|
|
|
- **address** (*Optional*, int): Manually specify the i^2c address of the sensor. Defaults to ``0x68``.
|
|
- **accel_x** (*Optional*): Use the X-Axis of the Accelerometer. All options from
|
|
:ref:`Sensor <config-sensor>`.
|
|
- **accel_y** (*Optional*): Use the Y-Axis of the Accelerometer. All options from
|
|
:ref:`Sensor <config-sensor>`.
|
|
- **accel_z** (*Optional*): Use the Z-Axis of the Accelerometer. All options from
|
|
:ref:`Sensor <config-sensor>`.
|
|
- **gyro_x** (*Optional*): Use the X-Axis of the Gyroscope. All options from
|
|
:ref:`Sensor <config-sensor>`.
|
|
- **gyro_y** (*Optional*): Use the Y-Axis of the Gyroscope. All options from
|
|
:ref:`Sensor <config-sensor>`.
|
|
- **gyro_z** (*Optional*): Use the Z-Axis of the Gyroscope. All options from
|
|
:ref:`Sensor <config-sensor>`.
|
|
- **temperature** (*Optional*): Use the internal temperature of the sensor. All options from
|
|
:ref:`Sensor <config-sensor>`.
|
|
- **update_interval** (*Optional*, :ref:`config-time`): The interval to check the sensor. Defaults to ``60s``.
|
|
|
|
- **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation.
|
|
|
|
See Also
|
|
--------
|
|
|
|
- :ref:`sensor-filters`
|
|
- :doc:`template`
|
|
- :apiref:`mpu6886/mpu6886.h`
|
|
- `i2cdevlib <https://github.com/jrowberg/i2cdevlib>`__ by `Jeff Rowberg <https://github.com/jrowberg>`__
|
|
- :ghedit:`Edit`
|