Components are broken down into 3 types in Esprida LiveControl:

1. Peripherals: hardware devices such as printers, card readers etc. Peripherals can be further broken down into simple USB devices with simple Online / Offline characteristics or more complex peripherals with multiple states.

2. Applications: software running on the device.

This article refers to the addition of peripherals with many states such as printers or check scanners.

For peripherals to be properly monitored there are 2 core pieces required:

1. An agent side application that talks with the peripherals and then drops status messages into a specific Esprida LiveControl Agent folder.

2. Updates to the Esprida LiveControl Server that specify the new peripherals critical information: the ComponentCode, the different states the component can be in (e.g. printer online, printer, out of paper, printer paper jam, etc.) and what the severity level is for each state (e.g. Normal, Warning or Error states)

The first piece (Agent side application) usually requires an understanding of the peripheral and may also require some development effort. The work can be done by you, through a professional services agreement with Esprida or through third party resources. Consult the Component API document available on the Support Portal under Releases & Documentations for an in depth description of the of the Component requirements.

The second piece (updating the Esprida LiveControl Server) is done by Esprida for our SaaS environment (https://livecontrol.esprida.com) or by your local system administrator if you are self-hosting the Esprida LiveControl Server. To add your peripheral to Esprida LiveControl, Esprida Support needs the following information for each new peripherals:

a) Component Code (e.g. Magtek_mt215)
b) Component Name (e.g. Magtek MT215 MSR). This is the name that would appear on the user Interface of Esprida LiveControl
c) Component Description (e.g. Magtek MT215 Magnetic Stripe Reader). This is the name that would appear within the details of a state message from the device on the user Interface of Esprida LiveControl

For each state that the peripherals will report indicate the following:

d) State Name (e.g. OnLine, OffLine, Out of Paper, Low on paper etc.)
e) State Severity Normal (Green)
Warning (Yellow)
Error (Red)

After submitting that information in a support ticket to Esprida Support;

1. Esprida will perform the steps to add your peripherals to the Esprida LiveControl Server.

2. Esprida will update the ticket with the exact Component Codes and State Codes required by the Agent side application.

For more information about the full requirements for peripherals, please consult the Component API document.