Skip to content
Draft
Show file tree
Hide file tree
Changes from 4 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions content/components/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -511,6 +511,7 @@ Sensors are organized into categories; if a given sensor fits into more than one
{{< imgtable >}}
"APDS9960","components/sensor/apds9960","apds9960.jpg","Colour & Gesture"
"BMI160","components/sensor/bmi160","bmi160.jpg","Accelerometer & Gyroscope"
"BMI270","components/sensor/bmi270","bmi270.jpg","Accelerometer & Gyroscope"
"LD2410","components/sensor/ld2410","ld2410.jpg","Motion & Presence"
"LD2412","components/sensor/ld2412","ld2412.jpg","Motion & Presence"
"LD2420","components/sensor/ld2420","ld2420.jpg","Motion & Presence"
Expand Down
76 changes: 76 additions & 0 deletions content/components/sensor/bmi270.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,76 @@
---
description: "Instructions for setting up BMI270 Accelerometer and Gyroscope sensors."
title: "BMI270 Accelerometer/Gyroscope Sensor"
params:
seo:
description: Instructions for setting up BMI270 Accelerometer and Gyroscope sensors.
image: bmi270.jpg
---

The `bmi270` sensor platform allows you to use your BMI270 Accelerometer/Gyroscope
([datasheet](https://www.bosch-sensortec.com/media/boschsensortec/downloads/datasheets/bst-bmi270-ds000.pdf)) sensors with ESPHome. The [I²C Bus](/components/i2c) is required to be set up in your configuration for this
sensor to work.

The BMI270 is a low-power 6-axis inertial measurement unit (IMU) from Bosch Sensortec, designed for wearables and other battery-powered applications. It offers improved power efficiency and features compared to its predecessor, the BMI160.

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 [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.

```yaml
# Example configuration entry
sensor:
- platform: bmi270
address: 0x68
update_interval: 60s
acceleration_x:
name: "BMI270 Accel X"
acceleration_y:
name: "BMI270 Accel Y"
acceleration_z:
name: "BMI270 Accel Z"
gyroscope_x:
name: "BMI270 Gyro X"
gyroscope_y:
name: "BMI270 Gyro Y"
gyroscope_z:
name: "BMI270 Gyro Z"
temperature:
name: "BMI270 Temperature"
```

## Configuration variables

- **address** (*Optional*, int): Manually specify the I²C address of the sensor. Defaults to `0x68`, may also be `0x69`.
- **acceleration_x** (*Optional*): Use the X-Axis of the Accelerometer. All options from
[Sensor](/components/sensor).

- **acceleration_y** (*Optional*): Use the Y-Axis of the Accelerometer. All options from
[Sensor](/components/sensor).

- **acceleration_z** (*Optional*): Use the Z-Axis of the Accelerometer. All options from
[Sensor](/components/sensor).

- **gyroscope_x** (*Optional*): Use the X-Axis of the Gyroscope. All options from
[Sensor](/components/sensor).

- **gyroscope_y** (*Optional*): Use the Y-Axis of the Gyroscope. All options from
[Sensor](/components/sensor).

- **gyroscope_z** (*Optional*): Use the Z-Axis of the Gyroscope. All options from
[Sensor](/components/sensor).

- **temperature** (*Optional*): Use the internal temperature of the sensor. All options from
[Sensor](/components/sensor).

- **update_interval** (*Optional*, [Time](/guides/configuration-types#time)): The interval to check the sensor. Defaults to `60s`.

- **id** (*Optional*, [ID](/guides/configuration-types#id)): Manually specify the ID used for code generation.

## See Also

- [Sensor Filters](/components/sensor#sensor-filters)
- [BMI160](/components/sensor/bmi160)
- {{< apiref "bmi270/bmi270.h" "bmi270/bmi270.h" >}}
- [Bosch BMI270 Product Page](https://www.bosch-sensortec.com/products/motion-sensors/imus/bmi270/)
6 changes: 3 additions & 3 deletions content/components/usb_uart.md
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
---
description: "Instructions for setting up a USB Host UART interface on an ESP32 in ESPHome"
title: "USB UART Interface"
title: "USB Host UART Interface"
params:
seo:
description: Instructions for setting up a USB Host UART interface on an ESP32 in ESPHome
image: usb.svg
---

This component allows an ESP32-S3 or ESP32-S2 to connect to USB-serial devices. It uses the {{< docref "/components/usb_host" >}}
component to connect to the device.
This component allows an ESP32-S3 or ESP32-S2 to host USB-serial peripheral devices. It uses the {{< docref "/components/usb_host" >}}
component to interface to the device as a USB-OTG host.

Currently supported devices are listed in the table below:

Expand Down
2 changes: 1 addition & 1 deletion netlify.toml
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@ status = 301
# It is replaced by sed in the makefile when netlify is building the site.
[[redirects]]
from = "/api/*"
to = "{{API_DOCS_URL}}/:splat"
to = "{{HUGOxPARAMSxAPI_DOCS_URL}}/:splat"
status = 301

# Webserver files
Expand Down
Loading