Files
nvcurve/frontend/src/types.ts
T
ARIA 6e87dcf862 fix: address PR review — flash state race, error paths, test robustness, nits
- 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
2026-10-05 20:40:05 +02:00

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">);