README.md

MQTT Protocol Documentation - fischertechnik APS

Overview

This documentation provides comprehensive information about the MQTT-based communication protocol used in the fischertechnik Agile Production Simulation (APS) 24V system. It is intended for developers who need to understand, integrate with, or extend the factory's MQTT interface.

Official Resources

• Product Page
• Technical Documentation

Table of Contents

1. Introduction

   • 1.1 Purpose of this Documentation
   • 1.2 Basic Concepts (MQTT, VDA5050, Pub/Sub)

2. System Architecture and Overview

   • 2.1 System Architecture
   • 2.2 Overview of Message Flows
   • 2.3 Topic Structure

3. UI Integration and Custom Applications

   • 3.1 Overview
   • 3.2 Topics Used by the Official Frontend
   • 3.3 Publishing Commands from UI
   • 3.4 Building a Custom UI
   • 3.5 Technology Stack Examples
   • 3.6 Best Practices for UI Development
   • 3.7 Security Considerations
   • 3.8 Troubleshooting
   • 3.9 Example: Complete Minimal UI

4. Relationship with OPC-UA

   • 4.1 Interfaces in System Context
   • 4.2 Data Exchange and Conversion

5. Message Structure and VDA5050

   • 5.1 General Message Structure (Modified VDA5050)
   • 5.2 Common Header Fields
   • 5.3 Modifications to VDA5050 Standard
   • 5.4 Action States and Lifecycle

6. Module-Specific Documentation

   • 6.1 Overview of All Modules
   • 6.2 Milling Module (MILL)
   • 6.3 Drilling Module (DRILL)
   • 6.4 Oven Module (OVEN)
   • 6.5 Quality Control with AI (AIQS)
   • 6.6 Delivery and Pickup Station (DPS)
   • 6.7 High-Bay Warehouse (HBW)
   • 6.8 Automated Guided Vehicle (AGV)
   • 6.9 Cloud Gateway (CGW)

7. Calibration and System Actions

   • 7.1 Calibration Overview
   • 7.2 Calibration Commands (Instant Actions)
   • 7.3 Module-Specific Calibration
   • 7.4 System Reset and Restart

8. Manual Intervention and Best Practices

   • 8.1 Risks and Warnings
   • 8.2 Best Practices for Manual Control
   • 8.3 Common Pitfalls
   • 8.4 Debugging and Monitoring

9. Tools and Testing

   • 9.1 MQTT Analysis Tools
   • 9.2 OPC-UA Analysis Tools
   • 9.3 Docker Architecture
   • 9.4 Best Practices for Testing

10. Scenario Examples

    • 10.1 HBW: Manual Stocking (SET_STORAGE)
    • 10.2 Triggering a Production Order
    • 10.3 System Reset
    • 10.4 AGV: Complete Navigation Flow
    • 10.5 Simulation Game
    • 10.6 HBW: Stocking via DPS

11. Appendices and References

    • 11.1 VDA5050 Specification
    • 11.2 Additional Resources
    • 11.3 Glossary

Quick Start

For a quick overview of the system:

1. Start with the Introduction to understand basic concepts
2. Review the System Architecture for the big picture
3. Consult Module-Specific Documentation for detailed commands and examples

Version

This documentation corresponds to the APS 24V system.

Last updated: December 2025