Documentation Menu

On this page

Settings

Hardware Settings

Hardware Settings

Configure printers, scanners, cash drawers, and other hardware devices for use with QoBooks.

Overview

The Hardware Settings module allows you to:

  • Configure receipt and invoice printers
  • Set up barcode scanners
  • Configure cash drawers
  • Configure weighing scales
  • Set up customer displays
  • Manage hardware connections

Printers

Adding a Printer

  1. Navigate to Hardware Settings

    • Go to Settings > Hardware
    • Click "Printers" tab
    • Click "Add Printer"
  2. Printer Details

    • Printer Name: Descriptive name
    • Printer Type: Receipt, Invoice, or Label printer
    • Connection Type: USB, Network, or Bluetooth
    • Manufacturer: Printer manufacturer
    • Model: Printer model
    • IP Address: (for network printers)
    • Port: (for USB printers)
    • Default: Mark as default printer
  3. Save Printer

    • Click "Save"
    • Printer appears in printer list

Printer Types

Receipt Printer

  • Thermal receipt printers
  • 58mm or 80mm width
  • Used for sales receipts
  • Fast printing
  • Low cost per print

Invoice Printer

  • A4 or Letter size
  • Laser or inkjet
  • Used for invoices and reports
  • High quality output
  • Color printing support

Label Printer

  • Barcode label printers
  • Various label sizes
  • Used for product labels
  • Thermal printing
  • Durable labels

Printer Configuration

Receipt Printer Settings

  • Paper Width: 58mm or 80mm
  • Cut Command: Auto-cut after print
  • Font Size: Small, Medium, or Large
  • Logo: Include company logo
  • Footer: Custom footer text

Invoice Printer Settings

  • Paper Size: A4 or Letter
  • Orientation: Portrait or Landscape
  • Color: Color or Black & White
  • Quality: Draft, Normal, or High
  • Duplex: Single or Double-sided

Label Printer Settings

  • Label Size: Select label dimensions
  • Orientation: Portrait or Landscape
  • Barcode: Include barcode
  • Price: Include price
  • Quantity: Include quantity

Testing Printer

  1. Navigate to printer list
  2. Click "Test Print" next to printer
  3. Select test document type
  4. Click "Print Test"
  5. Verify output

Barcode Scanners

Adding a Scanner

  1. Navigate to Hardware Settings

    • Go to Settings > Hardware
    • Click "Scanners" tab
    • Click "Add Scanner"
  2. Scanner Details

    • Scanner Name: Descriptive name
    • Scanner Type: USB, Bluetooth, or Network
    • Manufacturer: Scanner manufacturer
    • Model: Scanner model
    • Connection: Connection details
    • Default: Mark as default scanner
  3. Save Scanner

    • Click "Save"
    • Scanner appears in scanner list

Scanner Configuration

USB Scanner

  • Port: USB port
  • Baud Rate: Communication speed
  • Data Bits: Data bits (usually 8)
  • Stop Bits: Stop bits (usually 1)
  • Parity: Parity (usually None)

Bluetooth Scanner

  • Pairing: Pair with device
  • PIN: Pairing PIN if required
  • Auto-connect: Connect automatically
  • Timeout: Connection timeout

Network Scanner

  • IP Address: Scanner IP address
  • Port: Network port
  • Protocol: TCP or UDP
  • Timeout: Connection timeout

Scanner Testing

  1. Navigate to scanner list
  2. Click "Test Scanner" next to scanner
  3. Scan a test barcode
  4. Verify scan is recognized
  5. Check scan accuracy

Cash Drawers

Adding a Cash Drawer

  1. Navigate to Hardware Settings

    • Go to Settings > Hardware
    • Click "Cash Drawers" tab
    • Click "Add Cash Drawer"
  2. Cash Drawer Details

    • Drawer Name: Descriptive name
    • Connection Type: USB or Printer-triggered
    • Manufacturer: Drawer manufacturer
    • Model: Drawer model
    • Port: (for USB drawers)
    • Printer: (for printer-triggered)
    • Default: Mark as default drawer
  3. Save Cash Drawer

    • Click "Save"
    • Cash drawer appears in list

Cash Drawer Configuration

USB Cash Drawer

  • Port: USB port
  • Trigger Code: Open command code
  • Pulse Duration: Open pulse duration
  • Retry Attempts: Retry on failure

Printer-Triggered Cash Drawer

  • Printer: Connected printer
  • Trigger Mode: After print or before print
  • Pulse Duration: Open pulse duration
  • Retry Attempts: Retry on failure

Cash Drawer Testing

  1. Navigate to cash drawer list
  2. Click "Test Open" next to drawer
  3. Drawer should open
  4. Verify connection
  5. Check for errors

Weighing Scales

Adding a Scale

  1. Navigate to Hardware Settings

    • Go to Settings > Hardware
    • Click "Scales" tab
    • Click "Add Scale"
  2. Scale Details

    • Scale Name: Descriptive name
    • Connection Type: USB, Bluetooth, or Network
    • Manufacturer: Scale manufacturer
    • Model: Scale model
    • Max Weight: Maximum weight capacity
    • Precision: Weight precision (decimal places)
    • Unit: Weight unit (kg, lb, g, oz)
    • Default: Mark as default scale
  3. Save Scale

    • Click "Save"
    • Scale appears in scale list

Scale Configuration

USB Scale

  • Port: USB port
  • Baud Rate: Communication speed
  • Data Format: Weight data format
  • Tare: Auto-tare support
  • Zero: Auto-zero support

Bluetooth Scale

  • Pairing: Pair with device
  • PIN: Pairing PIN if required
  • Auto-connect: Connect automatically
  • Timeout: Connection timeout

Network Scale

  • IP Address: Scale IP address
  • Port: Network port
  • Protocol: TCP or UDP
  • Timeout: Connection timeout

Scale Testing

  1. Navigate to scale list
  2. Click "Test Scale" next to scale
  3. Place item on scale
  4. Verify weight is read correctly
  5. Check accuracy

Customer Displays

Adding a Customer Display

  1. Navigate to Hardware Settings

    • Go to Settings > Hardware
    • Click "Displays" tab
    • Click "Add Display"
  2. Display Details

    • Display Name: Descriptive name
    • Connection Type: USB, Serial, or Network
    • Manufacturer: Display manufacturer
    • Model: Display model
    • Lines: Number of display lines
    • Characters: Characters per line
    • Default: Mark as default display
  3. Save Display

    • Click "Save"
    • Display appears in list

Display Configuration

USB Display

  • Port: USB port
  • Protocol: Display protocol
  • Baud Rate: Communication speed
  • Character Set: Character encoding

Serial Display

  • Port: Serial port
  • Baud Rate: Communication speed
  • Data Bits: Data bits
  • Stop Bits: Stop bits
  • Parity: Parity

Network Display

  • IP Address: Display IP address
  • Port: Network port
  • Protocol: TCP or UDP
  • Timeout: Connection timeout

Display Testing

  1. Navigate to display list
  2. Click "Test Display" next to display
  3. Display should show test message
  4. Verify connection
  5. Check for errors

Hardware Profiles

Creating a Profile

Hardware profiles allow you to group hardware for specific locations or use cases:

  1. Navigate to Hardware Profiles

    • Go to Settings > Hardware
    • Click "Profiles" tab
    • Click "Add Profile"
  2. Profile Details

    • Profile Name: Descriptive name
    • Description: Profile description
    • Branch: Assign to branch (optional)
    • Hardware: Select hardware devices
  3. Save Profile

    • Click "Save"
    • Profile appears in list

Profile Usage

  • Branch Assignment: Assign profile to branch
  • User Assignment: Assign profile to user
  • Location Assignment: Assign profile to location
  • Default Profile: Set as default for organization

Troubleshooting

Printer Not Working

Check:

  • Printer is powered on
  • Connection is secure
  • Driver is installed
  • Paper is loaded
  • No paper jams

Solutions:

  • Restart printer
  • Reconnect cable
  • Reinstall driver
  • Clear paper jam
  • Test with different device

Scanner Not Scanning

Check:

  • Scanner is powered on
  • Connection is secure
  • Scanner is paired (Bluetooth)
  • Barcode is readable
  • Scanner is in focus

Solutions:

  • Restart scanner
  • Reconnect cable
  • Re-pair device
  • Clean scanner lens
  • Test with different barcode

Cash Drawer Not Opening

Check:

  • Drawer is connected
  • Printer is working (if printer-triggered)
  • Drawer is not locked
  • Power is connected
  • Cable is not damaged

Solutions:

  • Check connection
  • Test printer
  • Unlock drawer
  • Check power
  • Replace cable

Scale Not Reading Weight

Check:

  • Scale is powered on
  • Connection is secure
  • Scale is calibrated
  • Item is on platform
  • Scale is not overloaded

Solutions:

  • Restart scale
  • Reconnect cable
  • Calibrate scale
  • Center item on platform
  • Remove excess weight

Display Not Working

Check:

  • Display is powered on
  • Connection is secure
  • Display is not damaged
  • Cable is not damaged
  • Correct protocol selected

Solutions:

  • Restart display
  • Reconnect cable
  • Replace display
  • Replace cable
  • Check protocol settings

Best Practices

Printer Management

  • Use appropriate printer for each task
  • Keep printers maintained
  • Use quality paper
  • Regularly clean printers
  • Have backup printers available

Scanner Management

  • Keep scanner lens clean
  • Test scanner regularly
  • Use compatible barcodes
  • Train staff on proper use
  • Have backup scanner available

Cash Drawer Management

  • Secure cash drawer when not in use
  • Regularly test drawer operation
  • Keep drawer organized
  • Perform regular cash counts
  • Report issues immediately

Scale Management

  • Calibrate scale regularly
  • Keep scale clean
  • Test accuracy regularly
  • Don't overload scale
  • Use appropriate scale for items

Display Management

  • Keep display clean
  • Test display regularly
  • Use appropriate messages
  • Check visibility
  • Replace if damaged

Security

Access Control

  • Restrict hardware settings to administrators
  • Log hardware configuration changes
  • Monitor hardware usage
  • Report unauthorized changes

Physical Security

  • Secure hardware devices
  • Lock drawers when not in use
  • Protect cables from damage
  • Monitor hardware locations
  • Report theft immediately

Support Resources

Documentation

  • Hardware compatibility guides
  • Configuration instructions
  • Troubleshooting guides
  • Manufacturer documentation

Community

  • Community forum discussions
  • User-shared configurations
  • Hardware recommendations
  • Tips and tricks

Direct Support

  • Email support for technical issues
  • Chat support during business hours
  • Phone support for enterprise
  • Hardware vendor support

Privacy Center.

We use cookies to enhance your experience and analyze traffic. By clicking "Accept All", you consent to our use of cookies. Read Policy

Cookie Preferences

Necessary

Essential for the website to function properly.

Analytics

Help us understand how visitors interact with the website.

Marketing

Used to display ads that are relevant and engaging.

Live Chat

Chat on WhatsApp

Reach the QoTrack team for sales questions, onboarding help, or a quick product walkthrough.

Preferred Contact

+233542795439

Mon-Fri, 8am - 6pm

Start WhatsApp Chat
Try it out Live Demo