Описания к новым базовым элементам программы FLProg 9.X.X

[zmeew1966]

Доброе утро форумчане.
Наверное многие хотели бы по подробней
узнать о новом базовом блоке - Универсальный счетчик.
Предоставляю вашему вниманию, краткое описание данного блока.
Возможно у кого то есть дополнительная информация по данному счетчику,
можно ее разместить в данной теме.
Если у автора даных блоков, бутут какие то уточнения и замечания по данному описанию,
с удовольствием ознакомимся и внесем поправки.

[ecoins]

Доброе утро форумчане.
Наверное многие хотели бы по подробней
узнать о новом базовом блоке - Универсальный счетчик.
Предоставляю вашему вниманию, краткое описание данного блока.
Возможно у кого то есть дополнительная информация по данному счетчику,
можно ее разместить в данной теме.
Если у автора данного блока, будут какие то уточнения и замечания по данному описанию,
с удовольствием ознакомимся и внесем поправки.

Мощное начинание и отличное описание! Просто культурной шок! Огромное спасибо!
Разработчик доработал движок форума, в ближайшее время начнут выкладываться видеоролики - в начале общего характера, потом и обучающие. Ведется работа по созданию нового сайта, где документация по FLProg и контроллерам будет выкладываться в структурированном виде.
Еще раз большое спасибо за эту работу.
С уважением, ecoins.

[montirovka]

Спасибо за описание. У простого счетчика выход V - Value значение. А почему здесь выход обозначен V16? Про это нет ни где в описании. Может добавить почему V16?

2025-07-25_11-41-57.png

[ecoins]

Спасибо за описание.У простого счетчика выход V - Value значение. А почему здесь выход обозначен V16?

Постепенно внедряется мнемоника более близкая к C++.
v1 - bool;
v8 - байт, int8_t, uint8_t;
v16 - integer, int16_t, uint16_t;
v32 - long, unsignedLong, int32_t, uint32_t;
С уважением, ecoins.

[Dryundel]

Постепенно внедряется мнемоника более близкая к C++.

А есть смысл? Может быть приблизить к мнемонике Автора? byte, int, long, ulong(если коротко) и это ближе к С++ чем v16, v32...

[zmeew1966]

Спасибо за описание. У простого счетчика выход V - Value значение. А почему здесь выход обозначен V16? Про это нет ни где в описании. Может добавить почему V16?
2025-07-25_11-41-57.png

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

[montirovka]

Спасибо за описание.У простого счетчика выход V - Value значение. А почему здесь выход обозначен V16?

Постепенно внедряется мнемоника более близкая к C++.
v1 - bool;
v8 - байт, int8_t, uint8_t;
v16 - integer, int16_t, uint16_t;
v32 - long, unsignedLong, int32_t, int32_t;
С уважением, ecoins.

На будущее. Нельзя ли в корне каталога блоков (может рядом) сделать закладку с ликбезом? Туда закидывать различные обозначения, что то справочное.
Первая картинка есть.

2025-07-25_11-53-52.png

[zmeew1966]

Спасибо за описание.У простого счетчика выход V - Value значение. А почему здесь выход обозначен V16?

Постепенно внедряется мнемоника более близкая к C++.
v1 - bool;
v8 - байт, int8_t, uint8_t;
v16 - integer, int16_t, uint16_t;
v32 - long, unsignedLong, int32_t, uint32_t;
С уважением, ecoins.

Обозначения входов и выходов в штатных блоках, конечно желательно статдартизировать,
это будет намного упрощать работу в FLProg для конечных пользователей.

[ecoins]

v32 - long, unsignedLong, int32_t, uint32_t;

Постепенно внедряется мнемоника более близкая к C++.

А есть смысл? Может быть приблизить к мнемонике Автора? int, long, ulong(если коротко)

Раньше применялась мнемоника Arduino. Много лет назад она именно некоторый смысл - сейчас он утрачен.
И наоборот, FLProg становится все более независимым от Arduino.
Поэтому разработчик начал постепенно внедрять новую мнемонику.
Там где раньше на входе блока был byte, теперь будет v8.
Относительно стандартизации входов-выходов, предложения назревшее, поддерживаю.
Подход пока в стадии формирования.
Например разработчик размышляет над тем, чтобы возможно будет полезна и переменная unsigned int (uint16_t). Сейчас есть только int.
---------------
И при всем этом все одновременно делать не получается.
Уже писал, разработчик выбрал стратегию приоритета наращивание мощности и возможностей FLProg.
Например сейчас тестируется использования для оформления плат горизонтальных и вертикальных линий - на мой взгляд очень эффектный и эффективный инструмент.
Теперь формат скетча можно будет настраивать через новый инструмент "Настройки форматирования" - на вкус пользователя.
Все инструменты левого меню (Modbus, Web, Отображение) как можно будет отключать как через меню, так и через системные переменные.
Удобно для тестирования.
Проекты на FLProg теперь могут быть сложными и FLprog создает средства для отладки и тестирования.
-------------
Тестировщики ведут баг-трекер, куда по стараются включать ошибки, огрехи, пожелания.
Разработчик по возможности реагирует на них.
Полагаю, что последние несколько релизов ближе к 10-й версии (Разработчик уверенно и достаточно быстро движется в этом направлении) будут посвящены комплексной подчистки огрехов.
--------------
С уважением, ecoins.

[Dryundel]

Там где раньше на входе блока был byte, теперь будет v8.

Странное решение. Ну ок. (моё мнение - byte нагляднее, привычнее и допустим при написании кода на С++)

Например разработчик размышляет над тем, чтобы возможно будет полезна и переменная unsigned int (uint16_t). Сейчас есть только int.

Ну наконец то. Лет пять назад я об этом просил.
Сейчас с новыми контроллерами не очень оно актуально. Но всё равно хорошо.

[montirovka]

Как мне кажется тогда должно быть в описании не - V16 – текущее значение (Int, диапазон: –32 768 … +32 767), а V16 – текущее значение (V16, диапазон: –32 768 … +32 767).

[zmeew1966]

Как мне кажется тогда должно быть в описании не - V16 – текущее значение (Int, диапазон: –32 768 … +32 767), а V16 – текущее значение (V16, диапазон: –32 768 … +32 767).

Исправил описание. В шапке темы добавил описания
на Генератор импульсов и
Генератор событий и меандра.

[Dryundel]

В шапке ткмы добавил описания
на Генератор импульсов и
Генератор событий и меандра.

Такими темпами место в первом посте скоро закончится.
Мои описания тоже от этого страдают. 10 вложений предел для поста.

Может быть администрация рассмотрит увеличение допустимого количества вложений?

[Phazz]

Можно в ответах выкладывать а в шапке ссылки добавлять. Заодно тема поднимается при добавлении материала

[Dryundel]

Можно в ответах выкладывать а в шапке ссылки добавлять. Заодно тема поднимается при добавлении материала

Когда делаешь описание с примерами и скриншотами - не вариант.

[ecoins]

Если у автора даных блоков, будут какие то уточнения и замечания по данному описанию,
с удовольствием ознакомимся и внесем поправки.

ПО ГЕНЕРАТОРУ ИМПУЛЬСОВ.
Большое спасибо за описание.
Полагаю в описании полезно уточнить:
1. Генератор программный. Его точность зависит от проекта. Усредненный период остается достаточно стабильным.
2. Генератор лучше располагать в одной из свободных задач. Если использовать стандартные библиотеки FLProg, то дрейф показаний обычно меньше 2мс. При использовании сенсоров DHT22,ds1820 в цикле приема преобразованных данных дрейф может увеличиться до 5-5мс.
3.Во многих случаях лучшая альтернатива генератору импульсов в режиме меандра являются системные параметры диспетчера задач: блинк 10,25,50,100,250,500,1000мс.
4.После появления диспетчера практическая польза генератора снизилась.
4.Возможно будет полезен код реализации:

► Показать

//=================================================================================================
// 4.1. Генератор импульсов uint16_t ms
// Вход: id-рабочая структура, EN-внешний вход, timeON-время включения в ms, timeOFF-время выключения в ms.
// Выход: возвращаемое значение bool -генерируемый импульс.
//=================================================================================================
uint8_t generatorPulse16(RT_HW_GENERATOR_PULSE_ID &id, uint16_t timeON, uint16_t timeOFF, uint8_t EN=1){
if(id.dir==0) {if(EN) {id.dir=3;} else {return 0;}}
if(id.dir==1) {if(millis()==id.time) {id.time+=timeOFF; id.dir=2; return 0;} else {return 1;}}
if(id.dir==2) {if(millis()>=id.time) {id.dir=3;}}
if(id.dir==3) {if(EN) {id.time=millis()+timeON; id.dir=1; return 1;}
else {id.dir=0; return 0;}}
return 0;};
//=================================================================================================
// 4.2. Генератор импульсов uint32_t ms
// Вход: id-рабочая структура, EN-внешний вход, timeON-время включения в ms, timeOFF-время выключения в ms.
// Выход: возвращаемое значение bool -генерируемый импульс.
//=================================================================================================
uint8_t generatorPulse32(RT_HW_GENERATOR_PULSE_ID &id, uint32_t timeON, uint32_t timeOFF, uint8_t EN=1){
if(id.dir==0) {id.dir=3;}
if(id.dir==1) {if((millis()-id.time)>= timeON) {id.dir=2; return 0;} else {return 1;}}
if(id.dir==2) {if((millis()-id.time)>=(timeON+timeOFF)) {id.dir=3;}}
if(id.dir==3) {if(!EN) {return 0;} id.time=millis();
if(timeON ==0){return 0;}
if(timeOFF==0){return 1;}
id.dir=1; return 1;}
return 0;
};
uint8_t generatorPul32(RT_HW_GENERATOR_PULSE_ID &id, uint32_t timeON, uint32_t timeOFF, uint8_t EN=1){
return generatorPulse32(id, timeON, timeOFF, EN);
};


//=================================================================================================
// 4.3. Генератор импульсов uint32_t mcs
// Вход: id-рабочая структура, timeON-время включения в ms, timeOFF-время выключения в ms.
// Выход: возвращаемое значение bool -генерируемый импульс.
//=================================================================================================
uint8_t generatorPul32mcs(RT_HW_GENERATOR_PULSE_ID &id, uint32_t timeON, uint32_t timeOFF, uint8_t EN=1){ //==Генератор импульсов (v32);
if(id.dir==0) {id.dir=3;}
if(id.dir==1) {if((micros()-id.time)>= timeON) {id.dir=2; return 0;} else {return 1;}}
if(id.dir==2) {if((micros()-id.time)>=(timeON+timeOFF)) {id.dir=3;}}
if(id.dir==3) {if(!EN) {return 0;} id.time=micros();
if(timeON ==0){return 0;}
if(timeOFF==0){return 1;}
id.dir=1; return 1;}
return 0;};

Ещё раз спасибо за описание.
С уважением, ecoins.

[zmeew1966]

Если у автора даных блоков, будут какие то уточнения и замечания по данному описанию,
с удовольствием ознакомимся и внесем поправки.

ПО ГЕНЕРАТОРУ ИМПУЛЬСОВ.
Большое спасибо за описание.
Полагаю в описании полезно уточнить:
1. Генератор программный. Его точность зависит от проекта. Усредненный период остается достаточно стабильным.
2. Генератор лучше располагать в одной из свободных задач. Если использовать стандартные библиотеки FLProg, то дрейф показаний обычно меньше 2мс. При использовании сенсоров DHT22,ds1820 в цикле приема преобразованных данных дрейф может увеличиться до 5-5мс.
3.Во многих случаях лучшая альтернатива генератору импульсов в режиме меандра являются системные параметры диспетчера задач: блинк 10,25,50,100,250,500,1000мс.
4.После появления диспетчера практическая польза генератора снизилась.
4.Возможно будет полезен код реализации:

► Показать

//=================================================================================================
// 4.1. Генератор импульсов uint16_t ms
// Вход: id-рабочая структура, EN-внешний вход, timeON-время включения в ms, timeOFF-время выключения в ms.
// Выход: возвращаемое значение bool -генерируемый импульс.
//=================================================================================================
uint8_t generatorPulse16(RT_HW_GENERATOR_PULSE_ID &id, uint16_t timeON, uint16_t timeOFF, uint8_t EN=1){
if(id.dir==0) {if(EN) {id.dir=3;} else {return 0;}}
if(id.dir==1) {if(millis()==id.time) {id.time+=timeOFF; id.dir=2; return 0;} else {return 1;}}
if(id.dir==2) {if(millis()>=id.time) {id.dir=3;}}
if(id.dir==3) {if(EN) {id.time=millis()+timeON; id.dir=1; return 1;}
else {id.dir=0; return 0;}}
return 0;};
//=================================================================================================
// 4.2. Генератор импульсов uint32_t ms
// Вход: id-рабочая структура, EN-внешний вход, timeON-время включения в ms, timeOFF-время выключения в ms.
// Выход: возвращаемое значение bool -генерируемый импульс.
//=================================================================================================
uint8_t generatorPulse32(RT_HW_GENERATOR_PULSE_ID &id, uint32_t timeON, uint32_t timeOFF, uint8_t EN=1){
if(id.dir==0) {id.dir=3;}
if(id.dir==1) {if((millis()-id.time)>= timeON) {id.dir=2; return 0;} else {return 1;}}
if(id.dir==2) {if((millis()-id.time)>=(timeON+timeOFF)) {id.dir=3;}}
if(id.dir==3) {if(!EN) {return 0;} id.time=millis();
if(timeON ==0){return 0;}
if(timeOFF==0){return 1;}
id.dir=1; return 1;}
return 0;
};
uint8_t generatorPul32(RT_HW_GENERATOR_PULSE_ID &id, uint32_t timeON, uint32_t timeOFF, uint8_t EN=1){
return generatorPulse32(id, timeON, timeOFF, EN);
};


//=================================================================================================
// 4.3. Генератор импульсов uint32_t mcs
// Вход: id-рабочая структура, timeON-время включения в ms, timeOFF-время выключения в ms.
// Выход: возвращаемое значение bool -генерируемый импульс.
//=================================================================================================
uint8_t generatorPul32mcs(RT_HW_GENERATOR_PULSE_ID &id, uint32_t timeON, uint32_t timeOFF, uint8_t EN=1){ //==Генератор импульсов (v32);
if(id.dir==0) {id.dir=3;}
if(id.dir==1) {if((micros()-id.time)>= timeON) {id.dir=2; return 0;} else {return 1;}}
if(id.dir==2) {if((micros()-id.time)>=(timeON+timeOFF)) {id.dir=3;}}
if(id.dir==3) {if(!EN) {return 0;} id.time=micros();
if(timeON ==0){return 0;}
if(timeOFF==0){return 1;}
id.dir=1; return 1;}
return 0;};

Ещё раз спасибо за описание.
С уважением, ecoins.

Дополнил описание на Генератор импульсов.
Добавил описание Генератор PWM.

[ecoins]

Если у автора даных блоков, бутут какие то уточнения и замечания по данному описанию,
с удовольствием ознакомимся и внесем поправки.

ПО ГЕНЕРАТОРУ СОБЫТИЙ И МЕАНДРОВ.
Большое спасибо за описание.
Полагаю в описании полезно уточнить:
1. Термин "Событие" (event) - широко используется в новой версии FLProg.
Обычно событие появляется на выходе на время одного вхождения в блок.
При каждом вхождении в блок оно сбрасывается и далее может быть установлено блоком.
В описании написано, что каждый фронт генерирует событие.
Если посмотреть функцию и исходя из замысла точнее будет что блок генерирует событие которое меняет значение выхода меандр.
В логике функций FLProg событие первично, а от него работают генераторы, счетчики, сенсоры и прочие блоки.
2.Следует использовать "событие" за пределами платы, на котором он получен - неопытные пользователи могут столкнуться с неожиданностями в работе проекта, опытным рекомендую просто этого избегать.
3.Генератор программный. Его точность зависит от проекта. Усредненный период остается достаточно стабильным.
4. Генератор лучше располагать в одной из свободных задач. Если использовать стандартные библиотеки FLProg, то дрейф показаний обычно меньше 2мс. При использовании сенсоров DHT22,ds1820 в цикле приема преобразованных данных дрейф может увеличиться до 5-5мс.
5.Во многих случаях лучшая альтернатива генератору событий и меандров является ДЕЛИТЕЛЬ ИМПУЛЬСОВ (пока не описан. Название по мне не очень удачное - лучше было бы "Делитель событий".) + внешний генератор, который во многих случаях могут заменить один из системных параметров диспетчера задач(блинк 10,25,50,100,250,500,1000мс).

Ещё раз спасибо за описание.
Вы взялись за чрезвычайно важную и полезную работу и вносите вклад в развитие FLProg.
С уважением, ecoins.

[ecoins]

ПО ГЕНЕРАТОРУ ИМПУЛЬСОВ вер.2
Нравится. Очень. Спасибо.
Предложение - можно вместо Блинк лучше использовать Blink?
С уважением, ecoins.

[zmeew1966]

ПО ГЕНЕРАТОРУ ИМПУЛЬСОВ вер.2
Нравится. Очень. Спасибо.
Предложение - можно вместо Блинк лучше использовать Blink?
С уважением, ecoins.

Да, я сейчас поправлю, просто открыл FLProg а там....
поэтому написал так.