Replace preset tuning with a bounded controller: a PID over chain frequency that targets a DC power draw or a hashrate, inside the profile envelope. The controller rate-limits its output, ignores errors inside a deadband, takes the derivative on the measurement so a setpoint change does not kick it, and uses conditional integration so a saturated actuator does not wind the integral up. A thermal guard runs before the target logic: any sensor at or above the ceiling derates the frequency regardless of what the operator asked for, so a hashrate target can never cook a board.
Alkane OS
Rust mining and tuning core for Alkane control boards. The SDK builds board images and provides the hardware backend. The miner has no on-board web frontend.
Status
The host miner supports BM1362 and BM1366 through the SDK's simulator HAL and Stratum V1. Tests have replayed 33 captured BM1366 shares and one BM1362 share to a loopback pool with matching ACCEPT responses. Production board control is still under development.
The BM1370 module encodes a captured S21 Pro job and parses captured nonce frames. Work-ID mapping, chain control, and pool acceptance remain open.
The HAL client requests PSU shutdown on sensor faults and reserves work IDs until a confirmed reset or shutdown. A production backend still needs a power lease, watchdog, and validated temperature limits. SHA-256d and Litecoin Scrypt proof verification are implemented; Scrypt chip report handling and mining remain open.
Run alkane-os --list-targets for the target matrix. Set POOL_PASSWORD to
the pool password, then mine with a simulator HAL socket and Stratum V1 pool:
ALKANE_POOL_PASSWORD="$POOL_PASSWORD" alkane-os --mine-simulator HAL_SOCKET POOL_ADDRESS WORKER BM1366
Use BM1362 for that chip. Set ALKANE_API_LISTEN=127.0.0.1:4028 for
read-only summary and version commands; reach it remotely through SSH.
Release gate
main runs tests, benchmarks, and conformance before release; next builds
release candidates. The release gate is red. It requires all 64 same-vendor
pairings (52 Bitmain, 12 WhatsMiner), unmodified stock firmware, captured
silicon nonces, difficulty-1 pool acceptance, and bench-validated models.
Stock firmware may faithfully reject a pairing; Alkane OS must mine it.
See the evidence contract.
Badges cover host code, not board conformance. See the public benchmark history.
Local checks
CARGO_TARGET_DIR=/var/tmp/alkane-os-target cargo test --locked
Use an executable target directory if the source mount is noexec.
License
MIT. Vendored dependencies keep their own licenses.