Project: webapp-hardware-bridge (GitHub Link)

webapp-hardware-bridge-master
- src
  - main
    - resources
      - setting.fxml
      - log4j2.xml
    - java
      - META-INF
        MANIFEST.MF
      - tigerworkshop
        webapphardwarebridge
        Server.java
        utils
        ConnectionAttachment.java
        CertificateGenerator.java
        ImagePrintable.java
        AnnotatedPrintable.java
        ThreadUtil.java
        ObservableStringPair.java
        TLSUtil.java
        DownloadUtil.java
        services
        DocumentService.java
        SettingService.java
        websocketservices
        CloudProxyClientWebSocketService.java
        SerialWebSocketService.java
        PrinterWebSocketService.java
        Configurator.java
        responses
        PrintResult.java
        PrintDocument.java
        Setting.java
        GUI.java
        Config.java
        BridgeWebSocketServer.java
        interfaces
        WebSocketServiceInterface.java
        WebSocketServerInterface.java
        controller
        SettingController.java
- demo
  - printer-basic.htm
  - weigh-basic.htm
  - websocket-weigh.js
  - websocket-printer.js
  - websocket-serial.js
  - serial-basic.html
  - printer-advanced.htm
- gradlew.bat
- LICENSE
- gradlew
- build.gradle
- install.nsi
- setting.default.json
- README.md
- .idea
  - libraries
    - Gradle__com_google_guava_listenablefuture_9999_0_empty_to_avoid_conflict_with_guava.xml
    - Gradle__junit_junit_4_12.xml
    - Gradle__com_google_code_findbugs_jsr305_3_0_2.xml
    - Gradle__org_java_websocket_Java_WebSocket_1_4_0.xml
    - Gradle__org_bouncycastle_bcpkix_jdk15on_1_62.xml
    - Gradle__commons_io_commons_io_2_6.xml
    - Gradle__org_apache_httpcomponents_httpclient_4_5_7.xml
    - Gradle__org_apache_httpcomponents_httpcore_4_4_11.xml
    - Gradle__com_google_guava_guava_28_0_jre.xml
    - Gradle__commons_codec_commons_codec_1_11.xml
    - Gradle__de_huxhorn_lilith_de_huxhorn_lilith_3rdparty_junique_1_0_4.xml
    - Gradle__com_fazecast_jSerialComm_2_4_2.xml
    - Gradle__org_bouncycastle_bcprov_jdk15on_1_62.xml
    - Gradle__commons_logging_commons_logging_1_2.xml
    - Gradle__org_apache_logging_log4j_log4j_slf4j_impl_2_11_2.xml
    - Gradle__org_apache_logging_log4j_log4j_api_2_11_2.xml
    - Gradle__org_checkerframework_checker_qual_2_8_1.xml
    - Gradle__org_apache_commons_commons_lang3_3_8_1.xml
    - Gradle__org_codehaus_mojo_animal_sniffer_annotations_1_17.xml
    - Gradle__com_google_j2objc_j2objc_annotations_1_3.xml
    - Gradle__com_google_errorprone_error_prone_annotations_2_3_2.xml
    - Gradle__com_google_code_gson_gson_2_8_5.xml
    - Gradle__org_apache_pdfbox_fontbox_2_0_14.xml
    - Gradle__org_apache_logging_log4j_log4j_core_2_11_2.xml
    - Gradle__org_slf4j_slf4j_api_1_7_25.xml
    - Gradle__com_google_guava_failureaccess_1_0_1.xml
    - Gradle__org_apache_pdfbox_pdfbox_2_0_14.xml
    - Gradle__org_hamcrest_hamcrest_core_1_3.xml
  - jarRepositories.xml
  - compiler.xml
  - modules.xml
  - uiDesigner.xml
  - encodings.xml
  - artifacts
    - webapp_hardware_bridge_jar.xml
  - misc.xml
  - vcs.xml
  - gradle.xml
  - modules
    - webapp-hardware-bridge_main.iml
    - webapp-hardware-bridge_test.iml
    - webapp-hardware-bridge.iml
  - webapp-hardware-bridge.iml
- settings.gradle
- .gitignore
- tls
  - .gitignore

WebApp Hardware Bridge

WebApp Hardware Bridge (succeeder of "Chrome Hardware Bridge / Chrome Direct Print")

Make it possible for WebApp to perform silent print and access to serial ports.

Common use cases:

Web-based POS - PDF and ESC/POS receipt silent print
Web-based WMS - Serial weight scale real-time reading, delivery Note/packing List silent print
WebApp that need to read/write to serial ports

Features

[x] Direct print from webpage
[x] Serial read/write from webpage
[x] Support all modern broswers that implemented WebSocket (Chrome, Firefox, Edge... etc)
[x] JS SDK/Example included

Web Direct Print

0-click silent printing in web browsers
Download via URL / Base64 encoded file / Base64 encoded binary raw command
Support multiple printers, mapped by key
Support PDF/PNG/JPG Printing
Support RAW/ESC-POS Printing

Web Serial Access

Bidirectional communication
Support multiple ports, mapped by key
Support multiple connection share same serial port
Serial weigh scale (AWH-SA30 supported out-of-box in JS SDK)

How to use?

Client Side

Install and setup mapping via Configurator
Start "WebApp Hardware Bridge" and start using your WebApp

WebApp Side

Check JS SDK/Example

How it works?

WebApp Hardware Bridge is a Java based application, which have more direct access to hardwares.

It expose a WebSocket server on localhost which accept print jobs and serial connection.

For print jobs, PDF/Images job are downloaded/decoded and then sent to mapped printer.

Raw job are sent to mapped printer directly.

For serial port, serial port are opened by Java and "proxified" as WebSocket stream,

which allow bidirectional communcations.

Configurator is provided to setup mappings between keys and printers/serials.

Therefore web apps do not need to care about the actual printer names.

Known Issue

Browser refuse to connect to non-Secure WebSocket server Firefox Workaround: Change "network.websocket.allowInsecureFromHTTPS" to true in about:config

FAQs

Configurator/GUI do not run? Install vc_redist.x64.exe
Build from source

Advanced Usages

TODOs

[ ] Serial settings (Baudrate, data bits, stop bit, parity bit)

Any other ideas? Fork and PR are welcome!