1 %% Copyright (C) 2013-2014 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()>\
151 xSemaphoreGive(initialized_signal);
156 if (xSemaphoreTake(step_signal, portMAX_DELAY)) {
158 %<LibCallModelStep(0)>\
164 %% /* In case of shutdown, delete this task */
165 %% vTaskDelete(NULL);
169 void ext_mode_comm_task(void* p)
171 drv_sci_set_crlf_conv_en(FALSE); /* Disable CR->CRLF conversion */
173 %<SLibGenERTExtModeInit()>
174 xSemaphoreGive(ext_mode_ready);
176 while (rtmGetErrorStatus(%<modelName>_M) == NULL && !rtmGetStopRequested(%<modelName>_M)) {
177 rtExtModeOneStep(rtmGetRTWExtModeInfo(%<modelName>_M), %<numSampleTimes>, (boolean_T *)&rtmGetStopRequested(%<modelName>_M));
179 rtExtModeShutdown(%<numSampleTimes>);
180 /* In case of shutdown, delete this task */
186 * Hardware initialization, task spawning and OS scheduler start.
190 /* Initialize RPP board */
191 %if EXISTS(::rpp_ain_present)
194 %if EXISTS(::rpp_din_present) || EXISTS(::rpp_dout_present)
195 rpp_gio_init(RPP_GIO_PORT_ALL);
200 rpp_sci_setup(115200);
203 %assign model_info = SPRINTF("'%s' - %s (TLC %s)\\r\\n", LibGetMdlPubHdrBaseName(), TLC_TIME, TLC_VERSION)
204 rpp_sci_printk("%<model_info>");
207 /* Create and lock semaphore */
208 vSemaphoreCreateBinary(step_signal);
209 xSemaphoreTake(step_signal, 0);
210 vSemaphoreCreateBinary(initialized_signal);
211 xSemaphoreTake(initialized_signal, 0);
213 vSemaphoreCreateBinary(ext_mode_ready);
214 xSemaphoreTake(ext_mode_ready, 0);
217 /* Create tasks to step model and model task */
218 if (xTaskCreate(control_task, "control_task",
219 configMINIMAL_STACK_SIZE, NULL, CONTROL_PRIORITY, NULL) != pdPASS) {
220 rpp_sci_printk("ERROR: Cannot spawn control task.\r\n");
223 if (xTaskCreate(working_task, "working_task",
224 %<rppModelTaskStack>, NULL, WORKING_PRIORITY, NULL) != pdPASS) {
225 rpp_sci_printk("ERROR: Cannot spawn model task.\r\n"
231 rtParseArgsForExtMode(0, NULL);
233 if (xTaskCreate(ext_mode_comm_task, "ext_mode_comm_task", 1024, NULL, EXTMODE_PRIORITY, NULL) != pdPASS) {
234 rpp_sci_printk("ERROR: Cannot spawn model task.\r\n");
239 /* Start FreeRTOS Scheduler */
240 vTaskStartScheduler();
242 /* We should never get here */
243 %<LibCallModelTerminate()>
244 rpp_sci_printk("ERROR: Problem allocating memory for idle task.\r\n");
248 #if configUSE_MALLOC_FAILED_HOOK == 1
250 * FreeRTOS malloc() failed hook.
252 void vApplicationMallocFailedHook(void) {
253 rpp_sci_printk("ERROR: Memory allocation failed.\r\n");
258 #if configCHECK_FOR_STACK_OVERFLOW > 0
260 * FreeRTOS stack overflow hook.
262 void vApplicationStackOverflowHook(xTaskHandle xTask, signed portCHAR *pcTaskName)
264 rpp_sci_printk("ERROR: Stack overflow : \"%s\".\r\n", pcTaskName);
269 %<LibSetSourceFileSection(cFile, "Functions", tmpBuf)>