Difference between revisions of "Project Configuration File"

From Wiki
m
 
(3 intermediate revisions by the same user not shown)
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.
  
= 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.
+
Both the simulation (CPRog/iRC on your PC) and the embedded robot control got a copy of the project file. When changing this file make sure to change both, otherwise the software may complain about inconsistent configuration or the simulation may behave different than the actual robot.
  
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.
+
== Simulation (CPRog/iRC on the PC) ==
 
+
The project configuration file of CPRog/iRC can be found in the installation directory under:
== CPRog/iRC (on PC) ==
+
  Data\Projects\<Category>\<RobotType>.prj
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 ==
 
  
 +
== Embedded Robot Control (real robot) ==
 
=== Via CPRog/iRC ===
 
=== Via CPRog/iRC ===
Version 12 of CPRog/iRC simplifies access to the configuration files of the embedded control:
+
The project configuration file of the embedded control can be accessed via CPRog/iRC:
 
# Click File -> Access Configuration
 
# Click File -> Access Configuration
# Click "Try to Connect", if necessary
 
 
# In the Project Configuration section click "Load..." to load the current configuration from the embedded control.
 
# In the Project Configuration section click "Load..." to load the current configuration from the embedded control.
 
# Change the file with a basic text editor
 
# Change the file with a basic text editor
# Write it back by clicking "Write..."
+
# Write it back to the robot by clicking "Write..."
 
# Restart the robot to apply changes
 
# Restart the robot to apply changes
  
 
=== Manual Access ===
 
=== Manual Access ===
If older versions of CPRog/iRC are used the configuration file needs to be accessed manually.
+
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
# [[FTP and PuTTY Access|Use a SFTP client to connect to the embedded control]]
+
  /home/root/TinyCtrl/Data/Projects/EmbeddedCtrl.prj
# 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 92:
 
|Joypad
 
|Joypad
 
|
 
|
|Settings for jogging the robot via a gamepad
+
|[[Joystick and Gamepad|Settings for jogging the robot via a gamepad]]
 
|}
 
|}
  
[[Category:CPRog]][[Category:TinyCtrl]]
+
[[Category:Configuration]][[Category:CPRog]][[Category:TinyCtrl]]

Latest revision as of 09:26, 16 August 2023

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.

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

Both the simulation (CPRog/iRC on your PC) and the embedded robot control got a copy of the project file. When changing this file make sure to change both, otherwise the software may complain about inconsistent configuration or the simulation may behave different than the actual robot.

Simulation (CPRog/iRC on the PC)

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

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

Embedded Robot Control (real robot)

Via CPRog/iRC

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

  1. Click File -> Access Configuration
  2. In the Project Configuration section click "Load..." to load the current configuration from the embedded control.
  3. Change the file with a basic text editor
  4. Write it back to the robot by clicking "Write..."
  5. 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.

 /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