mirror of
https://github.com/DarkFlippers/unleashed-firmware
synced 2024-12-18 16:53:45 +00:00
325 lines
12 KiB
C
325 lines
12 KiB
C
/*
|
||
Unitemp - Universal temperature reader
|
||
Copyright (C) 2022 Victor Nikitchuk (https://github.com/quen0n)
|
||
|
||
This program is free software: you can redistribute it and/or modify
|
||
it under the terms of the GNU General Public License as published by
|
||
the Free Software Foundation, either version 3 of the License, or
|
||
(at your option) any later version.
|
||
|
||
This program is distributed in the hope that it will be useful,
|
||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||
GNU General Public License for more details.
|
||
|
||
You should have received a copy of the GNU General Public License
|
||
along with this program. If not, see <https://www.gnu.org/licenses/>.
|
||
*/
|
||
#ifndef UNITEMP_SENSORS
|
||
#define UNITEMP_SENSORS
|
||
#include <furi.h>
|
||
#include <input/input.h>
|
||
|
||
//Маски бит для определения типов возвращаемых значений
|
||
#define UT_TEMPERATURE 0b00000001
|
||
#define UT_HUMIDITY 0b00000010
|
||
#define UT_PRESSURE 0b00000100
|
||
|
||
//Статусы опроса датчика
|
||
typedef enum {
|
||
UT_DATA_TYPE_TEMP = UT_TEMPERATURE,
|
||
UT_DATA_TYPE_TEMP_HUM = UT_TEMPERATURE | UT_HUMIDITY,
|
||
UT_DATA_TYPE_TEMP_PRESS = UT_TEMPERATURE | UT_PRESSURE,
|
||
UT_DATA_TYPE_TEMP_HUM_PRESS = UT_TEMPERATURE | UT_HUMIDITY | UT_PRESSURE,
|
||
} SensorDataType;
|
||
|
||
//Типы возвращаемых данных
|
||
typedef enum {
|
||
UT_SENSORSTATUS_OK, //Всё хорошо, опрос успешен
|
||
UT_SENSORSTATUS_TIMEOUT, //Датчик не отозвался
|
||
UT_SENSORSTATUS_EARLYPOOL, //Опрос раньше положенной задержки
|
||
UT_SENSORSTATUS_BADCRC, //Неверная контрольная сумма
|
||
UT_SENSORSTATUS_ERROR, //Прочие ошибки
|
||
UT_SENSORSTATUS_POLLING, //В датчике происходит преобразование
|
||
UT_SENSORSTATUS_INACTIVE, //Датчик на редактировании или удалён
|
||
|
||
} UnitempStatus;
|
||
|
||
//Порт ввода/вывода Flipper Zero
|
||
typedef struct GPIO {
|
||
const uint8_t num;
|
||
const char* name;
|
||
const GpioPin* pin;
|
||
} GPIO;
|
||
|
||
typedef struct Sensor Sensor;
|
||
|
||
/**
|
||
* @brief Указатель функции выделения памяти и подготовки экземпляра датчика
|
||
*/
|
||
typedef bool(SensorAllocator)(Sensor* sensor, char* args);
|
||
/**
|
||
* @brief Указатель на функцию высвобождении памяти датчика
|
||
*/
|
||
typedef bool(SensorFree)(Sensor* sensor);
|
||
/**
|
||
* @brief Указатель функции инициализации датчика
|
||
*/
|
||
typedef bool(SensorInitializer)(Sensor* sensor);
|
||
/**
|
||
* @brief Указатель функции деинициализации датчика
|
||
*/
|
||
typedef bool(SensorDeinitializer)(Sensor* sensor);
|
||
/**
|
||
* @brief Указатель функции обновления значения датчика
|
||
*/
|
||
typedef UnitempStatus(SensorUpdater)(Sensor* sensor);
|
||
|
||
//Типы подключения датчиков
|
||
typedef struct Interface {
|
||
//Имя интерфейса
|
||
const char* name;
|
||
//Функция выделения памяти интерфейса
|
||
SensorAllocator* allocator;
|
||
//Функция высвыбождения памяти интерфейса
|
||
SensorFree* mem_releaser;
|
||
//Функция обновления значения датчика по интерфейсу
|
||
SensorUpdater* updater;
|
||
} Interface;
|
||
|
||
//Типы датчиков
|
||
typedef struct {
|
||
//Модель датчика
|
||
const char* typename;
|
||
//Полное имя с аналогами
|
||
const char* altname;
|
||
//Тип возвращаемых данных
|
||
SensorDataType datatype;
|
||
//Интерфейс подключения
|
||
const Interface* interface;
|
||
//Интервал опроса датчика
|
||
uint16_t pollingInterval;
|
||
//Функция выделения памяти для датчика
|
||
SensorAllocator* allocator;
|
||
//Функция высвыбождения памяти для датчика
|
||
SensorFree* mem_releaser;
|
||
//Функция инициализации датчика
|
||
SensorInitializer* initializer;
|
||
//Функция деинициализация датчика
|
||
SensorDeinitializer* deinitializer;
|
||
//Функция обновления значения датчка
|
||
SensorUpdater* updater;
|
||
} SensorType;
|
||
|
||
//Датчик
|
||
typedef struct Sensor {
|
||
//Имя датчика
|
||
char* name;
|
||
//Температура
|
||
float temp;
|
||
//Относительная влажность
|
||
float hum;
|
||
//Атмосферное давление
|
||
float pressure;
|
||
//Тип датчика
|
||
const SensorType* type;
|
||
//Статус последнего опроса датчика
|
||
UnitempStatus status;
|
||
//Время последнего опроса датчика
|
||
uint32_t lastPollingTime;
|
||
//Смещение по температуре (x10)
|
||
int8_t temp_offset;
|
||
//Экземпляр датчика
|
||
void* instance;
|
||
} Sensor;
|
||
|
||
extern const Interface SINGLE_WIRE; //Собственный однопроводной протокол датчиков DHTXX и AM23XX
|
||
extern const Interface ONE_WIRE; //Однопроводной протокол Dallas
|
||
extern const Interface I2C; //I2C_2 (PC0, PC1)
|
||
//extern const Interface SPI;
|
||
|
||
/* ============================= Датчик(и) ============================= */
|
||
/**
|
||
* @brief Выделение памяти под датчик
|
||
*
|
||
* @param name Имя датчика
|
||
* @param type Тип датчика
|
||
* @param args Указатель на строку с парамерами датчика
|
||
* @return Указатель на датчик в случае успешного выделения памяти, NULL при ошибке
|
||
*/
|
||
Sensor* unitemp_sensor_alloc(char* name, const SensorType* type, char* args);
|
||
|
||
/**
|
||
* @brief Высвыбождение памяти конкретного датчка
|
||
* @param sensor Указатель на датчик
|
||
*/
|
||
void unitemp_sensor_free(Sensor* sensor);
|
||
|
||
/**
|
||
* @brief Обновление данных указанного датчика
|
||
* @param sensor Указатель на датчик
|
||
* @return Статус опроса датчика
|
||
*/
|
||
UnitempStatus unitemp_sensor_updateData(Sensor* sensor);
|
||
|
||
/**
|
||
* @brief Проверка наличия датчика в памяти
|
||
*
|
||
* @param sensor Указатель на датчик
|
||
* @return Истина если этот датчик уже загружен, ложь если это новый датчик
|
||
*/
|
||
bool unitemp_sensor_isContains(Sensor* sensor);
|
||
|
||
/**
|
||
* @brief Получить датчик из списка по индексу
|
||
*
|
||
* @param index Индекс датчика (0 - unitemp_sensors_getCount())
|
||
* @return Указатель на датчик при успехе, NULL при неудаче
|
||
*/
|
||
Sensor* unitemp_sensor_getActive(uint8_t index);
|
||
|
||
/**
|
||
* @brief Загрузка датчиков с SD-карты
|
||
* @return Истина если загрузка прошла успешно
|
||
*/
|
||
bool unitemp_sensors_load();
|
||
|
||
/**
|
||
* @brief Функция перезагрузки датчиков с SD-карты
|
||
*/
|
||
void unitemp_sensors_reload(void);
|
||
|
||
/**
|
||
* @brief Сохранение датчиков на SD-карту
|
||
* @return Истина если сохранение прошло успешно
|
||
*/
|
||
bool unitemp_sensors_save(void);
|
||
|
||
/**
|
||
* @brief Удаление датчика
|
||
*
|
||
* @param sensor Указатель на датчик
|
||
*/
|
||
void unitemp_sensor_delete(Sensor* sensor);
|
||
|
||
/**
|
||
* @brief Инициализация загруженных датчиков
|
||
* @return Истина если всё прошло успешно
|
||
*/
|
||
bool unitemp_sensors_init(void);
|
||
|
||
/**
|
||
* @brief Деинициализация загруженных датчиков
|
||
* @return Истина если всё прошло успешно
|
||
*/
|
||
bool unitemp_sensors_deInit(void);
|
||
|
||
/**
|
||
* @brief Высвыбождение памяти всех датчиков
|
||
*/
|
||
void unitemp_sensors_free(void);
|
||
|
||
/**
|
||
* @brief Обновить данные всех датчиков
|
||
*/
|
||
void unitemp_sensors_updateValues(void);
|
||
|
||
/**
|
||
* @brief Получить количество загруженных датчиков
|
||
* @return Количество датчиков
|
||
*/
|
||
uint8_t unitemp_sensors_getCount(void);
|
||
|
||
/**
|
||
* @brief Добавить датчик в общий список
|
||
* @param sensor Указатель на датчик
|
||
*/
|
||
void unitemp_sensors_add(Sensor* sensor);
|
||
|
||
/**
|
||
* @brief Получить списк доступных типов датчиков
|
||
* @return Указатель на список датчиков
|
||
*/
|
||
const SensorType** unitemp_sensors_getTypes(void);
|
||
|
||
/**
|
||
* @brief Получить количество доступных типов датчиков
|
||
* @return Количество доступных типов датчиков
|
||
*/
|
||
uint8_t unitemp_sensors_getTypesCount(void);
|
||
|
||
/**
|
||
* @brief Получить тип сенсора по его индексу
|
||
* @param index Индекс типа датчика (от 0 до SENSOR_TYPES_COUNT)
|
||
* @return const SensorType*
|
||
*/
|
||
const SensorType* unitemp_sensors_getTypeFromInt(uint8_t index);
|
||
|
||
/**
|
||
* @brief Преобразовать строчное название датчка в указатель
|
||
*
|
||
* @param str Имя датчика в виде строки
|
||
* @return Указатель на тип датчика при успехе, иначе NULL
|
||
*/
|
||
const SensorType* unitemp_sensors_getTypeFromStr(char* str);
|
||
|
||
/**
|
||
* @brief Получить количество активных датчиков
|
||
*
|
||
* @return Количество активных датчиков
|
||
*/
|
||
uint8_t unitemp_sensors_getActiveCount(void);
|
||
|
||
/* ============================= GPIO ============================= */
|
||
/**
|
||
* @brief Конвертация номера порта на корпусе FZ в GPIO
|
||
* @param name Номер порта на корпусе FZ
|
||
* @return Указатель на GPIO при успехе, NULL при ошибке
|
||
*/
|
||
const GPIO* unitemp_gpio_getFromInt(uint8_t name);
|
||
/**
|
||
* @brief Конвертация GPIO в номер на корпусе FZ
|
||
* @param gpio Указатель на порт
|
||
* @return Номер порта на корпусе FZ
|
||
*/
|
||
uint8_t unitemp_gpio_toInt(const GPIO* gpio);
|
||
|
||
/**
|
||
* @brief Блокировка GPIO указанным интерфейсом
|
||
* @param gpio Указатель на порт
|
||
* @param interface Указатель на интерфейс, которым порт будет занят
|
||
*/
|
||
void unitemp_gpio_lock(const GPIO* gpio, const Interface* interface);
|
||
|
||
/**
|
||
* @brief Разблокировка порта
|
||
* @param gpio Указатель на порт
|
||
*/
|
||
void unitemp_gpio_unlock(const GPIO* gpio);
|
||
/**
|
||
* @brief Получить количество доступных портов для указанного интерфейса
|
||
* @param interface Указатель на интерфейс
|
||
* @return Количество доступных портов
|
||
*/
|
||
uint8_t unitemp_gpio_getAviablePortsCount(const Interface* interface, const GPIO* extraport);
|
||
/**
|
||
* @brief Получить указатель на доступный для интерфейса порт по индексу
|
||
* @param interface Указатель на интерфейс
|
||
* @param index Номер порта (от 0 до unitemp_gpio_getAviablePortsCount())
|
||
* @param extraport Указатель на дополнительный порт, который будет принудительно считаться доступным. Можно указать NULL если не требуется
|
||
* @return Указатель на доступный порт
|
||
*/
|
||
const GPIO*
|
||
unitemp_gpio_getAviablePort(const Interface* interface, uint8_t index, const GPIO* extraport);
|
||
|
||
/* Датчики */
|
||
//DHTxx и их производные
|
||
#include "./interfaces/SingleWireSensor.h"
|
||
//DS18x2x
|
||
#include "./interfaces/OneWireSensor.h"
|
||
#include "./sensors/LM75.h"
|
||
//BMP280, BME280
|
||
#include "./sensors/BMx280.h"
|
||
#include "./sensors/AM2320.h"
|
||
#include "./sensors/DHT20.h"
|
||
#endif
|