HI-TIDE^™ 1 (v1.2) to HI-TIDE^™ 3 (v3.00) Migration

Overview

This document will describe possible migration path for porting HI-TIDE^™ 1 (v1.2) projects to HI-TIDE^™ 3 (v3.00) projects. The migration path is a description of the manual steps needed to be able to port a project created by HI-TIDE 1 to HI-TIDE 3. The sections covered will be porting files, porting compiler options and a quick note about the debugger.

Debugger

Debugger migration is not covered in detail in this document but there is a cheatsheet included with HI-TIDE 3 that provides a tutorial on the debuggers usage. The cheatsheet called Debugger and Simulator can be accessed from the Help->Cheatsheets... menu.

HI-TIDE 3 includes a PIC18 simulator, but does not include virtual I/O. Also, there are some minor limitations to the simulator. Please see the compiler's release notes for detailed information.

Porting Files

To port the files from a HI-TIDE 1 project, you will first need to create a HI-TIDE 3 project. An outline of how HI-TIDE 3 work at this point may be helpful. Usually, projects and the files that are contained in them are stored in a workspace directory. The workspace directory is actually a directory on the file system. The files that are displayed from within HI-TIDE 3 are the same files that are in the workspace on the file system. If the files are deleted from the project the files are deleted from the file system. HI-TIDE 3 also allows an advanced usage where links to external (outside the workspace) projects can be created. In this guide, a link to the external project will be created.

Step 1: To create the external project that links to an existing HI-TIDE 1 project, select File->New->Project... from the file menu.

Step 2: Select PICC-18^™ Project from the Select a wizard page.

Step 3: After selecting Next, a page that allows the name of the project to be specified and optionally a non-default location will appear. Specify the name for the project in the text box labelled Project name (this name can be the same name as the HI-TIDE 1 project). Uncheck the check box labelled Use Default, then specify the path to the directory containing your HI-TIDE 1 project.

Step 4: The following wizard pages should be straight forward, although note that a main function is created by default. To prevent the creation of the main function the Create main function check box should be unchecked on the Confirm project configuration page of the wizard.

Step 5: When the new project wizard is complete all the files in the HI-TIDE 1 project will appear in the new HI-TIDE 3 project. Source files, output files and the HI-TIDE 1 project file will appear in the project. The output files can be moved or deleted as they are no longer required at that location. Remember, keep the HI-TIDE 1 project file there until compiler options have been ported. Hint, files can be dragged and dropped from HI-TIDE 3 to the system file explorer. The output files that are generated by HI-TIDE 3 can be found in the Release or Debug directories of the project.

*Note: The process described above is most useful if there is only one project in a particular directory. If there are two or more projects in a particular directory, a better approach would be to create a project in the default location (leave the Use Default* check box selected on the HI-TECH Project Wizard page) and import the files for that project. This approach is covered in the Importing External Files cheatsheet which can be accessed from the Help->Cheatsheets... menu.

Porting Compiler Options

Many options from HI-TIDE 1 are directly mappable to option in HI-TIDE 3, although some options may have changed in appearance. Some options are similar but have been simplified such as the ROM memory options. These options, the directly mappable and the similar options are shown below. On the left are the HI-TIDE 1 options; on the right are the HI-TIDE 3 options. An arrow, pointing from left to right, indicates where the option is in HI-TIDE 1 to where it is in HI-TIDE 3.

There are new options that have been added in HI-TIDE 3 which are not covered in this document. Also, some options that are in HI-TIDE 1 are no longer available in HI-TIDE 3 as the compiler no longer supports the options or the option has become redundant.

For details on the functionality of the options, please consult the corresponding command line options in the compiler manual.

Available Options Described Below: