FMSHProjectGenerator 0.0.28

FMSH(Fudan Microelectronics) general-purpose MCU families IDE project generator.

FMSH Project Generator is a project generation tool for FuDan Microelectronics general-purposed MCU families:

• FM33LC0

• FM33LG0(A)

• FM33LE0(A)

• FM33FR0

• FM33FT0A

• FM33FG0A

• FM33LF0

• FM33FK5

• FM33FH0

• FM33HT0A

• FM33LR0

• FM33LV0A

• FM33LD5

• FM33FC5

• FM33LH0

• FM33CT0A

• upcoming MCUs…

FMSH Project Generator allows you to define a project using .YAML files. It can generate IDE project based on the .yaml record, and one should never spend a lot of time again migrating their projects among these IDEs. it also featured a ‘import project’ function, which allows user to generate their YAML project files more conveniently from presenting IDE projects.

This project is inspired by open-sourced project project_generator.

Installing

Install and update using pip:

$ pip install -U FMSHProjectGenerator

How to use

User should first create an instance of ProjectGenerator before using any of the functions:

from FMSHProjectGenerator import ProjectGenerator

proj_gen = ProjectGenerator()

Generate IDE Project

Following code example demonstrated how to use FMSHProjectGenerator and a project description file(*.yaml) to generate IDE project (Keil5 project for this example, wich will generated in ./my_project_path/MDK-ARM):

from FMSHProjectGenerator.generators import Keil5Generator, Keil5VersionType
from FMSHProjectGenerator import ProjectGenerator

# create an instance
proj_gen = ProjectGenerator()

# generate KEIL5 project using input YAML
proj_gen.generate(dest_prj_path='./my_project_path',
                   generator=Keil5Generator(),
                   generator_version=Keil5VersionType.V5,
                   input_desc='./my_project_path/project.yaml')

User can also generate IDE project using existing dict, which makes the FMSHProjectGenerator easier to work with other project. Just modify the input_desc param to the dict which describes your project:

proj_desc = {
   # Your project description here
}

proj_gen.generate(dest_prj_path='./my_project_path',
                   generator=Keil5Generator(),
                   generator_version=Keil5VersionType.V5,
                   input_desc=proj_desc)

the generate function can accepts keyword args depending on the generator you used. For example, Keil5Generator class accepts the combine arg to control whether it should combine existing project(which has the same name) into the generated project:

proj_gen.generate(dest_prj_path='./my_project_path',
                  generator=Keil5Generator(),
                  generator_version=Keil5VersionType.V5,
                  input_desc=proj_desc,
                  combine=True)

Import IDE Project

Following code example demonstrated how to use FMSHProjectGenerator to import IDE project (Keil5 project for this example, which will generated the project YAML file as ./my_project_path/project.yaml):

from FMSHProjectGenerator.converters import Keil5Converter
from FMSHProjectGenerator import ProjectGenerator

# create an instance
proj_gen = ProjectGenerator()

# convert KEIL5 project(will automatically search required project files)
proj_gen.convert(src_prj_path='./my_project_path',
                   converter=Keil5Converter(),
                   output_file='./my_project_path/project.yaml')

Noet that the convert function also return the generated project description in order to cooperate with other programs.

Import and Generate IDE Project

After import or generate an IDE project, ProjectGenerator will always retain the latest project information. So it’s easy to import from one IDE Project and generate other IDEs’ Project:

from FMSHProjectGenerator.converters import Keil5Converter
from FMSHProjectGenerator.generators import IARGenerator, IARVersionType
from FMSHProjectGenerator import ProjectGenerator

# create an instance
proj_gen = ProjectGenerator()

# convert KEIL5 project
proj_gen.convert(src_prj_path='./my_project_path',
                   converter=Keil5Converter())

# generate IAR 8.32 project using retained info
proj_gen.generate(dest_prj_path='./my_project_path',
                   generator=IARGenerator(),
                   generator_version=IARVersionType.V8_32)

User should notice that the ‘generate’ and ‘convert’ function can both omit the ‘input/output_file’ option, which tells the Project Generator to generate/import IDE Project using/updating retained project information only.

Command line usage

FMSH Project Generator also provides a command line tool to convert project(s):

Usage: fmshproject convert [OPTIONS] PROJECT_PATH {Keil5|IAR}
                          {Keil5|Keil5_27|Keil5_32|IAR7|IAR8_32}

Status of the project

The project is now in alpha phase.