Skip to content

Latest commit

 

History

History
113 lines (89 loc) · 3.74 KB

README.md

File metadata and controls

113 lines (89 loc) · 3.74 KB
Raw

Station Configurator

Easy-to-use configurator to monitor environmental parameters with professional instruments

Requirements

  1. istSOS installed locally (www.istsos.org)
  2. Python 3
  3. Python 3 pip
  4. Supported instruments:
    • Ponsel instruments with ModBus 485 communication protocol
    • Lufft compact weather station WS-501 with ModBus 485 communication protocol
    • Unilux by Chelsea Technologies with RS232 communication protocol
    • Trilux by Chelsea Technologies with RS232 communication protocol
  5. Raspberry pi or other Linux device with a ModBus compatible port

How to use

  1. Clone the repository

     ```bash
 git clone https://gitlab.com/danistrigaro/station_configurator.git
 ```

  2. Very important to disable ModemManager module otherwise USB serial communication is not reliable bash sudo systemctl disable ModemManager

  3. Install postgresql-client

     ```bash
 sudo apt install build-essential
 sudo apt install postgresql-client
 sudo apt install python3-dev libpq-dev
 sudo apt-get install libxml2-dev libxslt1-dev
 ```

  4. Navigate inside the repository's folder

     ```bash
 cd station_configurator/
 ```

  5. Install the requirements.txt using pip

     ```bash
 pip install -r requirements.txt
 ```

  6. Edit and configure the section DEFAULT in the file default.cfg. Hereinafter each parameter is explained:

    • transmission: one of

      • nb-iot: LTE CAT1/NB-IoT: (default)
      • lora: LoRaWAN(default)
      • serial: Serial (to be implemented)
      • wifi: WiFi (to be implemented)

      This setting defined how to transmit data to the data center.

    • istsos: str

      This istSOS url identified the instance where the raw and aggregated data can be archived.

    • service: str

      • station: name of the istSOS service where raw data are archived (default)

    • user: str

      • admin: user to access istSOS. The user must have the read and write permissions

    • password: str

      • batman: password of the istSOS user (default)

    • log: one of

      • DEBUG (default)
      • INFO
      • ERROR

    • max_log_days: int

      • 20: max period for logged values (default)

    • sending_time: int

      • 20: every (default)

    • remote_istsos: str

    • remote_service: str

      • demo

    • remote_user: str

      • admin

    • remote_password: str

      • batmnan

    Example:

     ```
 [DEFAULT]
 transmission = serial
 istsos = http://localhost/istsos
 service = demo
 user = admin
 password = batman
 log = DEBUG
 max_log_days = 20
 sending_time = 20
 remote_istsos = http://localhost/istsos
 remote_service = demo
 remote_user = admin
 remote_password = batman
 ```

  7. In the default.cfg file add as many sections as sensors you have. Take a look into the point 6 to have more information.

    N.B. 1: if you are using a single MODBUS port to connect more than one sensor remember to use the same sampling_time number

    N.B. 2: if you are using a single MODBUS port to connect more than one sensor and if you are using more than one sensor of the same type, so with the same address, remember to configure different address for each sensor before start with the configuration

  8. The name of the section will give the name to the sensor which will be register into the istSOS

  9. fix a astatic usb path https://rolfblijleven.blogspot.com/2015/02/howto-persistent-device-names-on.html