/* ------------------------------------------------------------------------------------------------ */
/* FILE :        CreatingNewTarget.txt                                                              */
/*                                                                                                  */
/* CONTENTS :                                                                                       */
/*               Instructions to port demos to a new target											*/
/*                                                                                                  */
/*                                                                                                  */
/* Copyright (c) 2019, Code-Time Technologies Inc. All rights reserved.      	             		*/
/*                                                                                                  */
/* Code-Time Technologies retains all right, title, and interest in and to this work                */
/*                                                                                                  */
/* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS                          */
/* OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF                                       */
/* MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL                          */
/* THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR                             */
/* OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,                            */
/* ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR                            */
/* OTHER DEALINGS IN THE SOFTWARE.                                                                  */
/*                                                                                                  */
/*                                                                                                  */
/*  $Revision: 1.1 $                                                                                */
/*  $Date: 2019/02/19 01:06:20 $                                                                    */
/*                                                                                                  */
/* ------------------------------------------------------------------------------------------------ */

1 - You need to assign a new platform number for your target as it is not current supported.
    Read the file ../Platform/inc/Platform.h as it explains how to select the platform number and
    what information to add to fully define the new platform.
    Your newplatform number will likely be alike 0xFF#####

2 - You have to create projects for the new target.
    - Select an exiting project with the desired demo.  The current target for that demo is not
      important. Projects directories / folders located in the directory / folder Workspace.
    - Clean that project
    - Copy and Paste that project giving it a new name

3 - In the new project there is a file named Makefile. Edit it:
    - set the new target platform number in the assignment of PLATFORM
    - Add / modify any other set-up as required.

4 - In the Workspace (one level above the projects) there are a few Demo#_GCC.make files
    Look at the one for the desired demo and if at the top of the file there are some
    condition statements based on the platform number, i.e. ifeq ($(PLATFORM), ...
    You need to add a conditional for the new target platform:
        else ifeq ($(PLATFORM), ...
    Make sure to fill all the assignements with the values describing the new platform

5 - In the Workspace (one level above the project) there is a file named Common_GCC.make
    At the top of the file there are some conditional statements based on the platform number,
          i.e. ifeq ($(PLATFORM), ...
    Add a new conditional for the new platform:
        else ifeq ($(PLATFORM), ...
    And set the assignements with the values describing the new platform

6 - When creating the debug configuration, make sure to use the FPGA bitfile for the new platform

NOTE:
    In makefiles, conditionals are performed with string comparisons. So make sure the hex
    value assigned to PLATFORM in the Project's Makefile is exactly the same as the
    value, cases and all digits, used in the comnparison in the ifeq ($(PLATFORM), ...

/* EOF */
