1 %% Copyright (C) 2013-2015 Czech Technical University in Prague
4 %% - Carlos Jenkins <carlos@jenkins.co.cr>
5 %% - Michal Sojka <sojkam1@fel.cvut.cz>
7 %% This document contains proprietary information belonging to Czech
8 %% Technical University in Prague. Passing on and copying of this
9 %% document, and communication of its contents is not permitted
10 %% without prior written authorization.
12 %% File : rpp_srmain.tlc
14 %% Custom TLC file to generate an RPP "main" file.
16 %% This file generates the "main" file for the RPP target on top of the RPP
17 %% library and the FreeRTOS operating system.
19 %% The sr prefix is standard to mark Single Tasking main, which is the case. See
20 %% rpp_file_process.m description above for more information about this.
23 %% Example in <matlabroot>/rtw/c/tlc/mw/bareboard_srmain.tlc
28 %function FcnSingleTaskingMain() void
30 %if GenerateSampleERTMain
31 %assign CompiledModel.GenerateSampleERTMain = TLC_FALSE
35 %assign cFile = LibCreateSourceFile("Source", "Custom", "ert_main")
42 #include "%<LibGetMdlPubHdrBaseName()>.h"
44 /* RPP runtime includes */
45 #include "rpp_simulink_runtime.h"
48 /* External mode header file */
54 %<LibSetSourceFileSection(cFile, "Includes", tmpBuf)>
62 #define STEP_SIZE_MILLIS (%<CompiledModel.FundamentalStepSize>*1000.0)
63 #define CONTROL_PRIORITY 3
64 #define WORKING_PRIORITY 2
65 #define EXTMODE_PRIORITY 1
68 %<LibSetSourceFileSection(cFile, "Defines", tmpBuf)>
75 static boolean_t working = FALSE;
76 static xSemaphoreHandle step_signal = NULL;
77 static xSemaphoreHandle initialized_signal = NULL;
79 static xSemaphoreHandle ext_mode_ready = NULL;
81 static uint32_t steps_control = 0;
82 static uint32_t steps_working = 0;
83 boolean_t overrun_flag = FALSE;
86 %<LibSetSourceFileSection(cFile, "Declarations", tmpBuf)>
94 * Model step control and overrun detection task.
96 void control_task(void* p)
99 xSemaphoreTake(initialized_signal, portMAX_DELAY);
101 xSemaphoreTake(ext_mode_ready, portMAX_DELAY);
104 static const portTickType freq_ticks = STEP_SIZE_MILLIS / portTICK_RATE_MS;
105 portTickType last_wake_time = xTaskGetTickCount();
107 %% This condition has been added because of the warning:
108 %% "ert_main.c", line 46: warning #238-D: controlling expression is constant
109 %% caused by the expression (void*) 0 passed to the while statement. The rtmGetStopRequested
110 %% macro is defined to this constant if and only if the GenerateSampleERTMain is not set. So
111 %% The condition is not needed in this case as well.
113 %% See <MATLAB_ROOT>/rtw/c/tlc/mw/rtmspecmacs.tlc at line 198.
115 %if !GenerateSampleERTMain
116 while (rtmGetErrorStatus(%<modelName>_M) == NULL) {
118 while (rtmGetErrorStatus(%<modelName>_M) == NULL && !rtmGetStopRequested(%<modelName>_M)) {
120 /* Wait until next step */
121 vTaskDelayUntil(&last_wake_time, freq_ticks);
124 /* Overrun detected */
127 overrun_flag = FALSE;
128 /* Release semaphore */
129 xSemaphoreGive(step_signal);
134 rtExtModeCheckEndTrigger();
139 /* In case of shutdown, delete this task */
144 * Model step logic execution task.
146 void working_task(void* p)
148 /* Initialize model */
149 %<LibCallModelInitialize()>\
150 /* Step the model for any subrate */
151 xSemaphoreGive(initialized_signal);
154 if (xSemaphoreTake(step_signal, portMAX_DELAY)) {
156 %<LibCallModelStep(0)>\
162 %% /* In case of shutdown, delete this task */
163 %% vTaskDelete(NULL);
167 void ext_mode_comm_task(void* p)
169 drv_sci_set_crlf_conv_en(FALSE); /* Disable CR->CRLF conversion */
171 %<SLibGenERTExtModeInit()>
172 xSemaphoreGive(ext_mode_ready);
174 while (rtmGetErrorStatus(%<modelName>_M) == NULL && !rtmGetStopRequested(%<modelName>_M)) {
175 rtExtModeOneStep(rtmGetRTWExtModeInfo(%<modelName>_M), %<numSampleTimes>, (boolean_T *)&rtmGetStopRequested(%<modelName>_M));
177 rtExtModeShutdown(%<numSampleTimes>);
178 /* In case of shutdown, delete this task */
184 * Hardware initialization, task spawning and OS scheduler start.
188 /* Initialize RPP board */
189 %if EXISTS(::rpp_ain_present)
192 %if EXISTS(::rpp_aout_present)
195 %if EXISTS(::rpp_din_present)
198 %if EXISTS(::rpp_hbr_present)
201 %if EXISTS(::rpp_irc_present)
204 %if EXISTS(::rpp_lout_present)
207 %if EXISTS(::rpp_mout_present)
210 %if EXISTS(::rpp_sdr_present)
212 %if EXISTS(::rpp_gio_in_present) || EXISTS(::rpp_gio_out_present)
213 rpp_gio_init(RPP_GIO_PORT_ALL);
218 rpp_sci_setup(115200);
221 %assign model_info = SPRINTF("'%s' - %s (TLC %s)\\r\\n", LibGetMdlPubHdrBaseName(), TLC_TIME, TLC_VERSION)
222 rpp_sci_printk("%<model_info>");
225 /* Create and lock semaphore */
226 vSemaphoreCreateBinary(step_signal);
227 xSemaphoreTake(step_signal, 0);
228 vSemaphoreCreateBinary(initialized_signal);
229 xSemaphoreTake(initialized_signal, 0);
231 vSemaphoreCreateBinary(ext_mode_ready);
232 xSemaphoreTake(ext_mode_ready, 0);
235 /* Create tasks to step model and model task */
236 if (xTaskCreate(control_task, "control_task",
237 configMINIMAL_STACK_SIZE, NULL, CONTROL_PRIORITY, NULL) != pdPASS) {
238 rpp_sci_printk("ERROR: Cannot spawn control task.\r\n");
241 if (xTaskCreate(working_task, "working_task",
242 %<rppModelTaskStack>, NULL, WORKING_PRIORITY, NULL) != pdPASS) {
243 rpp_sci_printk("ERROR: Cannot spawn model task.\r\n"
249 rtParseArgsForExtMode(0, NULL);
251 if (xTaskCreate(ext_mode_comm_task, "ext_mode_comm_task", 1024, NULL, EXTMODE_PRIORITY, NULL) != pdPASS) {
252 rpp_sci_printk("ERROR: Cannot spawn model task.\r\n");
257 /* Start FreeRTOS Scheduler */
258 vTaskStartScheduler();
260 /* We should never get here */
261 %<LibCallModelTerminate()>
262 rpp_sci_printk("ERROR: Problem allocating memory for idle task.\r\n");
266 #if configUSE_MALLOC_FAILED_HOOK == 1
268 * FreeRTOS malloc() failed hook.
270 void vApplicationMallocFailedHook(void) {
271 rpp_sci_printk("ERROR: Memory allocation failed.\r\n");
276 #if configCHECK_FOR_STACK_OVERFLOW > 0
278 * FreeRTOS stack overflow hook.
280 void vApplicationStackOverflowHook(xTaskHandle xTask, signed portCHAR *pcTaskName)
282 rpp_sci_printk("ERROR: Stack overflow : \"%s\".\r\n", pcTaskName);
287 %<LibSetSourceFileSection(cFile, "Functions", tmpBuf)>