# epsonepos/epos architecture

> Architecture diagram of the GitHub repository epsonepos/epos, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/epsonepos/epos
- Repository: https://github.com/epsonepos/epos

## Overview

This repository contains Android sample applications for Epson’s ePOS-Print SDK, rather than the SDK implementation itself. The intended workflow is to choose or discover a printer, connect through a supported interface, then send print operations; the README documents SDK APIs and interfaces, while the tree shows separate printer-selection, command-demo, and receipt-demo modules. The source excerpts contain no application code, so internal calls and exact sample flows cannot be verified; dashed links indicate those limits.

Main entry points: [`ePOSEasySelect/src/main/java/com/example/eposeasyselectsample/MainActivity.java`](https://github.com/epsonepos/epos/blob/master/ePOSEasySelect/src/main/java/com/example/eposeasyselectsample/MainActivity.java) (Easy select app), [`ePOSEasySelect/src/main/java/com/example/eposeasyselectsample/printer/FindPrinter.java`](https://github.com/epsonepos/epos/blob/master/ePOSEasySelect/src/main/java/com/example/eposeasyselectsample/printer/FindPrinter.java) (Printer discovery), [`ePOSReceiptPrint/src/main/java/com/example/eposreceiptprintsample/EPOSReceiptPrintSampleActivity.java`](https://github.com/epsonepos/epos/blob/master/ePOSReceiptPrint/src/main/java/com/example/eposreceiptprintsample/EPOSReceiptPrintSampleActivity.java) (Receipt sample app), [`ePOSEasySelect/src/main/java/com/example/eposeasyselectsample/printer/ChoosePrinterActivity.java`](https://github.com/epsonepos/epos/blob/master/ePOSEasySelect/src/main/java/com/example/eposeasyselectsample/printer/ChoosePrinterActivity.java) (Choose printer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_selection["Printer selection"]
  node_easyselect["Easy select app<br/>[MainActivity.java]"]
  node_choose["Choose printer"]
  node_discovery["Printer discovery<br/>[FindPrinter.java]"]
  node_interfaces["Network interfaces"]
  node_bluetooth["Bluetooth interface"]
  node_pairing["Quick pairing"]
end

subgraph group_printdemo["Print command samples"]
  node_qr["QR print demo"]
  node_printcommands["Print command demos"]
  node_printerdemo["Printer discovery demo"]
end

subgraph group_receipt["Receipt sample"]
  node_receiptapp["Receipt sample app"]
  node_receiptfind["Receipt discovery"]
end

node_user(("App developer"))
node_sdk["ePOS-Print SDK"]
node_printer["Epson TM printer"]

node_user -.->|"uses sample"| node_easyselect
node_user -.->|"uses sample"| node_printcommands
node_user -.->|"uses sample"| node_receiptapp
node_easyselect -.->|"opens"| node_choose
node_choose -.->|"finds printers"| node_discovery
node_discovery -.->|"uses network"| node_interfaces
node_discovery -.->|"uses Bluetooth"| node_bluetooth
node_easyselect -.->|"offers pairing"| node_pairing
node_pairing -.->|"continues to print"| node_qr
node_printcommands -->|"uses APIs"| node_sdk
node_receiptapp -->|"uses APIs"| node_sdk
node_sdk -->|"prints to"| node_printer
node_printerdemo -.->|"uses APIs"| node_sdk
node_receiptapp -.->|"opens discovery"| node_receiptfind

click node_easyselect "https://github.com/epsonepos/epos/blob/master/ePOSEasySelect/src/main/java/com/example/eposeasyselectsample/MainActivity.java"
click node_choose "https://github.com/epsonepos/epos/blob/master/ePOSEasySelect/src/main/java/com/example/eposeasyselectsample/printer/ChoosePrinterActivity.java"
click node_discovery "https://github.com/epsonepos/epos/blob/master/ePOSEasySelect/src/main/java/com/example/eposeasyselectsample/printer/FindPrinter.java"
click node_interfaces "https://github.com/epsonepos/epos/blob/master/ePOSEasySelect/src/main/java/com/example/eposeasyselectsample/common/wifi/WiFiController.java"
click node_bluetooth "https://github.com/epsonepos/epos/blob/master/ePOSEasySelect/src/main/java/com/example/eposeasyselectsample/common/bluetooth/BluetoothController.java"
click node_pairing "https://github.com/epsonepos/epos/blob/master/ePOSEasySelect/src/main/java/com/example/eposeasyselectsample/quickpairing/QuickPairingActivity.java"
click node_qr "https://github.com/epsonepos/epos/blob/master/ePOSEasySelect/src/main/java/com/example/eposeasyselectsample/printqrcode/PrintQrCodeActivity.java"
click node_printcommands "https://github.com/epsonepos/epos/blob/master/ePOSPrint/src/main/java/com/example/BarcodeActivity.java"
click node_printerdemo "https://github.com/epsonepos/epos/blob/master/ePOSPrint/src/main/java/com/example/DiscoverPrinterActivity.java"
click node_receiptapp "https://github.com/epsonepos/epos/blob/master/ePOSReceiptPrint/src/main/java/com/example/eposreceiptprintsample/EPOSReceiptPrintSampleActivity.java"
click node_receiptfind "https://github.com/epsonepos/epos/blob/master/ePOSReceiptPrint/src/main/java/com/example/eposreceiptprintsample/DiscoverPrinterActivity.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_easyselect,node_choose,node_discovery,node_interfaces,node_bluetooth,node_pairing toneBlue
class node_qr,node_printcommands,node_printerdemo toneAmber
class node_receiptapp,node_receiptfind toneMint
class node_user,node_sdk,node_printer toneIndigo
```

## Components

### Printer selection

- [Easy select app](https://github.com/epsonepos/epos/blob/master/ePOSEasySelect/src/main/java/com/example/eposeasyselectsample/MainActivity.java): `ePOSEasySelect/src/main/java/com/example/eposeasyselectsample/MainActivity.java`
- [Choose printer](https://github.com/epsonepos/epos/blob/master/ePOSEasySelect/src/main/java/com/example/eposeasyselectsample/printer/ChoosePrinterActivity.java): `ePOSEasySelect/src/main/java/com/example/eposeasyselectsample/printer/ChoosePrinterActivity.java`
- [Printer discovery](https://github.com/epsonepos/epos/blob/master/ePOSEasySelect/src/main/java/com/example/eposeasyselectsample/printer/FindPrinter.java): `ePOSEasySelect/src/main/java/com/example/eposeasyselectsample/printer/FindPrinter.java`
- [Network interfaces](https://github.com/epsonepos/epos/blob/master/ePOSEasySelect/src/main/java/com/example/eposeasyselectsample/common/wifi/WiFiController.java): `ePOSEasySelect/src/main/java/com/example/eposeasyselectsample/common/wifi/WiFiController.java`
- [Bluetooth interface](https://github.com/epsonepos/epos/blob/master/ePOSEasySelect/src/main/java/com/example/eposeasyselectsample/common/bluetooth/BluetoothController.java): `ePOSEasySelect/src/main/java/com/example/eposeasyselectsample/common/bluetooth/BluetoothController.java`
- [Quick pairing](https://github.com/epsonepos/epos/blob/master/ePOSEasySelect/src/main/java/com/example/eposeasyselectsample/quickpairing/QuickPairingActivity.java): `ePOSEasySelect/src/main/java/com/example/eposeasyselectsample/quickpairing/QuickPairingActivity.java`

### Print command samples

- [QR print demo](https://github.com/epsonepos/epos/blob/master/ePOSEasySelect/src/main/java/com/example/eposeasyselectsample/printqrcode/PrintQrCodeActivity.java): `ePOSEasySelect/src/main/java/com/example/eposeasyselectsample/printqrcode/PrintQrCodeActivity.java`
- [Print command demos](https://github.com/epsonepos/epos/blob/master/ePOSPrint/src/main/java/com/example/BarcodeActivity.java): `ePOSPrint/src/main/java/com/example/BarcodeActivity.java`
- [Printer discovery demo](https://github.com/epsonepos/epos/blob/master/ePOSPrint/src/main/java/com/example/DiscoverPrinterActivity.java): `ePOSPrint/src/main/java/com/example/DiscoverPrinterActivity.java`

### Receipt sample

- [Receipt sample app](https://github.com/epsonepos/epos/blob/master/ePOSReceiptPrint/src/main/java/com/example/eposreceiptprintsample/EPOSReceiptPrintSampleActivity.java): `ePOSReceiptPrint/src/main/java/com/example/eposreceiptprintsample/EPOSReceiptPrintSampleActivity.java`
- [Receipt discovery](https://github.com/epsonepos/epos/blob/master/ePOSReceiptPrint/src/main/java/com/example/eposreceiptprintsample/DiscoverPrinterActivity.java): `ePOSReceiptPrint/src/main/java/com/example/eposreceiptprintsample/DiscoverPrinterActivity.java`

### Other components

- **App developer**
- **ePOS-Print SDK**
- **Epson TM printer**

## Connections

- App developer → Easy select app: uses sample
- App developer → Print command demos: uses sample
- App developer → Receipt sample app: uses sample
- Easy select app → Choose printer: opens
- Choose printer → Printer discovery: finds printers
- Printer discovery → Network interfaces: uses network
- Printer discovery → Bluetooth interface: uses Bluetooth
- Easy select app → Quick pairing: offers pairing
- Quick pairing → QR print demo: continues to print
- Print command demos → ePOS-Print SDK: uses APIs (evidence: `README.md`)
- Receipt sample app → ePOS-Print SDK: uses APIs (evidence: `README.md`)
- ePOS-Print SDK → Epson TM printer: prints to (evidence: `README.md`)
- Printer discovery demo → ePOS-Print SDK: uses APIs
- Receipt sample app → Receipt discovery: opens discovery
