Event IoT Module (Badge Printer Integration)
Integrate IoT badge printers with events to auto-print badges on check-in and manage professional attendance badges.
Event IoT module integrates IoT badge printers with event management system, auto-printing badges on check-in.
Supports dedicated 96x82mm label printers, customizable badge templates per event, manual and batch printing.
Key Features
Key points
• Auto-print attendance badges on event check-in.
• Integrate with IoT Box and dedicated 96x82mm label printers.
• Customize badge templates per event with logo, colors, information.
• Manual print for individual attendees or batch printing.
• Track badge print status and printing history.
• Support multiple printers for large events.
Core EN/VI Terminology
| Fields | Trường dữ liệu | Description |
|---|---|---|
| Badge | Thẻ tham dự | Printed card for event attendees. |
| IoT Box | Hộp IoT | Device connecting printers to Odoo via network. |
| Badge Printer | Máy in thẻ | Dedicated label printer with 96x82mm size. |
| Badge Format | Định dạng thẻ | Badge design template with layout, colors, information. |
| Auto-print | In tự động | Auto-print badge on successful check-in. |
| Manual Print | In thủ công | Manually print badge from attendee list. |
| Print Status | Trạng thái in | Status: Not Printed, Printed, Print Error. |
System Requirements
To use IoT badge printing features, prepare the following components:
Key points
• Odoo IoT Box (version 16.0 or later) connected to Odoo network.
• Label printer supporting 96x82mm size (Brother QL-820NWB, Zebra ZD410).
• Thermal label paper 96x82mm size.
• Event and IoT modules installed and activated.
• Event Manager access to configure printers and badge templates.
Recommended Printers
| Printer | Size | Connection | Notes |
|---|---|---|---|
| Brother QL-820NWB | 96x82mm | WiFi, USB | Recommended, high speed |
| Zebra ZD410 | 96x82mm | WiFi, USB, Bluetooth | Professional, durable |
| Dymo LabelWriter 450 | 89x36mm | USB | Budget-friendly, smaller size |
Configure IoT Box and Badge Printer
Connect IoT Box to Odoo and configure badge printer to be ready for printing.
Key points
• If printer does not appear, check USB/WiFi connection and restart IoT Box.
• Ensure paper is loaded correctly and printer is powered on.
Steps
1. Go to IoT → IoT Boxes and connect IoT Box to Odoo (follow IoT Box guide).
2. Connect label printer to IoT Box via USB or WiFi.
3. Go to IoT → Devices to view detected printer.
4. Open printer device and set Type to "Printer".
5. Check connection status: Status must be "Connected".
6. Click Test Print to verify printer works correctly.
Configure Badge Format for Events
Create custom badge template for each event with logo, colors, and display information.
Key points
• Can create multiple badge templates for different event types.
• Use QR Code to display check-in code or contact information.
Steps
1. Go to Event → Configuration → Badge Formats and click New.
2. Fill Name (template name, e.g., "Tech Conference 2026").
3. Select Badge Size: 96x82mm (or printer-supported size).
4. In Design tab, customize badge layout:
5. - Upload Logo: company or event logo.
6. - Background Color: badge background color.
7. - Text Fields: select display information (Name, Company, Email, Job Title).
8. - Font Size/Color: text size and color.
9. In Preview tab, preview badge template.
10. Click Save to save badge template.
Assign Badge Format and Printer to Event
Key points
• If Auto-print is not enabled, can manually print from attendee list.
• Can assign multiple printers for large events to increase printing speed.
Steps
1. Open event to configure in Event → Events.
2. In Configuration tab, find Badge Printing section.
3. Select Badge Format: template created in previous step.
4. Select Badge Printer: configured IoT printer.
5. Enable Auto-print on Check-in if auto-printing on check-in is desired.
6. Click Save to save configuration.
Check-in and Auto-print Badges
When attendees check-in at event, system auto-prints badge if Auto-print is enabled.
Key points
• If print error occurs, status will be "Print Error" and can manually reprint.
• Can batch check-in and print badges for multiple people simultaneously.
Steps
1. Open event and go to Attendees tab.
2. Click Check-in next to attendee name.
3. System automatically sends print command to IoT printer.
4. Printer will print badge with information: Name, Company, Email, QR Code.
5. Print Status changes to "Printed".
Manual Badge Printing
Manually print badges for attendees without badges or needing reprints.
Key points
• Can select multiple attendees and batch print.
• Use filters to find attendees without printed badges (Print Status = Not Printed).
Steps
1. Go to Event → Events and open event.
2. In Attendees tab, select attendees needing badge printing.
3. Click Action → Print Badges.
4. Select printer (if multiple printers available).
5. Click Print to send print command.
6. Check print status in Print Status column.
Batch Print Badges Before Event
Key points
• Pre-printing before event saves check-in time.
• Can print badges for registered attendees who have not checked in yet.
Steps
1. Go to Event → Events and open event.
2. In Attendees tab, click Print All Badges button.
3. Select Badge Format and Badge Printer.
4. Select Filter: All Attendees or Not Printed Only.
5. Click Print to print all badges.
6. Monitor printing progress in Print Queue.
Track Badge Print Status
Key points
• Go to Event → Reports → Badge Print Status to view report.
• Filters: Not Printed, Printed, Print Error.
• View print history: Print Date, Printer Used, Print Count.
• Export Excel report for analysis and archiving.
Best Practices
Key points
• Test print badge template before event to check layout and colors.
• Prepare backup paper and check ink before event.
• Use multiple printers for large events to avoid bottlenecks.
• Enable Auto-print for small events, disable for large events for control.
• Pre-print badges for VIPs or speakers to save time.
• Use QR Code on badges for quick check-in or information sharing.
• Check IoT Box and printer connection before event starts.
Troubleshooting
Key points
• Check IoT Box Log for detailed errors: IoT → IoT Boxes → View Logs.
• Test Print regularly to ensure printer operates stably.
• Contact support if issue persists after trying above solutions.
Common Issues
| Issue | Cause | Solution |
|---|---|---|
| Printer not appearing | USB/WiFi connection error | Check connection, restart IoT Box |
| Badge print error | Paper out or jammed | Check paper, clean printer |
| Blurry badge print | Low ink or wrong settings | Replace ink, adjust Print Quality |
| Slow printing | Printer overloaded | Use multiple printers or pre-print before event |
| Wrong badge layout | Paper size mismatch | Check Badge Size matches paper |
| Auto-print not working | Not enabled or printer offline | Enable Auto-print, check printer online |
User Groups and Permissions
Access Control
| Group | Main Permissions |
|---|---|
| Event User | Check-in attendees, manual badge printing, view print status. |
| Event Manager | Full access: configure printers, create badge templates, configure events, batch printing. |
| IoT Administrator | Manage IoT Box, configure devices, view logs, troubleshoot. |