2 layers65 × 30 mm MGFieldHAT, the printed circuit board in 3D

MGFieldHAT

Magnetic field measurement software (This software was developed for OCISLY - for more details, please contact OCISLY-ds) - Public dashboard available at https://dashboard.zyzonix.net/

Open in PCBKit

Size: 65 × 30 mm
Copper layers: 2
Thickness: 1.6 mm
Parts: 12
Nets: 31
Pads: 68
Tracks, vias: 70, 0
Pours: 1
Routed: Yes
KiCad: KiCad 8.0 (file 20240108)
Created: 26 Apr 2021
Updated: 24 Apr 2025

Overview

MGFieldHAT is an open-source printed circuit board by Zyzonix, from the Zyzonix/mgfield repository on GitHub, published under the GPL-3.0 licence. It is a 2-layer board of 65 × 30 mm with 12 parts on 31 nets, routed with 70 tracks and 0 vias.

It is built around the ADS1115. It belongs with the sensors and measurement boards of this library.

Main components

ADS1115
UncategorisedTexas Instruments

README

README.md

mgfield - Magnetic field measurement

This software has been developed with OCISLY-ds to measure magnetic fields with a Raspberry Pi. For more details, please contact OCISLY-ds.

[blocked] [blocked]

Installation

This software is designed to be run on a Raspberry Pi! First navigate to /opt/:

text

cd /opt

Then install all required APT-packages:

text

sudo apt install mariadb-server git

If required, also install phpmyadmin and libapache2-mod-php to make PHP work with Apache. After that clone the repository:

text

git clone https://github.com/Zyzonix/mgfield.git
cd mgfield/

Now all required software is downloaded.

To install the service type:

text

sudo cp services/mgfield.service /etc/systemd/system/

Enable the service with:

text

sudo systemctl enable mgfield.service

Install required python packages:

text

sudo apt install python3-psutil i2c-tools libgpiod-dev python3-libgpiod ./packages/*

The usage of pip3 depends on your system's configuration. Python packages on some systems like Debian are managed via apt.

text

sudo pip3 install mysql-connector

Install additional python packages for physical sensor:

text

pip3 install --upgrade RPi.GPIO adafruit-blinka
pip3 install adafruit-circuitpython-ads1x15

Create config directory and move config file:

text

sudo mkdir -p /home/root/.config/
cp config.json /home/root/.config/

And finally create the logfile directory:

text

sudo mkdir -p /var/log/mgfield/

Execution

Directly over the console (the programm will interrupt when the window will be closed)

text

python3 main.py

Or via the system service

text

sudo systemctl start mgfield.service

To view the current status use:

text

sudo systemctl status mgfield.service

To view the log/consoleout in realtime use:

text

sudo journalctl -u MGField.service

Settings

The software can be configured through the config-file named config.json.

Thereby that collecting all values from each measurement (x, y, z and out) might be to heavy for a Raspberry Pi, there's a switch called storeAllRawData in the config that can be used to en-/disable the storing of this data.
Also a specific path to the temperature sensor must be provided config. If the device can't be opened the return value of the sensor will be 0.00. The right format of the sensor's path is for example: /sys/bus/w1/devices/28-01204b515089/w1_slave

SQL Value Meanings

Each table contains two rows:

Value Name	Meaning/Use type
`time_utc`	Timestamp of value in UTC
`time_local`	Timestamp of value in local time (`Europe/Berlin`/ `+02:00`)

All other values are table-specific:

Table	Value Name	Meaning/Use type
`mgfield`	`x_value`	X-Value per measurement
`mgfield`	`y_value`	Y-Value per measurement
`mgfield`	`z_value`	Z-Value per measurement
`mgfield`	`out_value`	OUT-Value per measurement
`mgfield`	`measurement_duration`	Time delta of the single measurement
`netstats`	`hostname`	Local hostname from `/etc/hosts`
`netstats`	`local_ip`	Local IP
`netstats`	`packets_sent`	Packets sent
`netstats`	`packets_recv`	Packets received
`netstats`	`errin`	Incoming packets with errors
`netstats`	`errout`	Outgoing packets with errors
`netstats`	`dropin`	Dropped incoming packets
`netstats`	`dropout`	Dropped outgoing packets
`netstats`	`target1`	Any target configured to be pinged
`netstats`	`target2`	Any target configured to be pinged
`netstats`	`target3`	Any target configured to be pinged
`sysstats`	`cpu_speed`	CPU Speed in MHz
`sysstats`	`cpu_usage`	Current CPU usage in %
`sysstats`	`cpu_ctx_switches`	CPU CTX Switches
`sysstats`	`cpu_interrupts`	CPU interrupts since last boot
`sysstats`	`cpu_soft_interrupts`	CPU soft interrupts since last boot
`sysstats`	`ram_total`	Total RAM in MB
`sysstats`	`ram_free`	Free RAM in MB
`sysstats`	`ram_used`	Used RAM in MB
`sysstats`	`ram_cached`	Cached RAM in MB
`sysstats`	`ram_free_wcache_perc`	Free RAM in % with cache
`sysstats`	`ram_free_wocache_perc`	Free RAM in % without cache
`sysstats`	`cpu_thermal`	Raspberry Pi's CPU Temperature
`sysstats`	`uptime`	Uptime since last reboot in seconds
`temperature`	`temperature_value`	Current temperature in °C

This software was earlier named MGFieldPy.

Parts

Qty	Value	Footprint	References
4	MountingHole_2.7mm_M2.5	MountingHole:MountingHole_2.7mm_M2.5	MH1, MH2, MH3, MH4
2	TO-92-TO92127P495H2044-3	DS18B20 Footprint Symbol:TO-92-TO92127P495H2044-3	DS18B20, DS18B20
1	ADS1115	Connector_PinHeader_2.54mm:PinHeader_1x10_P2.54mm_Vertical	ADS1115
1	GPIO	Connector_PinSocket_2.54mm:PinSocket_2x20_P2.54mm_Vertical	Header
1	Resistor 4.7k	Resistor_SMD:R_0805_2012Metric	4.7k
1	SolderWire-0.1sqmm_1x06_P3.6mm_D0.4mm_OD1mm	Connector_Wire:SolderWire-0.1sqmm_1x06_P3.6mm_D0.4mm_OD1mm	FLC3-70

The 10 most common of 12 parts.

Questions

How big is the MGFieldHAT PCB?

It measures 65 × 30 mm and has 2 copper layers, 1.6 mm thick.

What parts does the MGFieldHAT use?

12 parts, built around the ADS1115. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the MGFieldHAT KiCad files?

From the Zyzonix/mgfield repository on GitHub, at the commit this page was made from: the board is arch/MGFieldHAT.kicad_pcb. PCBKit opens the board in the browser, with nothing to install.

Can I use the MGFieldHAT design in my own project?

Its repository publishes it under the GPL-3.0 licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).

Category and platform

Sensors and measurement

Project files

arch/MGFieldHAT.kicad_pcbBoard

Show this board on your page

A live frame, for any web page

<iframe src="https://pcbkit.io/embed/boards/zyzonix-mgfield" title="MGFieldHAT in PCBKit" width="100%" height="480" style="border:0;border-radius:12px" allow="fullscreen" loading="lazy"></iframe>

A picture

<img src="https://pcbkit.io/embed/boards/zyzonix-mgfield.jpg" alt="MGFieldHAT" width="1200" height="900">

A picture that opens the board, for a README

[![MGFieldHAT](https://pcbkit.io/embed/boards/zyzonix-mgfield.jpg?size=s)](https://pcbkit.io/boards/zyzonix-mgfield)

Source

Repository: Zyzonix/mgfield
Board file: arch/MGFieldHAT.kicad_pcb
Commit: dcf2950
Licence: GPL-3.0

Similar boards

2 layers168.9 × 123.3 mm
OEM ECU
aeonSolutions/AeonLabs-AI-Volvo-MKII-Open-Hardware
Volvo MKII Open Hardware
296 parts161CC0-1.0
2 layers94 × 79 mm
5 - Lizard Car
TRD-B/Lizard
3D printed RC race car with custom electronics
54 parts129CC-BY-4.0
2 layers54.6 × 33 mm
JuntekOnSteroidsTTGO
rin67630/Drok-Juntek-on-steroids
Extend the possibilities of cheap digital power supplies with a WiFi module
35 parts62
2 layers155 × 70 mm
Payphone v1
sdylewski/Analog-Redial
A circuit board for old telephones to come back to life. Plug one or two phones in, and you can call the other phone, use bluetooth, connect to others via voip, and do a variety of other things with a plain old rotary…
137 parts46
2 layers32.4 × 33 mm
OpenXsensor
Ingwie/OpenAVRc_Hw
OpenAVRc Hardware and addons
40 parts26
2 layers33.9 × 90 mm
BiasPro InputProtection v3
ToneAlchemy/BiasPro
A professional-grade, dual-probe Arduino Bias Meter for guitar tube amplifiers. Open source hardware & firmware
18 parts16MIT
4 layers52.5 × 59.7 mm
ESPHome Indoor Multi Sensor
mikelawrence/esphome-indoor-multi-sensor-hardware
ESPHome Indoor Multi-Sensor hardware. This design supports Radar/PIR Presence, Temperature, Humidity, Pressure, Light, CO2, CO, VOC, NOX and PM sensors.
113 parts14CERN-OHL-P-2.0
4 layers260 × 113 mm
CellKeeper
cellkeeper-bms/cellkeeper-hardware
PCB for the CellKeeper BMS
480 parts11GPL-3.0