CoDeSys SoftMotion: Resolving module.root Tutorial Errors

Tom Garrett1 min read
Motion ControlOther ManufacturerTroubleshooting
Licensed PE Working through this on a live machine? A Maine-licensed engineer can take it from here — included with IMD hardware, by the hour for everything else. Book an engineer

CoDeSys V2.3 SoftMotion tutorial projects require a target whose configuration includes the SoftMotion feature. When that target support is missing, opening a tutorial project can report description for module.root not found and may prompt for a configuration directory such as D:\Codesys\config. Changing that path does not address the documented cause when the required target configuration files were never installed.

Identify the Configuration Error

Observed condition Engineering interpretation Action
description for module.root not found The installed target lacks the configuration files needed by the SoftMotion project. Install a SoftMotion-enabled target.
The software suggests changing the configuration directory The requested files may be absent rather than stored at another path. Verify the target installation before redirecting the directory.
The same failure occurs with vendor-specific and standard CoDeSys V2.3 installations The evidence does not isolate the failure to the FESTO-specific package. Check whether RTE V2.3 was selected during installation.

Install the SoftMotion-Enabled Target

Run the CoDeSys V2.3 installation procedure and select the Install RTE V2.3 option. RTE V2.3 is identified in the available evidence as a SoftMotion-enabled target that supplies the target configuration required by the tutorial projects.

  1. Start the CoDeSys V2.3 installation procedure.
  2. Select the option labeled Install RTE V2.3.
  3. Complete the installation, then reopen the SoftMotion tutorial project.

Open and Verify the Example Projects

Reopen the projects under <CoDeSys V2.3 install directory>\Projects\Motion\Tutorial\. A successful correction means the project opens with its controller configuration instead of stopping at the module.root description error.

For a broader feature example, open C:\Program Files\3S Software\CoDeSys V2.3\Projects\Motion\4examples\4examples.pro. Use it to inspect and test the installed SoftMotion functions before building an X-Y circle or rounded-rectangle application. The evidence does not provide the axis configuration, motion blocks, interpolation settings, or program logic needed to document those trajectories safely.

FAQ

Why does CoDeSys V2.3 report description for module.root not found?

The available evidence attributes the error to missing target configuration files when no SoftMotion-enabled target is installed.

Which CoDeSys V2.3 installation option enables the SoftMotion examples?

Select Install RTE V2.3 during the CoDeSys V2.3 installation procedure, then reopen the tutorial project.

How do I verify that the CoDeSys SoftMotion installation works?

Confirm that a tutorial project opens with its controller configuration and without the module.root error. You can also open C:\Program Files\3S Software\CoDeSys V2.3\Projects\Motion\4examples\4examples.pro for a wider feature overview.

Back to blog