Migrating To External User Code Handling

This section will give you an overview how to migrate your DaVinci Project to the new User Code Handling in the DaVinci Configurator Classic Version 6.

Why You Need to Migrate?

The DaVinci Configurator Version 6 introduces a new approach to managing user code blocks during source file generation. Instead of automatically handling user code blocks, an external tool provides a mechanism to include user code blocks into the generated data.

This change separates the user code from the generated files, which allows you to use performance optimizations and better version control for user modifications.

Migrate DaVinci Project to the new User Code Handling

  1. Secure that you have up-to-date generated files. If you are not sure, generate the source files with the DaVinci Configurator Version 5.

  2. Use the DaVinci User Code Tool to extract the user code blocks from the generated files.

    The DaVinci User Code Tool is located in the BSW Package directory under: Misc/DaVinciUserCodeTool/Application.

    $ DvUCT.bat store -r=<PathToGenData> -u=<PathToUserCodeFiles>

    This command extracts all user code blocks from the generated files located in <PathToGenData> and saves them into separate *.ucb files in the <PathToUserCodeFiles> directory. For more information about the DaVinci User Code Tool, refer to the section "Generate Source Files with Custom User Code Blocks".

  3. If not already existing, add an external generation step for the DaVinci User Code Tool, which is triggered after the generation.

    See Generate Source Files with Custom User Code Blocks for instruction to add an external generation step.