Vault 7: Projects
This publication series is about specific projects related to the Vault 7 main publication.
MPLAB X project layout
In most example projects distributed with MLA, the name of each MPLAB X IDE build configuration will match the name of
the associated folder under the
system_config
folder in the project (the
exp16_pic24fj128ga010_pmp8_gfxv3_qvgav1
folder in the sample project). When a specific MPLAB X IDE
configuration is selected, the configuration files for that configuration are included in the build and the configuration files in
other configuration folders are excluded from the build.
Configuration Files:
•
system_config.h
•
system.h
•
system.c
Above files normally make up a complete configuration of the system. The purpose of each of these files is described in
more detail in the following sections. But, the basic idea is that you may want different configurations of your application for
different physical hardware boards, different Microchip microcontrollers, or different feature sets, depending on your specific
needs.
The "framework" folder
The "framework" logical folder contains all of the project relevant framework module source files. Depending on your project,
there can be many files and sub folders under this folder. These files are for MLA libraries that you should not need to edit.
In most cases, the "logical folder" organization within the MPLAB X project matches exactly with the physical directory
organization. This is done to keep things simple and consistent so you only need to learn a single layout. But, there are a
couple of notable exceptions.
1. MPLAB has a convention of splitting out "Header Files" (".h" files) and "Source Files" (".c" files), so the virtual folder
organization in the MPLAB X project separates the files and the physical directories on disk do not.
2. In an MLA example project, the "app" folder will correspond to the "src" directory on disk under the application's main
folder.
The project demonstrated in the MPLAB X Project Layout above is represented as follows on the hard disk,
1.4 Project Layout MLA - Getting Started Help
10
1
Protego_Release_01_05-Related-OEM-Documentation-MLA_v2013_12_20-help_mla_getting_started.pdf