พิมพ์ฉลากจาก Android ตรงถึง TSC MH261T ผ่าน Wi-Fi / LAN ด้วยเมนู Print ทั่วไป
An Android Print Service that sends PDF labels directly to a TSC MH261T over TCP 9100, with multiple named printers, print tests and custom paper sizes. English guide.
เวอร์ชันที่เผยแพร่: 1.3.5 — รุ่นสำหรับทดลองอัปเดตจาก 1.3.4 ผ่านปุ่มในแอป ดูรายละเอียดที่ Changelog
ดาวน์โหลด APK 1.3.5 · SHA256SUMS.txt · ติดตั้ง · แก้ปัญหา · Build · Changelog
ภาพชุดนี้จับจาก APK Release 1.3.4 บน Android 16 / API 36 Emulator ใช้ปลายทางจำลอง 127.0.0.1 / 127.0.0.2 เพื่อแสดงหลายเครื่องและกระดาษเริ่มต้นต่างกัน ต้องเปลี่ยนเป็น IP จริงของคุณ ภาพ Android Print เป็น preview ผ่านตัวรับจำลอง และไม่มีการพิมพ์ฉลากจริงระหว่างจับภาพ ดู รายละเอียดภาพ
หากติดตั้ง 1.3.4 อยู่แล้ว เปิด ตั้งค่า → อัปเดตแอป → ตรวจสอบอัปเดต → ดาวน์โหลด 1.3.5 จากนั้นอนุญาตติดตั้งจากแอปนี้เมื่อ Android ขอ กลับแอปแล้วกด ติดตั้งอัปเดต 1.3.5 และยืนยันในหน้าต่างระบบ ไม่ต้องถอนแอปเดิม ดู วิธีอัปเดต
ผลทดสอบบนเครื่องจริง — 16 ต.ค. 2026: ผู้ใช้ยืนยันว่าอัปเดตผ่านแอปจาก 1.3.4 → 1.3.5 สำเร็จ และข้อมูลเครื่องพิมพ์กับขนาดกระดาษยังอยู่ครบ เป็นผลยืนยันจากผู้ใช้ โดยไม่ได้ระบุรุ่นเครื่องหรือ Android เวอร์ชัน และยังไม่รวมผลพิมพ์หลังอัปเดต ดู ขอบเขตผลทดสอบ
- ตั้งค่า → อัปเดตแอป → ตรวจสอบอัปเดต ตรวจรุ่นปกติล่าสุดบน GitHub เมื่อกดปุ่ม
- ดาวน์โหลด APK พร้อมแสดงความคืบหน้าและยกเลิกได้ ตรวจ SHA-256, ชื่อแพ็กเกจ เวอร์ชัน และลายเซ็นให้ตรงกับแอปเดิม
- อนุญาตติดตั้งจาก TSC Direct Print ครั้งแรก แล้วกดติดตั้งและยืนยันในหน้าต่าง Android ข้อมูลเครื่องพิมพ์และกระดาษเดิมยังอยู่
- ต้องลง 1.3.4 ขึ้นไปครั้งแรกด้วยตนเอง ก่อนใช้ปุ่มนี้สำหรับรุ่นถัดไป ดู วิธีอัปเดต และ ผลทดสอบ
- ใช้ Print จาก browser, โปรแกรมอ่าน PDF และแอปที่รองรับ Android printing
- บันทึกเครื่องพิมพ์ได้ 20 เครื่อง แยกชื่อ / IPv4 / พอร์ต / กระดาษเริ่มต้น และเลือกได้ทั้งหน้า Print และ Print Test
- เลือก PDF จากในแอป แล้วเปิดหน้าพิมพ์ของ Android
- แปลง PDF → ภาพขาวดำ 203 DPI → TSPL
BITMAP→ เครื่องพิมพ์โดยตรง - Preset 102 × 76 มม. และ 148 × 210 มม. (A5) พร้อมเพิ่มขนาดเอง
- Print Test มีกรอบ 4 ด้าน เส้นวัด QR และข้อความสีขาวบนพื้นดำ
- เลือกหน้า จำนวนสำเนา และแนวกระดาษจากหน้าพิมพ์ของระบบ
- ตรวจสอบ ดาวน์โหลด และเปิดตัวติดตั้งอัปเดตจาก GitHub Releases ได้ในแอป
- UI ภาษาไทย ธีมสว่าง/มืด และ navigation rail สำหรับจอกว้าง
ไม่ต้องใช้ Mac, USB หรือ print server เป็นตัวกลาง ไม่มี telemetry และไม่ส่งเอกสารไป cloud
| รายการ | รองรับ |
|---|---|
| มือถือ / tablet | Android 13 ขึ้นไป (API 33+) |
| เครื่องพิมพ์ที่ทดสอบจริง | TSC MH261T, 203 DPI |
| เครือข่าย | มือถือเข้าถึง IPv4 ของเครื่องพิมพ์ผ่าน TCP ของเครื่องพิมพ์ได้ (ปกติ 9100) |
| กระดาษ | กว้าง 20–168 มม. × สูง 20–500 มม. ภายในข้อจำกัดของแอป |
| เอกสารต้นทาง | PDF หรือแอปที่มีเมนู Android Print |
รุ่น TSPL อื่นและหัวพิมพ์ 300/600 DPI ยังไม่ได้ทดสอบ เวอร์ชันนี้กำหนด 203 DPI สำหรับทุกโปรไฟล์ ไม่ได้แปลงโปรโตคอลให้เครื่องพิมพ์ที่ไม่รองรับ TSPL
- ดาวน์โหลด
TSC-Direct-Print-<version>.apkจาก Releases - เปิด APK บน Android 13+ และอนุญาตติดตั้งจากแอปที่เปิดไฟล์เมื่อ Android ขอ
- เปิด TSC Direct Print → ตั้งค่า → แตะชื่อเครื่องพิมพ์ กรอกชื่อ / IPv4 / พอร์ต / กระดาษเริ่มต้น แล้วกด บันทึกเครื่องพิมพ์ การติดตั้งใหม่มีค่าเริ่มต้น
192.168.70.37:9100; การอัปเดตทับเก็บค่าที่คุณบันทึกไว้ - แตะชื่อเครื่องอีกครั้งแล้วกด ตรวจการเชื่อมต่อ เพื่อตรวจ IP/พอร์ตของเครื่องในหน้ารายละเอียด โดยยังไม่ส่งฉลาก
- กลับ รายการเครื่องพิมพ์ → จัดการบริการพิมพ์ แล้วเปิด TSC Direct Print ในหน้าการพิมพ์ของ Android
- เลือกเครื่องและขนาดในหน้า พิมพ์ / Print Test ให้ตรงกับฉลาก แล้วเปิดเอกสารและกด Print → ชื่อเครื่องพิมพ์ที่บันทึก
- ตรวจ preview, Paper size, แนวกระดาษ, หน้า และจำนวนสำเนา ก่อนยืนยันพิมพ์
อนุญาตสิทธิ์เครือข่ายภายในเมื่อ Android รุ่นที่ใช้งานขอ ชื่อเมนูระบบอาจต่างกันตามยี่ห้อ
มี Release 1.3.5 พร้อม APK และ checksum แล้ว ตรวจไฟล์ก่อนติดตั้งบน macOS ด้วย shasum -a 256 -c SHA256SUMS.txt โดยวางสองไฟล์ในโฟลเดอร์เดียวกัน การ push ซอร์สอย่างเดียวไม่เผยแพร่ APK อัตโนมัติ
ไม่ต้องเพิ่ม IP ผ่าน System / Default Print Service → Add printer by IP: ให้เลือกบริการ TSC Direct Print ที่ติดตั้งจาก APK นี้
สำหรับเครื่อง handheld ดู ขั้นตอนติดตั้งบน CipherLab RS38 — เคยทดสอบพิมพ์จริงบน Android 13; ผลยังขึ้นกับเฟิร์มแวร์ของแต่ละเครื่อง
ใช้ปุ่ม Print ของเว็บไซต์หรือเมนู Print ของ browser แล้วเลือก ชื่อเครื่องพิมพ์ที่บันทึก เว็บไซต์/browser ต้องเปิด Android Print dialog ได้ก่อน แอปนี้ไม่ได้เพิ่มความสามารถพิมพ์ให้ WebView ที่ไม่รองรับ
เลือกเครื่องพิมพ์ในแท็บ พิมพ์ → เลือก PDF เพื่อพิมพ์ เลือกไฟล์ แล้วตรวจค่าใน Android Print dialog ก่อนยืนยัน
เพิ่มเครื่องที่ ตั้งค่า → เพิ่มเครื่องพิมพ์ กรอกชื่อ, IPv4, พอร์ต (ปกติ 9100) และกระดาษเริ่มต้น บันทึกได้ 20 เครื่อง โดย IP+พอร์ตต้องไม่ซ้ำกัน ตั้งแต่ 1.3.3 หน้า Settings แสดงรายการ เครื่องพิมพ์ที่บันทึก พร้อมชื่อ IP/พอร์ต กระดาษเริ่มต้น และลูกศรเข้าไปตั้งค่ารายเครื่อง การเปิดหรือบันทึกค่าเครื่องอื่นไม่เปลี่ยนเครื่องที่เลือกพิมพ์ไว้ ส่วนหน้า พิมพ์ และ Print Test เลือกจากช่อง เลือกเครื่องพิมพ์ ที่มีลูกศรลง ค่าเริ่มต้นกระดาษแยกกันในแต่ละเครื่อง และขนาดกระดาษที่เพิ่มเองใช้ร่วมกันได้
หน้าต่าง Print ของ Android เป็นผู้เลือกปลายทางจริง ระบบอาจจำเครื่องจากงานก่อน จึงต้องเลือก/ตรวจชื่อและ IP อีกครั้งก่อนยืนยัน การเลือกในแอปโหลดค่าเริ่มต้นของเครื่องนั้น แต่ไม่ได้บังคับปลายทางของหน้าต่าง Android ส่วนปุ่มตรวจการเชื่อมต่อและพิมพ์ทดสอบในหน้ารายละเอียดใช้ค่าที่บันทึกไว้ของเครื่องที่กำลังดู
งานของ IP+พอร์ตเดียวกันจะเรียงคิว ส่วนคนละปลายทางทำพร้อมกันได้สูงสุด 3 งาน รวมคิวสูงสุด 32 งาน ปลายทางถูกจับไว้ตอนบริการรับงานแล้ว การสลับเครื่องในแอปหรือแก้ IP ภายหลังไม่เปลี่ยนงานนั้น หากลบเครื่องก่อนงานถูกส่งเข้าบริการ งานจะถูกปฏิเสธ ไม่ส่งไปเครื่องเริ่มต้นแทน
แก้ไข/ลบที่ ตั้งค่า → แตะชื่อเครื่องพิมพ์ หน้ารายละเอียดยังมีปุ่มตรวจการเชื่อมต่อและพิมพ์ทดสอบเครื่องนี้ โดยต้องบันทึกค่าที่แก้ก่อนทดสอบ ปุ่มพิมพ์เปิด Android Print ให้ตรวจปลายทางก่อนยืนยัน ต้องเหลืออย่างน้อย 1 เครื่อง และไม่มีการกระจายฉลากเดียวไปทุกเครื่องอัตโนมัติ
ตั้งค่าเริ่มต้นแยกต่อเครื่องได้ที่ ตั้งค่า → แตะชื่อเครื่องพิมพ์ → กระดาษเริ่มต้นของเครื่องนี้ → บันทึกเครื่องพิมพ์ เช่น จุดแพ็ก 1 ใช้ 102 × 76 มม. และจุดแพ็ก 2 ใช้ A5 เมื่อสลับเครื่องใน Print / Print Test จะเรียกคืนขนาดของเครื่องนั้น
การเปลี่ยนขนาดในแอปจะจดจำเป็นค่าเริ่มต้นของเครื่องที่เลือก ส่วนการเปลี่ยน Paper size ในหน้าต่าง Android Print มีผลกับงานนั้น ระบบ Android อาจจำค่าจากงานก่อน จึงควรตรวจขนาดก่อนยืนยัน
เลือก preset 102 × 76 มม. หรือ 148 × 210 มม. ได้ทั้งหน้า พิมพ์, Print Test และ Paper size ของ Android
เพิ่มขนาดเองที่ ตั้งค่า → แตะชื่อเครื่องพิมพ์ → เพิ่มขนาดกระดาษเอง ใส่กว้าง/สูงหน่วยมิลลิเมตร กด บันทึกและใช้ขนาดนี้ แล้วกด บันทึกเครื่องพิมพ์ เพื่อใช้เป็นค่าเริ่มต้นของเครื่องนั้น รองรับทศนิยม 1 ตำแหน่งและบันทึกเองได้ 20 รายการ
กว้าง คือแนวหัวพิมพ์ และ สูง คือแนวป้อนกระดาษ ตัวอย่าง A5 ใช้ 148 × 210 แล้วเลือกแนวตั้ง/แนวนอนแยกในหน้าพิมพ์ ช่วง 20–168 × 20–500 มม. เป็นข้อจำกัดของแอป ไม่ใช่ความยาวสูงสุดของเครื่อง
ขนาดใน Print dialog ของงานนั้นเป็นค่าที่ส่งจริง เปลี่ยนม้วนฉลากแล้วต้องตั้งไกด์และ calibrate sensor ที่เครื่องให้ตรงด้วย
- เปิด Print Test เลือกเครื่องพิมพ์และขนาดกระดาษ
- กด พิมพ์ฉลากทดสอบ เพื่อเปิด Android Print dialog
- เลือก ชื่อเครื่องพิมพ์และ IP ที่ต้องการ, ขนาดฉลากที่ใส่จริง และ 1 สำเนา แล้วกดยืนยัน
- ตรวจกรอบทั้ง 4 ด้าน เส้นวัด และ QR ซึ่งควรอ่านได้เป็น
TSC-TEST-001
ภาพนี้เป็นผล render จากแอป ไม่ใช่ภาพถ่ายกระดาษ กรอบห่างขอบประมาณ 2 มม. เส้นวัดยาว 80 มม. หรือสั้นลงพร้อมระบุความยาวเมื่อใช้กระดาษแคบ การเปิด preview ยังไม่ส่งงานไปเครื่อง
- รักษาสัดส่วน ย่อ/ขยายให้พอดี จัดกึ่งกลาง และหมุนตามแนวกระดาษที่เลือก
- ขาวดำด้วย threshold 128 เพื่อคงขอบ barcode; ไม่มี dithering สำหรับภาพถ่าย
- ไม่เขียนค่า Shift, Reference, gap sensor, ribbon, speed หรือ density ของเครื่อง
- PDF สูงสุด 100 MiB / 100 หน้า; สูงสุด 100 สำเนาและรวมไม่เกิน 1,000 ฉลากต่องาน
- เตรียมทุกหน้าก่อนเชื่อมต่อ TCP; สำเนาเรียงเป็นเอกสาร เช่น
1,2,3,1,2,3 - เมื่อส่งขาดหรือยกเลิกจะไม่ส่งซ้ำอัตโนมัติ เครื่องอาจพิมพ์ข้อมูลที่รับแล้ว จึงต้องตรวจฉลากก่อนสั่งซ้ำ
- สถานะสำเร็จหมายถึงส่งข้อมูลผ่าน TCP แล้ว ยังไม่ได้ยืนยันกระดาษออก / paper out / ribbon / ฝาเปิด
- TCP 9100 ภายในเครือข่ายไม่มี TLS; ไฟล์งานเก็บใน app-private cache และลบเมื่อจบงาน
พื้นหลังที่หายตั้งแต่ PDF ต้องแก้ที่เว็บไซต์/แอปต้นทาง ส่วนขอบเลื่อนหรือป้อนฉลากคลาดเคลื่อนให้ตรวจ calibration และตำแหน่งพิมพ์ที่เครื่อง
ตรวจ ตั้งค่า → แตะชื่อเครื่องพิมพ์ → ตรวจการเชื่อมต่อ และเปิดบริการ TSC Direct Print หากเป็น Xiaomi / Redmi / HyperOS และพิมพ์ได้เฉพาะตอนเสียบ USB ให้ตรวจ App info → Power → No restrictions; เคสที่ทดสอบต้องรีสตาร์ต Android Print Spooler เพิ่มเติมก่อนพิมพ์งานใหม่ได้
อ่าน Troubleshooting และ Verification สำหรับขั้นตอนและขอบเขตผลทดสอบ
ติดตั้ง 1.3.4 ขึ้นไปครั้งแรก ผ่าน APK หรือ ADB ก่อน แล้วรุ่นถัดไปอัปเดตจากมือถือได้:
- รอให้งานพิมพ์เสร็จ เปิด ตั้งค่า แล้วเลื่อนลงไปที่ อัปเดตแอป
- กด ตรวจสอบอัปเดต หากมีรุ่นใหม่ ให้กด ดาวน์โหลด
- รอแอปตรวจ SHA-256, package, version และลายเซ็นให้ตรงกับแอปเดิม
- ครั้งแรกกด อนุญาตติดตั้งจากแอปนี้ เปิดสิทธิ์ใน Android แล้วกลับแอป
- กด ติดตั้งอัปเดต และยืนยัน อัปเดต / Update ในหน้าต่าง Android
เก็บข้อมูลเครื่องพิมพ์และกระดาษเดิมโดยไม่ถอนแอป การตรวจ/ดาวน์โหลดต้องใช้อินเทอร์เน็ตไป GitHub ส่วนการพิมพ์ยังส่งตรงภายใน LAN ตามเดิม เมื่อรุ่นที่ติดตั้งเท่ากับ GitHub Latest จะไม่เสนอให้ดาวน์โหลดซ้ำ ดู คู่มือและการแก้ปัญหาอัปเดต
ใช้ Python 3, JDK 21, Android SDK Platform 37, Build Tools 36.0.0 และ Gradle wrapper ที่รวมไว้
git clone https://github.com/FlintsLabs/tsc-android-print.git
cd tsc-android-print
# ตั้ง JAVA_HOME และ ANDROID_HOME ให้ตรงกับเครื่องก่อน
./gradlew :core:test :app:lintDebug :app:assembleDebugผล build อยู่ ~/.cache/tsc-android-print/build/ หรือ path ที่กำหนดด้วย TSC_BUILD_ROOT ดู test, signing และ release ที่ Building และเส้นทาง PDF → TSPL ที่ Architecture
MIT License · FlintsLabs contributors · Third-party notices
โครงการอิสระ ไม่ใช่แอปทางการหรือได้รับการรับรองจาก TSC ไม่มี driver binary, firmware หรือ proprietary SDK ของผู้ผลิตรวมอยู่ใน repository หรือ APK