> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plato.ae/llms.txt
> Use this file to discover all available pages before exploring further.

# Drivers

> Hardware bridge services used by Plato.

# Drivers

Plato drivers are local bridge services that let browser-based Plato apps talk to hardware on a store network. The first supported driver in this repository is the PC printer driver.

## Current Drivers

| Driver         | Package                  | Status  | Purpose                                                                                                        |
| -------------- | ------------------------ | ------- | -------------------------------------------------------------------------------------------------------------- |
| PC Printer     | `drivers/pc-printer`     | Current | Accepts HTTP print requests from Plato POS, queues them, and writes ESC/POS bytes to network thermal printers. |
| PC Printer Old | `drivers/pc-printer-old` | Legacy  | Restored older implementation kept for reference and rollback context.                                         |

## Recommended Reading Order

<CardGroup cols={3}>
  <Card title="PC Printer Driver" icon="printer" href="/drivers/pc-printer/overview">
    Understand what the driver does and how it connects Plato POS to local printers.
  </Card>

  <Card title="Installation" icon="download" href="/drivers/pc-printer/installation">
    Install the driver on the local machine that can reach the store printers.
  </Card>

  <Card title="Configuration" icon="settings" href="/drivers/pc-printer/configuration">
    Set ports, printer targets, Redis, HTTPS, and environment values.
  </Card>

  <Card title="HTTP API" icon="braces" href="/drivers/pc-printer/http-api">
    Review the local endpoints Plato uses to send print work.
  </Card>

  <Card title="Print Flow" icon="receipt-text" href="/drivers/pc-printer/print-flow">
    Follow a job from POS to queue to ESC/POS printer output.
  </Card>

  <Card title="Troubleshooting" icon="life-buoy" href="/drivers/pc-printer/troubleshooting">
    Fix connection, queue, printer, HTTPS, and release problems.
  </Card>
</CardGroup>

## Driver Rules

* Drivers run on machines inside the store or local network.
* Drivers expose local HTTP endpoints for Plato clients.
* Drivers should be treated as trusted-network services, not public internet services.
* Hardware-specific retries and queueing belong in the driver so the browser does not have to hold long-lived printer connections.