Cenaly Hardware Bridge — perangkat keras usaha

Browser sendiri tidak dapat mencetak struk pada printer POS, membuka laci uang, atau membaca berat dari timbangan. Tugas ini diselesaikan oleh Cenaly Hardware Bridge — aplikasi kecil gratis yang dipasang di komputer kasir, berjalan di latar belakang, dan menghubungkan halaman panel admin/kasir dengan perangkat keras lokal usaha.

Buka: Panel Admin → Perangkat Keras (admin.cenaly.com).

Apa yang terhubung#

Antrean pencetakan#

Pencetakan melalui bridge — bukan "kirim lalu berharap". Bridge memiliki antrean tugas dengan pengulangan yang bertahan setelah restart: jika printer dimatikan atau kertas habis, tugas tidak hilang dan akan dicetak saat perangkat kembali aktif.

Karena itu, pencetakan memiliki lima hasil berbeda, bukan "berhasil/tidak berhasil": tercetak, diterima dalam antrean (kertas belum ada!), dicetak oleh browser, dicetak oleh mesin kasir fiskal (lihat di bawah), dan tidak tercetak. Di bagian atas kasir terlihat indikator antrean dengan jumlah tugas yang menunggu.

Tugas bersifat idempoten: pengiriman ulang dokumen yang sama tidak menghasilkan kertas kedua.

Mesin kasir fiskal — bukan printer struk cadangan. Jika di cabang tidak ada printer struk terpisah, bridge TIDAK akan mencetak struk kami melalui mesin kasir fiskal: struk fiskal dicetak oleh mesin itu sendiri, sedangkan dokumen kami adalah kertas yang berbeda. Kasir dalam situasi seperti itu mengatakan: "struk dicetak oleh mesin kasir fiskal sendiri". Melalui mesin kasir fiskal hanya diizinkan uji cetak dan pracetak — dan pada keduanya dicetak penanda bahwa ini bukan dokumen fiskal.

Detail, pemetaan printer ke stasiun, dan halaman kode untuk Kiril dan Georgia — Pencetakan di dapur dan ruang utama.

Pemasangan Bridge#

Jika Bridge tidak ditemukan di PC ini, halaman akan menawarkan untuk memasangnya:

1. Unduh versi untuk OS Anda — Windows, Linux (x64) atau Linux (ARM64) (macOS — dalam rencana). Untuk verifikasi dicantumkan SHA-256.
2. Jalankan Aplikasi. Windows — klik dua kali: Bridge berjalan di latar belakang (ikon di baki sistem) dan membuka halaman status. Linux — lebih andal langsung memasangnya sebagai layanan latar belakang dengan perintah satu baris dari halaman «Perangkat Keras» (curl … | sudo … bash): layanan ini mulai saat PC dinyalakan dan memulai ulang sendiri. Menjalankan file yang diunduh secara manual (chmod +x lalu dijalankan) juga berfungsi, tetapi Bridge hanya hidup selama terminal terbuka dan tidak akan kembali setelah reboot; halaman status di Linux buka sendiri — http://127.0.0.1:9100.
3. Pastikan di halaman status bahwa Bridge berjalan. Buka admin di PC yang sama, pilih Cabang yang diinginkan dan bagian «Perangkat Keras»: browser terhubung secara otomatis.
4. Kembali ke admin dan tekan «Cari lagi» — Kasir akan menemukan Bridge di PC ini sendiri dan terhubung.

Jika Windows menampilkan peringatan saat mengunduh/menjalankan — itu wajar: pilih «Simpan», dan saat menjalankan «Detail» → «Jalankan tetap». Untuk Linux tersedia pemasangan satu baris sebagai layanan latar belakang.

Cara menghapus Bridge dari komputer (Linux). Dengan perintah satu baris yang sama dari halaman «Perangkat Keras», hanya dengan subperintah — di halaman itu tersembunyi di bawah «Linux — hentikan atau hapus Bridge»:

• … | sudo bash -s -- stop — hentikan layanan dan cabut dari autostart; file dan pengaturan tetap ada, menyalakan kembali — start;
• … | sudo bash -s -- uninstall — cabut layanan dan hapus programnya. Pengaturan dan penautan Kasir tetap ada, dan skrip mencetak di mana letaknya;
• … | sudo bash -s -- uninstall --purge — sama plus pengaturan: daftar Perangkat Keras dan penautan ke Cabang. Setelah itu Kasir harus ditautkan ulang;
• … | sudo bash -s -- status — apakah Bridge berjalan dan di alamat mana (jika 9100 terpakai, Bridge mengambil yang berikutnya yang kosong, hingga 9109).

Di Windows untuk ini tersedia «Instalasi dan penghapusan program» biasa (Rekaman «Cenaly Bridge») — deinstaller juga menghapus autostart.

Bridge di komputer yang adminnya tidak dibuka (server di ruang belakang, PC terpisah di dekat Printer), tidak bisa ditautkan dengan pencarian otomatis — penautan otomatis hanya bekerja antara Bridge dan halaman Kasir di komputer yang sama. Untuk kasus seperti itu pemilik menerbitkan di admin kode penautan sekali pakai (berlaku 15 menit) dan memasukkannya di halaman status Bridge.

Bridge terikat pada brand Anda: yang diunduh dari domain branding orang lain tidak akan melayani admin Anda, dan jika Bridge sudah tertaut ke Cabang lain milik pemilik yang sama, halaman akan menampilkan itu dan menawarkan untuk menautkannya ke sini dengan satu tombol.

Tiga cara koneksi#

Kode masuk karyawan dari bagian «Perangkat» — mekanisme terpisah. Jika PIN atau kode kedaluwarsa, buat yang baru dengan tombol yang sesuai.

Pengelolaan dan pemeriksaan#

Saat Bridge terhubung, di halaman terlihat:

• Perangkat — daftar dengan status masing-masing (terhubung / perhatian / error / tidak ditemukan);
• Pemeriksaan Perangkat Keras — uji cepat cetak, pindai, berat;
• Pengaturan Perangkat Keras;
• Aktivitas — umpan peristiwa (pindai, berat, cetak) secara real time;
• Pembaruan — jika versi Bridge baru keluar, bisa dipasang langsung dari sini.

Saat menambahkan Printer, pilih peruntukannya: struk, dapur, atau untuk label. Peran terlihat di kartu Perangkat. Ini menentukan peruntukan di dalam Bridge; pembagian Perangkat Keras antar stasiun kerja terpisah — tingkat pengaturan yang lain. Jika pembacaan pengaturan gagal, wizard akan menawarkan untuk mengulang dan menyimpan daftar yang ada.

Perangkat Keras yang ditemukan bisa dinonaktifkan atau dihapus. «Nonaktifkan» membiarkan Perangkat di daftar dengan semua pengaturan, tetapi driver tidak dijalankan: port COM bebas, tidak ada polling, peran diberikan ke Perangkat lain — dinyalakan kembali dengan satu tombol. «Hapus» (dengan konfirmasi) menghapus Perangkat selamanya, dan pengambilan otomatis Perangkat Keras yang dikenal tidak akan mengembalikannya saat Bridge dijalankan lagi. Perangkat Keras yang pernah dikonfigurasi tetapi sekarang tidak terlihat oleh pencarian, ditampilkan sebagai grup terpisah — jika tidak, tidak ada cara untuk mengelolanya.

Bridge per Akun bisa beberapa, dan masing-masing diberi peran: universal, Perangkat Keras, kamera, atau teleponi. Bridge Cabang tercantum dalam daftar terpisah — bisa diganti nama dan ditetapkan Bridge default.

Perangkat Keras seluruh Akun dan bekerja dari Cloud#

Selain bridge "komputer ini", di halaman ini ada registri Perangkat Keras Akun — tabel menyeluruh semua bridge, Perangkat, dan kamera di seluruh Cabang jaringan: terlihat apa yang terpasang di mana, apakah bridge online, Cabang mana yang dilayani Perangkat Keras-nya. Perangkat dapat dipindahkan ke Cabang lain jika bridge saat itu online; pada bridge offline, registri hanya menampilkan, tetapi tidak mengubah.

Pada setiap mesin di registri dapat dibuka kartu "Detail PC": nama komputer, IP dan MAC, sistem, model, prosesor, memori per slot, penyimpanan dengan ruang kosong dan kondisinya, semua Perangkat Keras yang terhubung dan semua port COM — dengan keterangan port mana yang terpakai oleh siapa dan mana yang kosong. Ini tempat pertama yang perlu dilihat ketika "Printer tadinya ada, sekarang tidak terlihat" atau PC Kasir kehabisan ruang. Data dikumpulkan oleh bridge itu sendiri; pada versi bridge lama daftar Perangkat Keras bisa kosong — cukup perbarui bridge-nya.

Selain kanal lokal (browser ↔ bridge di PC ini) ada kanal Cloud: perintah dikirim ke bridge melalui server, sehingga mencetak Struk atau memeriksa Printer dapat dilakukan dari Perangkat lain — misalnya pelayan mencetak dari ponselnya ke Printer Kasir di balik meja. Di halaman ini terlihat sebagai "penyambungan Cloud" pada bridge dan tombol terpisah untuk uji cetak Cloud.

Mencetak ke Printer komputer sebelah. Jika Printer terhubung secara fisik ke PC lain, tidak wajib "dibagikan" lewat jaringan atau ditarik kabel. Tindakan "Cetak dari PC lain" di registri membuat tautan ke Printer milik PC lain di mesin ini: dipilih komputer pemilik, Cabang, dan nama, lalu barisnya ditandai "melalui Cloud → PC pemilik", dan tugas cetak dicetak oleh antrean komputer tersebut. Folder bersama, VPN, dan visibilitas langsung antar mesin tidak diperlukan — cukup kedua bridge melayani satu Cabang yang sama.

Layar Kasir jarak jauh. Dari halaman yang sama (dan melalui undangan dari obrolan kerja) layar komputer Kasir dapat dilihat — misalnya untuk melihat dengan mata sendiri apa yang ditampilkan Kasir. Keputusan selalu di pihak pemilik: selama pemiliknya belum mengaktifkan akses jarak jauh di sisinya, tombol koneksi tidak ada, dan setiap sesi memerlukan persetujuannya secara terpisah — "jangan tanya lagi" sengaja tidak ada. Melihat dan mengendalikan adalah dua izin berbeda, dan menutup jendela dipastikan mengakhiri sesi.

Bagian terkait#

• Kasir (POS) — tempat pencetakan Struk dan laci uang digunakan
• Struk dan pengembalian — pencetakan dan cetak ulang Struk
• Fiskalisasi — Printer fiskal dan Mesin kasir fiskal online
• Cetak di dapur dan ruang utama — stasiun, stiker, antrean, dan halaman kode
• Barang timbang dan label — penggunaan timbangan, satuan ukur, dan label rak
• Perangkat Keras: apa yang terhubung — ikhtisar kelas perangkat dan paket minimum per format
• Telefoni: PBX sendiri — telepon dan gateway tidak memerlukan bridge Perangkat Keras dan berjalan pada sirkuitnya sendiri
• Kontrol kerugian — klip video operasi berisiko dari kamera bridge

Pertanyaan umum#

Apakah perlu memasukkan kode untuk penyambungan?#

Biasanya tidak: bridge dijalankan di PC yang sama tempat Kasir dibuka, dan Kasir menemukannya sendiri lewat tombol "Cari lagi". Kode hanya diperlukan untuk bridge di komputer yang adminnya tidak dibuka — dalam hal itu pemilik menerbitkan kode sekali pakai dan memasukkannya di halaman bridge.

Pada OS apa bridge berjalan?#

Windows dan Linux (x64 dan ARM64). Versi untuk macOS masih dalam rencana.

Perangkat Keras tidak terlihat — apa yang perlu diperiksa?#

Pastikan bridge berjalan (halaman status), lalu tekan "Cari lagi". Kondisi setiap Perangkat dan pemeriksaan cepat tersedia di halaman "Perangkat Keras". Jika Perangkat tidak muncul, buka kartu "Detail PC" mesin tersebut di registri Perangkat Keras: di sana terlihat semua perangkat keras yang dikenali komputer itu sendiri, dan semua port COM dengan keterangan siapa yang memakai port tersebut — biasanya itu cukup untuk memahami apakah masalahnya di kabel, di port, atau di program lain yang menahan port.