unfolder 0.1.0__py3-none-any.whl

unfolder/__init__.py

@@ -0,0 +1,6 @@
+"""Unfolder: a downloadable collection of 19 text files."""
+
+from .downloader import download
+
+__all__ = ["download"]
+__version__ = "0.1.0"

unfolder/__main__.py

@@ -0,0 +1,35 @@
+from __future__ import annotations
+
+import argparse
+
+from . import __version__, download
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(
+        prog="unfolder",
+        description="Extract the Unfolder collection of text files.",
+    )
+    parser.add_argument("--version", action="version", version=f"unfolder {__version__}")
+    subparsers = parser.add_subparsers(dest="command", required=True)
+
+    download_parser = subparsers.add_parser("download", help="Extract all bundled text files")
+    download_parser.add_argument(
+        "--destination",
+        "-d",
+        default=None,
+        help="Target folder (default: ./unfolder)",
+    )
+    download_parser.add_argument(
+        "--overwrite",
+        action="store_true",
+        help="Overwrite files that already exist",
+    )
+
+    args = parser.parse_args()
+    if args.command == "download":
+        download(args.destination, overwrite=args.overwrite)
+
+
+if __name__ == "__main__":
+    main()

unfolder/data/LDR_DHT22_COMBINED.txt

@@ -0,0 +1,82 @@
+DHT sensor library
+Adafruit Unified Sensor
+
+
+sketch.ino:
+
+
+#include <DHT.h>
+
+#define DHTPIN 4
+#define DHTTYPE DHT22
+#define LDRPIN 34
+
+DHT dht(DHTPIN, DHTTYPE);
+
+void setup() {
+  Serial.begin(115200);
+  dht.begin();
+}
+
+void loop() {
+  float temperature = dht.readTemperature();
+  float humidity = dht.readHumidity();
+
+  int light = analogRead(LDRPIN);
+
+  Serial.println("--------------------");
+
+  Serial.print("Temperature: ");
+  Serial.print(temperature);
+  Serial.println(" C");
+
+  Serial.print("Humidity: ");
+  Serial.print(humidity);
+  Serial.println(" %");
+
+  Serial.print("Light Reading: ");
+  Serial.println(light);
+
+  if (light > 500) {
+    Serial.println("Room: DARK");
+    Serial.println("Status: COMFY");
+  } else {
+    Serial.println("Room: BRIGHT");
+    Serial.println("Status: NOT COMFORTABLE");
+  }
+
+  delay(2000);
+}
+
+
+diagram.json:
+
+
+{
+  "version": 1,
+  "author": "",
+  "editor": "wokwi",
+  "parts": [
+    { "type": "board-esp32-devkit-c-v4", "id": "esp", "top": 0, "left": 0, "attrs": {} },
+    { "type": "wokwi-dht22", "id": "dht1", "top": 0.3, "left": -111, "attrs": {} },
+    {
+      "type": "wokwi-photoresistor-sensor",
+      "id": "ldr1",
+      "top": -73.6,
+      "left": 77.6,
+      "attrs": {}
+    }
+  ],
+  "connections": [
+    [ "esp:TX", "$serialMonitor:RX", "", [] ],
+    [ "esp:RX", "$serialMonitor:TX", "", [] ],
+    [ "dht1:VCC", "esp:3V3", "red", [] ],
+    [ "dht1:GND", "esp:GND.1", "black", [] ],
+    [ "dht1:SDA", "esp:4", "green", [] ],
+    [ "ldr1:VCC", "esp:3V3", "red", [] ],
+    [ "ldr1:GND", "esp:GND.1", "black", [] ],
+    [ "ldr1:AO", "esp:34", "blue", [] ]
+  ],
+  "dependencies": {
+  }
+}

unfolder/data/Q01_DHT_Sensor.txt

@@ -0,0 +1,77 @@
+DHT sensor library
+Adafruit Unified Sensor
+
+1.Develop an ESP32 program to read temperature and humidity values using a DHT22 sensor and display the readings using serial communication.
+
+sketch.ino:
+
+#include "DHT.h"
+
+#define DHTPIN 4
+#define DHTTYPE DHT22
+
+DHT dht(DHTPIN, DHTTYPE);
+
+void setup() {
+  Serial.begin(115200);
+
+  dht.begin();
+
+  Serial.println("DHT22 Sensor Started");
+}
+
+void loop() {
+  float humidity = dht.readHumidity();
+  float temperature = dht.readTemperature();
+
+  if (isnan(humidity) || isnan(temperature)) {
+    Serial.println("Failed to read from DHT22 sensor!");
+    delay(2000);
+    return;
+  }
+
+  Serial.print("Temperature: ");
+  Serial.print(temperature);
+  Serial.println(" °C");
+
+  Serial.print("Humidity: ");
+  Serial.print(humidity);
+  Serial.println(" %");
+
+  Serial.println("--------------------");
+
+  delay(2000);
+}
+
+diagram.json:
+
+
+{
+  "version": 1,
+  "author": "",
+  "editor": "wokwi",
+  "parts": [
+    {
+      "type": "board-esp32-devkit-c-v4",
+      "id": "esp",
+      "top": 0,
+      "left": 0,
+      "attrs": {}
+    },
+    {
+      "type": "wokwi-dht22",
+      "id": "dht",
+      "top": -20,
+      "left": 200,
+      "attrs": {}
+    }
+  ],
+  "connections": [
+    ["esp:TX", "$serialMonitor:RX", "", []],
+    ["esp:RX", "$serialMonitor:TX", "", []],
+    ["dht:VCC", "esp:3V3", "red", []],
+    ["dht:GND", "esp:GND.1", "black", []],
+    ["dht:SDA", "esp:4", "green", []]
+  ],
+  "dependencies": {}
+}

unfolder/data/Q02_LDR_Sensor.txt

@@ -0,0 +1,70 @@
+DHT sensor library
+Adafruit Unified Sensor
+
+2.Develop an ESP32 program to read light intensity using an LDR module and display the readings using serial communication.
+
+sketch.ino:
+
+
+#define LDR_PIN 34
+
+void setup() {
+  Serial.begin(115200);
+
+  Serial.println("LDR Sensor Started");
+}
+
+void loop() {
+  int lightValue = analogRead(LDR_PIN);
+
+  Serial.print("Light Intensity: ");
+  Serial.println(lightValue);
+
+  if (lightValue < 1500) {
+    Serial.println("Low Light");
+  }
+  else if (lightValue < 3000) {
+    Serial.println("Medium Light");
+  }
+  else {
+    Serial.println("High Light");
+  }
+
+  Serial.println("--------------------");
+
+  delay(1000);
+}
+
+
+diagram.json:
+
+
+{
+  "version": 1,
+  "author": "",
+  "editor": "wokwi",
+  "parts": [
+    {
+      "type": "board-esp32-devkit-c-v4",
+      "id": "esp",
+      "top": 0,
+      "left": 0,
+      "attrs": {}
+    },
+    {
+      "type": "wokwi-photoresistor-sensor",
+      "id": "ldr",
+      "top": -20,
+      "left": 200,
+      "attrs": {}
+    }
+  ],
+  "connections": [
+    ["esp:TX", "$serialMonitor:RX", "", []],
+    ["esp:RX", "$serialMonitor:TX", "", []],
+    ["ldr:VCC", "esp:3V3", "red", []],
+    ["ldr:GND", "esp:GND.1", "black", []],
+    ["ldr:AO", "esp:34", "green", []]
+  ],
+  "dependencies": {}
+}

unfolder/data/Q03_PIR_Sensor.txt

@@ -0,0 +1,64 @@
+DHT sensor library
+Adafruit Unified Sensor
+
+3.Develop an ESP32 program to detect motion using a PIR sensor and display the detection status using serial communication.
+
+sketch.ino:
+
+
+#define PIR_PIN 4
+
+void setup() {
+  Serial.begin(115200);
+
+  pinMode(PIR_PIN, INPUT);
+
+  Serial.println("PIR Motion Detection Started");
+}
+
+void loop() {
+  int motion = digitalRead(PIR_PIN);
+
+  if (motion == HIGH) {
+    Serial.println("Motion Detected!");
+  }
+  else {
+    Serial.println("No Motion");
+  }
+
+  delay(1000);
+}
+
+
+diagram.json:
+
+
+{
+  "version": 1,
+  "author": "",
+  "editor": "wokwi",
+  "parts": [
+    {
+      "type": "board-esp32-devkit-c-v4",
+      "id": "esp",
+      "top": 0,
+      "left": 0,
+      "attrs": {}
+    },
+    {
+      "type": "wokwi-pir-motion-sensor",
+      "id": "pir",
+      "top": -20,
+      "left": 200,
+      "attrs": {}
+    }
+  ],
+  "connections": [
+    ["esp:TX", "$serialMonitor:RX", "", []],
+    ["esp:RX", "$serialMonitor:TX", "", []],
+    ["pir:VCC", "esp:3V3", "red", []],
+    ["pir:GND", "esp:GND.1", "black", []],
+    ["pir:OUT", "esp:4", "green", []]
+  ],
+  "dependencies": {}
+}

unfolder/data/Q04_DHT_MQTT.txt

@@ -0,0 +1,181 @@
+DHT sensor library
+Adafruit Unified Sensor
+
+4.Develop an ESP32 program to read temperature and humidity data and publish it to an MQTT broker, and develop a Python subscriber program to receive and display the published data.
+
+
+pip install paho-mqtt
+
+sketch.ino:
+
+
+#include <WiFi.h>
+#include <PubSubClient.h>
+#include "DHT.h"
+
+// DHT22 configuration
+#define DHTPIN 4
+#define DHTTYPE DHT22
+
+DHT dht(DHTPIN, DHTTYPE);
+
+// WiFi configuration
+const char* ssid = "Wokwi-GUEST";
+const char* password = "";
+
+// MQTT broker configuration
+const char* mqtt_server = "test.mosquitto.org";
+const int mqtt_port = 1883;
+const char* topic = "iot/dht22";
+
+WiFiClient espClient;
+PubSubClient client(espClient);
+
+void connectWiFi() {
+  Serial.print("Connecting to WiFi");
+
+  WiFi.begin(ssid, password, 6);
+
+  while (WiFi.status() != WL_CONNECTED) {
+    delay(500);
+    Serial.print(".");
+  }
+
+  Serial.println("\nWiFi Connected!");
+}
+
+void reconnectMQTT() {
+  while (!client.connected()) {
+    Serial.print("Connecting to MQTT...");
+
+    if (client.connect("ESP32_DHT22_Publisher")) {
+      Serial.println("Connected!");
+    }
+    else {
+      Serial.print("Failed, state: ");
+      Serial.println(client.state());
+      delay(2000);
+    }
+  }
+}
+
+void setup() {
+  Serial.begin(115200);
+
+  dht.begin();
+
+  connectWiFi();
+
+  client.setServer(mqtt_server, mqtt_port);
+
+  Serial.println("DHT22 MQTT Publisher Started");
+}
+
+void loop() {
+  if (!client.connected()) {
+    reconnectMQTT();
+  }
+
+  client.loop();
+
+  float temperature = dht.readTemperature();
+  float humidity = dht.readHumidity();
+
+  if (isnan(temperature) || isnan(humidity)) {
+    Serial.println("DHT22 Read Failed!");
+    delay(2000);
+    return;
+  }
+
+  String payload = "{";
+  payload += "\"temperature\":" + String(temperature, 2) + ",";
+  payload += "\"humidity\":" + String(humidity, 2);
+  payload += "}";
+
+  if (client.publish(topic, payload.c_str())) {
+    Serial.print("Published: ");
+    Serial.println(payload);
+    
+  } else {
+    Serial.println("MQTT publish failed!");
+  }
+
+  delay(5000);
+}
+
+
+diagram.json:
+
+
+{
+  "version": 1,
+  "author": "",
+  "editor": "wokwi",
+  "parts": [
+    {
+      "type": "board-esp32-devkit-c-v4",
+      "id": "esp",
+      "top": 0,
+      "left": 0,
+      "attrs": {}
+    },
+    {
+      "type": "wokwi-dht22",
+      "id": "dht",
+      "top": -20,
+      "left": 200,
+      "attrs": {}
+    }
+  ],
+  "connections": [
+    ["esp:TX", "$serialMonitor:RX", "", []],
+    ["esp:RX", "$serialMonitor:TX", "", []],
+    ["dht:VCC", "esp:3V3", "red", []],
+    ["dht:GND", "esp:GND.1", "black", []],
+    ["dht:SDA", "esp:4", "green", []]
+  ],
+  "dependencies": {}
+}
+
+subscriber.py:
+
+
+import paho.mqtt.client as mqtt
+
+# MQTT broker configuration
+BROKER = "test.mosquitto.org"
+PORT = 1883
+TOPIC = "iot/dht22"
+
+# Callback when connected
+def on_connect(client, userdata, flags, reason_code, properties):
+    if reason_code.is_failure:
+        print("Connection failed:", reason_code)
+        return
+
+    print("Connected to MQTT Broker!")
+    client.subscribe(TOPIC)
+    print("Subscribed to:", TOPIC)
+
+
+# Callback when a message arrives
+def on_message(client, userdata, msg):
+    print("\nReceived MQTT Message:")
+    print(msg.payload.decode())
+
+
+# Create MQTT client using Paho MQTT 2.x callback API
+client = mqtt.Client(
+    callback_api_version=mqtt.CallbackAPIVersion.VERSION2
+)
+
+client.on_connect = on_connect
+client.on_message = on_message
+
+# Connect to broker
+client.connect(BROKER, PORT, 60)
+
+print("Waiting for sensor data...")
+
+# Keep receiving messages
+client.loop_forever()