Table of Contents
Patriot Systems Reference
The detail behind Patriot Systems Integration: the one-off job your control room's Patriot administrator does, what Patriot's own interface allows and refuses, what is coming, and what to check when alarms are not arriving.
Setting a site up does not need anything on this page. Start with Patriot Systems Integration and come back here when you need it.
Loading the TetherX Event Types into Patriot
TetherX logs every alarm under its own event type number, from 9001 to 9049. Patriot accepts any number and answers the same way whether it knows it or not, so nothing fails: the difference is only visible on the operator's screen. A number Patriot holds arrives with the event type's description in front of ours. A number it does not hold arrives with no description and no action plan at all.
This section is for the Patriot administrator at the control room. It is two jobs, and only the first is a one-off:
| Job | How often |
|---|---|
| Importing the template, which creates the TetherX event types in Patriot | Once per Patriot system. Not per customer and not per site. The types are held once and every account points at them |
| Ticking Use Template on an account | Once per monitored account, so each new site the control room takes on |
So a control room imports the file the first time it monitors a TetherX site, and after that adding a customer is only the second step.
The Files
| File | What it is for |
|---|---|
| TetherX event types, Patriot XML template | Loaded through Maintenance > Clients > Merge Data. Creates a template client called TetherX Event Types holding all 49 types |
| TetherX event types, CSV | Opens in Excel. Use it to check the numbers against your existing templates, or to type the types in by hand |
The CSV carries the type number, the TetherX event name, the description an operator should see, what the event means, and a suggested action plan and priority for each one. The action plans are suggestions using Patriot's standard plan names, so your own plans and priorities take precedence.
Warning: The XML file is built to the same format as the templates Patriot publishes, but it has not been loaded into a live Patriot installation by TetherX. Patriot's own guidance is to test an import in a non-production environment first, and to contact Patriot Support if you want a hand with it. If you would rather not import anything, the CSV and the Event Types tab do the same job by hand.
Where Event Types Live in Patriot
Event types belong to a client, on the client's Event Types tab. Open a client from Maintenance > Clients, select the Event Types tab, and the list of type numbers and their descriptions is on the left, with Insert, Edit, Delete and Copy From buttons.
Templates are clients too. They are managed at Maintenance > Clients > Templates, and a template that carries event types has the (Event) Type category ticked on its Template Types tab.
Patriot documents both screens in its own library:
- Event Types (opens in a new tab) - the tab, the fields and the Template Selector
- Template Maintenance (opens in a new tab) - creating templates and template chaining
- Import Templates (opens in a new tab) - the Merge Data screen
A Template, Not the Client
Types can be entered straight onto a single client, or held once on a template that many clients point at. Use a template for anything beyond a single site. Patriot's own reasons are that a change to the template reaches every client using it at once, whereas types copied onto each client have to be changed one by one, and that the template is held once in the database rather than per client.
Types entered on a client are also local to it, so a second site monitored for the same customer gets none of them.
Importing the Template
- Download the XML file above.
- Go to Maintenance > Clients > Merge Data and select the file. Patriot reads it and lists the action plans it refers to.
- Match each action plan to one on your system using the selector beside it, or create a new one. The file refers to nine plans, all of them names Patriot's own standard templates use:
General Alarm,System Alarm,System Alert,Low Battery,Restoral, No Alarm,Zone Info, No Alarm,Closing (Set), No Alarm,Opening (Unset), No AlarmandTest Report. - Choose the merge behaviour. Skip Existing is the safe choice on a first import, because it leaves anything already in your database untouched.
- Click Save. Patriot writes a log of the import beside the file it read.
The imported template is a client numbered TETX000101, named TetherX Event Types. Rename or renumber it afterwards to suit your own conventions.
It refers on to the System Generated template (SYST000101) so that clients using it still receive Patriot's own 65000 and above system events. That is Patriot's own recommendation for every event type template. Check the reference on the template's Event Types tab after the import and point it at your System Generated template if yours is numbered differently.
Selecting the Template on an Account
Each account that TetherX reports to has to be told to use the template.
- Open the client from Maintenance > Clients.
- Select the Event Types tab, and find the Signal Interpretation area.
- Tick Use Template, then click the Template Selector to open the Template PopUp.
- Find TetherX Event Types and double click it. Its number then shows in the Template Selector, and the types appear in the list with the template indicator icon on the left. Hovering over that icon names the template each type came from.
- Save the client.
If a template already covers the account, chain rather than replace: a template can refer to another template, up to three deep, and a type in the first template overrides the same number in the one it refers to.
Numbers Already in Use Win, So Check 9001 to 9049 First
Types entered at client level override the same number coming from a template, and a template overrides the templates it refers to. So an entry that already exists at one of our numbers is what the operator sees, and ours is never reached.
This is not hypothetical. Testing against a development account on 18 September 2026, a TetherX perimeter alert and a person detection arrived on the operator's screen as fire signals, because the account's own types already held those two numbers:
| TetherX sends | Meaning in TetherX | What the operator saw |
|---|---|---|
| 9026 | Perimeter Alert | FB-Fire bypass |
| 9027 | Person Detected | FC - Fire Cancel |
Warning: A number already in use turns a video alarm into whatever that number already means, and a fire signal raised by a camera event sends an operator down the wrong procedure. Check 9001 to 9049 across every template an account chains to, and on the accounts themselves, before the first site goes live.
Where a number is taken, either remove the entry holding it or tell TetherX, and the TetherX range is moved instead. Patriot allows any number from 0 to 65535 and reserves above 65000 for its own internally generated signals, so 9001 to 9049 stays clear of Patriot's own range whichever way this goes.
Tip: Types that need no operator action, such as the arming, restore and status types in the list, should be given an action plan with priority 0. Patriot alarms on any signal type it has not seen before, so an unconfigured number creates an activation for the operator to clear.
Checking It Worked
Ask TetherX to send a test alarm, or generate a detection on a camera at the site, then open the signal in Patriot.
- A configured number reads with its event type description first, then the TetherX description, for example
Person Detected Person detected on Camera 3. - An unconfigured number reads with the TetherX description alone, and carries no action plan.
If the description is missing, the account is not reaching the template: check that Use Template is ticked on that client and that the Template Selector names the TetherX template.
What TetherX Can and Cannot Send to Patriot
Patriot's interface decides what can cross between the two systems. Everything below is based on Patriot's published API, so it applies to any Patriot control room, not only IMS.
Sent today
| What | How it reaches the operator |
|---|---|
| Alarms from AI detections, camera analytics and VMD | A signal against the site's client number, with the camera as the zone number and the event type as the Patriot type number |
| The verification image | Carried inside the alarm, so it opens in the operator's activation |
| Camera and device communication failures | The same way, as their own event types |
| The site's position | Sent with every alarm and shown on the account's Map tab |
| A heartbeat | Every minute from the control room account, as an ordinary signal to the account nominated for it |
The heartbeat signal
Patriot has no heartbeat of its own. What TetherX sends is an ordinary signal, once a minute, to whichever account the control room nominates, and the control room treats a gap in it the way it treats a quiet alarm receiver line.
| Field | Value |
|---|---|
| Type | 602 |
| Zone | 1 |
| Description | API Heartbeat Signal |
| Client number | The Watchdog Account on the control room account |
Warning: Type 602 is outside the 9001 to 9049 range the TetherX template covers, so it has to exist in the nominated account's event types as well, with an action plan at priority 0. An account that does not hold 602 raises an activation for an operator to clear once a minute, because Patriot alarms on any type it has not seen before.
Switch the heartbeat off on the control room account if your control room does not watch for one. | Arming and disarming | As their own signals, because Patriot has no arm or disarm command and a signal is the only way it records the state |
Built, and waiting on your control room
These are in TetherX and switched on per site, but the TetherX user in Patriot has to hold the right before the control room will answer. The message TetherX shows you names the right Patriot asked for.
| What | What it does | What it needs |
|---|---|---|
| Camera names | Writes each camera's name into the matching Patriot zone, so the operator reads "Loading Bay" rather than a number, without anybody retyping the list | Permission to edit the account's zones |
| Maintenance windows | Puts the site on test at the control room for up to 24 hours with a reason, so planned work does not become operator call-outs. Alarms still reach Patriot and are still recorded, so the history is kept | Permission to set test mode |
| Operator actions | A note, a close, a snooze or taking an alarm in TetherX is reflected on the control room's screen | Permission to read and work alarms |
| What the operator did | The event shows who took the alarm, how long they took and how they completed it | The same permission |
Operator actions, and the honest limits
An operator working an alarm in TetherX can close it, record what action was taken, add a note, flag the footage, share it, escalate it and generate a report. Patriot's API allows some of that to be reflected in the control room, and refuses the rest.
| Action in TetherX | Can it reach Patriot? | How |
|---|---|---|
| Adding a note | Yes | A note can be written against the alarm the operator is working |
| Closing an event | Yes | The alarm can be completed, and on newer Patriot versions given a completion reason. Patriot answers with anything its own rules still require, such as a reason or a contact that was not checked |
| Snoozing or deferring | Yes | The alarm can be slept until a time, with notes |
| Taking an alarm | Yes | Ownership can be claimed and released |
| Adding a screenshot to an event | Not the picture itself | Patriot has no way to attach an image to an alarm that is already open, so TetherX writes a note saying what was added with a link back to the event. An image can only arrive at Patriot as part of a new alarm |
| Anything happening inside Patriot | Only by asking | Patriot's interface has no way to notify TetherX, so TetherX has to ask it repeatedly. Patriot 6.14.3 and later can send messages out over a separate licensed module, which your control room would have to buy and configure |
Warning: Every one of these needs your control room to grant extra rights to the TetherX user. The user that logs alarms holds one right only, so by default TetherX can send alarms and nothing else. Ask your control room before relying on any of it.
Limitations
These are limits of Patriot's own interface, not of TetherX, so they apply to any Patriot control room.
- Patriot cannot notify TetherX. Its interface has no webhook, no callback and no subscription of any kind, so anything TetherX shows about what the control room did has to be asked for. TetherX asks about once a minute for an alarm that is still open, and you can ask for it now with the refresh control rather than waiting.
- So there is a delay. What the operator did appears in TetherX within about a minute, not instantly.
- Real time needs a separate module. Patriot 6.14.3 and later includes a Websocket Messaging Client module, in which Patriot connects out to TetherX and sends messages as they happen. It is licensed separately, your control room has to buy and configure it, and control rooms on older versions do not have it at all. If real-time updates matter to you, ask your control room about that module by name.
- An image cannot be added to an alarm already open. Patriot has no way to do it. A picture can only arrive as part of a new alarm.
- Reading anything back needs extra rights. The user that logs alarms holds one right by default. Everything TetherX reads from Patriot, and every action it reflects back, needs your control room to grant more.
- Patriot has no arm or disarm command. The only way a site's armed state is recorded there is by sending it as its own signal.
Planned
These are not available yet. They are listed so you know what the integration is growing into, and what your control room would need to allow.
Scheduling itself has shipped. A site now carries its monitored hours, the dates that replace them, engineer visits, paused monitoring and the cameras the hours cover, and each camera carries its own recording schedule and can keep monitored hours of its own. Those hours decide what is forwarded to Patriot at all: see Monitored Hours and Camera Recording Schedule. What is still to come is sharing them with the control room.
| Planned | What it will do | What it waits on |
|---|---|---|
| Monitored hours in Patriot | Sending a site's monitored hours to Patriot as the account's open and close times, and reading the control room's back | Your control room allowing TetherX to read and edit the account's schedules |
| Site notes | Reading the control room's notes for a site. Writing them back is limited: Patriot has no way to add a note to an account, only to replace the site information and alarm instructions on it | Your control room allowing TetherX to read and edit the account |
| A customer dismissing an event | Letting the person who owns the site dismiss an alarm themselves, and telling the control room it was dealt with, so nobody is called out for it | Design work, then the rights above |
Adding Live Video
Alarms carry a still image. For live video inside Patriot, your control room can add each camera as a Network Video Stream camera, which plays the stream in the operator's normal Patriot screen and in Patriot's web client.
- Go to the Control Rooms page
- Copy the URL for each camera
- Send them to your control room to enter against the matching camera zone
If Alarms Are Not Arriving
- Check the site is armed. A disarmed site reports nothing, by design.
- Check the client number. Patriot rejects a signal whose account number it does not recognise, including a number missing the area and port.
- Check the user assignment. Patriot refuses a signal if the TetherX user is not assigned to that account.
- Check the heartbeat. On the control room account, Last failure shows the reason Patriot gave for the last heartbeat it refused or did not answer. A login problem there affects every site using the account.
- Ask your control room to check the event type template. A signal that arrives with no matching event type reaches the operator without a description, and a number their template already uses for something else reaches the operator as that other thing. Loading the TetherX Event Types into Patriot covers both.
TetherX reports a rejected signal or a failed heartbeat to support with the reason Patriot gave, so raise a ticket if the settings look right and alarms are still missing.
Related Articles
- Patriot Systems Integration - Setting a site up, start here
- Control Room Software Integration - Immix, CONXTD and HikCentral
- Monitoring Station Operator Guide - Working alarms in the operator console
- Definitions - Event types and terminology