Creating Source Maps

A source map defines the set of points you want to read from a device. It includes each point’s name, address, type, and optional metadata like units.

A key benefit of source maps is reusability. A single source map can be bound to multiple sources — so if you have ten identical VAV controllers, you define the point list once and bind it to all ten. When you update the source map — adding a point, changing an address — the change applies to every source that uses it.

Adding a Source Map

There are several ways to add a source map to your project:

• Manually — create a source map from scratch in the UI and define each point by hand.
• Import — upload a source map from a CSV or Excel file. Useful when you have a large number of points or want to reuse a map from another project.
• Explorer — after learning points from a device in Explorer, you can create a source map directly from the discovered points. See Using Explorer.

Source maps are managed from the Source Maps library under Sources in your project. For structure and CSV format details, see Source Maps.

Creating a Source Map Manually

1. Navigate to Sources in your project.
2. Click Source Maps to open the source map library.
3. Click Add to create a new source map.
4. Enter the source-level details — name, protocol type, and optionally vendor and model.
5. Add points to the map. For each point, provide:
   • Name — a human-readable label
   • Address — the protocol-specific address (e.g. ai.1 for BACnet)
   • Type — the semantic point type
   • Unit — the unit of measurement (optional)

Notes

• A source map is a template — it doesn’t collect data on its own. You need to bind it to a source to start data collection. See Binding Sources.
• Source maps support calculated points that derive values from other points using formulas. See Calculated Points for details.