Invalid Characters Error in PSoC Creator - KBA229090

Version 3

    Author: DheerajK_81           Version: **

     

    Question:
    When I create a project, PSoC® Creator™ throws the error message:
    “PSoC Creator Error prj:M0259 - Unable to proceed with project creation. Invalid character(s): ,”. How do I proceed?

     

    Answer:

    When a project is created in a path containing any of special characters (including “ # @ ! ~ $ % ^ & ( ) - = + _ { } [ ] ' , ”), PSoC Creator displays the error message as shown in Figure 1.

     

    Figure 1. Error Message in PSoC Creator

    PSoC Creator does not support these characters, because the downstream tools that it uses to create and build your application cannot handle paths containing special characters.

     

    To avoid the error, make sure that the path to your project does not contain any special characters.

     

    Workaround:

    If there is no alternative, and the path includes special characters, use MKLink, a command line tool provided by Microsoft to create symbolic links. The syntax for creating a symbolic link is:

     

    mklink /d <symbolic link name> <target>

     

    where,

     

    /d is an option to create a directory symbolic link.

     

    Consider an example where you need to create a project in C:/Company, Inc/ (target directory). Follow these steps to create a symbolic link for this path: 

     

    1. Run the Command Prompt as an Administrator.
    2. Navigate to any other directory that does not include any special characters in its path. For example, C:/Users/<user>/Documents.
    3. Run the command mklink /d PSoC_Project "C:\Company, Inc\.  

          Figure 2. Running the mklink Command
        
    4. Now, open PSoC Creator. Follow the menu path File > New > Project… to create a new project. Choose the target device and project template based on your application. When prompted for the location to save your workspace, copy and paste the path of the symbolic link directory. In this example, the path will be C:\Users\<user>\Documents\PSoC_Project as shown in Figure 3.       
           
          Figure 3. Path to Symbolic Link Directory

      Note: Do not use the browse option and point to the symbolic link directory. The symbolic link directory will change to the target directory and project creation will fail. Instead, copy and paste the symbolic directory path. 

    5. Click Finish.  
      The project will now be created without any errors. The PSoC Creator workspace directory is present in C:/Company, Inc/ as shown in Figure 4.

     

    Figure 4. PSoC Creator Workspace Directory