From 7beeee81e7e83bf05b806dbe0e93d9019a94a700 Mon Sep 17 00:00:00 2001 From: Jesse Hills <3060199+jesserockz@users.noreply.github.com> Date: Tue, 18 Nov 2025 07:01:52 +1300 Subject: [PATCH 1/5] Fix API docs url redirect (#5632) --- netlify.toml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/netlify.toml b/netlify.toml index 2574ba6acf..8e49b9aa22 100644 --- a/netlify.toml +++ b/netlify.toml @@ -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 From b79b2a1f797f9d06da9ccda44bfbfe462e270fec Mon Sep 17 00:00:00 2001 From: Tom Keddie Date: Mon, 17 Nov 2025 14:27:39 -0800 Subject: [PATCH 2/5] [usb_uart] Clarify connection type (#5633) --- content/components/usb_uart.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/components/usb_uart.md b/content/components/usb_uart.md index 96d01eb5d8..2d7d953abc 100644 --- a/content/components/usb_uart.md +++ b/content/components/usb_uart.md @@ -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: From 1acd851b0be0ebdfd4638ec0ebcc6e7949c7d6b5 Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 17 Nov 2025 23:21:22 +0000 Subject: [PATCH 3/5] Add BMI270 sensor documentation - Add documentation for BMI270 accelerometer/gyroscope sensor - Include configuration examples and sensor options - Add BMI270 to Motion sensors section in component index - Based on similar BMI160 sensor structure Refs: esphome/esphome#11958 --- content/components/_index.md | 1 + content/components/sensor/bmi270.md | 76 +++++++++++++++++++++++++++++ 2 files changed, 77 insertions(+) create mode 100644 content/components/sensor/bmi270.md diff --git a/content/components/_index.md b/content/components/_index.md index b00c2c89ff..53b26df985 100644 --- a/content/components/_index.md +++ b/content/components/_index.md @@ -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" diff --git a/content/components/sensor/bmi270.md b/content/components/sensor/bmi270.md new file mode 100644 index 0000000000..dbd1ebbdd8 --- /dev/null +++ b/content/components/sensor/bmi270.md @@ -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 {{< docref "/components/external_components" "external component" >}} +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) +- {{< docref "bmi160/" >}} +- {{< apiref "bmi270/bmi270.h" "bmi270/bmi270.h" >}} +- [Bosch BMI270 Product Page](https://www.bosch-sensortec.com/products/motion-sensors/imus/bmi270/) From c42aa2b321ce83c34f1efc21c0d283b22217bdf1 Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 17 Nov 2025 23:28:10 +0000 Subject: [PATCH 4/5] Replace docref shortcodes with standard markdown links --- content/components/sensor/bmi270.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/components/sensor/bmi270.md b/content/components/sensor/bmi270.md index dbd1ebbdd8..e59ca1e808 100644 --- a/content/components/sensor/bmi270.md +++ b/content/components/sensor/bmi270.md @@ -14,7 +14,7 @@ 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 {{< docref "/components/external_components" "external component" >}} +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. @@ -71,6 +71,6 @@ sensor: ## See Also - [Sensor Filters](/components/sensor#sensor-filters) -- {{< docref "bmi160/" >}} +- [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/) From 15f19dce0be7268a63baa98db446fc791b15c6f9 Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 17 Nov 2025 23:37:18 +0000 Subject: [PATCH 5/5] Encourage pull requests instead of external components --- content/components/sensor/bmi270.md | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/content/components/sensor/bmi270.md b/content/components/sensor/bmi270.md index e59ca1e808..dbfb5b23c5 100644 --- a/content/components/sensor/bmi270.md +++ b/content/components/sensor/bmi270.md @@ -13,10 +13,9 @@ 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. +This component only does some basic filtering and no calibration. If you need additional configuration options +or features, please consider adding them to the component and submitting a pull request to help improve ESPHome +for everyone. ```yaml # Example configuration entry