Add New Worker

This document provides guidelines for creating workers at two critical levels of the MiningOS inheritance hierarchy:

  • Level 4: Device Category Template Workers — abstract bases for device categories

  • Level 5: Brand/Model Specific Workers — concrete implementations for actual hardware

Together, these levels enable the management of diverse mining equipment through standardized interfaces while supporting brand-specific communication protocols.

For the complete inheritance hierarchy, see Repository Structure and Architecture — Class Hierarchy.

Mining operations require management of diverse equipment categories: power meters, electricity gear, sensors of various types, miner containers, the miners themselves, and more. Each category shares common behaviors within its type while differing in brand-specific communication protocols.

  • Level 4 templates provide standardized interfaces, shared configuration logic, and type system integration

  • Level 5 implementations handle actual device communication, protocol-specific logic, and hardware quirks

This two-layer approach maximizes code reuse while enabling support for any hardware vendor. For a complete list of currently supported hardware, see Supported Devices.

Specification

1. Inheritance Hierarchy Overview

spinner

For more information on the inheritance chain and MiningOS object model, check out Architecture.

Last updated