Project 1- Traffic Jam Assistant Feature

Aim:

To develop a specific requirement of Traffic Jam Assistant algorithm which would predominantly feature in the IPC algorithm..

Objective:

To familiarize with concepts of Model Based Development in MATLAB Environment. Process and steps to follow:

• Model must be developed in MATLAB Simulink as per MBD guidelines.
• Code Generation Profile must be in Embedded Coder.
• Simulink Data Dictionary must be created for the model & must be linked to the model.
• Model Advisor Report & Code Generation.

Description:

Traffic Jam Assistant Feature

Introduction to the Feature:

Traffic Jam Assistant is one of the most common feature in Advanced Driver Assistance System. Traffic Jam Assistant helps the driver arrive more relaxed at their destination, even in dense traffic or in traffic jams. As a partially automated comfort function, the system takes over the longitudinal & lateral guidance of the vehicle. This means that the car can drive off, accelerate & brake automatically, as well as steer the vehicle within certain constraints. The driver has to permanently supervise the system & be ready to take over the complete control of the vehicle at any time.

Traffic Jam Assistant system helps to avoid rear end collisions in dense traffic conditions & traffic jams. In Traffic jams, the vehicle takes over driving off, acceleration, braking and steering within same lane.

Basic Working Principle:

Traffic Jam Assistant is based on the sensors and the functionality of the Adaptive Cruise Control (ACC) with stop & go and Lane Keeping Support (LKS). When ACC ‘Stop & Go’ is turned ON, the Traffic Jam Assistant continuously analyses the speed of the surrounding vehicles and compares it with the own driving speed. If the system detects dense traffic or a traffic jam at speeds less than 60 kmph, the driver can activate the functionality by press of a button. The vehicle will now automatically follow the vehicle in front, takes over driving off, acceleration, braking and steering within same lane.

Information regarding the Traffic Jam Assistant will be available to be displayed to the driver in the Instrument Panel Cluster (IPC). The Algorithm which the students need to implement here in this project is predominantly based on IPC units.

Problem Statement:

To develop one specific requirement of Traffic Jam Assistant algorithm which would predominantly feature in the IPC algorithm.Please note that the whole Traffic Jam Assistant is a very huge algorithm & only one small part of the logic is implemented here. Idea is to familiarize with concepts of Model Based Development in MATLAB Environment. The Project must be done keeping in mind the following processes & steps.

• This model must be developed in MATLAB Simulink as per MBD guidelines.
• Code Generation Profile must be in Embedded Coder.
• Simulink Data Dictionary must be created for the model & must be linked to the model.
• Model Advisor Report is mandatory & this will be followed by Code Generation.

Input Signals:

Output Signal:

Calibration Signals:

Local Signal:

Development of the Target Model:

As per the requirement as shown below the target model has been developed:

Requirement No 1:

• Input Signal “Input_Voltage” is compared against voltage values “VOLTAGE_MINIMUM_RANGE” & “VOLTAGE_MAXIMUM_RANGE”.
• Incoming input signal “Input_Voltage” must be greater than – equal to “VOLTAGE_MINIMUM_RANGE” and less than – equal to “VOLTAGE_MAXIMUM_RANGE”.
• Output signal from here is “Optimum_Voltage” which will be one of the inputs to the subsystem “DisplayUnit”.

Requirement No 2 (DisplayUnit Subsystem):

• Input Signals are “Optimum_Voltage”, “Input_Switch”,“Enable_Display”. Signal “Enable_Display” must be saturated between the range 0 – 7. Output signal from the subsystem is “Output_Display”.
• Input Signal “Enable_Display” is compared against pre – defined set of values in a multiport switch. Total data ports in the multiport switch is 5.
• Multiport switch inputs 1 & 2 is connected to calibration signal “ON_MODE”, Multiport switch inputs 3 & 4 is connected to calibration signal “OFF_MODE” while Multiport switch input 5 is connected to calibration signal “STANDBY_MODE”.
• The output from Multiport switch is connected to the first input port of the Switch block. The third input port of the Switch block is connected to the calibration signal “NO_DISPLAY”.
• Meanwhile NOT value of input signal “Input_Switch” is compared in an AND gate against input signal “Optimum_Voltage” and the output from comparing if calibration signals “INTERRUPT_1” & “INTERRUPT_2” are equal. The output of the AND gate is the second input of the switch block.
• The output from the switch block is “Output_Display”.

Data Dictionary creation:

• A new Simulink data dictionary is created and updated signals & calibration Data List as per our requirements.
• The very first thing that we will do is create a Simulink Data Dictionary using the given Signal and Calibration Data List.

The following is the SLDD file :

Solver configuration parameter :

• Solver type : Fixed
• Solver : discrete ( no continuous states ) Sample time : 0.01
• Code generation Parameters : System target file : ert.tlc ( Embedded Coder ).

Designing MATLAB Simulink Model :

• The Input Voltage , input Switch , and the Enable switch are the inputs to the system , and the Output Display is the final Output from the system .

Requirement No 1:

• Input Signal “Input_Voltage” is compared against voltage values “VOLTAGE_MINIMUM_RANGE” & “VOLTAGE_MAXIMUM_RANGE”.
• Incoming input signal “Input_Voltage” must be greater than – equal to “VOLTAGE_MINIMUM_RANGE” and less than – equal to “VOLTAGE_MAXIMUM_RANGE”.
• Output signal from here is “Optimum_Voltage” which will be one of the inputs to the subsystem “DisplayUnit”.

Requirement No 2 (DisplayUnit Subsystem):

• Input Signals are “Optimum_Voltage”, “Input_Switch”,“Enable_Display”. Signal “Enable_Display” must be saturated between the range 0 – 7. Output signal from the subsystem is “Output_Display”.
• Input Signal “Enable_Display” is compared against pre – defined set of values in a multiport switch. Total data ports in the multiport switch is 5.
• Multiport switch inputs 1 & 2 is connected to calibration signal “ON_MODE”, Multiport switch inputs 3 & 4 is connected to calibration signal “OFF_MODE” while Multiport switch input 5 is connected to calibration signal “STANDBY_MODE”.
• The output from Multiport switch is connected to the first input port of the Switch block. The third input port of the Switch block is connected to the calibration signal “NO_DISPLAY”.
• Meanwhile NOT value of input signal “Input_Switch” is compared in an AND gate against input signal “Optimum_Voltage” and the output from comparing if calibration signals “INTERRUPT_1” & “INTERRUPT_2” are equal. The output of the AND gate is the second input of the switch block.
• The output from the switch block is “Output_Display”.

Requirement Tagging :

• Requirements can be a tag to requirement 1 & requirement 2 to their corresponding subsystems with word files.

Model Advisor Check :

• Model Advisor Check on Modelling Standards for MAAB .
• Model Advisor Check completed with 14 warning and 128 check passed.
• There are warinings that are acceptable but the notable part is that there is not a single failed result.
• 
• 

Model Advisor Report :

• Model Advisor Report can be generated,we can choose the format HTML,PDF or Word Format.
• HTML Report is generated and saved in the directory.
• 

Code generation :

• By using the embedded coder app we can generate code and build our model.
• Successfully conducted model build and generated code . The generated codes and files can be seen in the current directory .

Code Generation Report:

• Successfully conducted model build and generated code. The generated codes and files can be seen in the current directory.
• Code :
  /*
  

  * Event Support License -- for demonstration use and event support. Not
  

  * for government, research, commercial, or other organizational use.
  

  *
  

  * File: Project_traffic_Jam_Assist.c
  

  *
  

  * Code generated for Simulink model 'Project_traffic_Jam_Assist'.
  

  *
  

  * Model version : 1.4
  

  * Simulink Coder version : 9.8 (R2022b) 13-May-2022
  

  * C/C++ source code generated on : Mon Feb 20 10:39:54 2023
  

  *
  

  * Target selection: ert.tlc
  

  * Embedded hardware selection: Intel->x86-64 (Windows64)
  

  * Code generation objectives: Unspecified
  

  * Validation result: Not run
  

  */
  

  #include "Project_traffic_Jam_Assist.h"
  

  #include "rtwtypes.h"
  

  #include "Project_traffic_Jam_Assist_private.h"
  

  #include "Traffic_Jam_Assist.h"
  

  /* Exported data definition */
  

  /* Definition for custom storage class: ExportToFile */
  

  uint8_T Output_Display; /* '<S3>/Switch' */
  

  /* Real-time model */
  

  static RT_MODEL_Project_traffic_Jam__T Project_traffic_Jam_Assist_M_;
  

  RT_MODEL_Project_traffic_Jam__T *const Project_traffic_Jam_Assist_M =
  

  &Project_traffic_Jam_Assist_M_;
  

  static void rate_scheduler(void);
  

  /*
  

  * This function updates active task flag for each subrate.
  

  * The function is called at model base rate, hence the
  

  * generated code self-manages all its subrates.
  

  */
  

  static void rate_scheduler(void)
  

  {
  

  /* Compute which subrates run during the next base time step. Subrates
  

  * are an integer multiple of the base rate counter. Therefore, the subtask
  

  * counter is reset when it reaches its limit (zero means run).
  

  */
  

  (Project_traffic_Jam_Assist_M->Timing.TaskCounters.TID[1])++;
  

  if ((Project_traffic_Jam_Assist_M->Timing.TaskCounters.TID[1]) > 99) {/* Sample time: [1.0s, 0.0s] */
  

  Project_traffic_Jam_Assist_M->Timing.TaskCounters.TID[1] = 0;
  

  }
  

  }
  

  /* Model step function */
  

  void Project_traffic_Jam_Assist_step(void)
  

  {
  

  /* local block i/o variables */
  

  boolean_T Optimum_Voltage;
  

  if (Project_traffic_Jam_Assist_M->Timing.TaskCounters.TID[1] == 0) {
  

  /* Logic: '<S2>/AND' incorporates:
  

  * Constant: '<S2>/Constant'
  

  * Constant: '<S2>/Constant1'
  

  * Inport: '<Root>/Input_Voltage'
  

  * RelationalOperator: '<S2>/GreaterThanOrEqual'
  

  * RelationalOperator: '<S2>/GreaterThanOrEqual1'
  

  */
  

  Optimum_Voltage = ((Input_Voltage >= VOLTAGE_MINIMUM_RANGE) &&
  

  (Input_Voltage <= VOLTAGE_MAXIMUM_RANGE));
  

  /* Switch: '<S3>/Switch' incorporates:
  

  * Constant: '<S3>/Constant5'
  

  * Constant: '<S3>/Constant6'
  

  * Inport: '<Root>/Input_Switch'
  

  * Logic: '<S3>/AND'
  

  * Logic: '<S3>/NOT'
  

  * RelationalOperator: '<S3>/Equal'
  

  */
  

  if ((INTERRUPT_1 == INTERRUPT_2) && Optimum_Voltage && (!Input_Switch)) {
  

  /* MultiPortSwitch: '<S3>/Multiport Switch' incorporates:
  

  * Constant: '<S3>/Constant'
  

  * Switch: '<S3>/Switch'
  

  */
  

  Output_Display = ON_MODE;
  

  } else {
  

  /* Switch: '<S3>/Switch' incorporates:
  

  * Constant: '<S3>/Constant7'
  

  */
  

  Output_Display = NO_DISPLAY;
  

  }
  

  /* End of Switch: '<S3>/Switch' */
  

  }
  

  rate_scheduler();
  

  }
  

  /* Model initialize function */
  

  void Project_traffic_Jam_Assist_initialize(void)
  

  {
  

  /* (no initialization code required) */
  

  }
  

  /* Model terminate function */
  

  void Project_traffic_Jam_Assist_terminate(void)
  

  {
  

  /* (no terminate code required) */
  

  }
  

  /*
  

  * File trailer for generated code.
  

  *
  

  * [EOF]
  

  */
  

  Conclusion :

  Developed a model of single feature of Traffice Jam Assist as per MAAB Guidelines as well as created Simulink Data Dictionary using MATLAB & Simulink.Generated a code using Embedde Coder and generated a Model Advisor Report.