EsoCore

EsoCore (Edge Sensor Observation, Control, Operations, Reliability Engine) is an open-source industrial IoT platform for monitoring factory machinery and equipment. It spans the full stack from PCB hardware and embedded firmware to a Django REST API backend and a Nuxt.js user portal.

Status: in development. Newmatik builds it for monitoring machines on factory floors. The documentation website is live at www.esocore.com (Cloudflare Workers); the API and the portal have no production deployment yet and run locally only.

Coding agents: AGENTS.md has the conventions, local caveats and CI gates.

Repository Structure

esocore/
  server/       Django REST API backend
  portal/       Nuxt.js user portal (dashboard, devices, alerts)
  website/      Public documentation site (static Nuxt.js, Cloudflare Workers)
  firmware/     Embedded C firmware for Edge (STM32H7) and sensors (STM32G0)
  hardware/     PCB designs (Altium), BOMs, Gerber, STEP, schematics
  tools/        Utility scripts (BOM sync, STEP linter)
  assets/       Shared icons and images

Tech Stack

Layer	Technology
Backend	Python 3.11–3.13, Django 5, Django REST Framework, Poetry
Portal	TypeScript, Nuxt 4 (Vue 3), Nuxt UI, Tailwind CSS 4, Pinia
Website	TypeScript, Nuxt 4 (Vue 3), static generation, Cloudflare
Firmware	C (C11), STM32H7 / STM32G0, ARM GCC, GNU Make
Hardware	Altium Designer, 4-layer FR4 PCBs

Prerequisites

• Python 3.11 to 3.13 and Poetry for the server (CI uses 3.11)
• Node 22.19+ (or 24.11+) and pnpm 10 (as in CI) for the portal and website
• ARM GCC (arm-none-eabi-gcc) and GNU Make for the firmware

Getting Started

Server (Django REST API)

cd server
poetry install
poetry run python manage.py migrate
poetry run python manage.py createsuperuser
poetry run python manage.py runserver

The API is served at http://localhost:8000/api/ with Swagger docs at http://localhost:8000/api/docs/.

See server/README.md for full setup, authentication, and deployment details.

Portal (Nuxt.js)

cd portal
pnpm install
pnpm run dev

The portal runs at http://localhost:3080.

See portal/README.md for configuration and branding details.

Website (Documentation)

cd website
pnpm install
pnpm run dev

The website runs at http://localhost:3081.

To generate the static site for production:

pnpm run generate

See website/README.md for deployment instructions.

Firmware

cd firmware
make all          # Build Edge + all sensors
make edge         # Build Edge only
make vibration    # Build a single sensor target
make help         # List all available targets

Requires the ARM GCC toolchain. See firmware/README.md for architecture and protocol details.

Checks

The server, portal, website and tools each have a CI workflow in .github/workflows/ that runs on pull requests to main (firmware/ and hardware/ have none). The commands for these parts are listed in AGENTS.md; run the ones for the part you changed before pushing.

Hardware

PCB designs, schematics, and BOMs are organized under hardware/:

• hardware/edge/ -- Edge device (STM32H747, dual Ethernet, RS-485, WiFi, IEPE inputs, safety I/O)
• hardware/sensors/ -- RS-485 sensor modules
  • vibration, acoustic, current, air quality, light, oil quality, pressure, temperature spot, proximity position
• hardware/cables/ -- Cable assemblies

CAD files are in each device's altium/ folder (open the .PcbDoc projects with Altium Designer). See hardware/README.md and individual sensor READMEs for specifications.

BOM Management

Canonical BOM CSVs live in each device folder under hardware/. The website reads CSVs from website/public/bom/ for public rendering. After editing any BOM in hardware/, run:

python3 tools/sync_bom_data.py

Protocols

The Edge device supports industrial fieldbus protocols:

• Modbus RTU (RS-485, isolated) and Modbus TCP (Ethernet)
• PROFIBUS DP (DB-9, switchable termination)
• PROFINET Device (over Ethernet)

Documentation

• Hardware: Edge -- Core device specifications and connectivity
• Hardware: Sensors -- Sensor module catalog and applications
• Installation Guide -- Full setup walkthrough
• Full docs are published at www.esocore.com

Open Source

Source code: github.com/newmatik/EsoCore

Legal

Copyright 2026 Newmatik. All rights reserved. Licensed under the Apache License, Version 2.0. See website/content/license.md for details.