6 - The Ressources 
CoDeSys V2.3 
6-81 
The CoDeSys PLC Browser window 
The browser consists of a command entry line and a result/display window.  
In a selection box the input line displays a list of all the commands entered since the start of the 
project (input history). They are available for re-selection until the project is closed. Only commands, 
which differ from those already existing, are added to the list.  
The entered command is sent to the controller with <Enter>. If there is no Online connection, the 
command is displayed in the result window in the same way as it is sent to the controller, otherwise 
the  response from the controller is shown there. If a new  command  is  sent to  the controller, the 
content of the result window is deleted.  
Commands can be entered in the form of command strings , the use of macros is possible as well: 
6.13.2  Command entry in the PLC-Browser 
Basically the PLC-Browser makes available the 
3S standard commands
hard-coded in the run-time 
system. It is concerned with functions for direct memory manipulation, for the output of project- and 
status functions as well as for run-time monitoring. They are described in the browser's 
ini-file
, which 
is  an  integral  part  of  the  Target  Support  Package.  These  standard  commands  can  be  further 
supplemented  by  specialized  ones,  e.g.  self-diagnostic  functions or  other  status  messages  of the 
control application. The expansion of  the  command list must be carried out both  in the customer 
interface in the run-time system as well as through additional entries in the Browser ini-file.  
When opening the project the 
command list
available in the PLC-Browser is generated based on the 
entries in the Browser ini-file. It can be accessed as input help using the 
...
key in the dialog „Insert 
standard command" or using <F2>. Also the command 
'Insert' 'Standard commands'
can be used to 
get the command list. A command can be typed in manually to the command line or it can be selected 
from the list by a double-click on the appropriate entry.  
The general command syntax is: 
<KEYWORD><LEER><KEYWORD-DEPENDEND PARAMETERS> 
The  keyword  is  the 
command
 With  which 
parameter
 it  can  be  expanded  is  described  in  the 
respective tooltip in the entry help window.  
The command, which has been sent, is repeated in the output data window, the controller's response 
appears below it. 
Example: Request for the project Id from the controller with the command "pid" 
Entry in command line:  
Pid 
Convert pdf form to web form - software control dll:C# PDF Convert to HTML SDK: Convert PDF to html files in C#.net, ASP.NET MVC, WinForms, WPF application
How to Convert PDF to HTML Webpage with C# PDF Conversion SDK
www.rasteredge.com
Convert pdf form to web form - software control dll:VB.NET PDF Convert to HTML SDK: Convert PDF to html files in vb.net, ASP.NET MVC, WinForms, WPF application
PDF to HTML Webpage Converter SDK for VB.NET PDF to HTML Conversion
www.rasteredge.com
The PLC-Browser 
6-82 
CoDeSys V2.3 
Output in result window:  
pid 
Project-ID: 16#0025CFDA 
help  text
can be  supplied for  each  standard command  with ?<BLANK><KEYWORD>.  This  is 
similarly defined in the ini-file. 
The following commands are firmly integrated in the run-time system and contained in the ini-file with 
the corresponding entries for entry help, tooltips and help: 
Command 
Description 
?  
The  run-time  system  supplies  a  list  of  the  available  commands.  The  list  is 
independent of the status of the description files of the target system. 
mem  
Hexdump of a memory area 
Syntax 1: mem <start address> <end address> 
Addresses can be entered decimal, hexadecimal (Prefix 16#) or as a macro. 
memc  
Hexdump relative to the start address of the code in the controller; like mem, the data 
are added to the code area start address. 
memd  
Hexdump relative to the data base address in the controller; like mem, the data are 
added to the data area 
reflect 
Reflect current command line, for test purposes. 
dpt  
Read and display data-pointer table. 
ppt 
Read and display POU table. 
pid  
Read and display project Id. 
pinf 
Read and display project info (see 'Project' 'Project Info'). 
tsk 
Show list of IEC-tasks incl. task infos defined in the project. 
startprg 
Start PLC program ('Online' 'Start'). 
stopprg 
Stop PLC program ('Online' 'Stop'). 
resetprg 
Reset PLC program. Only not-retentive data get initialized. ('Online' 'Reset). 
resetprgcold 
Reset PLC program cold. Retentive data also get initialized. ('Online' 'Reset (cold)'). 
resetprgorg 
Reset PLC program original. The current application program as well as all data (incl. 
retentive and persistent) are deleted. ('Online' 'Reset (origin)'). 
reload 
Reload boot project. 
getprgprop 
Read and display program properties (Name, title, version author, date). 
getprgstat 
Read and display program status (e.g. "run", "stop", last error, flags). 
filedir 
File command "dir". List of files in the PLC directory. 
filecopy 
Copy file [from] [to]. Example: "filecopy filename.txt filename2.txt". 
filerename 
Rename files on PLC [old] [new]. Example: filerename oldname.txt newname.txt". 
filedelete 
Delete file on PLC; Example: "filedelete file.xml". 
saveretain 
Save retain variables. The name of the save file will be displayed afterwards. 
restoreretain  Load retain variables. The name of the save file, from which the variables values 
are restored, will be displayed. 
software control dll:VB.NET Image: Professional Form Processing and Recognition SDK in
on the top right of our web page. you have checked your forms before using form printing add provide powerful & profession imaging controls, PDF document, image
www.rasteredge.com
software control dll:Process Forms in Web Image Viewer | Online Tutorials
Twain Scanning; DICOM Reading; Form Recognition & Processing. Online PDF Editor (beta); Online Document Viewer; Online Convert PDF to Word; Online Convert
www.rasteredge.com
6 - The Ressources 
CoDeSys V2.3 
6-83 
Command 
Description 
setpwd 
Set password on controller; Syntax: setpwd <password> [level], e.g. "setpwd abcde 
0".  <level> can be "0" (default) just valid concerning logins from the programming 
system, or "1" valid for all applications. 
delpwd 
Delete password on PLC. 
Please regard:  
The first word of the command sequence entered is interpreted as 
keyword
(<KEYWORD>). 
If the first word of the command entry is 
not recognized
by the controller, the response 'Keyword not 
found' will appear in the result window. 
If  a  keyword  is  preceded  by  a  „
?<SPACE>
 (e.g.  „?  mem"),  the  ini-file  will  be  searched  for  the 
existence of a help section to this keyword. If one is available, nothing is sent to the controller, but 
only the help text is displayed in the output data window. 
6.13.3  Use of macros during the command entry in PLC-Browser 
If a command associated with a macro is entered in the command line, this is expanded before it is 
sent to the controller. Then the response in the result window appears in a similarly expanded form. 
The entry syntax is: <KEYWORD><macro> 
<KEYWORD> is the command. 
Macros are: 
%P<NAME> If NAME is a POU-name, the expression is expanded to <POU-Index>, otherwise there 
is no alteration  
%V<NAME> If  NAME  is  a  variable  name,  the  expression  is expanded  to  #<INDEX>:<OFFSET>, 
otherwise there is no alteration (this notation #<INDEX>:<OFFSET> is interpreted by the 
controller as a memory address) 
%T<NAME>  If  NAME  is  a  variable  name,  the  expression  is  expanded  to  <VARIABLENTYP>, 
otherwise there is no alteration. 
%S<NAME> If NAME is a variable name, the expression is expanded to <SIZEOF(VAR)>, otherwise 
there is no alteration. 
The % character is ignored if the escape symbol \ (Backslash) is placed in front. The escape symbol 
as such is only transmitted if written \\. 
Example:  
Entry in command line: (memory dump of the variable .testit ?) 
mem %V.testit  
Output in result window:  
mem #4:52 
03BAAA24 00 00 00 00 CD CD CD CD ....ÍÍÍÍ 
6.13.4  Further PLC-Browser options 
In the '
Extras
' menu or in the PLC-Browser's toolbar there are the following commands for handling 
the command entry or history list: 
software control dll:C#: How to Determine the Display Format for Web Doucment Viewing
RasterEdge web document viewer for .NET can convert PDF, Word, Excel and the same time, and then render image form to show on your C# project aspx web page
www.rasteredge.com
software control dll:C#: How to Add HTML5 Document Viewer Control to Your Web Page
Add a new Web Form to your C# _tabFile.addCommand(new RECommand("convert")); _tabFile.addCommand _userCmdDemoPdf = new UserCommand("pdf"); _userCmdDemoPdf.addCSS
www.rasteredge.com
Tools 
6-84 
CoDeSys V2.3 
With 
History  forward
and 
History  backward
you  can  scroll  backwards  and  forwards 
through the query results already carried out. The history recording is continued until you leave the 
project.  
With 
Cancel command 
you can break off a query which has been initiated. 
With 
Save history list 
you can save the query results carried out up until that point in an external 
text file. The dialogue 'Save file as' will appear, in which you can enter a file name with the extension 
„.bhl" (Browser History List). The command 
Print last command
opens the standard dialogue to print. 
The current query plus the output data in the message window can be printed. 
6.14 Tools 
The object 'Tools' will be available in the 'Resources' tab if the functionality is enabled for the currently 
set target system. It shows all available shortcuts (connections) to executable files of external tools, 
which  can  be  activated  by  a  double-click  in  order  to  call  these  external  programs  from  within 
CoDeSys. It is defined by the target file which and how many shortcuts are allowed. Depending on 
this definition the user can add or delete new shortcuts in the 'Tools' folder. 
For example the Tools folder in the Object Organizer might look like this:  
In  this  example  four  tools-shortcuts  are  installed.  One  serves  for  starting  another  CoDeSys 
programming system, one for opening the assembler listing in a text editor and two further shortcuts 
are available to open PDF-files. Shortcuts marked with a "<R>" cannot be modified in CoDeSys. The 
shortcuts may contain the connection to an editor, e.g. notepad.exe, or to a certain PDF-file, so that a 
double-click on the entry would open a notepad window showing the assembler listing respectively 
would open the Acrobat Reader showing the PDF-file. 
Additionally you can  define certain  files  which should be  downloaded  to the PLC as  soon  as the 
shortcut is activated.  
6.14.1  Properties of available Tool Shortcuts (Object Properties) 
By a mouse-click on the plus sign at entry 'Tools' in the Resources tab of the Organizer a list of the 
available shortcuts will open. If you are just starting to set up a new project, you will just see those 
which are defined in the target file as fix entries. But if the Tools folder already had been modified you 
might find another shortcuts, added by a user in CoDeSys. 
software control dll:C# Image: How to Integrate Web Document and Image Viewer
RasterEdgeImagingDeveloperGuide8.0.pdf: from this user manual, you can find the detailed instructions and Now, you may add a new Web Form to your web project.
www.rasteredge.com
software control dll:C# TIFF: C#.NET Code to Create Online TIFF Document Viewer
We still demonstrate how to create more web viewers on PDF and Word documents at the DLL into your C#.NET web page, you may create a new Web Form (Default.aspx
www.rasteredge.com
6 - The Ressources 
CoDeSys V2.3 
6-85 
Dialog 'Tool Properties'  
You can view the global tool properties (valid for all shortcuts listed in 'Tools') as well as the properties 
of single shortcuts. 
1. Tool Properties:
If 'Tools' is marked in the Resources tree, you will find the command 'Object Properties' in the context 
menu or in the menu 'Project' 'Object', which will open the dialog 'Tool Properties'. 
There you get a table listing all tool shortcuts which might be used for the currently set target. The 
following parameters are shown: The 
Id
(unique identification number) of the tool, the 
Name of the 
shortcut
which is used  to  reference the shortcut in the Object Organizer, and  the 
Name  of  the 
executable file
of the tool. The button 
Advanced
expands the dialog resp. closes the extension of 
the dialog: 
The expanded dialog shows the global properties of the shortcut as defined in the target file. Further 
on an edit field is available where a (working) 
Directory
can be defined which should be used for 
actions of the executable file. The path will be saved without closing the dialog as soon as you press 
the 
Apply
button. 
Properties of the Tool: 
FixedCount 
Number of shortcuts of the tool, which are inserted unalterably and automatically in 
the Tools folder. Only if "0" is entered here, the user will be able to create as many 
shortcuts as desired. 
Please regard: For shortcuts which are defined as "fix" ones by the target file, the 
number of possible usage in the Tools folder is predetermined and the properties 
cannot be modified by the CoDeSys user (cognizable by a "<R>" in the Object 
Organizer). 
Exe-Name:  
File name or full path of the executable file of the tool. Here you also can enter a 
registry path pointing to an exe-file: "[registry path].<registry entry in this path pointing 
to an exe-file>"If there is no entry, the file extension of the file, which is given in 
"Parameter Template", automatically will cause via Windows the start of the exe file 
of the according tool. 
Examples: "C:\programme\notapad.exe", "345.pdf" 
DefaultDisplayName: 
Name which is used to represent the tools in the Object Organizer. Possibly the 
template $(INSTANCE NUMBER) is used (see below 'Parameter Template'). 
Parameter Template: 
Templates for determining the file which should be opened by the tool. The following 
templates can be used, connected by the appropriate special characters: 
$(PROJECT_NAME) Name of the currently opened project  
(File name without extension *.pro"). 
$(PROJECT_PATH) Path of the directory where the project file is  
software control dll:C# PDF Converter Library SDK to convert PDF to other file formats
C#.NET can manipulate & convert standard PDF developers to conduct high fidelity PDF file conversion C#.NET applications, like ASP.NET web form application and
www.rasteredge.com
software control dll:C# PDF: How to Create PDF Document Viewer in C#.NET with
to images or svg file; Free to convert viewing PDF designed PDF document using C# code; PDF document viewer be created in C# Web Forms, Windows Form and mobile
www.rasteredge.com
Tools 
6-86 
CoDeSys V2.3 
(without indication of the drive). 
$(PROJECT_DRIVE) Drive where the currently opened project is. 
$(COMPILE_DIR) Compile directory of the project (including indication of the drive)  
$(TOOL_EXE_NAME) Name of the exe-file of the tool. 
$(DISPLAY_NAME) Name of the current shortcut, as used in the 'Tools' folder. 
$(INSTANCE_NUMBER) Number of the shortcut  
(Instance number, running number, starting with "1") 
$(CODESYS_EXE_DIR) Path of the directory where the Codesys exe-file is  
(including indication of the drive). 
The conversion of a template you will see in the dialog for the Shortcut Properties 
(see below) 
Example: 
"$(PROJECT_NAME)_$(INSTANCE_NUMBER).cfg"  
 The cfg-file with the name <name of current CoDeSys project>_<shortcut 
number>.cfg will be opened in the tool. 
DownloadFile 
Templates:  
Files, file pathes resp. templates for file which will be copied to the PLC during 
download.. If option 
Editable
is activated, the list of these files will be editable in the 
properties dialog of the shortcut. If a file name is entered without path, the file will be 
searched in the directory where the codesys-exe-file is. 
Example: 
"a.up;$(PROJECT_NAME).zaw;$(INSTANCE_NUMBER).upp"  
 the files a.up, <current CoDeSys Projekt>.pro and <shortcut number>.upp will be 
copied to the PLC during the next download 
2. Shortcut Properties:
Mark a shortcut entry in the 'Tools' tree in the  Object Organizer and select the command 'Object 
Properties' in the context menu or in the 'Project' 'Object' menu. The dialog 'Shortcut Properties' will 
open, containing the following items: 
Command 
Calling the tool; paths of the exe-file and of the file which is named in 'Parameter' (predefined 
by the 'Parameter Template', see above) 
e.g.: C:\programs\notepad.exe D:\listings\textfile.txt 
Parameter 
Path of the file which should be called by the tool. This is defined in the target file and can be 
edited here, if the option 'Editable' (see below) has been activated. 
Files to be 
downloaded 
Primarily you find here the 
Filenames
which are defined by the target file and which are also 
described in the Tool Properties (DownloadFileTemplate, see above). If option 'Editable' is 
activated in the extended dialog (see below) then you can modify the list. For this purpose 
press button 
New
to open the dialog 
'Filename'
, where you can enter another file resp. a file 
path. If you enter a file without path, then it will be searched in that directory, where the 
codesys-exe-file is. Button 
Delete
will remove the currently marked list entry. 
Button
Standard
resets the entries of the dialog to the default values defined by the target file. 
Button 
Apply
saves the done settings without closing the properties dialog. 
Button 
Advanced
expands the dialog so that it will look as follows: 
software control dll:C# PDF Convert to SVG SDK: Convert PDF to SVG files in C#.net, ASP
In some situations, it is quite necessary to convert PDF document into SVG image format. indexed, scripted, and supported by most of the up to date web browsers
www.rasteredge.com
6 - The Ressources 
CoDeSys V2.3 
6-87 
Dialog 'Advanced Properties' of a shortcut   
Shortcut Number: 
Running number, starting  with 1. New shortcuts of  the current tool  will each  get the 
next higher number. If a shortcut will be removed later, the numbers of the remaining 
shortcuts will stay unchanged. The shortcut number can be inserted in other definitions 
by  using  the  template  $(INSTANCE_NUMBER)  (e.g.  see  above,  'Parameter 
Template'). 
Tool ID: 
Unique identification number of the tool; defined in the target file.  
Default Number of 
Shortcuts: 
Number of shortcuts (instances) for a tool. Corresponds to the "FixedCount" defined in 
the target file. See above, Tool Properties. 
Editable: 
If this option is activated, it will be possible to edit the field 'Parameter' resp. the list of 
files which should be downloaded. 
Button 
OK
applies the done settings and closes the Properties dialog. 
6.14.2  Managing Tool Shortcuts 
Creating new Tool Shortcuts 
Select the entry 'Tools' or a shortcut entry in the Resources tree of the Object Organizer and select 
command 'Add Object' in the context menu or in the 'Project' 'Object' menu to open the dialog '
Create 
Shortcut
', see below. 
The  table  lists  all  tools  for  which  new  shortcuts  (connections)  can  be  created.  According  to  the 
definitions in the target file the following parameters are displayed: 
ID
of the tool, default 
Name of the 
shortcut
and the 
Name of the executable file
 
In order to create a(nother) shortcut for one of the offered tools, select this tool by a mouse-click in the 
'ID' column. Hereupon you can modify the default name of the shortcut in the edit field 
Name of the 
shortcut
and confirm with OK. This will only work if you enter a name which is not yet used.  
Tools 
6-88 
CoDeSys V2.3 
Dialog 'Create Shortcut'  
OK
closes the dialog and the new shortcut will be inserted in the Resources tree, represented by the 
shortcut name and a shortcut number which is 1 higher than the highest one used for a instance of 
this tool up to now. 
In the area below the name field appropriate hints concerning the user inputs will be displayed. 
Deleting Tool Shortcuts 
Deleting a shortcut can be done via the command Delete in the context menu (right mouse button) or 
in the 'Project' 'Object' menu. The command is only available, if there is no fix number of shortcuts 
defined for the currently marked shortcut. The shortcut  numbers of the remaining shortcuts will not 
change if you delete a shortcut. 
Executing Tool Shortcuts 
A shortcut will be executed on a double-click on the entry in the Resources tree or by the command 
'Open Object' in the 'Project' 'Object' menu resp. in the context menu (right mouse button).  
If the execution of  the  file,  which is  defined  in  the  shortcut  properties (Parameter),  fails, then  an 
appropriate error message will appear. If a parameter file will not be found, the exe-file of the tool will 
be executed and a dialog will open, asking you whether the file should be created.  
If the exe-file of the tool is not found in the defined path or if no path has been defined, then the 
standard dialog for selecting a file will be opened and the user will be asked to enter the path of the 
exe-file. This path will be saved when the dialog is closed by OK and thus will be available for the tool 
also in other CoDeSys projects. 
Saving Tool Shortcuts 
When the CoDeSys project is saved, the status and settings of the 'Tools' folder in the Resources tree 
will also be saved. 
Please note:
If you save a project by 'Save as' with a new name, then you must consider the following if you use 
the template $(PROJECT_NAME) in the definition of the parameter file and of the files which are to 
be downloaded:  
If you had added shortcuts for a tool (FixedCount=0) in the old project, then in the new project the file 
names have to be renamend manually corresponding to the new project name. In contrast for a tool 
which is defined with a fix number of shortcuts, the template always will be replaced automatically by 
the current project name !  
6.14.3  Frequently asked questions on Tools 
Why do I get no entry 'Tools' in the 'Resources' ?
Only if it is defined in the 
target file
of the currently set target system, the 'Tools' functionality will be 
available. 
For which tools already shortcuts are available, which shortcuts can I add in the CoDeSys project ?
6 - The Ressources 
CoDeSys V2.3 
6-89 
Open the folder 'Tools' in the 'Resources' tree of the Object Organizer by a double-click on the plus 
sign. You will see which tools already are connected for the current project. If you have just set up a 
new project and not yet worked on the Tools list, then just those entries will be displayed, which are 
predefined unalterably by the definitions in the target file. Otherwise you might see an already project 
specifically modified tools list. In order to check, whether the list is extendable by new entries, select 
the command 
'Add Object'
. You will get a dialog offering all tools for which additional shortcuts can be 
created.  
Which global properties do the available tools have ?
Mark the entry 'Tools' in the Object Organizer and choose the command 
'Object Properties'
from the 
context menu (right mouse button). Expand the appearing dialog by pressing the 'Advanced' button. 
Now you will see a list of the available tools and the corresponding parameters. Select one of the tools 
by a mouse click on the ID-Symbol in order to – for example - get displayed the allowed number of 
shortcuts for the tool in the field 'FixedCount', or to get displayed which files will be downloaded to the 
PLC if the shortcut is activated. The file names or paths might be shown in the form of templates, 
which will be interpreted for each single shortcut as described in the following paragraph: 
Which individual properties have the available shortcuts ?
Mark  one  of  the  entries  below  'Tools'  in  the  Object  Organizer  and  select  the  command 
'Object 
Properties'
in the context menu (right mouse button). Press button 'Advanced' to get the parameters of 
the chosen shortcut. Partially they will correspond to the above described global tool properties. If 
allowed by the definition in the target file you can edit these parameters here. 
How can I create a shortcut for a tool ?
Mark the entry 'Tools' in the Object Organizer and choose the command 
'Add Object'
from the context 
menu  (right mouse  button).  You  will  see  a list of  available  tools, but only of  those  for  which the 
maximum number of shortcuts (FixedCount) is not yet reached. Choose a tool and press OK. The tool 
will now be inserted in the Tools folder in the Object Organizer. If you want to insert it once more, then 
you must enter a different tool name first, which means to mark the new entry as another instance of 
the same tool. For example you could name the instances of the tool Toolxy "Toolxy_1", "Toolxy_2" 
etc.  
How can I modify the parameters of a tool ?
In order to modify the parameters of a shortcut (instance of a tool connection), mark the shortcut in the 
Object Organizer and choose command 
'Object Properties'
from the context menu. It depends on the 
pre-definition of the tool in the target file, whether the parameters can be edited  in the properties 
dialog. (See in the expanded dialog whether the option 'Editable' is activated. Button 'Standard' resets 
all edited values to the defaults. 
How can I execute a tool shortcut ?
Perform a double-click on the shortcut entry in the Object Organizer or select the command 
'Open 
Object'
in  the  context  menu  resp.  in  the  'Project'  menu  when  the  entry  is  marked  in  the  Object 
Organizer. 
Tools 
6-90 
CoDeSys V2.3 
Documents you may be interested
Documents you may be interested