1 В избранное 0 Ответвления 0

OSCHINA-MIRROR/RT-Thread-Mirror-sht3x

Присоединиться к Gitlife
Откройте для себя и примите участие в публичных проектах с открытым исходным кодом с участием более 10 миллионов разработчиков. Приватные репозитории также полностью бесплатны :)
Присоединиться бесплатно
Клонировать/Скачать
api.md 8.9 КБ
Копировать Редактировать Web IDE Исходные данные Просмотреть построчно История
Отправлено 06.03.2025 02:42 c6062e3

API SHT3x

Однократное чтение температуры и влажности

rt_err_t sht3x_read_singleshot(sht3x_device_t dev)
Параметр Описание
dev Указатель на структуру устройства SHT3x
Возврат Описание
RT_EOK Успешное выполнение
-RT_ERROR Неудача

Софт-резет

rt_err_t sht3x_softreset(sht3x_device_t dev)
Параметр Описание
dev Указатель на структуру устройства SHT3x
Возврат Описание
RT_EOK Успешное выполнение
-RT_ERROR Неудача

Сброс состояния регистров

rt_err_t sht3x_clear_status(sht3x_device_t dev)
Параметр Описание
dev Указатель на структуру устройства SHT3x
Возврат Описание
RT_EOK Успешное выполнение
-RT_ERROR Неудача

Чтение состояния регистров

rt_err_t sht3x_read_status(sht3x_device_t dev)

Значения считываемых регистров состояния хранятся в объединении sht3x_status, расположенном внутри структуры устройства SHT3x.| Параметр | Описание | |:--------------------|:-------------------------------------| | dev | Указатель на структуру устройства SHT3x | | Возврат | Описание | | RT_EOK | Успешное выполнение | | RT_ERROR | Неудача |## Включение нагревателя

rt_err_t sht3x_enable_heater(sht3x_device_t dev)
Параметр Описание
dev Указатель на структуру устройства SHT3x
Возврат Описание
RT_EOK Успешное выполнение
-RT_ERROR Неудача

Отключение нагревателя

rt_err_t sht3x_disable_heater(sht3x_device_t dev)
Параметр Описание
dev Указатель на структуру устройства SHT3x
Возврат Описание
RT_EOK Успешное выполнение
-RT_ERROR Неудача

Ускорение времени отклика

rt_err_t sht3x_acc_resp_time(sht3x_device_t dev)
Параметр Описание
dev Указатель на структуру устройства SHT3x
Возврат Описание
RT_EOK Успешное выполнение
-RT_ERROR Неудача

Выход из режима непрерывного чтения

rt_err_t sht3x_break(sht3x_device_t dev)
Параметр Описание
dev Указатель на структуру устройства SHT3x
Возврат Описание
RT_EOK Успешное выполнение
-RT_ERROR Неудача

sht3x_device_t sht3x_init(const char *i2c_bus_name, rt_uint8_t sht3x_addr)

Параметр Описание
i2c_bus_name Название шины I2C
sht3x_addr Адрес I2C устройства SHT3x
Возврат Описание
Адрес устройства SHT3x Указатель на структуру устройства SHT3x
RT_NULL Неудача инициализации, возвращается пустой указатель

Команды MSH для SHT3x

void sht3x(int argc, char *argv[])

  • sht3x probe <i2c_dev_name> <pu/pd> — Подключает устройство SHT3x, требует указания имени шины I2C и способа подключения (вверх/вниз), по умолчанию используется подтяжка вниз.
  • sht3x read — Чтение температуры и влажности с устройства SHT3x.
  • sht3x status — Чтение значения регистра состояния.
  • sht3x reset — Программное сброс устройства SHT3x.
  • sht3x heater <on/off> — Включение/выключение нагревателя.

MSH пример использования:

msh > sht3x
Использование:
        sht3x probe <i2c_устройство> <pu/pd> -- проверка сенсора по имени I2C устройства и конфигурация подтяжек
        sht3x read -- чтение данных сенсора SHT3X
        sht3x status -- регистр состояния SHT3X
        sht3x reset -- отправка команды мягкого сброса SHT3X
        sht3x heater <вкл/выкл> -- включение/отключение нагревателя SHT3X

msh > sht3x probe i2c1
SHT3X проверено, адрес:0x44

msh > sht3x heater вкл
Команда управления нагревателем SHT3X отправлена

Примеры команд

msh > sht3x probe i2c1 pu
SHT3X проверено, адрес:0x44

msh > sht3x read
Температура: 23°C, Влажность: 45%

msh > sht3x status
Значение регистра состояния: 0x00

msh > sht3x reset
Сброс устройства выполнен успешно

msh > sht3x heater off
Нагреватель отключен
```msh >sht3x status
Состояние SHT3X:
        контрольная сумма:       0       - 0 означает корректность контрольной суммы
        команда:                 0       - 0 означает успешное выполнение последней команды
        сброс обнаружен:         0
        ожидающий сигнал тревоги: 0
        тревога температуры:     0
        тревога влажности:       0
        нагреватель включен:      1

msh >sht3x heater off
Команда управления нагревателем SHT3X отправлена

msh >sht3x status
Состояние SHT3X:
        контрольная сумма:       0       - 0 означает корректность контрольной суммы
        команда:                 0       - 0 означает успешное выполнение последней команды
        сброс обнаружен:         0
        ожидающий сигнал тревоги: 0
        тревога температуры:     0
        тревога влажности:       0
        нагреватель включен:      0

msh >sht3x read
Влажность SHT3X: 39.9
Температура SHT3X: 24.5

Опубликовать ( 0 )

Вы можете оставить комментарий после Вход в систему

1
https://api.gitlife.ru/oschina-mirror/RT-Thread-Mirror-sht3x.git
git@api.gitlife.ru:oschina-mirror/RT-Thread-Mirror-sht3x.git
oschina-mirror
RT-Thread-Mirror-sht3x
RT-Thread-Mirror-sht3x
master