KEY TAKEAWAYS
- Check exact hardware and licensed interfaces.
- Keep tag meaning and quality with the value.
- Validate communication interruptions and stale data.
In this resource
Confirm the controller interface
Record the exact controller model, firmware and enabled communication options. Check documentation for available protocols and any licensing requirements.
An interface review should be performed with the people responsible for the equipment and network. Do not assume that a read-only reporting requirement permits changes to control behavior.
Create a tag register
A tag register connects the equipment address to a meaningful application name. Document the data type, unit, scaling, timestamp policy and quality indicator.
The example below is a planning convention, not a ready-to-use WhereFy API or controller address map. Actual register addresses and permissions must be confirmed for the equipment.
Validate before expanding
Compare selected values and state transitions with the machine or meter. Verify units and scaling rather than checking only that a number appears.
Define how a bad-quality value, stale timestamp or lost connection is represented. Use explicit missing-data states instead of silently carrying an old measurement forward as current.
Illustrative tag-register fields
| Field | Purpose | Example |
|---|---|---|
| Asset | Unique equipment identity | Floor01.CNC01 |
| Tag | Operating meaning | MachineState |
| Type / unit | How to interpret the value | Enumeration / no unit |
| Timestamp | When the value was observed | Agreed site time basis |
| Quality | Whether the data is usable | Good / stale / unavailable |
| Source | Verified equipment reference | Controller tag or register map |
Further reading
External references provide background. Their inclusion does not imply affiliation or equipment compatibility.
Have a site-specific question about these ideas?
Discuss your application