- server.py: claim the flash (state=bootloader) before spawning the task so the concurrent-request guard is effective immediately; guard the bundled image existence in the flash endpoint; single device.info() call per endpoint; 400 for refused flashes (409 stays for already-running); remove stale nvcurve-wireview-fw-*.bin temp files at startup - wireview_firmware.py: drain stderr in its own reader thread (a full pipe buffer would have hung the flash until timeout); chunked stdout reads instead of per-character read(2); BuildStruct field checks in dataclass order - wireview.py: document the intentional 0xF1 overlap between CMD_BOOTLOADER and SCREEN_RESUME_UPDATES (different command namespaces) - tests: check() now fails loudly under pytest (optional import, standalone runs unaffected); explicit reader-thread sync in test_enter_bootloader; less brittle flash-progress assertion; self-documenting checksum corruption in test_hex_parser - frontend: refreshFirmware in useCallback + effect deps; NaN% guard on flash.progress; explicit clear/keep masks in handleClear; WS firmware message reuses WireViewFlashProgress via Pick - docs: clarify that the dfu-util :leave modifier is what makes the device exit the bootloader and reboot; document the 400 vs 409 API contract; README now mentions per-pin readings, pin-imbalance gauge and fault clearing
256 lines
6.5 KiB
TypeScript
256 lines
6.5 KiB
TypeScript
export interface VFPoint {
|
|
index: number;
|
|
freq_khz: number;
|
|
freq_mhz: number;
|
|
volt_uv: number;
|
|
volt_mv: number;
|
|
delta_khz: number;
|
|
delta_mhz: number;
|
|
effective_freq_khz: number;
|
|
effective_freq_mhz: number;
|
|
domain: "gpu" | "memory";
|
|
}
|
|
|
|
export interface CurveState {
|
|
gpu_name: string;
|
|
timestamp: number;
|
|
points: VFPoint[];
|
|
}
|
|
|
|
export interface MonitoringSample {
|
|
timestamp: number;
|
|
voltage_uv: number | null;
|
|
voltage_mv: number | null;
|
|
clock_mhz: number | null;
|
|
temp_c: number | null;
|
|
power_w: number | null;
|
|
fan_pct: number | null;
|
|
fans: (number | null)[] | null;
|
|
pstate: number | null;
|
|
pstate_label: string | null;
|
|
mem_used_bytes: number | null;
|
|
mem_total_bytes: number | null;
|
|
mem_used_mib: number | null;
|
|
mem_total_mib: number | null;
|
|
gpu_util_pct: number | null;
|
|
mem_util_pct: number | null;
|
|
mem_clock_mhz: number | null;
|
|
throttle_reasons: number | null;
|
|
throttle_reasons_label: string | null;
|
|
pcie_link_width: number | null;
|
|
pcie_link_generation: number | null;
|
|
mem_temp_c: number | null;
|
|
}
|
|
|
|
export interface DashboardInfo {
|
|
name: string | null;
|
|
index: number;
|
|
driver_version: string | null;
|
|
vbios_version: string | null;
|
|
serial: string | null;
|
|
board_part_number: string | null;
|
|
uuid: string | null;
|
|
cuda_cores: number | null;
|
|
cuda_compute_capability: string | null;
|
|
rop_count: number | null;
|
|
vram_total_bytes: number | null;
|
|
vram_type: string | null;
|
|
memory_bus_width: number | null;
|
|
bar1_total_bytes: number | null;
|
|
bar1_used_bytes: number | null;
|
|
resizable_bar: boolean | null;
|
|
pcie_link_width: number | null;
|
|
pcie_link_generation: number | null;
|
|
pcie_max_link_width: number | null;
|
|
pcie_max_link_generation: number | null;
|
|
max_graphics_clock_mhz: number | null;
|
|
max_memory_clock_mhz: number | null;
|
|
max_video_clock_mhz: number | null;
|
|
power_limit_w: number | null;
|
|
power_min_limit_w: number | null;
|
|
power_max_limit_w: number | null;
|
|
persistence_mode: boolean | null;
|
|
num_fans: number | null;
|
|
supported_throttle_reasons: number | null;
|
|
temp_slowdown_c: number | null;
|
|
temp_shutdown_c: number | null;
|
|
temp_gpu_max_c: number | null;
|
|
}
|
|
|
|
export interface GpuInfo {
|
|
name: string;
|
|
index: number;
|
|
driver_version: string | null;
|
|
vram_bytes: number | null;
|
|
vram_gib: number | null;
|
|
}
|
|
|
|
export interface GpuProcess {
|
|
pid: number;
|
|
user: string;
|
|
dev: number;
|
|
type: "C" | "G" | "C+G";
|
|
// GPU utilization, only reported for processes active in the last ~1 s.
|
|
gpu_util_pct: number | null;
|
|
mem_util_pct: number | null;
|
|
vram_bytes: number | null;
|
|
vram_pct: number | null;
|
|
cpu_pct: number | null;
|
|
mem_host_bytes: number | null;
|
|
command: string;
|
|
}
|
|
|
|
export interface ProcessListResponse {
|
|
processes: GpuProcess[];
|
|
mem_total_bytes: number | null;
|
|
}
|
|
|
|
export interface SnapshotInfo {
|
|
filepath: string;
|
|
timestamp: string;
|
|
gpu: string;
|
|
nonzero_offsets: number;
|
|
size: number;
|
|
}
|
|
|
|
export interface LimitsState {
|
|
// Power
|
|
power_limit_w: number | null;
|
|
default_power_limit_w: number | null;
|
|
min_power_limit_w: number | null;
|
|
min_power_limit_w_native: number | null;
|
|
max_power_limit_w: number | null;
|
|
// "nvml" (default) or "ioctl" (experimental RM power control)
|
|
power_cap_mode: "nvml" | "ioctl";
|
|
rm_power_supported: boolean;
|
|
// Clock offsets — current values
|
|
gpc_offset_mhz: number | null;
|
|
mem_offset_mhz: number | null;
|
|
// Memory offset — hardware-reported range
|
|
min_mem_offset_mhz: number | null;
|
|
max_mem_offset_mhz: number | null;
|
|
}
|
|
|
|
export interface FanPoint {
|
|
temp_c: number;
|
|
fan_pct: number;
|
|
}
|
|
|
|
export interface FanInfo {
|
|
index: number;
|
|
fan_pct: number | null;
|
|
}
|
|
|
|
export interface FanState {
|
|
fan_pct: number | null;
|
|
fans: FanInfo[] | null;
|
|
num_fans: number | null;
|
|
fan_mode: "auto" | "curve" | null;
|
|
min_fan_pct: number | null;
|
|
max_fan_pct: number | null;
|
|
curve: FanPoint[] | null;
|
|
curve_active: boolean;
|
|
// Fan indices controlled by the active curve; null = all fans.
|
|
fan_targets: number[] | null;
|
|
}
|
|
|
|
export interface ProfileData {
|
|
name: string;
|
|
gpu_name: string;
|
|
curve_deltas: Record<string, number>;
|
|
mem_offset_mhz: number | null;
|
|
power_limit_w: number | null;
|
|
// "nvml" (default) or "ioctl" (experimental RM power control)
|
|
power_cap_mode: "nvml" | "ioctl" | null;
|
|
fan_curve: FanPoint[] | null;
|
|
fan_targets: number[] | null;
|
|
}
|
|
|
|
// ── WireView Pro II (Thermal Grizzly 12 VHPWR connector monitor) ──
|
|
|
|
export interface WireViewPin {
|
|
voltage_v: number;
|
|
current_a: number;
|
|
power_w: number;
|
|
}
|
|
|
|
export interface WireViewSample {
|
|
timestamp: number;
|
|
power_total_w: number;
|
|
current_total_a: number;
|
|
/** Spread (A) between the highest- and lowest-loaded pin */
|
|
pin_imbalance_a: number;
|
|
voltage_avg_v: number;
|
|
pins: WireViewPin[];
|
|
// Temperatures are null when the source has no channel for them
|
|
// (e.g. an hwmon module without external-sensor channels).
|
|
temp_in_c: number | null;
|
|
temp_out_c: number | null;
|
|
temp_ext1_c: number | null;
|
|
temp_ext2_c: number | null;
|
|
fan_duty_pct: number;
|
|
fault_status: number;
|
|
fault_log: number;
|
|
psu_capability_w: number;
|
|
}
|
|
|
|
export interface WireViewInfo {
|
|
device_name: string;
|
|
hw_rev: string;
|
|
firmware_version: string;
|
|
uid: string;
|
|
build: string;
|
|
transport: "serial" | "hwmon";
|
|
port: string;
|
|
}
|
|
|
|
export interface WireViewState {
|
|
available: boolean;
|
|
connected: boolean;
|
|
info: WireViewInfo | null;
|
|
sample: WireViewSample | null;
|
|
}
|
|
|
|
// ── WireView Pro II firmware (check + DFU flash) ──
|
|
|
|
export type WireViewFirmwareVerdict =
|
|
| "newer"
|
|
| "same"
|
|
| "unknown"
|
|
| "downgrade"
|
|
| "product_mismatch"
|
|
| "too_old_for_noctua";
|
|
|
|
export interface WireViewFlashProgress {
|
|
state: "idle" | "bootloader" | "waiting" | "flashing" | "done" | "failed";
|
|
progress: number;
|
|
status: string;
|
|
}
|
|
|
|
export interface WireViewFirmwareState {
|
|
device: {
|
|
connected: boolean;
|
|
transport: "serial" | "hwmon" | null;
|
|
version: number | null;
|
|
build: string | null;
|
|
};
|
|
image: {
|
|
available: boolean;
|
|
error: string | null;
|
|
version: number | null;
|
|
build: string | null;
|
|
};
|
|
verdict: WireViewFirmwareVerdict | null;
|
|
/** dfu-util version string, null when the binary is missing */
|
|
dfu_util: string | null;
|
|
flash: WireViewFlashProgress;
|
|
}
|
|
|
|
export type WireViewWsMessage =
|
|
| { type: "unavailable" }
|
|
| { type: "sample"; info: WireViewInfo; sample: WireViewSample }
|
|
// Flat payload: the flash progress fields are re-declared (not nested) to
|
|
// match the WS message shape; keep in sync with WireViewFlashProgress.
|
|
| ({ type: "firmware" } &
|
|
Pick<WireViewFlashProgress, "state" | "progress" | "status">);
|