From 58eb9017065849f7ee0915e5cb4fdb0a4627c1a5 Mon Sep 17 00:00:00 2001 From: April Wormwood Date: Sun, 27 Nov 2022 22:01:17 -0700 Subject: [PATCH] Update README --- README.md | 59 +++++++++++++++++++++++++++++++++---------------------- 1 file changed, 36 insertions(+), 23 deletions(-) diff --git a/README.md b/README.md index 6c5b418..5d77a4c 100644 --- a/README.md +++ b/README.md @@ -1,33 +1,46 @@ -# i2RecordCollector -This software handles data collection and processing for The Weather Channel's IntelliStar 2 software using a mix of TWC's v1, v2, and v3 APIs. +

+ +

+ +

IntelliStar 2 Data Collector

+ + # Requirements -* Firewall on the stock I2 image fixed to allow incoming connections from ``224.1.1.77`` on ports ``7787`` and ``7788`` +* Properly set up interface for UDP. * [Python 3.8.0](https://www.python.org/downloads/release/python-380/) -## Records -- [x] ADRecord - Airport Delays -- [x] BERecord - Alerts -- [ ] ClimatologyRecord - Record highs/lows -- [x] DDRecord - Daypart Forecast -- [x] DFRecord - Daily Forecast (7 Day Forecast) -- [x] ESRecord - Air Quality -- [x] IDRecord - Pollen -- [x] MORecord - Current Conditions -- [x] TIRecord - Tides -- [ ] TFRecord - Traffic Flow -- [ ] TNRecord - Traffic Incidents -- [ ] WMRecord - Marine Forecast +## Completed Records +- [X] Aches and Pains +- [X] Air Quality +- [X] Airport Delays + National Airport delays +- [X] Alerts *(BERecord)* +- [X] Breathing +- [X] Current Conditions +- [X] Daily Forecasts +- [X] Hourly Forecasts +- [X] Heating and Cooling +- [X] Mosquito Activity +- [X] Pollen Forecasts +- [X] Tide Station Forecasts +- [X] Watering Needs +- [] Marine Forecasts +- [] Traffic Forecasts **(API access missing)** # Usage instructions -[Download a release](https://github.com/Open-Telecom/i2MessageEncoder-Rewrite/releases) for the most stable version, or clone the repository. +1) Ensure that [Python 3.8 is installed](https://www.python.org/downloads/release/python-380/). +2) [Download a release](https://github.com/Open-Telecom/i2MessageEncoder-Rewrite/releases/tag/v2.0.2), and unzip to the wanted directory. +3) Use command prompt to enter the directory of the scripts, then install package requirements:
+```py -3 -m pip install -r requirements.txt```
+4) Drop your unit's **MachineProductConfiguration.xml** file into the root of the script +5) Run ``main.py`` -``git clone https://github.com/Open-Telecom/i2MessageEncoder-Rewrite`` +### Attributions & Disclaimers +Air Quality reports are powered by Copernicus Atmosphere Monitoring Service Information 2022. +Neither the European Commission nor ECMWF is responsible for any use that may be made of the Copernicus Information or Data it contains. -*(If downloading this as a zip, extract to the directory of your choosing.)* +### Copyright Notice -Install the requirements in ``requirements.txt`` +Copyright © 2022 OpenTelecom -``py -3 -m pip install -r requirements.txt`` - -Drop your IntelliStar 2's ``MachineProductCfg.xml`` file into the root of the directory of the encoder, then run ``main.py``. +The i2DataCollector project cannot be copied/distributed without the express permission of the OpenTelecom group. \ No newline at end of file