Please check if the occurring errors have already been covered in the FAQs
or if they have already been recorded and answered under our Forge community.

In addition, it can be helpful to inform you about the use of function blocks, methods and add-ons (provided by Codesys) in the Codesys Online Help (OLH).
Here, the usage, configuration, description and possible applications as well as general problems, that users might expect to encounter, are described.

Any error reports to CODESYS should contain the following information: 


Besides the above information, the principle of "more is better" applies here.
In order to be able to answer inquiries efficiently, it is useful to provide all relevant data:

See also the section for which additional data is helpful and why:

The more detailed information the support team receives, the faster the problem can be isolated, and a resolution provided.

Which additional data is helpful and why?

To be able to detect problems which may only be related with the used version(s), or to be able to exclude known issues,
the following version information should be provided:

  • Version of the CODESYS programming environment (IDE).
  • Version of the operating system, the used runtime and processor of the target system.
  • Version of the used CODESYS Packages (like SoftMotion, Ethernet, Visualization, etc.).
  • Version of the used Visualization Profile for visualization problems within the Visualization Editor and Visu Display Variants.


We always need accurate information and data to recreate the error profile:

  • Exact 'Steps to repeat' to be able to reproduce the error.
    The more precisely the individual steps are described, the less need there is to ask for error reproductions and the less room there is for interpretation when retesting.
  • A full project archive (not only the CODESYS project!).
    This contains the libraries used, the application structure of used functions, etc.
  • For more complex processes, in addition to the written steps, a short screen recorded video, showing the steps and then the error that occurs, can be very useful.
  • Note that sporadic errors are very difficult to solve.
    In these cases, you should endeavor to determine the conditions under which it occurs, so that the support team has a chance to reproduce it and investigate.

See also Why accurate 'steps for reproducing a problem' are important for any Technical Support


Depending on the existing problem, different additions to be reported are necessary (or at least helpful in order to correctly understand and comprehend error profiles):

  • If available, controller logs, with the appropriate log filter settings, should always be given.
  • Screenshots of the error when it occurs in the Codesys IDE.
  • In case of fieldbus related errors (or incorrectly displayed values in the different editors of the fieldbus), recording of the communication via 'Wireshark',
    that ranges from the download/login/start of the controller to after the occurrence of the error behavior, are needed. 



Reporting a runtime exception

By any exception in the runtime, first check if it is caused by an application structure in a POU, FB or library.
To do this, use the Implicit Checks available in the Codesys IDE.  

Exception Example:

See also our OLH on how to 'Create a Core Dump', and how to 'Creating a Core Dump of the running application manually'.

Please provide:


If you need technical support, please purchase a Support Ticket in the CODESYS Store.
Note that certain products in the CODESYS Store already include a Support Ticket.

To report software bugs or if you have a question concerning the products in the CODESYS Store,
click on the "My Question" button next to the shopping cart in the CODESYS Store.

FAQ:


For vendor (or 'third party') specific errors, it must distinguish where the error occurs:

  • The errors must be reproducible under the Codesys IDE and with a CODESYS SL PLC.
    • For errors that occur only under other IDEs, which were modified via brand labelling, the corresponding manufacturer must be contacted.
    • For errors that occur only with a device manufacturer's PLC, the device manufacturer should be contacted to pursue a resolution for the problem.

This is due to the fact that other IDE manufacturers use Codesys as a platform, but can build their own restrictions or extensions that deviate from the default interaction, behavior and standards of the Codesys IDE, and therefore can not be pursued by us. 

  • Errors that occur with a library, not developed by CODESYS GmbH
    • For errors that occur with a library, which was written by a 'third party', this library manufacturer should be contacted for further support.



  • Please set the compiler-define: VISU_NO_EXCEPTION_HANDLING

More detailed information can be found under debugging a Visu Exception FAQ.



See also....