This code is a control script, which appears to be...

August 25, 2025 at 08:07 PM

local debug = not My.Config.IsSiteServer
local feeder = PF341
local motor1 = FM343_1
local motor2 = FM343_2
local gate1 = VE344
local gate2 = VE345
local pump = HP336
local flakerRolls = V343
local flakerVir = FM343_vir
local equipmentAlarms = (pump.AlarmedOutput.Value) or motor1.AlarmedOutput.Value or motor2.AlarmedOutput.Value 
						or flakerRolls.AlarmedOutput.Value or FlakingStop.InAnAlarmState.Value

local motor1Running = Me.iRollMotor1Running.Value 
local motor2Running = Me.iRollMotor2Running.Value 
local rollsClosed = Me.iHMIRollsClose.Value 
local rollsOpened = Me.iRollsOpened.Value
local runMotor1 = false 
local runMotor2 = false 
local runPump = false 
local closeRollsCMD = false 
local OKStartMotors = pump.RampComplete.Value 
local OKCloseRolls = motor1.RampComplete.Value and motor2.RampComplete.Value and pump.RampComplete.Value

local statusMsg = ""

if flakerRolls and (not flakerRolls.GateType == flakerRolls.GateType.SingleActing) then flakerRolls.GateType = flakerRolls.GateType.SingleActing end 
--------------------------------------------------------------------------------------------------------------------------------------------------
--HMI imputs
--------------------------------------------------------------------------------------------------------------------------------------------------
local HMIenableFlaker = Me.iHMIEnableFlaker.InputValue 
local HMIstartMotors = Me.iHMIRollMotorsStart.InputValue and motor1.InAutoMode.Value and motor2.InAutoMode.Value 
local HMIcloseRolls = Me.iHMIRollsClose.InputValue 
local HMIMasterEnable = true --Me.iHMIMasterEnable.Value --.Value deliberate 

--Block pushbuttons if not Enabled or Master Enable is off
if not HMIenableFlaker or not HMIMasterEnable then 
	if Me.iHMIEnableFlaker.InputValue then Me.iHMIEnableFlaker.InputValue = false end 
	if Me.iHMIRollMotorsStart.InputValue then Me.iHMIRollMotorsStart.InputValue = false end 
	if Me.iHMIRollsClose.InputValue then Me.iHMIRollsClose.InputValue = false end 
	HMIenableFlaker = false 
	HMIstartMotors = false 
	HMIcloseRolls = false 
end 
--------------------------------------------------------------------------------------------------------------------------------------------------

--Set hydraulic pump idle timer 
if pump.IdleTimer.PresetSeconds ~= Me.pCfgHydaulicPumpStopDelay then 
	pump.IdleTimer.PresetSeconds = Me.pCfgHydaulicPumpStopDelay
end 

--Delay before rolls considered to be opened 
if Me.iRollsOpened.DebounceOnSeconds ~= Me.pCfgRollOpenTime then 
	Me.iRollsOpened.DebounceOnSeconds = Me.pCfgRollOpenTime
end 

--Delay before rolls considered to be closed 
if Me.iRollsClosed.DebounceOnSeconds ~= Me.pCfgRollCloseTime then 
	Me.iRollsClosed.DebounceOnSeconds = Me.pCfgRollCloseTime
end 

--Delay before stopping hydraulic pump when system disabled 
if Me.tPumpDelayStop.PresetSeconds ~= Me.pCfgHydaulicPumpStopDelay then 
	Me.tPumpDelayStop.PresetSeconds = Me.pCfgHydaulicPumpStopDelay 
end 

--Delay starting roll motor 2 from start of roll motor 1
if Me.tRollMotor2StartDelay.PresetSeconds ~= Me.pCfgRollMotor2StartDelay then 
	Me.tRollMotor2StartDelay.PresetSeconds = Me.pCfgRollMotor2StartDelay
end 

if not flakerRolls.InAutoMode.Value then 
	flakerRolls.AutoPB.OneShot = true
end 

--------------------------------------------------------------------------------------------------------------------------------------------------
--Functions 
--------------------------------------------------------------------------------------------------------------------------------------------------
local function debugPrint(s)
	if (debug) then
		helmprint(tostring(os.date()).. ": " .. Me.Name..".BStC: " .. tostring(s))
	end
end

local function openRolls() 
	closeRollsCMD = false 
end 

local function closeRolls()
	if feeder.RampComplete.Value and motor1.RampComplete.Value and motor2.RampComplete.Value then 
		closeRollsCMD = true
	else 
		closeRollsCMD = false 
		if Me.iHMIRollsClose.InputValue then 
			Me.iHMIRollsClose.InputValue = false 
		end 
	end 
end 

local function startPump()
	runPump = true
end 

local function  stopPump()
	runPump = false 
end 

local function startMotors()
	runMotor1 = true 
	--Once motor1 is running start a timer before starting motor2
	if motor1Running then 
		if not Me.tRollMotor2StartDelay.Enabled then 
			Me.tRollMotor2StartDelay.Enabled = true 
		end 
	else
		if Me.tRollMotor2StartDelay.Enabled then 
			Me.tRollMotor2StartDelay:Reset() 
			Me.tRollMotor2StartDelay.Enabled = false 
		end 
	end 

	--Start motor2 once timer is done
	if motor1Running and Me.tRollMotor2StartDelay.TimerDone or Me.tRollMotor2StartDelay.PresetSeconds == 0 then 
		runMotor2 = true 
	else 
		runMotor2 = false 
	end 
end 

local function stopMotors() 
	runMotor1 = false  
	runMotor2 = false 

	if Me.tRollMotor2StartDelay.Enabled then 
		Me.tRollMotor2StartDelay:Reset()
		Me.tRollMotor2StartDelay.Enabled = false  
	end 
end 

local function clearOutputs()
	Me.oRunFeeder.Value = false 
end 

local function clearUserInputs()
	if Me.iHMIRollMotorsStart.InputValue then Me.iHMIRollMotorsStart.InputValue = false  end 
	if Me.iHMIRollsClose.InputValue then Me.iHMIRollsClose.InputValue = false end
	if not HMIMasterEnable then 
		if Me.iHMIEnableFlaker.InputValue then Me.iHMIEnableFlaker.InputValue = false end
	end 
end 

--------------------------------------------------------------------------------------------------------------------------------------------------
--State functions 
--------------------------------------------------------------------------------------------------------------------------------------------------
local function stateIdle() --0

	if HMIenableFlaker then 
		startPump()
	else 
		stopPump()
	end 

	stopMotors()
	openRolls()

	if HMIenableFlaker and not equipmentAlarms then 
		Me.pState = states.run
	end 

	if not HMIMasterEnable then 
		clearUserInputs()
	end 

end

local function stateRun() --10
	startPump()

	if (not motor1.InAutoMode.Value or not motor2.InAutoMode.Value) and Me.iHMIRollMotorsStart.InputValue then 
		Me.iHMIRollMotorsStart.InputValue = false 
	end

	if HMIcloseRolls then 
		closeRolls()
	else 
		openRolls()
	end 

	if HMIstartMotors then 
		startMotors()
	else 
		stopMotors()
	end 

	if not HMIenableFlaker or not HMIMasterEnable or equipmentAlarms then 
		clearUserInputs()
		Me.pState = states.idle
	end 

end 

--------------------------------------------------------------------------------------------------------------------------------------------------
--Execute state functions 
--------------------------------------------------------------------------------------------------------------------------------------------------
if not HMIenableFlaker then 
	--clearUserInputs()
	--Me.pState = states.idle
end 

if Me.pState == states.run then 
	stateRun() 
else 
	Me.pState = states.idle
	stateIdle() 
end

if Me.pStatus ~= statusMsg then  
	Me.pStatus = statusMsg 
end 

--Set outputs to run equipment
Me.oPumpRun.Value = runMotor1 or runMotor2 or Me.iHMIEnableFlaker.Value --runPump
Me.oRollsMotor1Run.Value = runMotor1
Me.oRollsMotor2Run.Value = runMotor2
Me.oRollsClose.Value = closeRollsCMD

if Me.pStatus ~= statusMsg then 
	Me.pStatus = statusMsg
end 


--------------------------------------------------------------------------------------------------------------------------------------------------
--Downstream gates positioning and loaded flags
--------------------------------------------------------------------------------------------------------------------------------------------------

if flakerVir.Loaded then 
	gate1.InhibitClean.InputValue = true
	gate2.InhibitClean.InputValue = true
	gate1.LoadMe = true
	gate2.LoadMe = true
else
	gate1.InhibitClean.InputValue = false
	gate2.InhibitClean.InputValue = false
end  

if Me.iDownstreamFillRequest.Value and VE375.AtPositionTwo.Value and CD370_DRAG.RampComplete.Value and CD401_DRAG.RampComplete.Value and 
	motor1.RampComplete.Value and motor2.RampComplete.Value and feeder.RampComplete.Value and flakerRolls.AtOpenPosition.Value
then
	Me.oGatesReqPos1.Value = 1
	Me.oGatesReqPos2.Value = 1
else 
	Me.oGatesReqPos1.Value = 2
	Me.oGatesReqPos2.Value = 2
end

This code is a control script, which appears to be used for operating and automating a flaking process involving industrial machinery. The code is implemented as part of a larger control system with configurable parameters, states, and equipment states. Here's a high-level breakdown of what it does:

1. Initialization:

Variables and equipment objects like motors, pumps, and gates are defined and associated with their respective system components.
Initialization of parameters, such as delays, equipment alarms, and interlocks for safety.

2. HMI (Human-Machine Interface) Inputs:

Handles user inputs (e.g., enabling the system, starting motors, closing rolls) through the HMI.
Ensures safety by disabling controls if the flaking machine is not enabled or a master enable switch is off.
Blocks button presses when certain conditions are not met.

3. Configuration of Timers:

Sets delays for hydraulic pumps, roll motor start sequencing, and opening/closing rolls.
These delays are used to coordinate machinery operation and ensure safe transitions between states.

4. Equipment States and Alarm Handling:

Continuously checks the alarm state of critical equipment like motors, pumps, and rolls. These alarms dictate when certain parts of the system can run safely.

5. Functions:

Basic Operations:
- Functions (e.g., startPump, stopPump, startMotors, stopMotors, closeRolls, openRolls) encapsulate individual equipment behaviors.
Reset Functions:
- Functions (e.g., clearUserInputs, clearOutputs) are used to reset outputs or clear user inputs when needed or in response to an error or stop condition.
Debugging:
- Provides debugging print statements to log important system events during debugging.

6. State Machine:

The code defines different states for the system and transitions between these states based on system conditions:
- Idle State:
  - If the system is not enabled or alarms are active, it stops all equipment and prevents operation.
  - Prepares the system to enter a run state if conditions are safe.
- Run State:
  - Starts and controls equipment operation.
  - Manages individual behaviors for rolls, motors, and pumps (e.g., motor sequencing, roll closing).
  - Monitors for alarms, HMI inputs, and other conditions to transition back to the idle state if necessary.

7. Output Control:

Updates the physical outputs of the system (e.g., to start/stop motors, close rolls, open gates).
Ensures coordination between upstream/downstream signals and component statuses.

8. Downstream Gate Control:

Executes logic to position downstream gates and manage fill requests.
Takes into account conditions like roll and motor states, gate positions, and feeder readiness before allowing certain operations.

Summary:

The script operates an automated system to control flaker machinery, monitoring alarms, coordinating equipment states, processing user inputs, and ensuring safety through interlocks and alarms. It integrates equipment-specific delays, sequencing logic, and state-machine control to reliably manage the machinery's operation. Its purpose is to handle the automation logic for flaker rolls, motors, pumps, gates, and downstream activities in an industrial setting, while maintaining safety and operational efficiency.

Generate your own explanations

Download our vscode extension

Read other generated explanations

Built by @thebuilderjr