AC500-Specific PLC Browser Commands

The PLC browser interface of the Control Builder provides CoDeSys standard commands as well as AC500-specific commands. The general operation of the PLC browser is described in the according user manual.

This section only describes AC500-specific commands and commands that provide special data for the AC500.

For all commands online help information is available. The help information is displayed language-dependent by entering “?command” when operating in online mode. The command “?” lists all available firmware commands.

The commands listed in online mode can differ from the commands shown when pressing the button […] as the Control Builder version and firmware version can differ. The commands listed when clicking the button […] are defined in the file “Browser.ini” that belongs to the selected target system package (TSP).

The PLC browser provides the following AC500-specific commands:

Command Meaning Implementation
? Displays all implemented commands Standard
mem Memory dump from up to Standard
memc Memory dump relative to code area Standard
memd Memory dump relative to data area Standard
reflect Reflect actual command line (for test purposes) Standard
dpt Displays the data pointer table Standard
ppt Displays the block pointer table Standard
pid Displays the project ID Standard
pinf

Displays project information in the format:

pinf

Address of Structure:     16#0013CF74

Date: 4213949F

Project Name: MODBUS_Test_BB.pro

Project Title: Test     MODBUS

Project Version: V1.0

Project Author: Brigitte     Blei

Project Description:

Test of serial interfaces

End of Project-info.

Standard
tsk

Displays the IEC task list with task information in the format:

tsk

Number of Tasks: 1

Task 0: Main program,     ID: 1519472

Cycle     count: 45402

Cycle     time: 1 ms

Cycle     time (min): 1 ms

Cycle     time (max): 1 ms

Cycle     time (avg): 1 ms

Status:     RUN

Mode:     CONTINUE

----

Priority:     10

Interval:     5 ms

Event:     NONE

----

Function     pointer: 16#00601584

Function     index: 131

Standard
tskclear Clears IEC Task information (cycle count & overall maximum and minimum cycle time) Specific as of V2.0
startprg Starts the user program

Standard (with CPU firmware below V2.3.0)

No (with CPU firmware V2.3.0 and higher)

stopprg Stops the user program

Standard (with CPU firmware below V2.3.0)

No (with CPU firmware V2.3.0 and higher)

resetprg Resets the user program

Standard (with CPU firmware below V2.3.0)

No (with CPU firmware V2.3.0 and higher)

resetprgcold Resets the user program (cold)

Standard (with CPU firmware below V2.3.0)

No (with CPU firmware V2.3.0 and higher)

resetprgorg Resets the user program (origin)

Standard (with CPU firmware below V2.3.0)

No (with CPU firmware V2.3.0 and higher)

reload Reloads the boot project from Flash Standard (not supported with CPU firmware V2.2 or higher)
getprgprop

Displays program properties in the format:

getprgprop

Name: MODBUS_FBP_Test_BB.pro

Title: Test MODBUS

Version: V1.0

Author: Brigitte Blei

Date: 4213949F

Standard
getprgstat

Displays the program status in the format:

getprgstat

Status: Run

Last error: Id 00000000     TimeStamp 000055F3 Parameter 00000000 Text

Flags:

Standard
filecopy File command copy No
filerename File command rename No
filedelete File command delete No
filedir File command dir No
saveretain

In V1.0 and V1.1: Saves the RETAIN variables to the SD card.

As of V1.2: Writes the RETAIN variables to RAM

(same as retain save)

Specific
restoreretain

In V1.0 and V1.1: Restores the RETAIN variables from the SD card.

As of V1.2: Restores the RETAIN variables from RAM

(same as retain restore)

Specific
setpwd

Sets the PLC password (required at logon!)

Note: From CPU firmware V2.3.0 and higher, this command works as follows:

  • If there is no password set, a password can be set with: setpwd <new_password>
  • If there has been set a password, you have also to specify the old password: setpwd <old_password> <new_password>

Standard (with CPU firmware to V2.3.0)

Specific (with CPU firmware V2.3.0 and higher)

delpwd

Deletes the PLC password

Note: From CPU firmware V2.3.0 and higher, this command works only if a password has been set. Also, you have to specify the old password to delete it, i. e. syntax is: delpwd <current_password>

Standard (with CPU firmware to V2.3.0)

Specific (with CPU firmware V2.3.0 and higher)

plcload Displays the PLC utilization (system+IEC+tasks+communication) Standard
rtsinfo

Displays the firmware information (version, driver) in the format:

rtsinfo

rts version: 2.4.7.24

OS version: SMX smxPPC     3.5.2

u:code:ses IO driver interface

rts api version: 2.408

4 driver(s) loaded

driver 1: AC500 CPU     driver, device interface version: 2.403

driver 2: AC500 I/O-BUS     driver, device interface version: 2.403

driver 3: AC500 COM     driver, device interface version: 2.403

driver 4: AC500 Coupler     driver, device interface version: 2.403

AC500 PM581(DISP) :     V2.1

AC500 PM581(BOOT) :     V2.0.5, 2010-10-26 (Build: 9603, 13:55:09, Rel)

AC500 PM581(FW)   :     V2.0.4, 2010-10-12 (Build: 9530, 14:30:50, Rel)

Specific
traceschedon Enables task tracing No
traceschedoff Disables task tracing No
traceschedstore Stores task trace to RAM No
fdir <path> Show content of a drive or directory <path> (e.g.:code:fdir userdisk, fdir sdcard/userdata) Specific as of V2.1
fread <path> Dump a file’s content Specific as of V2.1
mkdir <path> Create a directory Specific as of V2.1
deldir <path> Delete an empty directory Specific as of V2.1
rndir <old path> <new path> Rename a directory Specific as of V2.1
ipaddr Sets the IP address of the CPU No
basetick Sets the basetick to µs No
diagreset Resets the diagnosis system Specific
diagack all Acknowledges all errors Specific
diagack x Acknowledges all errors of the class X (with X= 1…4) Specific
diagshow all

Shows all errors in the format:

diagshow all

--- All errors ---

State             Class     Comp Dev Mod Ch Err

0152502216

active and acknowledged  4    9    22  31 31  8

1970-01-01     00:00:08 occurred

disappeared

1970-01-01     00:00:15 ack.

0152369165

active     not acknowledged    49 2031013

1970-01-01     01:19:12 occurred

-                   disappeared

-                   ack.

--- end ---

Specific
time Displays and sets the time of the realtime clock Specific
date Displays and sets the date of the realtime clock Specific
batt Polls the battery status Specific
sdappl Saves the boot project to the SD card Specific
sdclone Copys the user program and the user data to the SD card. For AC500-S only!
sdfunc Displays and changes the SD card function Specific
sdboot Updates the bootcode from the SD card Specific
sddisplay Updates the MMI firmware from the SD card Specific
sdfirm Updates the firmware from the SD card Specific
sdcoupler x Updates the firmware of Communication Module x from the SD card Specific
cpuload Displays the CPU load (current, min., max., average) Specific
delappl Deletes the user program in the Flash memory Specific
retain

Saving and restoring the RETAIN variables:

retain clear -> Clears all RETAIN variables

retain save -> Saves the RETAIN variables to the RAM disk

retain restore -> Restores the RETAIN variables from the RAM disk

retain export -> Exports the RETAIN variables from the RAM disk to the SD card

retain import -> Imports the RETAIN variables from the SD card to the RAM disk

Specific as of V1.2
persistent

Saving and restoring the persistent area %R area:

persistent clear -> Clears the %R area

persistent save -> Saves the buffered %R area to the RAM disk

persistent restore -> Restores the buffered %R area from the RAM disk

persistent export -> Exports the buffered %R area from the RAM disk to the SD card

persistent import -> Imports the buffered %R area from the SD card to the RAM disk

Specific as of V1.2
io-bus stat Displays the I/O bus statistic Specific
io-bus desc Displays the I/O bus configuration Specific
com protocols Displays the protocols available for the serial interfaces Specific
com settings Displays the serial interface settings Specific
coupler desc Displays information on the Communication Module interfaces (type, firmware, serial number, date) Specific
coupler settings Displays the current Communication Module settings, for example, IP address and socket assignment Specific as of V1.2
reboot

Reboots the PLC (CoDeSys performs a logout when restarting or logout possible up to 3 seconds after command input)

(This command is not available for CM574-RS as of firmware revision V2.1.x)

Specific
diskcfg

Access to drive maintenance

Command Syntax:

diskcfg [option] [drivename]

Command Options:

  • unlock: unlock a drive for writing MBR or formating
  • lock : lock drive again
  • writembr : write clean MBR (unlock required)
  • format : write clean file system (unlock required)
  • settings : show drive configuration details
  • desc: show drive overview
  • help : show this help
  • [none] : no option shows this help

Available Drives (not all commands are supported on all drives):

  • Flash
  • SD Memory Card
  • Ramdisk
  • Userdisk
  • Flashdisk
  • Sramdisk
Specific as of V2.1
proddata

Shows Production Data of PLC

proddata

Production data

---------------

Ident     :     1SAP130100R0200

Index     :     B1

Type      :     PM571

Date      :     0447

BA-Inst   :     1S120

Factory   :     05

Year      :     07

Serial No. : 00007134

MAC-Addr  : “

Specific as of V2.0
confdata

Shows Configuration Data of PLC

With the Function Blocks CPU_CONFIG_READ CPU_CONFIG_READ: CPU_CONFIG_READ CPU_CONFIG_READ and CPU_CONFIG_WRITE: CPU_CONFIG_WRITE CPU_CONFIG_WRITE (from SysInt_AC500_V10.lib) it is possible to save and load PLC specific configuration of any kind. The AC500 firmware also uses this INI file for settings like IP addresses.

Specific