Parallel Port Printer Controller

專案說明

這是一個用於控制並行埠印表機的 Node.js 應用程式，支援 LPT1 和 LPT2 埠口。

功能特點

• 支援 LPT1/LPT2 印表機控制
• 文字列印功能
• 自動換行功能
• 紙張裁切功能
• 可設定預設印表機埠
• 自動更新功能
• Windows 服務安裝
• 檢查印表機是否連線

系統需求

• Windows 作業系統
• Node.js 14.x 或以上版本
• 並行埠印表機（LPT1 或 LPT2）

安裝方式

方法一：使用安裝程式（推薦）

1. 下載最新版本的安裝程式：ParallelPortPrinter-Setup.exe
2. 執行安裝程式
3. 依照安裝精靈的指示完成安裝
4. 選擇是否建立桌面捷徑和開機自動啟動

方法二：手動安裝

1. 克隆專案：

   git clone https://github.com/shinnlu/parallel-port-printer.git
   cd parallel-port-printer

2. 安裝依賴：

   npm install

3. 安裝 Windows 服務：

   • 32位元系統：執行 install-service-x86.bat
   • 64位元系統：執行 install-service-x64.bat

使用方式

1. 啟動應用程式：

   • 如果使用安裝程式：從開始選單或桌面捷徑啟動
   • 如果手動安裝：執行 start-server.bat

2. 開啟瀏覽器訪問：

   http://localhost:3000

3. 在網頁介面中：

   • 選擇印表機埠（LPT1/LPT2）
   • 輸入要列印的文字
   • 點擊「列印一行文字」按鈕
   • 使用「插入換行」按鈕控制換行
   • 使用「裁切紙張」按鈕裁切紙張

設定說明

• 預設印表機埠設定會儲存在 .env 檔案中
• 可以透過網頁介面修改預設印表機埠
• 設定會自動儲存並在下次啟動時載入

自動更新

• 應用程式會自動檢查更新
• 當有新版本時，會顯示更新通知
• 可以選擇自動或手動更新

管理服務

• 啟動服務：net start PrinterControl
• 停止服務：net stop PrinterControl
• 移除服務：
  • 32位元系統：nssm\nssm32.exe remove PrinterControl confirm
  • 64位元系統：nssm\nssm64.exe remove PrinterControl confirm

故障排除

如果遇到問題，請檢查：

1. Node.js 是否正確安裝
2. 專案依賴是否已安裝
3. 印表機埠是否正確連接
4. 檢查 Windows 事件檢視器中的錯誤日誌
5. 確認使用了正確版本的安裝腳本（32位元/64位元）

開發相關

1. 開發模式啟動：

   npm run dev

2. 生產模式啟動：

   npm start

版本歷史

• v1.0.0 (2024-03-xx)
  • 初始版本
  • 基本列印功能
  • 自動更新功能
  • Windows 服務支援

授權說明

本專案採用 MIT 授權條款。詳見 LICENSE 檔案。

貢獻指南

1. Fork 本專案
2. 建立你的功能分支 (git checkout -b feature/AmazingFeature)
3. 提交你的變更 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 開啟一個 Pull Request

聯絡方式

• 作者：Shinn Lu
• 電子郵件：你的電子郵件
• 專案連結：https://github.com/shinnlu/parallel-port-printer

API 說明

應用程式提供以下 API 端點供前端與後端通訊：

• GET /settings：取得目前的設定值，例如預設印表機埠。
• POST /settings：更新設定值，需提供 JSON 格式的資料，例如 { "port": "LPT1" }。
• POST /command：發送列印指令，需提供 JSON 格式的資料，例如 { "type": "printLine", "text": "Hello", "port": "LPT1" }。
• POST /printer-status：檢查印表機狀態，回傳印表機的連線狀態與錯誤資訊。

這些 API 端點可用於與應用程式進行互動，實現列印與狀態檢查等功能。