rubis 0.3.4

Control tool of ADC monitor board, "rubis" on Raspberry Pi

rubis

ADC board for 16 channels Slow Control on Raspberry pi. This repository provides board design and control software.

Feature

• Standalone
• Inexpensive
• Multi channels (16 ch) and additional connectors (4 ch)

Hardware components

• rubis board - less than 5 dollars at elecrow
• PIN Socket
• ADC Board * 1--4 / 20 dollers per board
• BNC Connector ( * 4, optional)
• SMA Connector ( * 4, optional)
• LEMO Connector (Optional)

Software

Install

Before run, enable I2C on Raspberry Pi. (sudo raspi-config) Then, you can find the i2c devices like this.

> sudo i2cdetect -y 1
     0  1  2  3  4  5  6  7  8  9  a  b  c  d  e  f
00:          -- -- -- -- -- -- -- -- -- -- -- -- --
10: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
20: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
30: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
40: -- -- -- -- -- -- -- -- 48 49 4a 4b -- -- -- --
50: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
60: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
70: -- -- -- -- -- -- -- --

If you need, run sudo apt install libatlas-base-dev to use numpy (This tool doesn't depend on numpy).

Then, type pip3 install rubis The rubis binary will be provided at ~/.local/bin/rubis

If you want database store, do like that additionaly

sudo apt install mariadb-server
sudo mysql -u root
MariaDB [(none)]> UPDATE mysql.user SET password=password('newpassword') WHERE User = 'root';
MariaDB [mysql]> UPDATE mysql.user SET plugin='' WHERE User='root';
MariaDB [mysql]> exit
sudo systemctl restart mysql

Usage

When you execute rubis without option, logging immidiately starts with default configurations. You can use your custom configuration file with -c option. Some options can be overwrited with options.

rubis -g generates template config file. Edit them, then run rubis -c custom_config.json.

rubis -h provides option descriptions.

The output file format is CSV/MySQL.

As a default, the csv files like sc-20211029-75enrt.csv are created. The 75enrt is a hash created by configurations. rubis make files separately for different configurations. The CSV format is like that.

time,ch1,ch2,ch3,ch4,ch5,ch6,ch7,ch8,ch9,ch10,ch11,ch12,ch13,ch14,ch15,ch16
2021-10-29 00:49:50, 0.5481417, 0.5476417, 0.5483917, 0.5476417, 0.5432666, 0.5430166, 0.5441416, 0.5433916, 0.5486417, 0.5478917, 0.5482667, 0.5477667, 0.5441416, 0.5446416, 0.5440166, 0.5440166
2021-10-29 00:50:51, 0.5486417, 0.5483917, 0.5475167, 0.5476417, 0.5437666, 0.5435166, 0.5435166, 0.5436416, 0.5482667, 0.5483917, 0.5485167, 0.5481417, 0.5451416, 0.5451416, 0.5438916, 0.5437666
2021-10-29 00:51:51, 0.5480167, 0.5478917, 0.5480167, 0.5475167, 0.5432666, 0.5431416, 0.5430166, 0.5437666, 0.5482667, 0.5481417, 0.5481417, 0.5480167, 0.5445166, 0.5436416, 0.5443916, 0.5443916
2021-10-29 00:52:51, 0.5487667, 0.5481417, 0.5481417, 0.5481417, 0.5437666, 0.5437666, 0.5438916, 0.5435166, 0.5487667, 0.5482667, 0.5483917, 0.5478917, 0.5448916, 0.5440166, 0.5442666, 0.5438916
2021-10-29 00:53:52, 0.5482667, 0.5486417, 0.5476417, 0.5477667, 0.5438916, 0.5437666, 0.5432666, 0.5435166, 0.5487667, 0.5481417, 0.5481417, 0.5485167, 0.5445166, 0.5440166, 0.5441416, 0.5440166
2021-10-29 00:54:52, 0.5482667, 0.5478917, 0.5477667, 0.5478917, 0.5433916, 0.5430166, 0.5436416, 0.5438916, 0.5487667, 0.5487667, 0.5488918, 0.5478917, 0.5451416, 0.5447666, 0.5442666, 0.5441416
2021-10-29 00:55:53, 0.5487667, 0.5480167, 0.5478917, 0.5475167, 0.5441416, 0.5437666, 0.5435166, 0.5433916, 0.5487667, 0.5480167, 0.5483917, 0.5482667, 0.5452666, 0.5450166, 0.5448916, 0.5441416
2021-10-29 00:56:53, 0.5487667, 0.5483917, 0.5482667, 0.5481417, 0.5440166, 0.5438916, 0.5441416, 0.5443916, 0.5491418, 0.5487667, 0.5483917, 0.5482667, 0.5446416, 0.5442666, 0.5441416, 0.5445166
2021-10-29 00:57:54, 0.5478917, 0.5483917, 0.5480167, 0.5480167, 0.5441416, 0.5438916, 0.5440166, 0.5442666, 0.5491418, 0.5488918, 0.5488918, 0.5481417, 0.5450166, 0.5443916, 0.5441416, 0.5442666

For analysis with pandas dataframe, it is easy to extract the csv files.

import pandas as pd
from glob import glob

hash_str = '75enrt'
df = [pd.read_csv(name, parse_dates=[0], index_col=0) for name in sorted(glob('./*'+hash_str+'.csv'))]
df = pd.concat(df)

Config option

Configure name	Description	Option	Overwrite option
path	Path to store the data	Default: "./"	-p
file_header	File header of generated file	Default: "sc"	-h
naming	Naming style of file	'head-date-hash', 'head-hash', 'date-hash', 'hash', 'head-date'	-n
time_interval_sec	Data taking time interval (sec)	Default: 10	-t
available_boards	List of available ADS1115 boards	Default: [1,2,3,4]
output	Output format	"csv", "db", or "both"	-o
time_format	Time column format	"timestamp", "datetime" (default), or strftime format (for example, "%H:%M:%S")
boards	Setting for each ADS1115 board	"gain" option is available
sources	Setting for each channels

If you select naming including "date", a new file will be created day by day.

The sources should be set like,

"1":{
    "name": "ch1",
    "description": "channel 1",
    "type": "volt"
    },
"2":{
    "name": "ch2",
    "description": "channel 2",
    "type": "linear"
    "a": 2.0,
    "b": 1.2
    },

The name is used for csv header. For the type, "volt", "raw", "millivolt", and "linear" are available. "linear" returns the value "a" * (volt) + "b". The "a" and "b" should be written in the config file, for each sources.

If you set "db" or "both" for output, the following settings are required.

"db":{
    "login":{
        "host": "127.0.0.1",
        "port": 3306,
        "user": "root",
        "passwd": "newpassword",
        "autocommit": true},
    "name": "rubis"
    }