Odoo IoT Box: Hardware Integration Guide

What Is the Odoo IoT Box?

The Odoo IoT Box is a small hardware device that bridges the gap between Odoo software and physical peripherals. It connects printers, barcode scanners, scales, payment terminals, cameras, and industrial sensors to your Odoo instance. The IoT Box acts as a local hub — devices plug into it via USB, Bluetooth, or network, and Odoo communicates with them through a secure connection.

Hardware Requirements

IoT Box Options

Supported Devices

# Device categories:
# Receipt Printers: Epson TM-T20/T88, Star TSP100/650
# Label Printers: Zebra ZD/ZT series, DYMO LabelWriter
# Barcode Scanners: Any USB HID scanner
# Scales: Mettler Toledo, Adam Equipment (RS232/USB)
# Payment Terminals: Worldline/Ingenico (SIX protocol)
# Cameras: USB webcams (for customer display or photo capture)
# Foot Switches: USB foot pedals (hands-free operation)
# Measurement Devices: Calipers, gauges (RS232/USB)

IoT Box Setup

Raspberry Pi Installation

1. Download the Odoo IoT image from odoo.com
2. Flash it to a microSD card (minimum 8GB)
3. Insert the SD card into the Raspberry Pi
4. Connect Ethernet or configure Wi-Fi
5. Power on — the IoT Box starts automatically
6. Access the IoT Box at its IP address in a browser

Connecting to Odoo

1. Go to IoT → IoT Boxes in Odoo
2. Click Connect
3. Enter the IoT Box IP address or use automatic discovery
4. Odoo detects connected devices
5. Assign devices to their intended use (POS printer, scale, etc.)

# Network requirements:
# - IoT Box and Odoo server on same network
# - HTTPS for secure communication
# - Ports: 8069 (Odoo), 443 (HTTPS), 8070 (longpolling)
# - Static IP recommended for IoT Box
# - DNS resolution to Odoo server

Point of Sale Integration

The most common IoT use case is connecting POS hardware:

POS Hardware Setup

• Receipt Printer — Connect via USB or network. Assign in POS configuration. Prints receipts automatically after payment.
• Cash Drawer — Connected through the receipt printer's RJ11 port. Opens automatically on cash payment.
• Customer Display — Screen showing order details to the customer. Connected via HDMI or USB.
• Barcode Scanner — USB scanner for scanning product barcodes at checkout.
• Payment Terminal — Card reader for electronic payments. Communicates via SIX protocol.
• Scale — For weighing products sold by weight (produce, bulk items).

Manufacturing Integration

IoT connects industrial devices to manufacturing operations:

• Measurement devices — Digital calipers and gauges send readings directly to quality checks
• Cameras — Photo capture at quality inspection points
• Sensors — Temperature, humidity, pressure monitoring
• Foot switches — Hands-free operation control on work orders

Device Management

IoT Dashboard

The IoT module provides a dashboard showing:

• Connected IoT Boxes and their status
• All detected devices with connection type
• Device assignment to POS, manufacturing, or other uses
• Connection quality and error logs

Troubleshooting

# Common IoT issues and fixes:
# Device not detected:
#   → Check USB connection, try different port
#   → Restart IoT Box
#   → Check driver compatibility

# Printer not printing:
#   → Verify printer is assigned in POS config
#   → Check paper and ribbon
#   → Test print from IoT Box web interface

# Scale not reading:
#   → Check RS232 cable and baud rate
#   → Verify scale protocol in IoT settings
#   → Calibrate the scale

Security

• IoT Box communicates with Odoo over HTTPS
• Device access is controlled through Odoo user permissions
• IoT Box firmware updates are managed through Odoo
• No device data is stored on the IoT Box itself

Best Practices

• Use wired connections — Ethernet and USB are more reliable than Wi-Fi and Bluetooth
• Assign static IPs — Prevents connectivity issues after network changes
• Test before deployment — Verify all devices work in a test environment
• Keep firmware updated — Regular updates fix bugs and add device support
• Have spares — Keep backup IoT boxes and cables for quick replacement

DeployMonkey + IoT

DeployMonkey's AI agent helps configure IoT Box connections, device assignments, and POS hardware integration for your retail or manufacturing setup.