Modicon M258 Logic Controller
Post Configuration
EIO0000004135 09/2020
Post Configuration Chapter 14
Post Configuration
Introduction
This chapter describes how to generate and configure the post configuration file of the Modicon
M258 Logic Controller.
What Is in This Chapter?
This chapter contains the following topics:
Topic
Post Configuration Presentation
Post Configuration File Management
Post Configuration Example
Page
236
238
241
EIO0000004135 09/2020
235
Post Configuration
Post Configuration Presentation
Introduction
Post configuration is an option that allows you to modify some parameters of the application without changing the application. Post configuration parameters are defined in a file called
Machine.cfg, which is stored in the controller.
By default, all parameters are set in the application.The parameters defined in the Post
Configuration file are used instead of the corresponding parameters defined in the application. Not all parameters have to be specified in the Post Configuration file (for example: one parameter can change the IP address without changing the Gateway Address). All parameters in the Post
Configuration file without corresponding hardware are ignored (for example, a PCI module configuration without a PCI module).
Parameters
The Post Configuration file allows you to change network parameters.
Ethernet parameters:
IP Address
Subnet Mask
Gateway Address
Transfer Rate
IP Config Mode
Device Name
Serial Line parameters, for each serial line in the application (embedded port or PCI module):
Baud rate
Parity
Data bits
Stop bit
Profibus parameters, for each Profibus in the application (PCI module):
Station address
Baud rate
NOTE: Parameter updates with a Post Configuration file that impacts parameters used by other devices via a communication port are not updated in the other devices.
For example, if the IP address used by an HMI is updated in the configuration with a Post
Configuration file, the HMI uses the previous address. You must update the address used by the
HMI independently.
236
EIO0000004135 09/2020
Post Configuration
Operating Mode
The Post Configuration file is read after:
A Reset Warm command
A Reset Cold command
A reboot
( see page 64 )
An application download
(
(
( see page 62
see page 63
see page 66
)
)
)
Refer to Controller States and Behaviors transitions.
( see page 47 )
for further details on controller states and
EIO0000004135 09/2020
237
Post Configuration
Post Configuration File Management
Introduction
The file Machine.cfg is located in the directory /usr/cfg .
Each parameter is specified by a variable type, variable ID, and value. The format is: id[moduleType].param[paramId].paramField=value where:
moduleType is a numerical value, for example 111.
paramId is a numerical value specifying the parameter to be modified, for example 10000.
paramField is a string value that must be used in addition to the paramId to specify serial line parameters, for example, “Bauds”.
value is the value assigned to the parameter. Its type depends on the parameter data type.
Each parameter is defined on three lines in the Post Configuration file:
The first line describes the internal 'path' for this parameter.
The second line is a comment describing the parameter in a comprehensive way.
The third line is the definition of the parameter (as described above) with its value.
Post Configuration File Generation
The Post Configuration file (Machine.cfg) is generated by EcoStruxure Machine Expert.
To generate the file, proceed as follows:
2
3
Step
1
Action
In the menu bar, choose Build → Post Configuration → Generate...
Result: An explorer window is displayed.
Select the destination folder of the Post Configuration file.
Click OK.
When you use EcoStruxure Machine Expert to create a Post Configuration file (Generate), it reads the value of each parameter assigned in your application program and then writes the values to the Machine.cfg Post Configuration file. After generating a Post Configuration file, review the file and remove any parameter assignments that you wish to remain under the control of your application. Keep only those parameter assignments that you wish changed by the Post
Configuration function that are necessary to make your application portable and then modify those values appropriately.
238
EIO0000004135 09/2020
Post Configuration
Post Configuration File Transfer
After creating and modifying your Post Configuration file, transfer it to the /usr/cfg directory of the controller. The controller does not read the Machine.cfg file unless it is in this directory.
You can transfer the Post Configuration file by the following methods:
USB Memory key
( see page 248 )
Download through the FTP server
(with the proper script)
( see page 171 )
Download with EcoStruxure Machine Expert controller device editor ( see page 72 )
Modifying a Post Configuration File
If the Post Configuration file is located in the PC, use a text editor to modify it.
NOTE: Do not change the text file encoding. The default encoding is ANSI.
To modify the Post Configuration file directly in the controller, use the Setup menu of the Web
server ( see page 149 ) .
To modify the Post Configuration file in the controller with EcoStruxure Machine Expert in online mode:
Step
1
2
5
6
3
4
Action
In the Devices tree, click the controller name.
Click Build → Post Configuration → Edit...
Result: The Post Configuration file opens in a text editor.
Edit the file.
If you want to apply the modifications after saving them, select Reset device after sending.
Click Save as.
Click Close.
NOTE: If the parameters are invalid, they are ignored.
EIO0000004135 09/2020
239
Post Configuration
Deleting the Post Configuration File
You can delete the Post Configuration file by the following methods:
USB Memory key
( see page 245
Through the FTP server
(
)
(with the delete script)
see page 171 )
Online with EcoStruxure Machine Expert controller device editor ( see page 72 )
, Files tab
For more information on Files tab of the Device Editor, refer to EcoStruxure Machine Expert
Programming Guide.
NOTE:
The parameters defined in the application are used instead of the corresponding parameters defined in the Post Configuration file after:
A Reset Warm command
A Reset Cold command
A reboot
( see page 64 )
An application download
(
(
( see page 62
see page 63
see page 66
)
)
)
240
EIO0000004135 09/2020
Post Configuration
Post Configuration Example
Post Configuration File Example
# TM258LD42DT4L / Ethernet / IPAddress
# Ethernet IP address id[111].param[0] = [0, 0, 0, 0]
# TM258LD42DT4L / Ethernet / SubnetMask
# Ethernet IP mask id[111].param[1] = [0, 0, 0, 0]
# TM258LD42DT4L / Ethernet / GatewayAddress
# Ethernet IP gateway address id[111].param[2] = [0, 0, 0, 0]
# TM258LD42DT4L / Ethernet / TransferRate
# Transfer Rate: 0:Auto, 1:10 MBit full, 2:10 MBit half, 3:100 MBit full,
4:100 MBit half id[111].param[3] = 0
# TM258LD42DT4L / Ethernet / IPConfigMode
# IP configuration mode: 0:FIXED 1:BOOTP 2:DHCP id[111].param[4] = 0
# TM258LD42DT4L / Ethernet / DeviceName
# Name of the device on the Ethernet network id[111].param[5] = 'my Device'
# TM258LD42DT4L / Serial Line / Serial Line Configuration / Baudrate
# Serial Line Baud Rate in bit/s id[40101].param[10000].Bauds = 38400
# TM258LD42DT4L / Serial Line / Serial Line Configuration / Parity
# Serial Line Parity (0=None, 1=Odd, 2=Even)
EIO0000004135 09/2020
241
Post Configuration id[40101].param[10000].Parity = 0
# TM258LD42DT4L / Serial Line / Serial Line Configuration / Data bits
# Serial Line Data bits (7 or 8) id[40101].param[10000].DataFormat = 8
# TM258LD42DT4L / Serial Line / Serial Line Configuration / Stop bits
# Serial Line Stop bits (1 or 2) id[40101].param[10000].StopBit = 1
# TM258LD42DT4L / PCI Slots / BusAddr
# Profibus station address id[42000].pos[1].id[34].param[100] = 2
# TM258LD42DT4L / PCI Slots / BaudRate
# Profibus Baud Rate (0: 9.6, 1: 19.2, 11: 45.45, 2: 93.75, 3: 187.5, 4:
500, 6: 1500, 7: 3000, 8: 6000, 9: 12000, 15: Auto) id[42000].pos[1].id[34].param[101] = 15
242
EIO0000004135 09/2020
