Support Center
Get help with PrintPulse - Your ESC/POS printer diagnostic tool
Frequently Asked Questions
PrintPulse supports any ESC/POS compatible network printer that communicates over TCP port 9100. This includes most receipt printers from manufacturers like:
- Epson TM series
- Star Micronics TSP series
- Citizen CT-S series
- Bixolon SRP series
- Other ESC/POS compliant printers
Note: The printer must be connected to the same local network as your iOS device and have TCP port 9100 enabled.
Camera access is used only for scanning QR codes that contain enterprise authorization codes. This feature is designed for business users who receive authorization codes from their IT administrators.
Privacy: No camera images are stored or uploaded. The QR code is parsed locally on your device. If you prefer, you can manually type the authorization code instead of scanning.
Local network access allows PrintPulse to:
- Discover printers on your network by scanning IP addresses in your subnet (/24 range)
- Connect to printers via TCP socket on port 9100
- Send test commands to verify printer functionality
- Measure network latency and connection reliability
Privacy: All network scanning and diagnostic data is processed locally on your device. No data leaves your network unless you explicitly enable server upload in Settings.
No, by default. All diagnostic reports are stored locally on your iOS device. You have complete control:
- Local Storage: Reports are saved to the app's Documents directory
- Manual Export: You can share reports as JSON or text files via iOS Share Sheet
- Optional Upload: If you enable "Auto Upload Reports" in Settings and configure a server URL, reports will be sent to your enterprise server. This is disabled by default
To export a diagnostic report:
- Open the History tab in PrintPulse
- Tap on the report you want to export
- Tap the Share button (iOS share icon)
- Choose export format:
- JSON: Machine-readable format for data processing
- Text: Human-readable format for documentation
- Share via AirDrop, email, or save to Files app
PrintPulse calculates a health score (0-100) for each printer based on three factors:
- Connection Success Rate (30%): How many connection attempts succeeded
- Write Success Rate (40%): How many ESC/POS commands were successfully received by the printer
- Network Latency (30%): Average response time (lower is better)
Status thresholds:
- Good (Green): Score ≥ 90
- Warning (Yellow): Score ≥ 70
- Critical (Orange): Score ≥ 1
- Unreachable (Red): Score = 0 (cannot connect)
Yes! PrintPulse offers several monitoring modes:
- Batch Diagnostics: Test up to 50 printers in a single session (tested sequentially for accuracy)
- Network Scan: Discover all devices on your /24 subnet (up to 255 hosts) and identify ESC/POS printers
- Real-time Monitor: Track latency trends for multiple printers with live charts and statistics
Note: Tests are run sequentially (not in parallel) to avoid network congestion and ensure accurate results.
For accurate diagnostics, PrintPulse tests printers one at a time (sequentially) rather than all at once (in parallel). This is because:
- ESC/POS printers are sensitive to burst traffic
- Parallel testing can cause false-positive failures
- Network congestion affects latency measurements
While this takes longer, it ensures each printer is tested under realistic conditions with accurate results.
PrintPulse supports English and Traditional Chinese (繁體中文):
- Open the Settings tab
- Find the Language setting
- Select your preferred language
- The app will update immediately
Engineering Mode is an advanced debugging feature for IT administrators:
- How to enable: Tap the Settings screen title 7 times consecutively
- Features: Access to advanced network diagnostics, raw TCP logs, and debug settings
- Warning: Only for experienced users. Incorrect settings may affect diagnostic accuracy
Technical Requirements
- iOS Version: iOS 15.0 or later
- Compatible Devices: iPhone, iPad
- Network: WiFi connection required for network scanning and printer communication
- Printer Requirements: ESC/POS compatible printer with TCP port 9100 enabled
- Network Configuration: Device and printers must be on the same local network (same subnet)
Known Issues & Limitations
- Subnet Limitation: Network scanning is limited to /24 subnets (255 host addresses). Larger networks require multiple scans from different subnets
- Sequential Testing: Batch diagnostics test printers one at a time, which may take longer for large printer fleets
- Default Timeout: Each printer has a 90-second timeout by default. This can be adjusted in Settings if your printers are slower to respond
- Port Restriction: Only TCP port 9100 is supported (standard ESC/POS port). Custom ports are not currently supported
Troubleshooting
Issue: No printers found during network scan
- Verify your iOS device is connected to WiFi (not cellular)
- Ensure printers are powered on and connected to the same network
- Check that printers have TCP port 9100 enabled
- Try manually adding a printer's IP address
Issue: Printer shows "Unreachable" status
- Ping the printer's IP address from another device to verify network connectivity
- Check firewall settings on your network
- Verify the printer's IP address hasn't changed (consider using static IP)
Issue: Camera won't scan QR code
- Grant camera permission in iOS Settings → PrintPulse
- Ensure QR code is well-lit and in focus
- Alternatively, manually type the authorization code
Contact Support
Need More Help?
Our support team is here to assist you:
Email: [email protected]
Response Time: We typically respond within 48 hours during business days
Languages Supported: English, Traditional Chinese (繁體中文)
Privacy Policy: Read our Privacy Policy
Documentation
- Privacy Policy - How we handle your data
- GitHub: Coming soon - Open source components and sample code