tdse-tp0_03-hw_sw_test

FIUBA - Electrónica - Taller de Sistemas Embebidos - Trabajo Práctico N°: 0 - Proyecto N°: 03
Index Commits Files Refs README
app/src/task_a_commented_read.me (4530B)
   1 /*
   2  * Copyright (c) 2023 Juan Manuel Cruz <jcruz@fi.uba.ar> <jcruz@frba.utn.edu.ar>.
   3  * All rights reserved.
   4  *
   5  * Redistribution and use in source and binary forms, with or without
   6  * modification, are permitted provided that the following conditions are met:
   7  *
   8  * 1. Redistributions of source code must retain the above copyright
   9  *    notice, this list of conditions and the following disclaimer.
  10  *
  11  * 2. Redistributions in binary form must reproduce the above copyright
  12  *    notice, this list of conditions and the following disclaimer in the
  13  *    documentation and/or other materials provided with the distribution.
  14  *
  15  * 3. Neither the name of the copyright holder nor the names of its
  16  *    contributors may be used to endorse or promote products derived from
  17  *    this software without specific prior written permission.
  18  *
  19  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  20  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  21  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  22  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
  23  * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
  24  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
  25  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
  26  * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  27  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
  28  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
  29  * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  30  * POSSIBILITY OF SUCH DAMAGE.
  31  *
  32  * @file   : task_a.c
  33  * @date   : Set 26, 2023
  34  * @author : Juan Manuel Cruz <jcruz@fi.uba.ar> <jcruz@frba.utn.edu.ar>
  35  * @version    v1.0.0
  36  */
  37 
  38 /********************** inclusions *******************************************/
  39 /* Project includes */
  40 #include "main.h"
  41 
  42 /* Demo includes */
  43 #include "logger.h"
  44 #include "dwt.h"
  45 
  46 /* Application & Tasks includes */
  47 #include "board.h"
  48 #include "app.h"
  49 
  50 /********************** macros and definitions *******************************/
  51 #define G_TASK_A_CNT_INI    0ul
  52 
  53 #define TASK_A_CNT_INI        0ul
  54 #define TASK_A_CNT_MAX        1000ul
  55 
  56 #define TASK_A_DEL_INI        0ul
  57 #define TASK_A_DEL_MAX        20ul
  58 
  59 /********************** internal data declaration ****************************/
  60 
  61 /********************** internal functions declaration ***********************/
  62 
  63 /********************** internal data definition *****************************/
  64 const char *p_task_a         = "Task A - Blocking Code";
  65 
  66 /********************** external data declaration ****************************/
  67 uint32_t g_task_a_cnt;
  68 
  69 /********************** external functions definition ************************/
  70 void task_a_init(void *parameters)
  71 {
  72     /* Print out: Task Initialized */
  73     LOGGER_INFO(" ");
  74     LOGGER_INFO("  %s is running - %s", GET_NAME(task_a_init), p_task_a);
  75 
  76     /* Init & Print out: Task execution counter */
  77     g_task_a_cnt = G_TASK_A_CNT_INI;
  78     LOGGER_INFO("   %s = %lu", GET_NAME(g_task_a_cnt), g_task_a_cnt);
  79 }
  80 
  81 void task_a_update(void *parameters)
  82 {
  83     #if (TEST_X == TEST_0)
  84 
  85     /* Memory Layout of C Programs (https://www.geeksforgeeks.org/) */
  86     /* Storage Classes in C (https://www.geeksforgeeks.org/) */
  87     /* C Variables (https://www.geeksforgeeks.org/) */
  88     /* Local Variable in C (https://www.geeksforgeeks.org/) */
  89     /*
  90      * A variable declared within a function or a block of code is called a
  91      * local variable. Local variables are frequently used to temporarily
  92      * store data in a defined scope where they can be accessed and
  93      * manipulated.
  94      */
  95     uint32_t task_a_cnt;
  96 
  97     /* Update Task Counter */
  98     g_task_a_cnt++;
  99 
 100     /* Blocking and Non-Blocking in Node.js (https://www.geeksforgeeks.org/) */
 101     /*
 102      * Blocking: It refers to the blocking of further operation until the
 103      * current operation finishes.
 104      * Blocking methods are executed synchronously.
 105      * Synchronously means that the program is executed line by line.
 106      * The program waits until the called function or the operation
 107      * returns.
 108      * */
 109     for (task_a_cnt = TASK_A_CNT_INI; task_a_cnt < TASK_A_CNT_MAX; task_a_cnt++);
 110 
 111     #endif
 112 
 113     #if (TEST_X == TEST_1)
 114 
 115     /* Wait for TASK_A_DEL_MAX mS */
 116     HAL_Delay(TASK_A_DEL_MAX);
 117 
 118     #endif
 119 
 120     #if (TEST_X == TEST_2)
 121 
 122     /* Here Chatbot Artificial Intelligence generated code */
 123 
 124     #endif
 125 }
 126 
 127 /********************** end of file ******************************************/