외부 코드 통합하기

사용자 지정 고정소수점 S-Function을 사용한 외부 코드 통합

사용자 지정 고정소수점 S-Function을 사용하여 외부 코드를 통합할 수 있습니다.

함수

사용자 지정 고정소수점 S-Function을 위한 API

데이터형 변환

`ssFxpConvert`	Convert value from one data type to another
`ssFxpConvertFromRealWorldValue`	Convert value of data type `double` to another data type
`ssFxpConvertToRealWorldValue`	Convert value of any data type to `double`

U32 비트 영역

`ssFxpGetU32BitRegion`	Return stored integer value for 32-bit region of real, scalar signal element
`ssFxpGetU32BitRegionCompliant`	Determine whether S-function is compliant with the U32 bit region interface
`ssFxpSetU32BitRegion`	Set stored integer value for 32-bit region of real, scalar signal element
`ssFxpSetU32BitRegionCompliant`	Declare compliance with the U32 bit region interface for fixed-point data types with 33 or more bits

등록된 데이터형 정보

`ssGetDataTypeBias`	Return bias of registered data type
`ssGetDataTypeFixedExponent`	Return exponent of slope of registered data type
`ssGetDataTypeFracSlope`	Return fractional slope of registered data type
`ssGetDataTypeFractionLength`	Return fraction length of registered data type with power-of-two scaling
`ssGetDataTypeFxpContainWordLen`	Return word length of storage container of registered data type
`ssGetDataTypeFxpIsSigned`	Determine whether fixed-point registered data type is signed or unsigned
`ssGetDataTypeIsDoubleSingleorHalf`	Determine whether registered data type is double, single, or half-precision data type (R2020b 이후)
`ssGetDataTypeFxpWordLength`	Return word length of fixed-point registered data type
`ssGetDataTypeIsFixedPoint`	Determine whether registered data type is fixed-point data type
`ssGetDataTypeIsFloatingPoint`	Determine whether registered data type is floating-point data type
`ssGetDataTypeIsFxpFltApiCompat`	Determine whether registered data type is supported by API for user-written fixed-point S-functions
`ssGetDataTypeIsHalfPrecision`	Determine whether registered data type is half-precision data type (R2020b 이후)
`ssGetDataTypeIsScalingPow2`	Determine whether registered data type has power-of-two scaling
`ssGetDataTypeIsScalingTrivial`	Determine whether scaling of registered data type is slope = 1, bias = 0
`ssGetDataTypeNumberOfChunks`	Return number of chunks in multiword storage container of registered data type
`ssGetDataTypeStorageContainCat`	Return storage container category of registered data type
`ssGetDataTypeStorageContainerSize`	Return storage container size of registered data type
`ssGetDataTypeTotalSlope`	Return total slope of scaling of registered data type

시뮬레이션 중에 수집된 정보 기록

ssLogFixptInstrumentation Record information collected during simulation

고정소수점 데이터형 등록

`ssRegisterDataTypeFxpSlopeBias`	Register data type with [Slope Bias] scaling and return its data type ID
`ssRegisterDataTypeHalfPrecision`	Register half-precision data type and return its data type ID (R2020b 이후)
`ssRegisterDataTypeFxpScaledDouble`	Register scaled double data type with [Slope Bias] scaling specified in terms of fractional slope, fixed exponent, and bias, and return its data type ID
`ssRegisterDataTypeFxpFSlopeFixExpBias`	Register fixed-point data type with [Slope Bias] scaling specified in terms of fractional slope, fixed exponent, and bias, and return its data type ID
`ssRegisterDataTypeFxpBinaryPoint`	Register fixed-point data type with binary-point-only scaling and return its data type ID

도움말 항목

Data Type Support
Lists the data types supported by the API and discusses the treatment of integers and data-type-overridden signals.
Structure of the S-Function
Displays the basic structure of an S-function that directly handles fixed-point data types.
Storage Containers
Discusses the containers used to hold signals in simulation and code generation.
Data Type IDs
Describes the creation, assignment, and usage of data type IDs, including how to get and set information about data types in an S-function.
Overflow Handling and Rounding Methods
Discusses the tokens you can use to define overflow handling and rounding methods in your fixed-point S-function, and describes the overflow logging structure.
Create MEX-Files
Describes the extra steps that you need to take to create MEX-files for fixed-point S-functions.
Get the Input Port Data Type
Within your S-function, you might need to know the data types of different ports, run-time parameters, and DWorks.
Set the Output Port Data Type
You may want to set the data type of various ports, run-time parameters, or DWorks in your S-function.
Interpret an Input Value
Suppose you need to get the value of the signal on your input port to use in your S-function.
Write an Output Value
Suppose you need to write the value of the output signal to the output port in your S-function.
Determine Output Type Using the Input Type
Using the data type of the input to your S-function to calculate the output data type.

추천 예제

Fixed-Point S-Functions: Querying Properties

Several ways to use S-functions to probe signal properties. Use this model for simulation only; it does not support code generation.

스크립트 열기

Fixed-Point S-Functions: Arithmetic Shift

A custom C language S-function written to perform an arithmetic shift. This operation is available in Simulink® with the "Shift Arithmetic" block, which can be used for comparison with this S-function example.

스크립트 열기

Fixed-Point S-Functions: Fixed-Point Source

A custom C language S-function written to generate a constant value. This operation is available in Simulink® with the "Constant" block, which can be used for comparison with this S-function example.

스크립트 열기

고정소수점 S-Function: 데이터형 전파

이 모델은 고정소수점 S-Function에서 고정소수점 데이터형을 전파하는 방법을 보여줍니다. 여기서는 여러 신호에 데이터형을 적용하기 위해 작성된 사용자 지정 C 언어 S-Function을 실행합니다. 이 작업은 "Data Type Propagation" 블록을 사용하여 Simulink®에서 수행할 수 있으며, 이 S-Function 예제와 결과를 비교해 볼 수 있습니다.

스크립트 열기

고정소수점 S-Function: 곱과 합

이 모델에서는 고정소수점 "곱과 합" 연산을 계산하기 위해 작성된 사용자 지정 C 언어 S-Function을 실행하는 방법을 보여줍니다. S-Function의 소스 코드를 보려면 마우스 오른쪽 버튼을 클릭하여 나타나는 상황별 메뉴를 사용하여 "블록 파라미터"를 선택하십시오. 대화 상자가 표시되면 편집 버튼을 누릅니다.

스크립트 열기