agcs/README.md

AGCS v2 Weather Display

A self-contained, dockerized weather display application with desktop and mobile views.

Features

• Real-time weather data display via MQTT
• Compass visualization for wind direction
• Archive data retrieval from database
• WeatherLink API proxy
• Responsive design for mobile and desktop

Setup

1. Ensure Docker and Docker Compose are installed.

2. Clone or copy this project to your local machine.

3. Run the application:

   docker-compose up --build
   

4. Access the application:

   • Desktop view: http://localhost:8080/agcsnew.html
   • Mobile view: http://localhost:8080/mobile.html
   • Archive: http://localhost:8080/archive.php

Configuration

• MQTT broker: Configured to connect to 'ikarus.egfh.internal:8083'
• Database: MySQL with credentials (user: weewx, pass: weewx, db: weewx)
• WeatherLink API: Proxy configured with API key and secret

Troubleshooting

• If MQTT connection fails, ensure the broker is running and accessible.
• For database issues, check if the db service is up and data is populated.
• PHP errors: Check container logs with docker-compose logs web

Files

• agcsnew.html: Desktop weather display
• mobile.html: Mobile-optimized weather display
• archive.php: PHP script for database archive data
• wlproxy.php: Proxy for WeatherLink API