Blank custom interface cabinet bridges building-control and lighting hardware in a mechanical room.
This primary view makes the visible room or equipment interfaces concrete while planning custom integrations; final equipment and placement follow the site survey.
Automation

Custom Integrations

Building automation integration is the focus of this guide. The interface decides feasibility. Custom integration connects systems that were not delivered as one product. The first task is an interface audit, because a logo or mobile app does not prove that a supported control path exists.

Quick answer

What is custom integrations?

Interfaces need proof. A custom integration can use a documented API, protocol gateway, dry contact or other approved interface to exchange commands and status. Feasibility depends on the exact model, firmware and exposed functions. If the interface is private or unstable, replacement may be safer than a fragile bridge.

Understand

Check the dependencies around custom integration

Read the adjacent technical page before choosing equipment. It may change the wiring, network or control method that belongs in the brief.

Read the related guide

How to think about it

Interfaces need proof. Integration is translation; one side says what happened in its own format; the bridge turns that into a message the other side understands. Missing words stay missing, so a gateway cannot create feedback that the source device never provides.

Shared technical guidance

What does an interface audit collect?

Commissioning needs evidence. We record model and firmware, physical ports, protocols, authentication, data objects, command rights, rate limits and vendor support; a bench test is used when documentation leaves an important gap.

Requirements come first. The audit ends with supported, unsupported and uncertain functions. Uncertainty is priced as investigation, not disguised as a promise. The written result should name the model, interface, test evidence and next investigation needed before any uncertain function becomes a promise on site.

Who owns the bridge after handover?

Failure needs a tested path. The scope names the software or gateway, configuration backup, credentials, update policy and recovery steps; custom code also needs a repository and a defined runtime environment.

Vendor API changes are an ongoing risk. A manual alternative keeps the building usable while that risk is resolved. The fallback should remain documented and usable without the changed interface while a supported replacement, update or rollback is evaluated on site.

Service-specific guidance

API, gateway or relay?

Interfaces need proof. An API can expose rich status and commands; a certified gateway maps known protocol objects; a relay offers a small but often dependable binary interface. The simplest interface that meets the need is usually easier to support.

How is a proof of concept tested?

Commissioning needs evidence. One representative device is connected, commands and feedback are logged, error states are forced, and restart behaviour is observed; production design follows only after those results are recorded. The test record names firmware and interface versions.

When should an integration be rejected?

The room changes performance. Reject it when the only path depends on screen scraping, a personal account, undocumented cloud calls or a safety bypass; clever is not the same as supportable.

How is integration effort estimated and kept supportable?

Scope sets the budget. Cost is driven by interface quality, number of commands and states, authentication, rate limits, event behavior, test environments, exception handling and future version changes. A supported manufacturer gateway is usually safer than reverse-engineering a private interface. Sometimes two separate user interfaces are the honest alternative when the systems have no stable, documented way to exchange data.

Commissioning needs evidence. Start with an interface proof using real hardware or a vendor sandbox before promising the full workflow; freeze a data map, command authority and timeout behavior, then test normal, delayed, rejected, duplicated and unavailable responses. Handover includes configuration, credentials ownership, version information, logs and a way to disable the bridge. If either side fails, commands should time out visibly and avoid repeated unsafe retries. Routine service should review API or firmware changes before applying them to production.

What does integration commissioning prove?

One successful command is insufficient. Commissioning exercises normal, delayed, denied, duplicated and unavailable responses with real supported interfaces, then records timeouts, authority, logs, disable controls and the expected state on both sides.

Featureless gate motor cover, safety photocells and junction box support an integrated villa entrance.
This related view exposes coordination points beyond the first device while planning custom integrations; final equipment and placement follow the site survey.

How the system works

Custom integration boundary map: Source system, Interface, Gateway, Target system, Fallback
Acceptance should verify fallback explicitly before the system is handed over.
Command, acknowledgement and state synchronisation: Command, Acknowledgement, State update, Timeout, Retry
Acceptance should verify retry explicitly before the system is handed over.

Comparison and decision tables

Custom integration interface choice
InterfaceStrengthReason to reject
Documented APIRich commands and statusNo stable authentication or support
Protocol gatewayDefined object mappingRequired points are absent
Dry contactSmall and understandable scopeNeed for detailed state feedback
Legacy apartment intercom distribution is bridged to a compact local gateway.
This third view keeps commissioning access and future serviceability in scope while planning custom integrations; final equipment and placement follow the site survey.

Evaluate

Turn the custom integration brief into drawings

Bring the floor plan, reflected ceiling plan or equipment schedule. We can mark assumptions, interfaces and unresolved choices before procurement.

Request a design review

Editorial information

Content owner: SmartR Spaces Editorial Team

Technical owner: SmartR Spaces Systems Engineering

Content updated:

Sources

Next step

Discuss a scoped custom integration project

A useful proposal starts with the property, expected behaviour and handover standard. Product names come after those decisions.

Book a consultation