Сделана документация на то, что есть сейчас
This commit is contained in:
@@ -1,25 +1,37 @@
|
||||
/**************************************************************************
|
||||
/**
|
||||
**************************************************************************
|
||||
* @file mcu_wrapper.c
|
||||
* @brief Исходный код оболочки МК.
|
||||
**************************************************************************
|
||||
@details
|
||||
Данный файл содержит функции для симуляции МК в Simulink (S-Function).
|
||||
|
||||
**************************************************************************/
|
||||
#include "mcu_wrapper_conf.h"
|
||||
|
||||
SIM__MCUHandleTypeDef hmcu; // для управления контекстом программы МК
|
||||
/**
|
||||
* @addtogroup WRAPPER_CONF
|
||||
* @{
|
||||
*/
|
||||
|
||||
double SystemClockDouble = 0; // для симуляции системных тиков, прока просто по приколу
|
||||
double SystemClock_step = 0; // для симуляции системных тиков, прока просто по приколу
|
||||
uint64_t SystemClock; // для симуляции системных тиков, прока просто по приколу
|
||||
SIM__MCUHandleTypeDef hmcu; ///< Хендл для управления потоком программы МК
|
||||
|
||||
double SystemClockDouble = 0; ///< Счетчик в формате double для точной симуляции системных тиков С промежуточными значений
|
||||
uint64_t SystemClock; ///< Счетчик тактов для симуляции системных тиков (в целочисленном формате)
|
||||
double SystemClock_step = 0; ///< Шаг тиков для их симуляции, в формате double
|
||||
|
||||
/** MCU_WRAPPER
|
||||
* @}
|
||||
*/
|
||||
//-------------------------------------------------------------//
|
||||
//-----------------CONTROLLER SIMULATE FUNCTIONS---------------//
|
||||
/* THREAD FOR MCU APP */
|
||||
/**
|
||||
* @brief Main function of MCU app.
|
||||
* @brief Главная функция приложения МК.
|
||||
* @details Функция с которой начинается выполнение кода МК. Выход из данной функции происходит только в конце симуляции @ref mdlTerminate
|
||||
*/
|
||||
extern int main(void); // extern while from main.c
|
||||
/** THREAD FOR MCU APP */
|
||||
/**
|
||||
* @brief Thread that run MCU code.
|
||||
* @brief Поток приложения МК.
|
||||
* @details Поток, который запускает и выполняет код МК (@ref main).
|
||||
*/
|
||||
unsigned __stdcall MCU_App_Thread(void) {
|
||||
@@ -27,13 +39,16 @@ unsigned __stdcall MCU_App_Thread(void) {
|
||||
return 0; // end thread
|
||||
// note: this return will reached only at the end of simulation, when all whiles will be skipped due to @ref sim_while
|
||||
}
|
||||
/** SIMULATE MCU FOR ONE SIMULATION STEP */
|
||||
/* SIMULATE MCU FOR ONE SIMULATION STEP */
|
||||
/**
|
||||
* @brief Read from simulink S-Block Inputs and write to MCU I/O ports.
|
||||
* @param time - current time of simulation (in second).
|
||||
* @brief Симуляция МК на один такт симуляции.
|
||||
* @param S - указатель на структуру S-Function из "simstruc.h"
|
||||
* @param time - текущее время симуляции.
|
||||
* @details Запускает поток, который выполняет код МК и управляет ходом потока:
|
||||
* Если прошел таймаут, поток прерывается, симулируется периферия
|
||||
* и на следующем шаге поток возобнавляется.
|
||||
*
|
||||
* Вызывается из mdlUpdate()
|
||||
*/
|
||||
void MCU_Step_Simulation(SimStruct* S, time_T time)
|
||||
{
|
||||
@@ -50,9 +65,9 @@ void MCU_Step_Simulation(SimStruct* S, time_T time)
|
||||
MCU_writeOutputs(S); // запись портов (по факту запись в буфер. запись в порты в mdlOutputs)
|
||||
}
|
||||
|
||||
/** SIMULATE MCU PERIPHERAL */
|
||||
/* SIMULATE MCU PERIPHERAL */
|
||||
/**
|
||||
* @brief Simulate peripheral of MCU
|
||||
* @brief Симуляция периферии МК
|
||||
* @details Пользовательский код, который симулирует работу периферии МК.
|
||||
*/
|
||||
void MCU_Periph_Simulation(void)
|
||||
@@ -64,11 +79,11 @@ void MCU_Periph_Simulation(void)
|
||||
Simulate_TIMs();
|
||||
}
|
||||
|
||||
/** READ INPUTS S-FUNCTION TO MCU REGS */
|
||||
/* READ INPUTS S-FUNCTION TO MCU REGS */
|
||||
/**
|
||||
* @brief Read from simulink S-Block Inputs and write to MCU I/O ports.
|
||||
* @param in - inputs of S-Function.
|
||||
* @details Пользовательский код, который записывает в порты ввода-вывода из disc.
|
||||
* @brief Считывание входов S-Function в порты ввода-вывода.
|
||||
* @param S - указатель на структуру S-Function из "simstruc.h"
|
||||
* @details Пользовательский код, который записывает порты ввода-вывода из входов S-Function.
|
||||
*/
|
||||
void MCU_readInputs(SimStruct* S)
|
||||
{
|
||||
@@ -78,18 +93,18 @@ void MCU_readInputs(SimStruct* S)
|
||||
SFUNC_to_GPIO(IN);
|
||||
}
|
||||
|
||||
/** WRITE OUTPUTS BUFFER S-FUNCTION FROM MCU REGS*/
|
||||
/* WRITE OUTPUTS BUFFER S-FUNCTION FROM MCU REGS*/
|
||||
/**
|
||||
* @brief Read from MCU I/O ports and write to simulink S-Block Outputs.
|
||||
* @param disc - discrete array of S-Function. Outputs would be written from disc.
|
||||
* @details Пользовательский код, который записывает в disc порты ввода-вывода.
|
||||
* @brief Запись портов ввода-вывода в буфер выхода S-Function
|
||||
* @param S - указатель на структуру S-Function из "simstruc.h"
|
||||
* @details Пользовательский код, который записывает буфер выходов S-Function из портов ввода-вывода.
|
||||
*/
|
||||
void MCU_writeOutputs(SimStruct* S)
|
||||
{
|
||||
/* Get S-Function descrete array */
|
||||
real_T* DISC = ssGetDiscStates(S);
|
||||
real_T* Out_Buff = ssGetDiscStates(S);
|
||||
|
||||
GPIO_to_SFUNC(DISC);
|
||||
GPIO_to_SFUNC(Out_Buff);
|
||||
}
|
||||
//-----------------CONTROLLER SIMULATE FUNCTIONS---------------//
|
||||
//-------------------------------------------------------------//
|
||||
@@ -98,16 +113,16 @@ void MCU_writeOutputs(SimStruct* S)
|
||||
|
||||
//-------------------------------------------------------------//
|
||||
//----------------------SIMULINK FUNCTIONS---------------------//
|
||||
/** WRITE OUTPUTS OF S-BLOCK */
|
||||
/* WRITE OUTPUTS OF S-BLOCK */
|
||||
/**
|
||||
* @brief Write S-Function Output ports to inputs.
|
||||
* @param disc - discrete array of S-Function. Outputs would be written from disc.
|
||||
* @details Пользовательский код, который записывает выходы S-Function.
|
||||
* @brief Формирование выходов S-Function.
|
||||
* @param S - указатель на структуру S-Function из "simstruc.h"
|
||||
* @details Пользовательский код, который записывает выходы S-Function из буфера.
|
||||
*/
|
||||
void SIM_writeOutputs(SimStruct* S)
|
||||
{
|
||||
real_T* GPIO;
|
||||
real_T* DISC = ssGetDiscStates(S);
|
||||
real_T* Out_Buff = ssGetDiscStates(S);
|
||||
|
||||
//-------------WRITTING GPIOS---------------
|
||||
for (int j = 0; j < PORT_NUMB; j++)
|
||||
@@ -115,30 +130,33 @@ void SIM_writeOutputs(SimStruct* S)
|
||||
GPIO = ssGetOutputPortRealSignal(S, j);
|
||||
for (int i = 0; i < PORT_WIDTH; i++)
|
||||
{
|
||||
GPIO[i] = DISC[j * PORT_WIDTH + i];
|
||||
DISC[j * PORT_WIDTH + i] = 0;
|
||||
GPIO[i] = Out_Buff[j * PORT_WIDTH + i];
|
||||
Out_Buff[j * PORT_WIDTH + i] = 0;
|
||||
}
|
||||
}
|
||||
//------------------------------------------
|
||||
}
|
||||
/** MCU WRAPPER DEINITIALIZATION */
|
||||
/* MCU WRAPPER DEINITIALIZATION */
|
||||
/**
|
||||
* @brief Initialize structures and variables for simulating MCU.
|
||||
* @details Пользовательский код, который будет настраивать все структуры для симуляции.
|
||||
* @brief Инициализация симуляции МК.
|
||||
* @details Пользовательский код, который создает поток для приложения МК
|
||||
и настраивает симулятор МК для симуляции.
|
||||
*/
|
||||
void SIM_Initialize_Simulation(void)
|
||||
{
|
||||
// инициализация потока, который будет выполнять код МК
|
||||
hmcu.hMCUThread = (HANDLE)CreateThread(NULL, 0, MCU_App_Thread, 0, CREATE_SUSPENDED, &hmcu.idMCUThread);
|
||||
|
||||
|
||||
/* user initialization */
|
||||
Initialize_Periph_Sim();
|
||||
|
||||
/* wrapper initialization */
|
||||
SystemClock_step = SystemCoreClock * hmcu.SIM_Sample_Time; // set system clock step
|
||||
// инициализация потока, который будет выполнять код МК
|
||||
hmcu.hMCUThread = (HANDLE)CreateThread(NULL, 0, MCU_App_Thread, 0, CREATE_SUSPENDED, &hmcu.idMCUThread);
|
||||
}
|
||||
/** MCU WRAPPER DEINITIALIZATION */
|
||||
/* MCU WRAPPER DEINITIALIZATION */
|
||||
/**
|
||||
* @brief Deinitialize structures and variables for simulating MCU.
|
||||
* @brief Деинициализация симуляции МК.
|
||||
* @details Пользовательский код, который будет очищать все структуры после окончания симуляции.
|
||||
*/
|
||||
void SIM_deInitialize_Simulation(void)
|
||||
@@ -149,12 +167,3 @@ void SIM_deInitialize_Simulation(void)
|
||||
deInitialize_MCU();
|
||||
}
|
||||
//-------------------------------------------------------------//
|
||||
|
||||
////-----------INIT WRAPPER-----------
|
||||
//if (hmcu.MCU_Start) // если надо получть указатель на "начало" стека
|
||||
//{ // сброс флаша, чтобы сюда больше не попадать
|
||||
// hmcu.MCU_Start = 0;
|
||||
// // инициализация потока, который будет выполнять код МК
|
||||
// hmcu.hMCUThread = (HANDLE)_beginthreadex(NULL, 0, MCU_App_Thread, 0, 0x00000004, &hmcu.idMCUThread); /* 0x00000004 - CREATE_SUSPENDED */
|
||||
//}
|
||||
////----------------------------------
|
||||
Reference in New Issue
Block a user