From 925fd5de742347c6d1e004b0ad8efafba19f0251 Mon Sep 17 00:00:00 2001 From: ismail Date: Mon, 7 Jul 2025 09:27:28 +0300 Subject: [PATCH] Update descriptions about the inertia timing. Fixes #1027 --- README.md | 2 +- relay_chn/include/relay_chn.h | 3 ++- 2 files changed, 3 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 7e9c78a..5fbb7cd 100644 --- a/README.md +++ b/README.md @@ -15,7 +15,7 @@ An ESP-IDF component for controlling relay channels, specifically designed for d ## Description -Each relay channel consists of 2 output relays controlled by 2 GPIO pins. The component provides APIs to control these relay pairs while ensuring safe operation, particularly for driving bipolar motors. It prevents short-circuits by automatically managing direction changes with configurable inertia timing. +Each relay channel consists of 2 output relays controlled by 2 GPIO pins. The component provides APIs to control these relay pairs while ensuring safe operation, particularly for driving bipolar motors. To prevent mechanical strain on the motor, the component automatically manages direction changes with a configurable inertia delay, protecting it from abrupt reversals. It also provides an optional tilting interface per channel base. Tilting makes a channel move with a specific pattern moving with small steps at a time. Tilting is specifically designed for controlling some types of curtains that need to be adjusted to let enter specific amount of day light. Since it operates on relays, the switching frequency is limited to 10Hz which complies with the most of the general purpose relays' requirements. The minimum frequency is 2Hz and the duty cycle is about 10% in all ranges. diff --git a/relay_chn/include/relay_chn.h b/relay_chn/include/relay_chn.h index 4ac3efe..4f500bf 100644 --- a/relay_chn/include/relay_chn.h +++ b/relay_chn/include/relay_chn.h @@ -14,7 +14,8 @@ * One relay channel consists of 2 output relays, hence 2 GPIO pins are required for each relay channel. * This module provides an API to control the relay channels, specifically to drive bipolar motors. * It also provides APIs to control the direction of the relay channel, bipolar motors in mind. - * The module also automatically manages the direction change inertia to prevent short-circuiting the motor. + * To prevent mechanical strain on the motor, the component automatically manages direction changes + * with a configurable inertia delay, protecting it from abrupt reversals. * The STOP command overrides any other command and clears the pending command if any. * * The module internally uses a custom esp event loop to handle relay commands serially to ensure