# Nomenclature request

J

#### Jiri Baum

Hello,

I can't think of a good word...

What is an:
- input from the point of view of its I/O driver,
- output from the POV of the logic engine that controls it
- internal relay from the POV of the logic engine that controls it

One word for all of them.

So far I've thought of writes', but it sounds obscure, and produces', but it's rather long. Sets' might be better, except it has so many other meanings, even within this project.

Jiri
--
Jiri Baum <[email protected]>
Windows is not popular. Windows is *widespread*. Linux is popular.

_______________________________________________
LinuxPLC mailing list
[email protected]
http://linuxplc.org/mailman/listinfo/linuxplc

J

#### Jiri Baum

Scott Cornwall:
> > Any suggestions? Verbs, nouns, adjectives?

Scott Cornwall:
> Coil is common in the PLC world.

Yes, but I wanted a word that would mean a coil that this module may change' as opposed to all the other coils, which it may read only.

The three that come to mind are
- inputs, for the I/O driver
- outputs, for a logic engine, and
- some coils for a logic engine

but that's three words, and messy at that.

Maybe I'll just arrange the syntax so the word isn't necessary...

Jiri
--
Jiri Baum <[email protected]>
Windows is not popular. Windows is *widespread*. Linux is popular.

_______________________________________________
LinuxPLC mailing list
[email protected]
http://linuxplc.org/mailman/listinfo/linuxplc

J

#### Jiri Baum

Simon Martin:

I think I didn't express myself very well :-(

I'm looking for a word that would mean a point this module may write', as distinct from a point this module may read'

Jiri
--
Jiri Baum <[email protected]>
Windows is not popular. Windows is *widespread*. Linux is popular.

_______________________________________________
LinuxPLC mailing list
[email protected]
http://linuxplc.org/mailman/listinfo/linuxplc

J

#### Joe Jansen

a driven point? A controlled point? a slave point? a point subject to control? A write-locked point? ( to distinguish that a process has isolated control as opposed to shared control). Isolated control?

More if I think of them.....

As a side note, and DEFINITELY NOT to say ANYTHING about submitted items, but just as a method of volunteering, I have done technical documentation for automation systems for 9 years. If anyone is looking to have some
documentation written up, I can oblige in this area. My coding skills are weak at this point, but if someone can provide some documented code, and maybe a brief description, I would be willing to take a stab at writing some expanded documentation, whenever someone feels the time is right.

LMK

--Joe

_______________________________________________
LinuxPLC mailing list
[email protected]
http://linuxplc.org/mailman/listinfo/linuxplc

S

J

#### Jiri Baum

Jansen, Joe:
> a driven point? A controlled point? a slave point? a point subject to
> control? A write-locked point? ( to distinguish that a process has
> isolated control as opposed to shared control). Isolated control?

Hmm, driven' might cause confusion with I/O driver'.

Controlled'/control' sounds good, but may be counterintuitive in some situations (an I/O driver controls the inputs but not the outputs).

Slave' should probably be reserved for later use.

I tend most naturally to write', but that's computer jargon, which I'm loath to use. Is it a commonly-used word in the PLC world?

I just checked through the archives, and other words I don't really like are owns' and only'.

BTW, all points are write-locked, so that only one module may change them. There used to be talk of making some points semaphore-controlled, but for the time being each point is written by exactly one module.

> As a side note, and DEFINITELY NOT to say ANYTHING about submitted items,
> but just as a method of volunteering, I have done technical documentation
> for automation systems for 9 years. If anyone is looking to have some
> documentation written up, I can oblige in this area.

Well, if you want to give me feedback on the docs I've written so far...

Jiri
--
Jiri Baum <[email protected]>
Windows is not popular. Windows is *widespread*. Linux is popular.

_______________________________________________
LinuxPLC mailing list
[email protected]
http://linuxplc.org/mailman/listinfo/linuxplc

C

#### Curt Wuollet

Welcome Joe:

Can you put that and the other particulars in our "rogues gallery" ? Documentation is a crucial skill that all projects need.
cww

> As a side note, and DEFINITELY NOT to say ANYTHING about submitted items,
> but just as a method of volunteering, I have done technical documentation
> for automation systems for 9 years. If anyone is looking to have some
> documentation written up, I can oblige in this area. My coding skills are
> weak at this point, but if someone can provide some documented code, and
> maybe a brief description, I would be willing to take a stab at writing some
> expanded documentation, whenever someone feels the time is right.

_______________________________________________
LinuxPLC mailing list
[email protected]
http://linuxplc.org/mailman/listinfo/linuxplc

J

#### Joe Jansen

AFAIK, the most common term is 'Set' a bit, and 'Clear' a bit. I realize you had some concerns with this, but I believe it is the most common
terminology in the PLC realm.

--Joe

_______________________________________________
LinuxPLC mailing list
[email protected]
http://linuxplc.org/mailman/listinfo/linuxplc

J

#### Jiri Baum

Yes, I know - but is there a word that means either set or clear'?

I'm sure I'm expressing myself very badly.

What I'm looking for here is a word that could be used in the configuration of a module that would indicate that the module has the right to set and
clear the point indicated.

Since this is an input for an I/O driver but an output for a logic engine, it's difficult to come up with a word that would fit naturally into both
situations, yet clearly exclude everything else (outputs for an I/O driver, inputs for a logic engine etc).

Jiri
--
Jiri Baum <[email protected]>
Windows is not popular. Windows is *widespread*. Linux is popular.

_______________________________________________
LinuxPLC mailing list
[email protected]
http://linuxplc.org/mailman/listinfo/linuxplc

R

#### Ron Gage

Jiri:

How about "owner". If a "module" owns a "point" then it can manipulate the point. As for examining a point, that should be global and without any permissions, right?

Ron

_______________________________________________
LinuxPLC mailing list
[email protected]
http://linuxplc.org/mailman/listinfo/linuxplc

J

#### Jiri Baum

Yeah, I may well end up using that.

Still, what is a non-computer person going to say when told that an I/O driver owns the inputs, but not the outputs?

> As for examining a point, that should be global and without any
> permissions, right?

That's right.

Jiri
--
Jiri Baum <[email protected]>
Windows is not popular. Windows is *widespread*. Linux is popular.

_______________________________________________
LinuxPLC mailing list
[email protected]
http://linuxplc.org/mailman/listinfo/linuxplc

R

#### Ralph G. McDonald, P.E.

> You are the first tech writer I've noticed volunteering. As such you have a very valuable contribution to make. Thank you.<

I believe that this project needs a common vocabulary with attached definitions

There seems to be a problem with different terms meaning different things to different people,
probably due to our diverse backgrounds. As the
group comes to agreement on a term it should be included in an online database.

This could be a valuable contribution to progress on the project

Also in most PLCs that I have programmed coil refers to a point ( real or internal ) that is energized, set, or reset, by the logic.

Some PLCs use lock or unlock in place of set/reset.

I like the idea of being able to define write access to a point as either global or local.

Ralph
______________________________________
LinuxPLC mailing list
[email protected]
http://linuxplc.org/mailman/listinfo/linuxplc

P

#### Paul H. Gusciora

In the control world "state" or "state variable" is commonly used to describe the values on their way to or from real-world hardware.

Under normal conditions, the I/O driver copies the state.value to the output, and sets the state.status to success if writing was succesful. The I/O driver also sets the state raise OK and lower OK bits so that the loops which are sending their outputs to that particular analog output can
respond appropriately. During intialization, the I/O driver retrieieves the last output from the hardware (or perhaps from a sequestered location),
writes that to state.value and then invokes state.initialize to force all loops which are sending their outputs to that particular analog output to initialize.

Paul H. Gusciora
San Rafel, CA

Algorithms are free. What is expensive is interfaces to algorithms, and the engineering interface to apply them.

_______________________________________________
LinuxPLC mailing list
[email protected]
http://linuxplc.org/mailman/listinfo/linuxplc

J

#### Jiri Baum

Jack Gallagher:

Ok, set or clear or toggle'. (That covers all the operations.)

I'm not looking for a word for the operation; I'm looking for a word to describe the point itself.

A word I can use to say `module X can change point Y', concisely.

Jiri
--
Jiri Baum <[email protected]>
Windows is not popular. Windows is *widespread*. Linux is popular.

_______________________________________________
LinuxPLC mailing list
[email protected]
http://linuxplc.org/mailman/listinfo/linuxplc

J

#### Jiri Baum

Jansen, Joe:

> Could you put it into a sentence for context?

The context I'm thinking of is a config file, which (for each module) lists which points it has write access to. Among other things, presumably.

Jiri
--
Jiri Baum <[email protected]>
Windows is not popular. Windows is *widespread*. Linux is popular.

_______________________________________________
LinuxPLC mailing list
[email protected]
http://linuxplc.org/mailman/listinfo/linuxplc