=============================================================================================================================================== This document contains:

• A description of the CSC wind data web posting system
• Install instructions

The system gets wind data from a csc machine running weewx and pushes the data to Appspot. Once the data is pushed, it is displayed on the appspot page. (Jorrit has the access to the appspot page) Currently the csc machine it is installed on is the csc desktop in the club house. It will be moved to the pine64 at some point.

last updated: 08-31-2020 info: cyril: cyrilbiz@gmail.com

The system is built ontop of weewx. Weewx must already be installed and working, acquiring data from the Vantage box located inside the clubhouse.

The following system gets the data from weewx and sends it to be posted on csc website via Appspot.

SYSTEM DESCRIPTION

The system works as follows:

1. Weewx produces one data frame (containing wind speed, direction and many other informations at the current time) A weewx extension (plugin) called csv then writes that data frame to a csv file located at:

   /home/admin/wind2web/data/cscVantageLoop.csv

2. Then every minute, the python script /home/admin/wind2web/wind2appspot.py is launched by a cron job. That script takes the cscVantageLoop.csv as input, extracts the relevant infos from it and produces the /home/admin/wind2web/data/cscWind.txt

3. Then 5 secondes later a cron job calls the script /home/admin/wind2web/pushWind2Appspot.sh which uploads the file cscWind.txt to appspot. Jorrit has the access to appspot and he handles actually displaying the data on the appspot page.

HOW TO INSTALL

You must be logged in as the user named "admin" Your home directory must be /home/admin

1. Download the folder wind2web (this repository) to /home/admin (or use git if you are familiar with it)

you should now have /home/admin/wind2web

note: If you do not have a /home/admin directory or if you need to install the system in a different directory (/usr/local/bin for instance) then you will have to manually change the path names accordingly in the following files ( because these paths are hardcoded for now ):

• wind2web/csv/install.py (change this BEFORE installing the csv extension to weewx)
• wind2web/wind2appspot.py
• wind2web/pushwind2appspot.sh and you need to modify these paths in the crontab (step 3) as well

2. Install the csv weewx extension: cd /home/admin/wind2web sudo wee_extension --install=csv

then stop and restart weewx:

sudo /etc/init.d/weewx stop sudo /etc/init.d/weewx start

in the terminal do:

  wee_extension --list 

this should return:

Extension Name Version Description csv 0.10 Emit loop or archive data in CSV format.

note: I modified the file csv/install.py from the original. Therefore do NOT use the original csv code (https://github.com/weewx/weewx/wiki/csv). This is because despite what their documentation says I could not configure weewx.conf to tell the original csv code where to output the data (/home/admin/wind2web/data/cscVantageLoop.csv). Therefore instead, I modified install.py and hardcoded the path there. So use the csv folder posted here in wind2web.

Before continuing: now check that the file /home/admin/wind2web/data/cscVantageLoop.csv contains wind data updated every seconds or so.

3. add the following three cron jobs:

@reboot /etc/init.d/weewx start

• • • • • /home/admin/wind2web/wind2appspot.py
• • • • • ( sleep 5; /home/admin/wind2web/pushWind2appspot.sh )

note: these cronjobs should be run as root (at least the start one) therefore in order to add them use this: sudo crontab -e