{"id":21518234,"url":"https://github.com/eusha425/sylvan-eye","last_synced_at":"2026-05-09T13:17:33.751Z","repository":{"id":243601281,"uuid":"780909565","full_name":"Eusha425/sylvan-eye","owner":"Eusha425","description":"A prototype IoT environmental sensor using the Sense HAT emulator to monitor tree growth conditions, capturing data like temperature, humidity, and wind conditions. This data is sent to a PHP-based webserver for logging and display, with an interface to track and view event logs.","archived":false,"fork":false,"pushed_at":"2024-11-23T09:15:21.000Z","size":1163,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-31T04:11:20.943Z","etag":null,"topics":["data-logging","environmental-monitoring","iot","php8","python3","raspberry-pi-3","real-time-data","sense-hat","webserver"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Eusha425.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-04-02T11:49:32.000Z","updated_at":"2024-11-23T09:17:46.000Z","dependencies_parsed_at":"2024-06-10T05:23:58.324Z","dependency_job_id":"4377b45a-3f14-4a3d-8193-73ca8776af99","html_url":"https://github.com/Eusha425/sylvan-eye","commit_stats":null,"previous_names":["eusha425/sylvan-eye"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Eusha425%2Fsylvan-eye","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Eusha425%2Fsylvan-eye/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Eusha425%2Fsylvan-eye/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Eusha425%2Fsylvan-eye/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Eusha425","download_url":"https://codeload.github.com/Eusha425/sylvan-eye/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244071183,"owners_count":20393354,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["data-logging","environmental-monitoring","iot","php8","python3","raspberry-pi-3","real-time-data","sense-hat","webserver"],"created_at":"2024-11-24T00:50:53.755Z","updated_at":"2026-05-09T13:17:33.718Z","avatar_url":"https://github.com/Eusha425.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# IoT Environmental Sensor and Webserver\n\n![IoT Environmental Sensor and Webserver Logo](assets/sylvan_eye.png)\n\nThis project is a prototype for an IoT-based environmental sensor designed to assist forestry workers in monitoring tree growth conditions. The sensor, emulated using the **Sense HAT**, collects environmental data such as temperature, humidity, and wind conditions, and communicates with a webserver to log and display this data in real-time.\n\n## Table of Contents\n\n- [Project Overview](#project-overview)\n- [Features](#features)\n  - [IoT Device](#iot-device)\n  - [Webserver](#webserver)\n- [Setup and Installation](#setup-and-installation)\n- [Usage](#usage)\n  - [IoT Device Usage](#iot-device-usage)\n  - [Webserver Usage](#webserver-usage)\n- [System Diagram](#system-diagram)\n- [Contributing](#contributing)\n- [License](#license)\n\n## Project Overview\n\nThis project combines an IoT device that uses the **Sense HAT** emulator to monitor environmental conditions and a webserver that logs and displays this data. The device detects movement events in real-time, classifies them (e.g., as normal, windy, or a collision), and sends the data to a PHP-based webserver. The server logs these events and provides a user-friendly interface to view the logged data.\n\n## Features\n\n### IoT Device\n\n- **Movement Detection \u0026 Classification:** Detects and classifies movement events into categories like normal, windy, or collision based on preset thresholds.\n- **Environmental Data Reporting:** Reports environmental data such as temperature, humidity, and wind conditions to the server every minute.\n- **Error Handling:** Displays error messages if the server fails to acknowledge the report.\n- **Setup Mode:** Allows for manual adjustment of temperature and humidity thresholds via the Sense HAT buttons.\n\n### Webserver\n\n- **Data Logging:** Receives data from the IoT device and logs it in an XML file.\n- **Web Interface:** Provides a user-friendly web interface to view logged data, including:\n  - Total number of timestamps recorded.\n  - Current temperature and humidity thresholds.\n  - Details of any events exceeding thresholds or involving collisions.\n\n## Setup and Installation\n\nFollow the steps below to set up the IoT device and the webserver.\n\n### 1. Clone the Repository\n\n```bash\ngit clone https://github.com/Eusha425/sylvan-eye.git\ncd sylvan-eye\n```\n\n### 2. Install Dependencies\n\n- **For the IoT Device (Python):**\n\n```bash\npip install sense_hat\n```\n\n- **For the Webserver (PHP):**\n  - Ensure you have a web server (e.g., Apache) and PHP installed on your system.\n\n### 3. Start the Webserver\n\n- Place the `webserver.php` and `displaywebserver.php` files in your web server's root directory (e.g., `/var/www/html` for Apache).\n\n### 4. Run the IoT Device Script\n\n```bash\npython iot_device.py\n```\n\n## Usage\n\n### IoT Device Usage\n\n- **Normal Operation Mode:**\n  - The device will report environmental data (temperature, humidity, and wind conditions) to the server every minute.\n  \n- **Setup Mode:**\n  - To enter Setup Mode, press the middle button on the Sense HAT (while not in a collision state).\n  - Use the left and right buttons to switch between temperature and humidity settings.\n  - Use the up and down buttons to adjust the thresholds.\n  - Press the middle button again to exit Setup Mode.\n\n### Webserver Usage\n\n- Access the **`displaywebserver.php`** file via your web browser to view the logged data.\n  - This page will display the total number of data logs, the current temperature and humidity thresholds, and any events that exceed thresholds or involve collisions.\n\n## System Diagram\n\nBelow is a system diagram showing how the IoT device communicates with the webserver:\n\n![State Transition Diagram](./assets/state_diagram.png)\n\n## Contributing\n\nContributions are welcome! If you'd like to contribute to the project, please follow these steps:\n\n1. Fork the repository.\n2. Create a new branch.\n3. Make your changes or additions.\n4. Submit a pull request with a description of your changes.\n\nFor any bugs or feature requests, please open an issue.\n\n## License\n\nThis project is licensed under the **MIT License**. See the [LICENSE](./LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feusha425%2Fsylvan-eye","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feusha425%2Fsylvan-eye","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feusha425%2Fsylvan-eye/lists"}