From 3402381c55335f66cf24a2946fe9a4b3871142eb Mon Sep 17 00:00:00 2001 From: Coal56AB Date: Mon, 3 Mar 2025 18:49:43 +0300 Subject: [PATCH] =?UTF-8?q?=D0=97=D0=B0=D0=B3=D0=BE=D1=82=D0=BE=D0=B2?= =?UTF-8?q?=D0=BA=D0=B0=20=D0=B4=D0=BB=D1=8F=20readme?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 141 +++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 139 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 45b82ef..921c2c8 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,139 @@ -# PY32F002B Scan Dallas + Modbus Module -Прога для PY32F002B которая будет считывать датчики температуры, сохранять в модбас и выдавать если надо будет \ No newline at end of file +# PY32F002B ScanDallas+Modbus Module +Прога для PY32F002B которая будет считывать датчики температуры, сохранять в модбас регистры. +Конверсия идет непрерывно и после каждой конверсии считываются все датчики и записываются в модбас регистры. + +## Управление модулем +**Температура:** Для считывания температуры необходимо считать холдинг регистры №0-29. + +**Параметры датчика:** Для считывания параметров конкретного датчика надо выставить регистр Location (№0) датчика или его ROM, и после выставить коил ReadSensor (№1). После считать параметры полученные параметры в инпут регистрах №30-36 + +**Инициализация датчика:** Для инициализации датчика надо выставить регистр Location (№0), где находится датчик и его ROM, и после выставить коил InitSensor (№2). После в UserByte выбранного по ROM датчика записывается его локация. + +**Деинициализация датчика:** Для деинициализации датчика надо выставить регистр Location (№0), где находится датчик, и после выставить коил DenitSensor (№3). После в UserByte выбранного по ROM датчика записывается его локация. И + + +## Структура данных +Управлять работой модуля можно по коилам и регистрам +- 0: `RunConvertions` - запуск преобразований датчика +- 1: `ReadSensor` - считать параметры датчика по холдинг регистрам +- 2: `InitSensor` - инициализация датчика по холдинг регистрам +- 3: `DenitSensor` - деинициализировать датчик по холдинг регистрам + +Холдинг регистры используются для передачи параметров датчика и для инициализации/деинициализации. +- 0: `Location` - локация датчика +- 1-4: `ROM` - ROM датчика +- 5: `Resolution` - разрешение датчика +- 6: `Enable` - считывать напряжение с этого датчика или нет + +Инпут регистры используются для передачи температуры и параметров датчика +Температура храниться в первых 30 инпут регистрах +- 0-29: `SensTemperature` - температура n-го датчика в [***Цельсий x 100***] +Параметры храняться в рестрах N+1. Хранятся параметры последнего датчика к которому было совершнео обращение (коилы №1-3) +- 30: `Location` - локация датчика, к которому было совершено обращение +- 31-34: `ROM` - ROM датчика, к которому было совершено обращение +- 35: `Resolution` - разрешение датчика, к которому было совершено обращение +- 36: `Enable` - включен датчик или нет + + +## Флаги модуля +- 16: `ConvertionDone` - флаг окончания конверсии. Сбрасывается после считывания температуры из регистров +- 17: `LostedSensors` - флаг есть ли потерянные сенсоры. Сбрасывается по модбас + +## Настройка датчиков +Тайминги выставляются в holding регистрах №0-4: + - 0: `TimeForForward` - время на которое диод включается в прямом направлении (мс или мкс) + - 1: `TimeForReverse` - время на которое диод включается в обратном направлении (мс или мкс) + - 2: `TimeBeforeTest` - время которое выжидается перед началом тестирования (мс или мкс) + - 3: `TimeDeadtime` - время между переключениями фаз (мс или мкс) + - 4: `TimeBeforePeak` - время между включением АЦП и подключением обратного напряжения (мс или мкс) + +В коилах №16-19, можно выставить флаги - включить миллисекундную задержку вместо микросекундной для соответствующего тайминга: + - 16: `msTimeForForward_enable` + - 17: `msTimeForReverse_enable` + - 18: `msTimeBeforeTest_enable` + - 19: `msTimeDeadtime_enable` + - 20: `msTimeBeforePeak_enable` + +## Настройка АЦП +Настройки АЦП выставляются в holding регистрах №5-9: + - 5: `Adc_PulseWidth` - ожидаемая длительность импульса в отчетах ацп. +На основе этого параметра берется выборка по которой расчитывается среднее значение пик (пик +-Adc_PulseWidth/2) + - 6: `Adc_PulseSign` - полярность скачка напряжения при обратном включении + - 7: `Adc_CalibrValue` - калибровочное значение ацп + - 8: `Adc_ZeroValue` - нулевое значение ацп + - 9: `Adc_U_Calibr` - калибровочное напряжение ацп + +Из этого рассчитывается шаг АЦП: `Adc_U_Calibr/(Adc_CalibrValue - Adc_ZeroValue)` + + +# Тестирование +## Тест в прямом подключении (`TESTER_TestDiode_Forward`) +- ожидается задержка, перед началом работы `ticks_before_test` +- включается АЦП в континуес режиме +- диод подключается в прямом направлении на заданное время `ticks_for_forward`. +- считывается АЦП и накапливаются заданное количество для расчета среднего. и так по кругу пока диод подключен +- после таймаута отключается напряжение и останавливается АЦП + +По итогу сохраняется напряжение прямого включения диода `htest->DiodeForwardVolt`. + +## Тест в обратном подключении (`TESTER_TestDiode_Reverse`) +- ожидается задержка, перед началом работы `ticks_before_test` +- включается АЦП в дма режиме +- ожидается задержка, перед предполагаемым скачком `ticks_before_peak` +- диод подключается в обратном направлении на заданное время `ticks_for_reverse`, и отключается +- после дожидается окончание заполнения буфера ДМА и обрабатывается: находится минимальный/максимальный пик и среднее напряжение в том районе + +По итогу сохраняется скачок напряжение при обратном включении диода `htest->DiodeReversePeakVolt`. + +## Тест перехода из прямого подключении в обратное (`TESTER_TestDiode_SwitchConnection`) +- ожидается задержка, перед началом работы `ticks_before_test` +- диод подключается в прямом направлении на заданное время `ticks_for_forward` +- после истечения задержки сохраняется прямое напражение на диоде +- диод отключается от питания и выжидается мертвое время `ticks_deadtime` +- включается АЦП в дма режиме +- ожидается задержка, перед предполагаемым скачком `ticks_before_peak` +- диод подключается в обратном направлении на заданное время `ticks_for_reverse` +- дожидается окончание заполнения буфера ДМА и обрабатывается: находится минимальный/максимальный пик и среднее напряжение в том районе + +По итогу сохраняется напряжение прямого включения диода `htest->DiodeForwardVolt` и скачок при обратном `htest->DiodeReversePeakVolt`. + + + +# Внутренняя настройка +В начале программы в регистрах модбас выставляются дефолтные настройки из tester_config.h (`TESTER_Set_Default_Settings`) +После эти настройки подтягиваются в структуры тестера, через отдельную функцию (`TESTER_UpdateSettings`). Она вызывается перед каждым тестом. +## tester_config.h +Содержит дефолтные настройки для таймингов (`TESTER_SW_TIMINGS_CONFIG`): +- количество тиков и дефайн для включения миллисекундной разных задержек. + +для светодиода и кнопки (`TESTER_INTERFACE_CONFIG`): +- состояния пина для включения и выключения светодиода +- порт и пин светодиода +- частоты моргания для разных режимов работы +- состояния пина при нажатой и отжатой кнопки +- порт и пин кнопки +- задержка для выжидания дребезга + +для управления ключами (`TESTER_PHASE_SW_CONFIG`): +- `USE_HAL_GPIO_FUNCTIONS` - использовать HAL_GPIO-функции. Без неё переключается быстрее +- `RECONNECT_WITHOUT_DEADTIME` - отключить дедтайм при переключении. Если отключить еще и USE_HAL_GPIO_FUNCTIONS, то переключатся фазы будут почти синхронно (быстрее десятков мкс). Хз надо ли такое, но возможность есть +- порт и пины для двух ключей обратного подключения диода (порт общий для двух ключей) +- порт и пины для двух ключей обратного подключения диода (порт общий для двух ключей) + +для АЦП (`TESTER_ADC_CONFIG`): +- размер dma буффера (`ADC_BUFF_SIZE, ADC_DMA_BUFF_SIZE`) +- калибровочное напряжение АЦП (`ADC_U_CALIBR`) +- значение АЦП при калибровочном напряжении (`ADC_VALUE_CALIBR`) +- значение АЦП при нулевом напряжении (`ADC_VALUE_ZERO`) +- таймаут на чтение АЦП (`ADC_READ_TIMEOUT_MS`) +- ожидаемая длина импульса в отсчетах АЦП (`TESTER_ADC_PULES_EXPETCED_WIDTH`) +Из этого рассчитывается шаг АЦП: `Adc_U_Calibr/(Adc_CalibrValue - Adc_ZeroValue)` + +## Структуры для настроек +Настройки для таймингов записываются в структуру `SwTimings`, которая находится в `htest`/`hTestDiode (глобально)`, а она уже в главной структуре проекта `TESTER`. + +Настройки светодиода и кнопки записываются в структуры `leds.LED1` и `SwStart`. Они находятся в структуре проекта `TESTER` + +Настройки для портов и пинов ключей записываются в структуры `SwPhaseForward` и `SwPhaseReverse`, которые находится в `htest`/`hTestDiode (глобально)`, а она уже в главной структуре проекта `TESTER`. + +Настройки для АЦП записыватся в структуру `TESTER.htest->adc->chAdc.s` (`ADC_ParamsTypeDef`). \ No newline at end of file