Safety and interlocks

Permissive <smart-permissive>

Permissive displays a list of conditions that a start requires or that a running device depends on, with whether each condition is met.

<smart-permissive> · 8 properties, 2 methods, 3 events · source/modules/smart.permissive.js

Usage in Vue

Vue uses the custom element directly. A property is bound with :kebab-name; an array or an object needs the .prop modifier so that Vue sets the property rather than an attribute. Events are listened to with @eventName; methods are called on the element through a template ref.

import 'smart-industrial/source/modules/smart.permissive.js';

<smart-permissive ref="permissive" :label="'P-2101A start permissives'" :allow-bypass="true"
    @bypassRequest="onEvent"></smart-permissive>

// methods are called on the element the ref holds
permissive.value.summary();

// an array or an object is set as a property, not converted to an attribute: use .prop
<smart-permissive :conditions.prop="conditions"></smart-permissive>

Properties

Binding	Type, default	Description
:conditions conditions	array	Sets or retrieves the conditions as [{ id, label, satisfied, required, bypassed, bypassedBy, tag, value, description, timestamp }]. required defaults to true; an advisory condition is listed but never blocks. timestamp is the time the condition last changed state and is used to determine the first-out condition. Assign a new array to update the component. Flags given as text, as a tag database may hand them over, are read as such: 'false', '0', 'no', 'off' and '' are not set.
:mode mode	PermissiveMode permissive	Sets or retrieves the type of the list. A permissive list gates a start, and the verdict reads ready or not permitted. An interlock list trips a running device, the verdict reads healthy or tripped, and the first-out condition is marked.
:label label	string	Sets or retrieves the title of the list, usually the device name and the purpose of the list.
:show-first-out showFirstOut	boolean true	Determines whether the earliest unsatisfied required condition, by timestamp, is marked as first-out. Applies in interlock mode only. Conditions without a timestamp cannot be first-out, and a tie is reported as no first-out.
:show-satisfied showSatisfied	boolean true	Determines whether met conditions are listed. When off, a long list shows only the conditions that block; the verdict still counts every condition.
:show-timestamps showTimestamps	boolean true	Determines whether each condition shows how long it has been in its state, from its timestamp. The ages tick without the rows being rebuilt.
:allow-bypass allowBypass	boolean false	Determines whether a bypass control is offered on each required condition that blocks, and a removal control on each bypassed one. The control raises bypassRequest and changes nothing itself.
:announce-changes announceChanges	boolean true	Determines whether a change of verdict is read through the live region, assertively for a trip, politely otherwise.

Methods

Method	Description
summary(): object	Returns a summary of the list as { total, required, satisfied, unsatisfied, bypassed, ready, blocking, firstOut }, where blocking is the ids of the required conditions that are not met and firstOut is an id or null. With no conditions, ready is false: an empty list permits nothing.
conditionById(id: string): object	Returns the condition with the given id, as the application supplied it, or null. id string The condition's id.

Events

The data of an event is in event.detail. bypassRequest is a request: the bypass button appears only while allowBypass is true, and the component keeps the condition as it is until the application sets bypassed on it in conditions. readyChange reports a change of the overall verdict, and conditionClick reports a click on a row.

Event	Description and detail
@readyChange	This event is triggered when the verdict changes, a start becomes possible or a device trips, and not on every redraw. It also fires when the list is emptied (ready false, nothing blocking) and when it is filled again. ready boolean Whether every required condition is met or bypassed. blocking any[] The ids of the required conditions not met. firstOut string The id of the first-out condition, or null.
@bypassRequest	This event is triggered when a bypass control is pressed. The list is not changed; the application applies the bypass, records who applied it, and returns an updated list. It is raised once per press: the control waits for the application's updated list, or five seconds, before it asks again. Each bypass control is named after its condition. id string The condition's id. bypass boolean True to apply a bypass, false to remove one. condition object The condition as the application supplied it.
@conditionClick	This event is triggered when a condition row is clicked, so that the application can open the faceplate or trend of the tag. id string The condition's id. condition object The condition as the application supplied it.

Types

type PermissiveMode

'permissive' | 'interlock'

CSS variables

The component declares 6 CSS variables; the CSS page shows how to set them.

--smart-permissive-blocked-color --smart-permissive-blocked-fill --smart-permissive-bypass-color --smart-permissive-bypass-fill --smart-permissive-ready-color --smart-permissive-met-color