Tru-Control App - Support

Tru-Control App Support

Your complete guide to monitoring and controlling your Truma™ heating system

🚀

Quick Start Guide

1 Install the App

Download Tru-Control from the App Store on your iPhone or iPad.

2 Choose Connection Method

Select between BLE (Bluetooth) or MQTT connection in Settings.

3 Connect via BLE

For BLE: Enable Bluetooth → Scan for devices → Select your Truma™ system → Pair.

4 Connect via MQTT

For MQTT: Enter broker details → Tap "Save and Connect" → Check status indicator.

5 Monitor & Control

Use the dashboard to control temperature, hot water, and power settings.

App Features UPDATED

Connectivity NEW

Dual Connectivity

BLE (Bluetooth Low Energy) and MQTT support for flexible connection options

Automatic Device Discovery

Scan and discover nearby Truma™ systems via Bluetooth

Connection Manager

Switch between BLE and MQTT connections seamlessly

Monitoring & Control

Real-time Temperature Monitoring

Live updates of heating system temperature

Battery Status Display

Voltage monitoring with color-coded visual indicators

Energy Mix Control

Switch between Gas, Electric, or Mixed heating modes

Hot Water Control

Set water temperature (ECO/60°/BOOST modes)

Advanced Features

Smart Error Handling

Detailed error codes with actionable solutions

Background Operation

Maintains connection for real-time monitoring when app is minimized

Enhanced Debug Log

Comprehensive connection and communication logs for troubleshooting

Favorites Management

Save frequently used devices for quick access

User Interface

Dark/Light Mode

Automatic theme switching based on system settings

Intuitive Dashboard

Clean, organized interface with quick-access controls

📋

System Requirements

For BLE Connection NEW

  • Truma™ Combi heating system with BLE interface
  • Bluetooth 4.0 or later (Bluetooth LE)
  • iOS device with BLE capability

For MQTT Connection

  • Truma™ Combi heating system with MQTT interface
  • MQTT broker (e.g., Mosquitto, HiveMQ, EMQX)
  • Network connectivity

Software

  • iOS 15.0 or later
  • iPhone, iPad, or iPod touch
Note: BLE connection requires iOS 15.0+ and works up to approximately 30 meters range.
🛠️

Hardware Setup

To use Tru-Control, you need to set up the required hardware that connects to your Truma™ heating system.

External Hardware Configuration

For detailed instructions on how to install and configure the necessary Raspberry Pi hardware:

Visit Tru-Control GitHub Repository

The GitHub repository contains complete installation guides and configuration instructions.

What you'll find on GitHub:

  • Step-by-step hardware installation instructions
  • Raspberry Pi configuration guides
  • LIN-BUS interface setup
  • BLE Server and MQTT Gateway configuration
  • Troubleshooting guides for common issues
Important: This project is for educational purposes. All LIN-BUS protocols and codes remain property of Truma™ Gerätetechnik GmbH & Co. KG.
🔧

Troubleshooting Common Issues

BLE Connection Problems NEW

Device Not Found

• Ensure Bluetooth is enabled on your iOS device
• Make sure Truma™ system is powered on and in pairing mode
• Check device proximity (within 30 meters)
• Restart Bluetooth on your iOS device

Connection Drops

• Move closer to the Truma™ system
• Check for interference from other wireless devices
• Ensure iOS device battery is not in low power mode
• Update to latest iOS version

MQTT Connection Problems

MQTT Not Connecting

• Verify broker hostname/IP is correct
• Check port number (default: 1883 for non-TLS, 8883 for TLS)
• Ensure broker is running and accessible
• Check username/password if authentication is required

Common Error Codes

Tap any error code in the app for detailed information:

BLE-001 BLE-002 MQTT-101 112 24 407

General App Issues

App Crashes or Freezes

• Force close and restart the app
• Update to latest version from App Store
• Restart your iOS device
• Check for iOS updates

No Data Displayed

• Verify connection is active (check status indicator)
• For BLE: Check Bluetooth connection
• For MQTT: Check broker connectivity
• Review Debug Log in Settings for details

Frequently Asked Questions

General Questions UPDATED

Q: Which connection method should I use?

A: BLE for direct control without internet. MQTT for remote access and integration with smart home systems.

Q: Is my data secure?

A: All data stays on your device. We don't collect any personal information. See our Privacy Policy.

BLE Questions NEW

Q: What's the range for BLE connection?

A: Approximately 30 meters in open space, less through walls or obstacles.

Q: Can I use BLE and MQTT simultaneously?

A: No, you can use only one connection method at a time, but switching is easy in Settings.

Q: Does BLE drain my phone battery?

A: Bluetooth LE is designed for low energy consumption. Impact on battery is minimal.

Technical Questions

Q: Can I use TLS/SSL with my MQTT broker?

A: Yes! Enable "Use TLS" in Settings and use port 8883 (or your custom TLS port).

Q: How do I set up my MQTT broker?

A: We recommend Mosquitto or EMQX. Consult your broker's documentation for setup instructions.

Need More Help?

Can't find what you're looking for? Contact us directly:

Typical response time: 24-48 hours during business days.

© 2025 Tru-Control App. All rights reserved.

This app is not affiliated with Truma™ Gerätetechnik GmbH & Co. KG.
Truma™ is a registered trademark of Truma™ Gerätetechnik GmbH & Co. KG.