mcu_matlab/McuLib/m/periphConfig.m
2025-06-19 13:29:33 +03:00

698 lines
30 KiB
Matlab
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

classdef periphConfig
methods(Static)
function updateMask(blockPath, config)
% blockPath = [blockPath '/MCU'];
% Проверяем, была ли маска открыта
% wasOpen = isMaskDialogOpen(blockPath);
mask = Simulink.Mask.get(blockPath);
tableNames = {'incTable', 'srcTable'};
columns_backup = customtable.save_all_tables(tableNames);
try
rowWidth = str2double(get_param(blockPath, 'rowWidth'));
containerName = 'configTabAll';
periphConfig.clear_all_from_container(mask, containerName);
% Ищем контейнер, в который будем добавлять вкладки
container = mask.getDialogControl(containerName);
if isempty(container)
error('Контейнер "%s" не найден в маске.', containerName);
end
if ~isempty(config)
% Проходим по каждому модулю (ADC, TIM...)
periphs = fieldnames(config);
for i = 1:numel(periphs)
periph = periphs{i};
% Сохраняем код, если он есть
periphConfig.store_single_periph_code(mask, periph, config.(periph));
% Проверяем наличие Defines
if ~isfield(config.(periph), 'Defines')
continue;
end
defines = config.(periph).Defines;
defNames = fieldnames(defines);
% Создаём вкладку для модуля
tabCtrl = container.addDialogControl('tab', periph);
tabCtrl.Prompt = [periph ' Config'];
rowCountMap = containers.Map();
for j = 1:numel(defNames)
defPrompt = defNames{j};
def = defines.(defPrompt);
% Вызов функции добавления одного параметра
periphConfig.addConfig(mask, containerName, periph, defPrompt, def, rowCountMap, rowWidth);
end
end
end
periphConfig.create_all_code_storage_params(blockPath, config);
% periphConfig.cleanup_obsolete_code_params(blockPath, config);
periphConfig.update();
% Восстанавлиperiph = allTabNamesваем таблицы
customtable.restore_all_tables(tableNames, columns_backup);
catch
% Восстанавливаем таблицы
customtable.restore_all_tables(tableNames, columns_backup);
end
% % Повторно открываем маску, если она была открыта
% if wasOpen
% open_system(blockPath, 'mask');
% end
end
function update()
blockPath = gcb;
mask = Simulink.Mask.get(blockPath);
config = configJs.read(blockPath);
containerName = 'configTabAll';
container = mask.getDialogControl(containerName);
paramsAll = mcuMask.collect_all_parameters(container);
% Получаем все имена в кладок из container (у вас должен быть container)
allTabs = container.DialogControls;
allTabNames = arrayfun(@(t) t.Name, allTabs, 'UniformOutput', false);
fieldsConfig = fieldnames(config);
% Цикл по всем вкладкам в контейнере
for i = 1:length(allTabNames)
periph = fieldsConfig{i};
% Попытка найти параметр чекбокса Tab_<Periph>_Enable
checkboxName = ['Tab_' periph '_Enable'];
if ismember(checkboxName, paramsAll)
% Чекбокс есть - проверяем его состояние
paramObj = mask.getParameter(checkboxName);
val = paramObj.Value;
try
tab = container.getDialogControl(periph);
if strcmpi(val, 'off')
tab.Enabled = 'off';
% Рекурсивно очищаем связанные скрытые параметры
periphConfig.clear_tab_params(mask, config.(periph), periph);
else
tab.Enabled = 'on';
periphConfig.sync_tab_params(mask, config.(periph), periph);
end
catch
warning('Вкладка с именем "%s" не найдена.', periph);
end
else
% Чекбокса нет — просто пытаемся включить вкладку, если она есть
try
tab = container.getDialogControl(periph);
tab.Enabled = 'on';
% Опционально можно синхронизировать параметры, если есть config поле
if isfield(config, periph)
periphConfig.sync_tab_params(mask, config.(periph), periph);
end
catch
% Можно не выводить предупреждение — вкладка может быть необязательной
% warning('Вкладка с именем "%s" не найдена.', periph);
end
end
end
end
function periphParamCallback(paramName)
blockPath = gcb;
mask = Simulink.Mask.get(blockPath);
hObj = mask.getParameter(paramName);
config = configJs.read(blockPath);
container = mask.getDialogControl('configTabAll');
% === Проверка на Tab_<Periph>_Enable ===
exprTab = '^Tab_(\w+)_Enable$';
tokensTab = regexp(paramName, exprTab, 'tokens');
if ~isempty(tokensTab)
periph = tokensTab{1}{1};
try
tab = container.getDialogControl(periph);
paramVal = hObj.Value;
if strcmpi(paramVal, 'off')
tab.Enabled = 'off';
if isfield(config, periph)
periphConfig.clear_tab_params(mask, config.(periph), periph);
end
else
tab.Enabled = 'on';
if isfield(config, periph)
periphConfig.sync_tab_params(mask, config.(periph), periph);
end
end
catch
warning('Ошибка обработки вкладки "%s".', periph);
end
return;
end
% === Проверка на параметр, связанный с Sources/Includes ===
% Проверка: это параметр, у которого есть соответствующий Hidden_<Name>_Sources или Hidden_<Name>_Includes
nameBase = paramName;
paramNames = string({mask.Parameters.Name});
hasSources = any(paramNames == "Hidden_" + nameBase + "_Sources");
hasIncludes = any(paramNames == "Hidden_" + nameBase + "_Includes");
if hasSources || hasIncludes
useVal = hObj.Value;
% Получаем содержимое config по nameBase — возможно, вложенное
try
valueStruct = configJs.get_field(config, nameBase);
catch
warning('Не удалось найти путь %s в config.', nameBase);
return;
end
if strcmpi(useVal, 'on')
try
periphConfig.store_single_periph_code(mask, nameBase, valueStruct);
catch
warning('Не удалось сохранить параметры для %s.', nameBase);
end
else
periphConfig.clear_single_periph_code_param(mask, nameBase);
end
return;
end
% === Если не подошло ни под одно из условий ===
% warning('Объект "%s" не поддерживается универсальным коллбеком.', paramName);
end
function updatePeriphRunMexBat()
% Запись run_mex.bat
blockPath = gcb;
CodeStruct = periphConfig.restore_periph_code_from_mask(blockPath);
periphPath = mcuPath.get('periphPath');
[periphPath, ~, ~] = fileparts(periphPath);
periphConfig.addCodeBat(CodeStruct, periphPath);
end
end
methods(Static, Access=private)
function addHiddenParam(mask, containerName, nameBase, kind, existingParams)
% Преобразуем к красивому имени
prettyName = strrep(nameBase, '_', ' ');
paramName = ['Hidden_' char(nameBase) '_' kind];
if ismember(paramName, existingParams)
return;
end
mask.addParameter( ...
'Name', paramName, ...
'Type', 'edit', ...
'Prompt', ['Hidden ' prettyName ' ' kind], ...
'Value', '', ...
'Visible', 'off', ...
'Container', containerName ...
);
fprintf('Создан скрытый параметр: %s\n', paramName);
end
function clear_tab_params(mask, configStruct, prefix, depth)
if nargin < 4
depth = 0;
end
maxDepth = 3; % Максимальная глубина рекурсии
fields = fieldnames(configStruct);
for i = 1:numel(fields)
key = fields{i};
value = configStruct.(key);
paramName = [prefix '_' key];
if isstruct(value)
if depth < maxDepth
% Рекурсивный вызов для вложенных структур с увеличением глубины
periphConfig.clear_tab_params(mask, value, paramName, depth + 1);
end
else
if strcmp(key, 'Sources') || strcmp(key, 'Includes')
baseName = configJs.get_final_name_from_prefix(prefix);
periphConfig.clear_single_periph_code_param(mask, baseName);
end
end
end
end
function sync_tab_params(mask, configStruct, prefix, depth)
if nargin < 4
depth = 0;
end
maxDepth = 3; % Максимальная глубина рекурсии
fields = fieldnames(configStruct);
for i = 1:numel(fields)
key = fields{i};
value = configStruct.(key);
paramName = [prefix '_' key];
if isstruct(value)
if depth < maxDepth
% Рекурсивный вызов для вложенных структур с увеличением глубины
periphConfig.sync_tab_params(mask, value, paramName, depth + 1);
end
else
if strcmp(key, 'Sources') || strcmp(key, 'Includes')
baseName = configJs.get_final_name_from_prefix(prefix);
periphConfig.store_single_periph_code(mask, baseName, configStruct);
end
end
end
end
function create_all_code_storage_params(blockPath, config)
mask = Simulink.Mask.get(blockPath);
containerName = 'configTabAll';
container = mask.getDialogControl(containerName);
existingParams = mcuMask.collect_all_parameters(container);
% Убедимся, что контейнер существует
tabName = 'hiddenCodeTab';
tab = mask.getDialogControl(tabName);
if isempty(tab)
tab = container.addDialogControl('tab', tabName);
tab.Prompt = 'Hidden Code Settings';
tab.Visible = 'off';
else
tab.Visible = 'off';
end
% Запуск рекурсивного обхода
periphConfig.process_struct_recursive(mask, tabName, config, {}, existingParams);
end
function process_struct_recursive(mask, tabName, currentStruct, nameStack, existingParams)
fields = fieldnames(currentStruct);
for i = 1:numel(fields)
fieldName = fields{i};
value = currentStruct.(fieldName);
newStack = [nameStack, fieldName]; % Добавляем уровень к имени
% Если value — структура, обходим дальше
if isstruct(value)
% Проверяем: это структура с Sources/Includes или просто промежуточный узел?
hasSources = isfield(value, 'Sources');
hasIncludes = isfield(value, 'Includes');
if hasSources
periphConfig.addHiddenParam(mask, tabName, fieldName, 'Sources', existingParams);
end
if hasIncludes
periphConfig.addHiddenParam(mask, tabName, fieldName, 'Includes', existingParams);
end
% Рекурсивно продолжаем обход
periphConfig.process_struct_recursive(mask, tabName, value, newStack, existingParams);
end
end
end
function cleanup_obsolete_code_params(blockPath, config)
mask = Simulink.Mask.get(blockPath);
maskParams = mask.Parameters;
% Получаем список актуальных периферий
validPeriphs = fieldnames(config);
for i = 1:numel(maskParams)
paramName = maskParams(i).Name;
% Проверяем, является ли параметром хранения Sources или Includes
expr = '^Hidden_(\w+)_(Sources|Includes)$';
tokens = regexp(paramName, expr, 'tokens');
if ~isempty(tokens)
periph = tokens{1}{1};
% Если периферии больше нет удаляем параметр
if ~ismember(periph, validPeriphs)
mask.removeParameter(paramName);
fprintf('Удалён устаревший параметр: %s\n', paramName);
end
end
end
end
function codeStruct = restore_periph_code_from_mask(blockPath)
mask = Simulink.Mask.get(blockPath);
maskParams = mask.Parameters;
allSources = {};
allIncludes = {};
for i = 1:numel(maskParams)
name = maskParams(i).Name;
% Ищем параметры Sources
tokensSrc = regexp(name, '^Hidden_(\w+)_Sources$', 'tokens');
if ~isempty(tokensSrc)
val = maskParams(i).Value;
if ischar(val) || isstring(val)
valStr = strtrim(char(val));
% Пропускаем пустые строки и '[]'
if isempty(valStr) || strcmp(valStr, '[]')
continue;
end
lines = splitlines(valStr);
lines = lines(~cellfun(@(x) all(isspace(x)) || isempty(x), lines));
allSources = [allSources; lines]; %#ok<AGROW>
end
continue;
end
% Ищем параметры Includes
tokensInc = regexp(name, '^Hidden_(\w+)_Includes$', 'tokens');
if ~isempty(tokensInc)
val = maskParams(i).Value;
if ischar(val) || isstring(val)
valStr = strtrim(char(val));
if isempty(valStr) || strcmp(valStr, '[]')
continue;
end
lines = splitlines(valStr);
lines = lines(~cellfun(@(x) all(isspace(x)) || isempty(x), lines));
allIncludes = [allIncludes; lines]; %#ok<AGROW>
end
continue;
end
end
codeStruct = struct();
codeStruct.Sources = allSources;
codeStruct.Includes = allIncludes;
end
function clear_all_from_container(mask, containerName)
% allControls = mask.getDialogControls();
container = mask.getDialogControl(containerName);
if isempty(container)
warning('Контейнер "%s" не найден.', containerName);
return;
end
% Рекурсивно собрать все параметры (не вкладки)
paramsToDelete = mcuMask.collect_all_parameters(container);
% Удаляем все параметры
for i = 1:numel(paramsToDelete)
try
mask.removeParameter(paramsToDelete{i});
catch
warning('Не удалось удалить параметр %s', paramsToDelete{i});
end
end
% Рекурсивно удалить все вкладки внутри контейнера
mcuMask.delete_all_tabs(mask, container);
end
function res = addCodeBat(codeConfig, codePath)
% Добавить сурсы и пути в батник
% Возвращает 0 при успехе, 1 при ошибке
try
% Формируем строки
srcText = compiler.createSourcesBat('code_PERIPH', codeConfig.Sources, codePath);
incText = compiler.createIncludesBat('includes_PERIPH', codeConfig.Includes, codePath);
% Записываем результат
res = compiler.updateRunMexBat(srcText, incText, ':: PERIPH BAT'); % Всё прошло успешно
catch
% В случае ошибки просто возвращаем 1
res = 1;
end
end
function res = addUserFunctions(userCodeConfig)
% Добавить функции и дефайны в исходный код wrapper
% userCodeConfig — структура config.UserCode
initFuncsText = '';
simFuncsText = '';
deinitFuncsText = '';
if isfield(userCodeConfig, 'Functions')
funcs = userCodeConfig.Functions;
if isfield(funcs, 'PeriphInit')
initFuncs = funcs.PeriphInit;
initFuncsText = strjoin(strcat('\t', initFuncs, ';'), '\n');
end
if isfield(funcs, 'PeriphSimulation')
simFuncs = funcs.PeriphSimulation;
simFuncsText = strjoin(strcat('\t', simFuncs, ';'), '\n');
end
if isfield(funcs, 'PeriphDeinit')
deinitFuncs = funcs.PeriphDeinit;
deinitFuncsText = strjoin(strcat('\t', deinitFuncs, ';'), '\n');
end
res = periphConfig.writeWrapperCode(initFuncsText, simFuncsText, deinitFuncsText);
end
end
function res = writeWrapperCode(initFuncsText, simFuncsText, deinitFuncsText)
% Входные параметры:
% srcText - текст для записи set code_...
% incText - текст для записи set includes_...
%
% Возвращает:
% res - 0 при успехе, 1 при ошибке
wrapPath = fullfile(mcuPath.get('wrapperPath'), 'mcu_wrapper.c');
res = 1;
try
code = fileread(wrapPath);
code = regexprep(code, '\r\n?', '\n');
% Записываем строки initFuncsText и simFuncsText
code = editCode.insertSection(code, '// PERIPH INIT', initFuncsText);
code = editCode.insertSection(code, '// PERIPH SIM', simFuncsText);
code = editCode.insertSection(code, '// PERIPH DEINIT', deinitFuncsText);
fid = fopen(wrapPath, 'w', 'n', 'UTF-8');
if fid == -1
error('Не удалось открыть файл для записи');
end
fwrite(fid, code);
fclose(fid);
res = 1;
catch ME
error('Ошибка: неудачная запись в файл при записи файла: %s', ME.message);
end
end
function addConfig(mask, containerName, periphName, defPrompt, def, rowCountMap, rowWidth)
% mask — объект маски Simulink.Mask.get(blockPath)
% containerName — имя контейнера, в который добавляем параметр (например, 'configTabAll')
% periphName — имя вкладки / контейнера для текущего периферийного блока (например, 'ADC')
% defPrompt — имя параметра в Defines (например, 'shift_enable')
% def — структура с описанием параметра (Prompt, Def, Type, Default, NewRow и т.п.)
if ~isKey(rowCountMap, periphName)
rowCountMap(periphName) = 0;
end
rowCount = rowCountMap(periphName) + 1;
% Устанавливаем NewRow, если он не задан
if ~isfield(def, 'NewRow')
def.NewRow = mod(rowCount - 1, rowWidth) == 0;
elseif def.NewRow == true
rowCount = 1;
end
rowCountMap(periphName) = rowCount;
% Найдем контейнер с таким именем
container = mask.getDialogControl(containerName);
if isempty(container)
error('Контейнер "%s" не найден в маске.', containerName);
end
% Проверим, есть ли вкладка с именем periphName, если нет — создадим
tabCtrl = mask.getDialogControl(periphName);
if isempty(tabCtrl)
tabCtrl = container.addDialogControl('tab', periphName);
tabCtrl.Prompt = [periphName ' Config'];
end
% Определяем тип параметра (checkbox или edit)
switch lower(def.Type)
case 'checkbox'
paramType = 'checkbox';
case 'edit'
paramType = 'edit';
case 'popup'
paramType = 'popup';
otherwise
% Игнорируем остальные типы
return;
end
paramName = matlab.lang.makeValidName(defPrompt);
% Получаем значение
if strcmp(paramType, 'popup')
if isfield(def, 'Def') && iscell(def.Def) && ~isempty(def.Def)
choices = def.Def;
valStr = ''; % по умолчанию — ничего
elseif isfield(def, 'Options')
choices = def.Def;
valStr = ''; % по умолчанию — ничего
else
warning('Popout параметр "%s" не содержит допустимого списка в Def.', defPrompt);
return;
end
else
val = def.Default;
if islogical(val)
valStr = periphConfig.ternary(val, 'on', 'off');
elseif isnumeric(val)
valStr = num2str(val);
elseif ischar(val)
valStr = val;
else
error('Unsupported default value type for %s.%s', periphName, defPrompt);
end
end
% Добавляем параметр в маску
if strcmp(paramType, 'popup')
param = mask.addParameter( ...
'Type', paramType, ...
'Prompt', def.Prompt, ...
'Name', paramName, ...
'Container', periphName ...
);
else
param = mask.addParameter( ...
'Type', paramType, ...
'Prompt', def.Prompt, ...
'Name', paramName, ...
'Value', valStr, ...
'Container', periphName ...
);
end
param.Evaluate = 'off';
if def.NewRow
param.DialogControl.Row = 'new';
else
param.DialogControl.Row = 'current';
end
if isfield(def, 'Def')
if strcmp(paramType, 'popup')
if iscell(def.Def)
param.TypeOptions = def.Def;
elseif isfield(def, 'Options')
param.Alias = def.Def;
param.TypeOptions = def.Options;
end
else
param.Alias = def.Def;
end
end
callback = sprintf('periphConfig.periphParamCallback("%s");', paramName);
param.Callback = callback;
end
%% ELEMENTARY
function clear_single_periph_code_param(mask, periph)
% Очистка кода одного поля конфига
paramNames = {
['Hidden_' char(periph) '_Sources'],
['Hidden_' char(periph) '_Includes']
};
for i = 1:numel(paramNames)
paramName = paramNames{i};
try
param = mask.getParameter(paramName);
param.Value = '';
catch
% Параметр не существует — ничего не делаем
end
end
end
function store_single_periph_code(mask, periph, code)
% Запись кода одного поля конфига
% Сохраняем Sources, если они есть
if isfield(code, 'Sources')
paramName = ['Hidden_' char(periph) '_Sources'];
try
param = mask.getParameter(paramName);
param.Value = configJs.convert_code_value(code.Sources);
catch
mcuMask.disp(0, ['Параметр ' paramName ' не найден']);
end
end
% Сохраняем Includes, если они есть
if isfield(code, 'Includes')
paramName = ['Hidden_' char(periph) '_Includes'];
try
param = mask.getParameter(paramName);
param.Value = configJs.convert_code_value(code.Includes);
catch
mcuMask.disp(0, ['Параметр ' paramName ' не найден']);
end
end
end
function res = ternary(cond, valTrue, valFalse)
if cond
res = valTrue;
else
res = valFalse;
end
end
end
end