v1.1 Released Latest version with improved stability. Repository restored after FiaOS core clearance. Download 

Open-source library for deriving solar radiation and heat flux from standard environmental sensors. Based on published research, works on Arduino, ESP32, Raspberry Pi, and other embedded platforms.

Download v1.1 GitHub Research Paper
Now Available On
PlatformIO
PlatformIO GitHub Arduino® Arduino® Cloud VS Code Extensions npmJS Direct Download
FiaPhy Vision

Unlocking the Hidden Potential of Every Sensor

Billions of sensors exist right now, measuring simple parameters only because that's how they were labeled. We are overlooking the true value of mathematical approximation.
As demonstrated in countless applications involving these sensors and sensing devices, a combination of such sensors can yield derived parameters—values we often cannot obtain directly with perfect precision.
But do we always need perfect precision?
Let's end this information crisis. Restricting sensor potential is like blocking our future generations from building upon what we create today. Old or new sensors, built for various purposes, combined together, can derive far more advanced real-world parameters in applications that don't demand absolute precision. We are wasting resources.
A single such waste can cause millions of organisms to suffer, fall behind, or be restricted.

Contribute to the next wave of planetary recovery—we can build frameworks that rely on frameworks. FiaPhy is a research initiative focused on maximizing the potential of sensors, the near-future carriers of full-human automation, to help sustain existing and upcoming innovations while enabling them to work with our frameworks for generations to come.

Contributing to the good of everywhere.

Platform Availability

FiaPhy works across multiple platforms and development environments

VS Code Extension

Language support and syntax highlighting for FiaPhy library development

Install Extension

Arduino IDE

Install via Library Manager or manual ZIP file installation

Download ZIP

PlatformIO

Professional embedded development with dependency management

$ pio lib install fiaos-org/FiaPhy@^1.0.1

Installation Instructions

Arduino Cloud Download

Arduino IDE Library Manager

  1. Open Arduino IDE
  2. Navigate to Sketch → Include Library → Manage Libraries
  3. Search for "FiaPhy" in the search box
  4. Click Install button
Arduino IDE Library Installation

Manual ZIP File Installation

  1. Download FiaPhy-1.0.1.zip from GitHub Releases
  2. Open Arduino IDE
  3. Go to Sketch → Include Library → Add .ZIP Library
  4. Select the downloaded ZIP file
  5. Library will be installed and available in your sketches
Download from GitHub Releases

VS Code Extension

  1. Open Visual Studio Code
  2. Go to Extensions (Ctrl+Shift+X or Cmd+Shift+X)
  3. Search for "FiaPhy Language Support"
  4. Click Install button (look for verified badge)
VS Code Extension Installation
Install from VS Code Marketplace

PlatformIO

Add to your platformio.ini configuration file:

[env:yourboard] platform = atmelavr ; or espressif32, etc. board = uno lib_deps = fiaos-org/FiaPhy@^1.0.1 adafruit/Adafruit BME280 Library@^2.2.2

Or install via command line:

$ pio lib install fiaos-org/FiaPhy@^1.0.1

What FiaPhy Delivers

FiaPhy implements the DTDSS (Differential Temporal Derivative Soft-Sensing) framework—a physics-based approach that transforms standard environmental sensors into capability-dense radiometers.

Global Horizontal Irradiance

Derive GHI measurements without thermopile pyranometers. FiaPhy reconstructs solar radiation data from common sensor readings.

Convective Heat Flux

Obtain heat transfer measurements that traditional sensors cannot provide directly. Unlock energy exchange dynamics from your existing hardware.

Differential Topology

Dual-node architecture separates environmental baseline from radiative flux detection. Common-mode noise rejection built into the hardware design.

Inertial Noise Reduction

Proprietary INR signal processing compensates for thermal inertia and quantization noise. Real-time derivative calculation without phase delay.

Altitude-Agnostic

Dynamic air density calculation from pressure readings. Deploy from sea level to 5000m without firmware modification or recalibration.

Evapotranspiration Ready

Derived radiation values enable Penman-Monteith ET₀ calculations. Environmental monitoring without specialized instrument costs.

Simple Integration

Configure your dual-sensor topology and let FiaPhy handle the physics. The library abstracts the differential processing internally.

main.cpp
#include <FiaPhy.h> #include <Adafruit_BME280.h> Adafruit_BME280 refSensor; // 0x76 Adafruit_BME280 fluxSensor; // 0x77 FiaPhy::DTDSS system; void setup() { Serial.begin(115200); refSensor.begin(0x76); fluxSensor.begin(0x77); system.configure(6.9271, 79.8612, 100.0); } void loop() { system.feedReferenceData(refSensor.readTemperature(), refSensor.readHumidity(), refSensor.readPressure() / 100.0); system.feedFluxData(fluxSensor.readTemperature(), fluxSensor.readHumidity(), fluxSensor.readPressure() / 100.0); if (system.isFrameReady()) { FiaPhy::RadiationResult result = system.compute(); if (result.valid) { Serial.print("GHI: "); Serial.println(result.ghi_Wm2); } } delay(3000); }

Derived Outputs

Global Horizontal Irradiance 847W/m²
Convective Heat Flux 124W/m²
Reference Evapotranspiration 4.2mm/day
Air Density (calculated) 1.18kg/m³

How It Works

A differential sensing architecture that derives atmospheric parameters from paired environmental sensors.

Reference Node

Ventilated sensor at equilibrium with ambient conditions

Differential
Analysis

Flux Node

Reactive sensor responding to radiative and thermal fluxes

Solar Irradiance
GHI in W/m²
Heat Flux
Convective transfer
Evapotranspiration
Penman-Monteith ET₀
Air Density
Real-time ρ

FiaPhy implements a dual-sensor differential topology using standard environmental sensors (BME280, etc.). By comparing a reference sensor at thermal equilibrium with a reactive flux sensor, the system extracts atmospheric parameters that would traditionally require expensive specialized instruments.

The built-in Inertial Noise Reduction (INR) filter ensures clean signals even in noisy environments, while altitude-agnostic calculations use real-time pressure readings to compute air density—eliminating the need for manual elevation calibration.

Deploy on any platform

From Arduino sketches to industrial PLCs. FiaPhy is designed to run anywhere C/C++ compiles.

ESP32 / Arduino

Embedded Systems

Native support for ESP32, ESP8266, Arduino (AVR, ARM Cortex), STM32, and Raspberry Pi Pico. Optimized for low memory and real-time operation. Install via PlatformIO or Arduino Library Manager.

Linux / Desktop

Server & Desktop

Run FiaPhy on Raspberry Pi OS and Linux systems for research and data collection. Requires GCC 8.0+ and CMake 3.10+. Full source available on GitHub with example implementations.

Built for real applications

From farms to factories, FiaPhy enables advanced environmental intelligence without specialized instruments.

Smart Home & IoT

Integrate environmental intelligence into home automation systems. Automate blinds, HVAC, and lighting based on real-time solar radiation and thermal conditions.

Solar Energy Systems

Monitor solar panel performance by comparing expected vs actual output. Detect panel degradation, shading, or soiling without expensive reference cells.

Building Energy Management

Optimize HVAC systems with real-time heat flux data. Understand thermal gains and losses through building envelopes for predictive climate control.

Weather Stations

Upgrade DIY and citizen science weather stations with derived radiation parameters. Fill gaps in meteorological networks with low-cost instrumentation.

Frequently Asked Questions

Is this free?

Yes. This is 100% free and open source. The library, research paper, and all source code are publicly available on GitHub.

How can we trust this technology?

This technology is based on the research paper "Temporal Derivative Soft-Sensing and Reconstructing Solar Radiation and Heat Flux from Common Environmental Sensors." The paper has been accepted by IEEE for peer review. We are currently in the review process and continuing to improve the technology. This is a pre-release version under active testing and development.

Does this work on macOS, Windows, and Linux?

Yes. FiaPhy works across all major operating systems (Windows, macOS, Linux) and on embedded platforms (ESP32, Arduino, Raspberry Pi, etc.). The library integrates with your development environment (Arduino IDE, PlatformIO, VS Code) rather than directly with the operating system.

How can I verify downloads are not fake?

Look for the verified checkmark next to the publisher name on the VS Code Marketplace. For GitHub releases, verify the repository URL is github.com/fiaos-org/fiaphy. Official releases are signed by the FiaOS organization.

What platforms are supported?

FiaPhy supports Arduino (AVR, ARM Cortex-M0/M3/M4), ESP32/ESP8266, Raspberry Pi (Linux ARM), STM32, and other embedded platforms. You can use Arduino IDE, PlatformIO, or compile directly with GCC on Linux systems.

Start Using FiaPhy

Download the latest version and integrate into your project

Download v1.1 VS Code Extension
GitHub Repository Research Paper

View the timeline - how we built this