Back to lessons

Field-Ready · Lesson 1.4

Learning the Language

Point naming conventions: how to read a controller program without a translator.

1

Learning the Language

When you first open a program on an unfamiliar controller, you are going to see a list of point names that looks like someone fell asleep on a keyboard. CCLA_T. CWMUV_C. WWR_T. SF_S. Your first instinct might be to panic, close the laptop, and pretend you were never there. Do not. There is a system to this. It just has not been explained to you yet.

Point names are a language with rules. Once you learn the grammar you can read almost any program cold, even on a platform you have never touched. The rules are not standardized across the industry. Every contractor, every engineering firm, every manufacturer has their own conventions. Some use underscores, some use dashes, some use camelCase like a programmer who wandered into the wrong building. But the logic underneath is consistent. The same information is always encoded the same way: what system, what thing, what kind of point.

Most point names are built from three parts. A prefix that identifies the system or equipment: CW for condenser water, ZN for zone, DA for discharge air, OA for outdoor air. A descriptor that identifies what the point actually is: T for temperature, P for pressure, F for flow, MUV for makeup valve, SP for setpoint. And sometimes a suffixthat identifies the point's function: C for command, S for status, A for alarm. Not every name uses all three parts. Some drop the suffix when the descriptor makes the type obvious. But the pattern is almost always there if you look.

Walk through a real one. CWMUV_C. CW = condenser water. MU = makeup. V = valve. C = command. Four compressed segments and you know exactly what this point does and what kind of signal it is. It is telling the condenser water makeup valve to open or close. In JCI's world, -C is a binary command: open or closed, on or off. If you see -O, that is the analog output. You did not need a manual. You did not need to ask anyone. You just read the name.

One more that trips people up: the -Q suffix. JCI uses Q for CO2 points. Why Q? Because Q stands for quality, as in indoor air quality. It makes total sense once someone tells you. Before that it looks completely arbitrary. That is true of a lot of these conventions. They all made sense to whoever invented them. Your job is to learn enough of the pattern that you can decode new ones on the fly, and ask about the ones you cannot.

2

Common Suffixes

3

Decode the Point