CTRL_PWM: CTRL_PWM: CTRL_PWM: CTRL_PWM: Pulse-width Pulse-width Pulse-width Pulse-width modulationmodulationmodulationmodulation

Description

You can use the "CTRL_PWM" instruction to enable and disable a pulse output supported by the CPUusing the software.

NoteNoteNoteNotePulse output parameters are assigned exclusively in the device configuration and not using the"CTRL_PWM" instruction. Any change of parameters that is intended to have an effect on the CPUmust therefore be made while the CPU is in STOP mode.

You enter the hardware ID of the pulse output you want to control with the instruction in the PWMinput. Error-free execution of the instruction is possible only when the specified pulse output is ena‐bled in the hardware configuration.

Only tags of "HW_PWM" data type can be specified in the PWM input. The hardware data typeHW_PWM has a length of one WORD.

The pulse output is enabled when the bit in the ENABLE input of the instruction is set. If ENABLE hasthe value TRUE, the pulse output generates pulses that have the properties defined in the device con‐figuration. When the bit in the ENABLE input is reset or the CPU changes to STOP, the pulse outputis disabled and no more pulses are generated.

The "CTRL_PWM " instruction is only executed if the signal state in the EN input is "1".

Since the S7-1200 enables the pulse output when the "CTRL_PWM" instruction is executed, BUSY atS7-1200 always has the value FALSE.

The ENO enable output is set only when the EN enable input has signal state "1" and no errors haveoccurred during execution of the instruction.

NoteNoteNoteNote

Use Use Use Use of of of of the the the the force force force force table table table table for for for for PWM PWM PWM PWM and and and and PTOPTOPTOPTO

Digital inputs and outputs that are used for PWM and PTO cannot be forced. Digital inputs and out‐puts that were assigned via device configuration cannot be controlled by either the force table orthe monitoring table.

ParametersParametersParametersParametersThe following table shows the parameters of the "CTRL_PWM" instruction:

ParameterParameterParameterParameter DeclarationDeclarationDeclarationDeclaration Data Data Data Data typetypetypetype Memory Memory Memory Memory areaareaareaarea DescriptionDescriptionDescriptionDescription

PWM Input HW_PWM(WORD)

I, Q, M, L or con‐stant Hardware ID of the pulse generator

ENABLE Input BOOL I, Q, M, D, L orconstant

The pulse output is enabled whenENABLE = TRUE and disabled whenENABLE = FALSE.

BUSY Output BOOL I, Q, M, D, L Processing statusSTATUS Output WORD I, Q, M, D, L Status of the instruction

For additional information on valid data types, refer to "Overview Overview Overview Overview of of of of the the the the valid valid valid valid data data data data typestypestypestypes".

CTRL_PWM: Pulse-width modulation (S7-1200, S7-1500)

- 1 -

Parameter Parameter Parameter Parameter STATUSSTATUSSTATUSSTATUS

Error Error Error Error code*code*code*code*(W#16#...)(W#16#...)(W#16#...)(W#16#...)

DescriptionDescriptionDescriptionDescription

0 No error80A1 Hardware ID of the pulse generator is invalid* The error codes can be displayed as integer or hexadecimal values in the program editor. For ad‐ditional information on toggling display formats, refer to "See also".

CTRL_PWM: Pulse-width modulation (S7-1200, S7-1500)

- 2 -

CTRL_HSC: CTRL_HSC: CTRL_HSC: CTRL_HSC: Control Control Control Control high-speed high-speed high-speed high-speed counterscounterscounterscounters

Parameter

ParameterParameterParameterParameter Data Data Data Data typetypetypetype Memory Memory Memory Memory areaareaareaarea DescriptionDescriptionDescriptionDescriptionEN BOOL I, Q, M, D, L Enable inputENO BOOL I, Q, M, D, L Enable output

HSC HW_HSC I, Q, M or constantHardware address ofthe high-speed counter(HW-ID)

DIR BOOL I, Q, M, D, L or constantEnables the new countdirection (seeNEW_DIR)

CV BOOL I, Q, M, D, L or constant Enables the new countvalue (see NEW_CV)

RV BOOL I, Q, M, D, L or constantEnables the new refer‐ence value (seeNEW_RV)

PERIOD BOOL I, Q, M, D, L or constant

Enables the new periodof a frequency meas‐urement (seeNEW_PERIOD)

NEW_DIR INT I, Q, M, D, L or constant Count direction loadedwhen DIR = TRUE.

NEW_CV DINT I, Q, M, D, L or constant Count value loadedwhen CV = TRUE.

NEW_RV DINT I, Q, M, D, L or constant Reference value loa‐ded when RV = TRUE.

NEW_PERIOD INT I, Q, M, D, L or constant

Period of the frequencymeasurement loadedwhen PERIOD =TRUE.

BUSY BOOL I, Q, M, D, L Processing statusSTATUS WORD I, Q, M, D, L Status of the operation

DescriptionDescriptionDescriptionDescriptionWith the "Control high-speed counters" instruction, you can make parameter settings and control thehigh-speed counters supported by the CPU by loading new values into the counter. Execution of theinstruction requires that the high-speed counter to be controlled is enabled. You cannot execute multi‐ple "Control high-speed counters" instructions simultaneously in the program for a given high-speedcounter.

You can load the following parameter values into a high-speed counter using the "Control high-speedcounters" instruction:

CTRL_HSC: Control high-speed counters (S7-1200, S7-1500)

- 3 -

• Count direction (NEW_DIR): The count direction defines whether a high-speed counter counts upor down. The count direction is defined by the following values at the NEW_DIR input: 1 = up, -1 =down.

A change to the count direction with the "Control high-speed counters" instruction is only possiblewhen direction control is set in the parameters by the program. The count direction specified at theNEW_DIR input is loaded into a high-speed counter when the bit at the DIR input is set.

• Count value (NEW_CV): The count value is the initial value at which a high-speed counter startscounting. The count value can be in the range -2147483648 to 2147483647.

The count value specified at the NEW_CV input is loaded into a high-speed counter when the bit atthe CV input is set.

• Reference value (NEW_RV): You can compare the reference value with the current counter valueto trigger an alarm. Similar to the counter value, the reference value can be in the range-2147483648 to 2147483647.

The reference value specified at the NEW_RV input is loaded into a high-speed counter when thebit at the RV input is set.

• Period of the frequency measurement (NEW_PERIOD): The period of the frequency measurementis specified by the following values at the NEW_PERIOD input: 10 = 0.01s, 100 = 0.1s, 1000 = 1s.

The time period can be updated if the "Measure frequency" function for the specified high-speedcounter is configured. The time period specified at the NEW_PERIOD input is loaded into a high-speed counter when the bit at the PERIOD input is set.

The "Control high-speed counters" instruction is only executed if the signal state at the EN input is "1".As long as the operation is executing, the bit at the BUSY output is set. Once the operation has exe‐cuted completely, the bit at the BUSY output is reset.

The ENO enable output is set only when the EN enable input has signal state "1" and no errors occurduring execution of the operation.

When inserting the "Control high-speed counters" instruction, an instance data block is created inwhich the operation data is saved.

Parameter Parameter Parameter Parameter STATUSSTATUSSTATUSSTATUSAt the STATUS output, you can query whether errors occurred during execution of the "Control high-speed counters" instruction. The following table shows the meaning of the values output at the STA‐TUS output:

Error Error Error Error code code code code (hexadecimal)(hexadecimal)(hexadecimal)(hexadecimal) DescriptionDescriptionDescriptionDescription0 No error80A1 Hardware identifier of the high-speed counter invalid80B1 Count direction (NEW_DIR) invalid80B2 Count value (NEW_CV) invalid80B3 Reference value (NEW_RV) invalid80B4 Period of the frequency measurement (NEW_PERIOD) invalid80C0 Multiple access to the high-speed counter

80D0 The high-speed counter (HSC) is not enabled in the CPU hard‐ware configuration.

CTRL_HSC: Control high-speed counters (S7-1200, S7-1500)

- 4 -