Package: terkin
Data logging for humans, written in MicroPython.Documentation:https://terkin.org/Source Code:https://github.com/hiveeyes/terkin-dataloggerPyPI:https://pypi.org/project/terkin/Status:At a glanceTerkin is a flexible data logger application for MicroPython and
CPython environments. It provides a lot of sensor-, networking-
and telemetry-connectivity options.Terkin has been conceived for the Bee Observer (BOB)
and Hiveeyes projects and was funded by the BMBF.https://bee-observer.hiveeyes.org/bmbf-verbundprojekthttps://community.hiveeyes.org/c/bee-observerFeaturesBatteries included.OverviewModular firmware frameworkFlexible configuration settings subsystemCompatible with MicroPython and CPythonConcise, readable and modularized code which is easy to followDecoupled code domains and data models for sensors vs. telemetryBased on approved modules from the MicroPython standard libraryConvenient development sandbox and test suite for quick iteration cyclesArchitectureDataloggerandDeviceare singleton objects representing the data logger application and the logging device.Components of the sensor subsystem wrap hardware drivers to generalize sensor reading.The telemetry subsystem uses different transport adapters to
implement various connectivity scenarios.Hardware supportArchitecturesx86_64, ARM, ESP32, STM32PlatformsGenuine MicroPython: PYBOARD-D, TTGO T-Call, TTGO T-BeamPycom MicroPython: WiPy, GPy, LoPy4, FiPyCPython: Linux x86_64, Linux ARM (BeagleBone, Odroid, Raspberry Pi), macOS, WSLPeripheralsSensors: 1-Wire, I2C, ADC, System, WiFiDrivers: DS18B20, BME280, BMP280, SI7021, ADS1x15, HX711, MAX17043, DS3231, AT24C32, INA219Adapters: GPSD, EPSolar ViewStar PWM charge controller, Victron Energy VE.Direct MPPT charge controller, Raspberry Pi USV+Connectivity: WiFi, SIM800 for GPRS, SX127x for LoRa (LoPy4, FiPy andDragino LoRa/GPS HAT), Sequans Monarch forLTE Cat M1orLTE Cat NB1Telemetry: WiFi/MQTT, WiFi/HTTP, SIM800/HTTP, LoRaWAN/TTN OTAA+ABPScreenshotsSensorkit and boardBee Observer Sensorkit, assembled.Bee Observer Board, assembled.Console outputTo get a better idea about how running this firmware will feel like when
watching its log output, we collected some excerpts atRunning the Terkin Datalogger.Getting startedIntroductionSeeGetting started with the Terkin Datalogger.The documentation covers the main features of the MicroPython datalogger firmware
and walks you through the setup process of the development sandbox environment
in detail.If you feel you have questions about anything you might
encounter during the setup and installation process or
if you even have suggestions to improve things, feel free
to get back to us by creating an issue on the GitHub repository.DownloadOn therelease page, bundles of the most recent software versions
are available through.tar.gzand.ziparchives.
These are suitable for uploading through Pymakr or similar
development environments / file synchronization tools.ConfigurationCopy thesettings.example.pyblueprint intosettings.pyand adjust each configuration setting appropriately. The
documentation of all parameters is in the file itself
and should be reasonably self-explanatory.
For using Terkin with TTN/LoRaWAN find some more detailshere.Sandbox setupIf you would like to contribute to the development or want to setup
a development environment for running the head version of this
software, please follow up atSetup Terkin Datalogger sandboxto read about how to install the MicroPython firmware development environment
and other software components it relies on and how to configure it properly.The programming environment is command line based and has been tested
successfully onLinux,macOSand the Windows Subsystem for Linux (WSL)
shipped withWindows 10.AcknowledgementsThis software is an effort of many people. Thanks to all thecontributorswho helped to co-create and conceive
it in one way or another. You know who you are.LicenseThis project is licensed under the terms of the AGPL license.Have fun!