hm/slhal
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

增加时钟模块

Browse Source
This commit is contained in:
Matthew GONG
2020-03-26 08:58:58 +08:00
parent d97d5e1822
commit 6a49528cc8
9 changed files with 420 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
CHANGELOG.md
+1
View File
@@ -23,3 +23,4 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
- add hal_api for uart/nvram/ctrls/sens
- dummy mode for nvram in MIL simulation
- add clock
README.md
+9
View File
@@ -388,6 +388,8 @@ hal_sen_read_Outputs_wrapper函数用于提取信号向量，如果hal_sen_read_
## hal_api_general库
### hal_general_in/out模块
hal_api_general.slx实现了对最通用的接口抽象，其中包含了S-function hal_general_in/out。
hal_general_in/out模块用于根据名称调用注册的函数。
@@ -415,6 +417,13 @@ pW定义 | 类型 | 说明
hal_general_in/out_Outputs_wrapper函数根据pw[0]与pw[1]调用函数。作为一层壳，一般本函数无需修改。
### hal_clock模块
hal_clock模块提供硬件时间，根据选择输出 微秒或毫秒。
hal_clock模块通过hal_clock_wrapper.c文件实现其功能。
hal_clock_Start_wrapper函数用于调用单例函数initialize_clock初始化并关联硬件中断驱动的时钟。hal_clock_Outputs_wrapper函数根据typ[0]输出微秒或毫秒。
## 测试
工程使用Gitlab-CI实现自动化测试。当前测试项目`test/scriptTest.m`是通过代码生成与编译`hal_template.slx`模型，检查接口设计正确性。
hal_api_general.slx
BIN
View File
Binary file not shown.
hal_api_general_bld.slx
BIN
View File
Binary file not shown.
hal_clock.c
+260
View File
@@ -0,0 +1,260 @@
/*
* File: hal_clock.c
*
*
* --- THIS FILE GENERATED BY S-FUNCTION BUILDER: 3.0 ---
*
* This file is an S-function produced by the S-Function
* Builder which only recognizes certain fields. Changes made
* outside these fields will be lost the next time the block is
* used to load, edit, and resave this file. This file will be overwritten
* by the S-function Builder block. If you want to edit this file by hand,
* you must change it only in the area defined as:
*
* %%%-SFUNWIZ_defines_Changes_BEGIN
* #define NAME 'replacement text'
* %%% SFUNWIZ_defines_Changes_END
*
* DO NOT change NAME--Change the 'replacement text' only.
*
* For better compatibility with the Simulink Coder, the
* "wrapper" S-function technique is used. This is discussed
* in the Simulink Coder's Manual in the Chapter titled,
* "Wrapper S-functions".
*
* -------------------------------------------------------------------------
* | See matlabroot/simulink/src/sfuntmpl_doc.c for a more detailed template |
* -------------------------------------------------------------------------
*
* Created: Thu Mar 26 08:37:57 2020
*/
#define S_FUNCTION_LEVEL 2
#define S_FUNCTION_NAME hal_clock
/*<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<*/
/* %%%-SFUNWIZ_defines_Changes_BEGIN --- EDIT HERE TO _END */
#define NUM_INPUTS 0
#define NUM_OUTPUTS 1
/* Output Port 0 */
#define OUT_PORT_0_NAME boot_time
#define OUTPUT_0_WIDTH 1
#define OUTPUT_DIMS_0_COL 1
#define OUTPUT_0_DTYPE uint32_T
#define OUTPUT_0_COMPLEX COMPLEX_NO
#define OUT_0_FRAME_BASED FRAME_NO
#define OUT_0_BUS_BASED 0
#define OUT_0_BUS_NAME
#define OUT_0_DIMS 1-D
#define OUT_0_ISSIGNED 1
#define OUT_0_WORDLENGTH 8
#define OUT_0_FIXPOINTSCALING 1
#define OUT_0_FRACTIONLENGTH 3
#define OUT_0_BIAS 0
#define OUT_0_SLOPE 0.125
#define NPARAMS 1
/* Parameter 0 */
#define PARAMETER_0_NAME typ
#define PARAMETER_0_DTYPE uint8_T
#define PARAMETER_0_COMPLEX COMPLEX_NO
#define SAMPLE_TIME_0 INHERITED_SAMPLE_TIME
#define NUM_DISC_STATES 0
#define DISC_STATES_IC [0]
#define NUM_CONT_STATES 0
#define CONT_STATES_IC [0]
#define SFUNWIZ_GENERATE_TLC 1
#define SOURCEFILES "__SFB__"
#define PANELINDEX 8
#define USE_SIMSTRUCT 0
#define SHOW_COMPILE_STEPS 0
#define CREATE_DEBUG_MEXFILE 0
#define SAVE_CODE_ONLY 0
#define SFUNWIZ_REVISION 3.0
/* %%%-SFUNWIZ_defines_Changes_END --- EDIT HERE TO _BEGIN */
/*<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<*/
#include "simstruc.h"
#define PARAM_DEF0(S) ssGetSFcnParam(S, 0)
#define IS_PARAM_UINT8(pVal) (mxIsNumeric(pVal) && !mxIsLogical(pVal) &&\
!mxIsEmpty(pVal) && !mxIsSparse(pVal) && !mxIsComplex(pVal) && mxIsUint8(pVal))
extern void hal_clock_Start_wrapper(const uint8_T *typ, const int_T p_width0);
extern void hal_clock_Outputs_wrapper(uint32_T *boot_time,
const uint8_T *typ, const int_T p_width0);
/*====================*
* S-function methods *
*====================*/
#define MDL_CHECK_PARAMETERS
#if defined(MDL_CHECK_PARAMETERS) && defined(MATLAB_MEX_FILE)
/* Function: mdlCheckParameters =============================================
* Abstract:
* Verify parameter definitions and types.
*/
static void mdlCheckParameters(SimStruct *S)
{
int paramIndex = 0;
bool invalidParam = false;
/* All parameters must match the S-function Builder Dialog */
{
const mxArray *pVal0 = ssGetSFcnParam(S, 0);
if (!IS_PARAM_UINT8(pVal0)) {
invalidParam = true;
paramIndex = 0;
goto EXIT_POINT;
}
}
EXIT_POINT:
if (invalidParam) {
char parameterErrorMsg[1024];
sprintf(parameterErrorMsg, "The data type and or complexity of parameter %d does not match the "
"information specified in the S-function Builder dialog. "
"For non-double parameters you will need to cast them using int8, int16, "
"int32, uint8, uint16, uint32 or boolean.", paramIndex + 1);
ssSetErrorStatus(S, parameterErrorMsg);
}
return;
}
#endif /* MDL_CHECK_PARAMETERS */
/* Function: mdlInitializeSizes ===============================================
* Abstract:
* Setup sizes of the various vectors.
*/
static void mdlInitializeSizes(SimStruct *S)
{
DECL_AND_INIT_DIMSINFO(outputDimsInfo);
ssSetNumSFcnParams(S, NPARAMS); /* Number of expected parameters */
#if defined(MATLAB_MEX_FILE)
if (ssGetNumSFcnParams(S) == ssGetSFcnParamsCount(S)) {
mdlCheckParameters(S);
if (ssGetErrorStatus(S) != NULL) {
return;
}
} else {
return; /* Parameter mismatch will be reported by Simulink */
}
#endif
ssSetArrayLayoutForCodeGen(S, SS_COLUMN_MAJOR);
ssSetSimStateCompliance(S, USE_DEFAULT_SIM_STATE);
ssSetNumContStates(S, NUM_CONT_STATES);
ssSetNumDiscStates(S, NUM_DISC_STATES);
if (!ssSetNumInputPorts(S, NUM_INPUTS)) return;
if (!ssSetNumOutputPorts(S, NUM_OUTPUTS)) return;
ssSetOutputPortWidth(S, 0, OUTPUT_0_WIDTH);
ssSetOutputPortDataType(S, 0, SS_UINT32);
ssSetOutputPortComplexSignal(S, 0, OUTPUT_0_COMPLEX);
ssSetNumPWork(S, 0);
ssSetNumSampleTimes(S, 1);
ssSetNumRWork(S, 0);
ssSetNumIWork(S, 0);
ssSetNumModes(S, 0);
ssSetNumNonsampledZCs(S, 0);
ssSetSimulinkVersionGeneratedIn(S, "9.2");
/* Take care when specifying exception free code - see sfuntmpl_doc.c */
ssSetOptions(S, (SS_OPTION_EXCEPTION_FREE_CODE |
SS_OPTION_USE_TLC_WITH_ACCELERATOR |
SS_OPTION_WORKS_WITH_CODE_REUSE));
}
/* Function: mdlInitializeSampleTimes =========================================
* Abstract:
* Specifiy the sample time.
*/
static void mdlInitializeSampleTimes(SimStruct *S)
{
ssSetSampleTime(S, 0, SAMPLE_TIME_0);
ssSetModelReferenceSampleTimeDefaultInheritance(S);
ssSetOffsetTime(S, 0, 0.0);
}
#define MDL_SET_OUTPUT_PORT_DATA_TYPE
static void mdlSetOutputPortDataType(SimStruct *S, int port, DTypeId dType)
{
ssSetOutputPortDataType(S, 0, dType);
}
#define MDL_SET_DEFAULT_PORT_DATA_TYPES
static void mdlSetDefaultPortDataTypes(SimStruct *S)
{
ssSetOutputPortDataType(S, 0, SS_DOUBLE);
}
#define MDL_SET_WORK_WIDTHS
#if defined(MDL_SET_WORK_WIDTHS) && defined(MATLAB_MEX_FILE)
static void mdlSetWorkWidths(SimStruct *S)
{
const char_T *rtParamNames[] = {"P1"};
ssRegAllTunableParamsAsRunTimeParams(S, rtParamNames);
}
#endif
#define MDL_START /* Change to #undef to remove function */
#if defined(MDL_START)
/* Function: mdlStart =======================================================
* Abstract:
* This function is called once at start of model execution. If you
* have states that should be initialized once, this is the place
* to do it.
*/
static void mdlStart(SimStruct *S)
{
const int_T p_width0 = mxGetNumberOfElements(PARAM_DEF0(S));
const uint8_T *typ = (const uint8_T *) mxGetData(PARAM_DEF0(S));
hal_clock_Start_wrapper(typ, p_width0);
}
#endif /* MDL_START */
/* Function: mdlOutputs =======================================================
*
*/
static void mdlOutputs(SimStruct *S, int_T tid)
{
uint32_T *boot_time = (uint32_T *) ssGetOutputPortRealSignal(S, 0);
const int_T p_width0 = mxGetNumberOfElements(PARAM_DEF0(S));
const uint8_T *typ = (const uint8_T *) mxGetData(PARAM_DEF0(S));
hal_clock_Outputs_wrapper(boot_time, typ, p_width0);
}
/* Function: mdlTerminate =====================================================
* Abstract:
* In this function, you should perform any actions that are necessary
* at the termination of a simulation. For example, if memory was
* allocated in mdlStart, this is the place to free it.
*/
static void mdlTerminate(SimStruct *S)
{
}
#ifdef MATLAB_MEX_FILE /* Is this file being compiled as a MEX-file? */
#include "simulink.c" /* MEX-file interface mechanism */
#else
#include "cg_sfun.h" /* Code generation registration function */
#endif
hal_clock.mexw64
BIN
View File
Binary file not shown.
hal_clock.tlc
+81
View File
@@ -0,0 +1,81 @@
%% File : hal_clock.tlc
%% Created : Thu Mar 26 08:37:57 2020
%%
%% Description:
%% Simulink Coder wrapper functions interface generated for
%% S-function "hal_clock.c".
%%
%% File generated by S-function Builder Block
%%
%% For more information on using the Target Language with the
%% Simulink Coder, see the Target Language Compiler manual
%% (under Simulink Coder) in the "Inlining S-Functions"
%% chapter under the section and subsection:
%% "Writing Block Target Files to Inline S-Functions",
%% "Function-Based or Wrappered Code".
%%
%implements hal_clock "C"
%% Function: BlockTypeSetup ===================================================
%%
%% Purpose:
%% Set up external references for wrapper functions in the
%% generated code.
%%
%function BlockTypeSetup(block, system) Output
%openfile externs
#ifdef __cplusplus
extern "C" {
#endif
extern void hal_clock_Start_wrapper(const uint8_T *typ, const int_T p_width0);
extern void hal_clock_Outputs_wrapper(uint32_T *boot_time,
const uint8_T *typ, const int_T p_width0);
extern void hal_clock_Terminate_wrapper(const uint8_T *typ, const int_T p_width0);
#ifdef __cplusplus
}
#endif
%closefile externs
%<LibCacheExtern(externs)>
%%
%endfunction
%% Function: Start ============================================================
%%
%function Start(block, system) Output
/* %<Type> Block: %<Name> */
%assign nelements1 = LibBlockParameterSize(P1)
%assign param_width1 = nelements1[0] * nelements1[1]
%if (param_width1) > 1
%assign pp1 = LibBlockMatrixParameterBaseAddr(P1)
%else
%assign pp1 = LibBlockParameterAddr(P1, "", "", 0)
%endif
hal_clock_Start_wrapper(%<pp1>, %<param_width1>);
%endfunction
%% Function: Outputs ==========================================================
%%
%% Purpose:
%% Code generation rules for mdlOutputs function.
%%
%function Outputs(block, system) Output
%%
%assign py0 = LibBlockOutputSignalAddr(0, "", "", 0)
%assign nelements1 = LibBlockParameterSize(P1)
%assign param_width1 = nelements1[0] * nelements1[1]
%if (param_width1) > 1
%assign pp1 = LibBlockMatrixParameterBaseAddr(P1)
%else
%assign pp1 = LibBlockParameterAddr(P1, "", "", 0)
%endif
hal_clock_Outputs_wrapper(%<py0>, %<pp1>, %<param_width1>);
%%
%endfunction
%% [EOF] hal_clock.tlc
hal_template.slx
BIN
View File
Binary file not shown.
template/hal_clock_wrapper.c
+69
View File
@@ -0,0 +1,69 @@
/*
* Include Files
*
*/
#if defined(MATLAB_MEX_FILE)
#include "tmwtypes.h"
#include "simstruc_types.h"
#else
#include "rtwtypes.h"
#endif
/* %%%-SFUNWIZ_wrapper_includes_Changes_BEGIN --- EDIT HERE TO _END */
#ifdef HAL_IMPL
/* TODO include files */
#endif
/* %%%-SFUNWIZ_wrapper_includes_Changes_END --- EDIT HERE TO _BEGIN */
#define y_width 1
/*
* Create external references here.
*
*/
/* %%%-SFUNWIZ_wrapper_externs_Changes_BEGIN --- EDIT HERE TO _END */
static int is_init = 0;
static void initialize_clock()
{
if (!is_init)
{
#ifdef HAL_IMPL
/* TODO setup clock */
is_init = 1;
#endif
}
}
/* %%%-SFUNWIZ_wrapper_externs_Changes_END --- EDIT HERE TO _BEGIN */
/*
* Start function
*
*/
void hal_clock_Start_wrapper(const uint8_T *typ, const int_T p_width0)
{
/* %%%-SFUNWIZ_wrapper_Start_Changes_BEGIN --- EDIT HERE TO _END */
initialize_clock();
/* %%%-SFUNWIZ_wrapper_Start_Changes_END --- EDIT HERE TO _BEGIN */
}
/*
* Output function
*
*/
void hal_clock_Outputs_wrapper(uint32_T *boot_time,
const uint8_T *typ, const int_T p_width0)
{
/* %%%-SFUNWIZ_wrapper_Outputs_Changes_BEGIN --- EDIT HERE TO _END */
if (is_init)
{
#ifdef HAL_IMPL
//TODO get clock
// typ: 0 - msec; 1 - usec;
#endif
}
/* %%%-SFUNWIZ_wrapper_Outputs_Changes_END --- EDIT HERE TO _BEGIN */
}