Difference between revisions of "Project Configuration File"

From Wiki
m (added to category "Configuration")
(simplified)
Line 1: Line 1:
The project configuration file contains settings for one specific robot. If you use multiple robots with different configuration you may want to use a different project file for each of them. This article shows how to change the project configuration.
+
The project configuration file contains settings for one specific robot. If you use multiple robots with different configuration you can use different project files for each of them. CPRog/iRC on your PC and the embedded robot control both got a copy of the project file so make sure changes are synchronized to both.
  
= Configuration via CPRog/iRC =
+
Most changes can be done via the configuration area in CPRog/iRC. To access it click "File" -> "Configure Project" or "Configure Interfaces". If a robot is connected to while applying the changes will be synchronized to the embedded control. For special configurations the project files can be changed using a basic text editor.
Most relevant settings can be changed via CPRog/iRC. Connect to your robot, then open the configuration area (File -> Project Configuration and File -> Interface Configuration). These settings are synchronized to the embedded control if one is connected when you click "Apply".
 
  
= Accessing the Configuration File =
+
= Accessing the Project Configuration File =
More specialized changes need to be done manually via the configuration file. Be careful with these settings since wrong values can lead to unexpected behavior, like the robot moving faster than expected.
 
  
Like all configuration files the simulation and programming software on your PC and the embedded control both contain a copy of each robot configuration file. If you use a robot with embedded control you will need to change both, otherwise the simulation may act differently than the real robot.  
+
The project configuration file of CPRog/iRC can be found in the installation directory under:
 +
  Data\Projects\<Category>\<RobotType>.prj
  
== CPRog/iRC (on PC) ==
+
The project configuration file of the embedded control can be accessed via CPRog/iRC:
Find the installation directory of CPRog/iRC (usually directly on drive C:\ or in C:\Program Files). Then find the following file: Data\Projects\<category>\<type>.prj
 
 
 
You can edit the configuration file with a basic text editor. Reload the project in CPRog/iRC to apply changes.
 
 
 
== Embedded Control ==
 
 
 
=== Via CPRog/iRC ===
 
Version 12 of CPRog/iRC simplifies access to the configuration files of the embedded control:
 
 
# Click File -> Access Configuration
 
# Click File -> Access Configuration
 
# Click "Try to Connect", if necessary
 
# Click "Try to Connect", if necessary
Line 25: Line 16:
 
# Restart the robot to apply changes
 
# Restart the robot to apply changes
  
=== Manual Access ===
+
If that does not work (e.g. when using an older version of CPRog/iRC) the project file can be found at one of the following locations. Read [[FTP and PuTTY Access]] on how to access files on the embedded control.
If older versions of CPRog/iRC are used the configuration file needs to be accessed manually.
+
  /home/robot/TinyCtrl/Data/Projects/EmbeddedCtrl.prj
 
+
  /home/root/TinyCtrl/Data/Projects/EmbeddedCtrl.prj
# [[FTP and PuTTY Access|Use a SFTP client to connect to the embedded control]]
 
# Download the file /home/'''robot'''/TinyCtrl/Data/Projects/EmbeddedCtrl.prj or /home/'''root'''/TinyCtrl/Data/Projects/EmbeddedCtrl.prj
 
# Edit it with a basic text editor
 
# Upload it
 
# Restart the robot to apply changes
 
  
 
= Parameters =
 
= Parameters =
Line 102: Line 88:
 
|Joypad
 
|Joypad
 
|
 
|
|Settings for jogging the robot via a gamepad
+
|[[Joystick and Gamepad|Settings for jogging the robot via a gamepad]]
 
|}
 
|}
  
 
[[Category:Configuration]][[Category:CPRog]][[Category:TinyCtrl]]
 
[[Category:Configuration]][[Category:CPRog]][[Category:TinyCtrl]]

Revision as of 15:15, 3 November 2022

The project configuration file contains settings for one specific robot. If you use multiple robots with different configuration you can use different project files for each of them. CPRog/iRC on your PC and the embedded robot control both got a copy of the project file so make sure changes are synchronized to both.

Most changes can be done via the configuration area in CPRog/iRC. To access it click "File" -> "Configure Project" or "Configure Interfaces". If a robot is connected to while applying the changes will be synchronized to the embedded control. For special configurations the project files can be changed using a basic text editor.

Accessing the Project Configuration File

The project configuration file of CPRog/iRC can be found in the installation directory under:

 Data\Projects\<Category>\<RobotType>.prj

The project configuration file of the embedded control can be accessed via CPRog/iRC:

  1. Click File -> Access Configuration
  2. Click "Try to Connect", if necessary
  3. In the Project Configuration section click "Load..." to load the current configuration from the embedded control.
  4. Change the file with a basic text editor
  5. Write it back by clicking "Write..."
  6. Restart the robot to apply changes

If that does not work (e.g. when using an older version of CPRog/iRC) the project file can be found at one of the following locations. Read FTP and PuTTY Access on how to access files on the embedded control.

 /home/robot/TinyCtrl/Data/Projects/EmbeddedCtrl.prj
 /home/root/TinyCtrl/Data/Projects/EmbeddedCtrl.prj

Parameters

The most important parameters of the project configuration are the following.

We generally recommend changing these via the CPRog/iRC user interface to avoid mistakes.

Line Parameter Description
Robot Type Robot type - this defines the robot configuration file that is used
Program File, FileLogic The robot program file and logic program file that are loaded after starting the robot
Program Override The velocity override value (0-100, percent of maximum velocity)
Program Repeat Run the program once or repeat after it ends
PLCInterfaceRefSequence Referencing sequence
OperationModes Active Enables the operation mode switch - limits the velocity depending on operation mode
OperationModes ManualMaxVelMMPerSec Maximum cartesian velocity in manual mode
OperationModes DInOpModeAuto, DInEnableMotionInManualMode Digital inputs to enable manual and automatic mode
InteractionElements Defines which UI elements are shown in CPRog/iRC and which values are used when adding new commands to a robot program
CRIServer Active Enables the CRI server (only CPRog/iRC)
ModbusServer Active Enables the Modbus server
ModbusServer Port Port of the Modbus server
ModbusServer MaxConnections Maximum number of concurrent connections (only embedded control)
Cloud Cloud configuration
Joypad Settings for jogging the robot via a gamepad