# Úložisko CHDÚ a hardvérové zostavy

> Ktoré chránené dátové úložisko (CHDÚ) zvoliť, na ktorých systémoch funguje a ako vyzerá zostava s počítačom, Android tabletom a platobným terminálom.

Zdroj: https://ekasa.ninedigit.sk/docs/storage-and-hardware

Každá online registračná pokladnica potrebuje chránené dátové úložisko (CHDÚ). Ktoré zvolíte, závisí od toho,
kde bude predaj prebiehať: na počítači, na vlastnom zariadení s Androidom alebo na platobnom termináli.
Na vývoj žiadny hardvér nepotrebujete.

## Modely úložiska

| Úložisko | Čo to je | Kde sa používa |
|---|---|---|
| **CHDU Lite** | Externé zariadenie pripojené k počítaču alebo tabletu. Pripája sa k nemu aj tlačiareň. | počítač (Windows, macOS, Linux), Android tablet alebo kiosk |
| **SwissBit** | MicroSD karta vo vnútri platobného terminálu, zvonku ju nevidno. | len certifikované platobné terminály |
| **CHDU-SK** | Predchodca CHDU Lite. Podporujú ho aj najnovšie verzie eKasy. | rovnako ako CHDU Lite |
| **In-Memory** | Simulované úložisko v aplikácii, bez hardvéru. Doklady „tlačí“ do PDF. | vývoj a testovanie v integračnom prostredí, na všetkých platformách |

<figure>

[Obrázok: CHDU Lite: čierne zariadenie s káblom, vo verzii s 25-pinovým a 9-pinovým konektorom pre tlačiareň]

<figcaption>CHDU Lite (verzia s 25-pinovým a 9-pinovým konektorom)</figcaption>
</figure>
<figure>

[Obrázok: Karta microSD SwissBit, ktorá sa vkladá do platobného terminálu]

<figcaption>SwissBit, microSD karta do platobného terminálu (foto: Swissbit AG)</figcaption>
</figure>

Úložisko SwissBit je certifikované len pre konkrétne modely platobných terminálov: **Sunmi P3 MIX, Sunmi P3h Dual,
Ingenico DX4000, Ingenico DX8000 a PAX A920Pro**. Na vlastnom Android tablete, kiosku či inom zariadení ho preto použiť
nemožno, pre takéto zariadenia je určené CHDU Lite.

## Kompatibilita

| | CHDU Lite | CHDU-SK | SwissBit | In-Memory |
|---|:---:|:---:|:---:|:---:|
| Windows | áno | áno | nie | áno |
| macOS | áno | áno | nie | áno |
| Linux | áno | áno | nie | áno |
| Android tablet alebo kiosk | áno | áno | nie | áno |
| Certifikovaný platobný terminál | nie | nie | áno | áno |

## Ktoré úložisko zvoliť

```mermaid
flowchart TD
    A{Vývoj alebo ostrá prevádzka?} -->|vývoj a testovanie| D[In-Memory<br/>bez hardvéru]
    A -->|ostrá prevádzka| E{Na akom zariadení?}
    E -->|platobný terminál| B[SwissBit<br/>microSD v termináli]
    E -->|počítač, vlastný tablet<br/>alebo kiosk| C[CHDU Lite]
```

- **Platobný terminál:** ideálne SwissBit. Úložisko je ukryté v termináli a predavač pracuje len s jedným zariadením.
- **Počítač, tablet, kiosk:** CHDU Lite.
- **Vývoj:** začnite s In-Memory. Pred nasadením odporúčame integráciu vyskúšať aj so skutočným úložiskom,
  napríklad kvôli papierovej tlači.

## Zostavy

### Počítač

eKasa beží ako služba na počítači s Windows, macOS alebo Linuxom (alebo ako súčasť vašej .NET aplikácie).
CHDU Lite sa k počítaču pripája USB káblom a **tlačiareň sa pripája k úložisku**, nie priamo k počítaču.
Tlač tak vždy ide cez CHDÚ. Staršie CHDU-SK sa zapája rovnako.

**Váš softvér**: na počítači, v sieti alebo v cloude
→ HTTP
**eKasa**: služba na počítači
→ USB
**CHDU Lite**: úložisko
→ sériový kábel
**Tlačiareň**: na doklady

Tlačiareň musí mať sériové rozhranie (9- alebo 25-pinový konektor), podporovať príkazy ESC/POS a slovenskú
diakritiku. Tieto požiadavky spĺňa väčšina tlačiarní na doklady.

Váš softvér môže bežať na tom istom počítači, inde v lokálnej sieti alebo v cloude či prehliadači. Ako sa k eKase
pripojiť v jednotlivých prípadoch, popisuje [Pripojenie a zabezpečenie](https://ekasa.ninedigit.sk/docs/security).

#### <span id="ovladac-usb" class="anchor"></span>Ovládač USB vo Windows

Úložisko sa v počítači ohlási ako sériový port. Vo Windows ho v Správcovi zariadení (Device Manager) nájdete
v skupine **Porty (COM a LPT)**. Ovládač Windows zvyčajne nainštaluje sám, inštalátory eKasy ho neobsahujú.
Ak sa úložisko ako COM port nezobrazí, nainštalujte ovládač výrobcu čipu:

- **CHDU-SK** používa prevodník Silicon Labs CP210x: ovládač
  [USB to UART Bridge VCP Drivers](https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers).
- **CHDU Lite** sa ohlási ako virtuálny COM port STM32. Vo Windows 10 a 11 používa vstavaný ovládač Windows,
  ovládač výrobcu [STSW-STM32102](https://www.st.com/en/development-tools/stsw-stm32102.html) je podľa
  STMicroelectronics určený len pre staršie verzie Windows (7, 8.x).

### Android tablet alebo kiosk

eKasa beží ako aplikácia v zariadení s Androidom. Úložisko (CHDU Lite alebo CHDU-SK) sa k nemu pripája USB káblom
a tlačiareň k úložisku, presne ako pri počítači: zariadenie – CHDÚ – tlačiareň.

**Váš softvér**: v zariadení alebo v sieti
→ HTTP
**eKasa**: aplikácia pre Android
→ USB
**CHDU Lite**: úložisko
→ sériový kábel
**Tlačiareň**: na doklady

### Platobný terminál

Platobný terminál je iný: má vstavanú tlačiareň a slot na microSD kartu, do ktorého sa vkladá úložisko SwissBit.
eKasa beží ako aplikácia priamo v termináli a doklad sa tlačí na jeho vstavanej tlačiarni.

**Váš softvér**: v termináli alebo v sieti
→ HTTP
**eKasa**: aplikácia v termináli
→ vo vnútri
**SwissBit**: microSD v termináli
→ tlač
**Vstavaná tlačiareň**: alebo USB tlačiareň

Namiesto vstavanej tlačiarne môžete k terminálu pripojiť **externú tlačiareň cez USB**. Musí podporovať príkazy
ESC/POS a voči terminálu sa ohlásiť ako tlačiareň (USB trieda tlačiarne).

## Kam ďalej

- [Príprava prostredia](https://ekasa.ninedigit.sk/docs/environment-setup): Integračné prostredie, In-Memory úložisko a inštalácia eKasy.
- [HTTP API](https://ekasa.ninedigit.sk/docs/rest-api): Požiadavky a inštalácia služby na počítači.
- [Informácie o tlačiarni](https://ekasa.ninedigit.sk/docs/printer-info): Šírka riadku a pripojenie tlačiarne, ktorú eKasa používa.
