Real-Time Workshop®

File Paths and Naming Conventions

Compile Path Search Order

Embedded MATLAB Coder resolves M-functions by searching first on the Embedded MATLAB path and then on the MATLAB path. See How the Embedded MATLAB Subset Resolves Function Calls in the Embedded MATLAB documentation.

Back to Top

Can I Add Files to the Embedded MATLAB Path?

With Embedded MATLAB Coder, you can prepend directories and files to the Embedded MATLAB path, as described in Adding Directories to Search Paths. By default, the Embedded MATLAB path contains the current directory and the Embedded MATLAB libraries.

Back to Top

When to Use the Embedded MATLAB Path

Use the Embedded MATLAB path to override a MATLAB function with a customized version. Because Embedded MATLAB Coder searches the Embedded MATLAB path first, an M-file on the Embedded MATLAB path always shadows an M-file of the same name on the MATLAB path. To override a MATLAB function with a version implemented in Embedded MATLAB libraries, follow these steps:

1. Create each version of the M-function in identically-named M-files.

2. Add the MATLAB version of the function to the MATLAB path.

3. Add the Embedded MATLAB version of the function to the Embedded MATLAB path.

   See Adding Directories to Search Paths.

Back to Top

Adding Directories to Search Paths

The following table explains how to add directories to search paths:

Back to Top

Naming Conventions

Embedded MATLAB Coder enforces naming conventions for M-functions and generated files.

• Reserved Prefixes

• Conventions for Naming Generated files

Reserved Prefixes

Embedded MATLAB Coder reserves the prefix eml for global C functions and variables in generated code. For example, Embedded MATLAB runtime library function names all begin with the prefix emlrt, such as emlrtCallMATLAB. To avoid naming conflicts, do not name C functions or primary M-functions with the prefix eml.

Conventions for Naming Generated files

The following table describes how Embedded MATLAB Coder names generated files. Embedded MATLAB Coder follows MATLAB conventions by providing platform-specific extensions for C MEX files.

Back to Top

Setting Up the C Compiler

Making M-Code Compliant with the Embedded MATLAB Subset