Metadata-Version: 2.1
Name: MqttMonitor
Version: 1.0.2
Summary: Monitor MQTT messages.
Home-page: https://fw-box.com
Author: Hartman Hsieh
Author-email: hartman@fw-box.com
License: GPLv3+
Description: MqttPrint and MqttMonitor
        =========================
        The function is based on MQTT. When the original serial of ESP8266/ESP32 cannot be used, it can replace serial print.
        
        
        MqttPrint
        ---------
        A Arduino library
        [MqttPrint](https://github.com/fw-box/MqttPrint)
        
        Easy Arduino example:
        
            #if defined(ESP32)
            #include <WiFi.h>
            #else
            #include <ESP8266WiFi.h>
            #endif
        
            #include "MqttPrint.h"
        
            // Update these with values suitable for your network.
        
            const char* ssid = "YOUR_WIFI_SSID";
            const char* password = "YOUR_WIFI_PASSWORD";
        
            const char* MqttServer = "broker.emqx.io";
            const char* MessageTopic = "YOUR_MQTT_SUB_TOPIC";
        
            void setup() {
        
                Serial.begin(115200);
                
                //
                // Begin to connect to thw WiFi AP.
                //
                Serial.println("setup : Attempting to connect...");
                WiFi.mode(WIFI_STA);
                WiFi.begin(ssid, password); // Connect to WiFi.
        
                int count = 0;
                while (WiFi.status() != WL_CONNECTED) {
                    if (count > 30)
                    break;
                    delay(500);
                    Serial.print(".");
                    count++;
                }
        
                Serial.println("");
                Serial.println("WiFi connected");
                Serial.println("IP address: ");
                Serial.println(WiFi.localIP());
                
                mbegin(MqttServer, 1883, MessageTopic);
        
            }
        
            void loop() {
                mprint("millis = ");
                mprintln(millis());
                mprintln("Hello World");
                mprintf("TEST = %d\n", millis());
                delay(1000);
            }
        
        
        MqttMonitor
        -----------
        An application to receive the MQTT messages. It's written in Python. Please install it by the command.
        
            pip install MqttMonitor
        
        How to run 'MqttMonitor'?
        - Right-click on your desktop and select New > Shortcut.
        - Add the below string in the textbox - "Type the location of the item:" and press 'Next'.
        
            **pythonw.exe -m MqttMonitor**
        
        - Add the below string in the textbox - "Type a name for this shortcut:" and press 'Finish'.
        
            **MqttMonitor**
        
        
        Usage
        -----
        MqttPrint is a MQTT sender, MqttMonitor is a MQTT receiver. They should use the same MQTT broker and sub topic.
        This is the screentshot of MqttMonitor.
        
        ![alt screenshot](https://github.com/fw-box/MqttPrint/blob/main/screenshot.png?raw=true)
        
Keywords: MQTT,monitor,serial,view
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Operating System :: Microsoft :: Windows
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Description-Content-Type: text/markdown
