test_discovery¶

Classes¶

FakeXdmaPaths

Functions¶

`test_discover_devices_returns_empty_list_when_no_xdma_paths`(...) → None
`test_discover_devices_uses_macos_backend_on_darwin_default_dev_root`(...) → None
`test_identify_device_rejects_generic_xdma_bitstream`(...) → None
`test_identify_device_reports_unhealthy_bar_when_magic_reads_all_ones`(...) → None
`test_discover_devices_reports_one_matching_fake_device`(...) → None
`test_discover_devices_decodes_the_concrete_contract_on_register_map_0_2`(...) → None	Register map 0.2: OPERATOR_BITMAP is hardware truth (typed INT32 at
`test_identify_device_supports_register_window_offset`(...) → None
`test_identify_device_retries_transient_zero_magic_read`(...) → None
`test_identify_device_reports_unadvertised_metadata_honestly`(...) → None
`test_an_undecoded_operator_word_advertises_nothing`(...) → None	MAGIC reads, so the path is healthy, but the operator word is
`test_device_decodes_status_and_counters_from_register_block`(...) → None
`test_device_reads_register_block_snapshot_from_dau_core_contract`(...) → None
`test_read_u64_uses_two_u32_register_reads_for_xdma_user_bar`(...) → None
`test_device_bar_health_check_reports_all_ones_for_selected_register`(...) → None
`test_device_validates_dma_transfer_shape_before_real_xdma_io`(...) → None
`_sysfs_owner`(root, bdf, node) → None
`test_a_fake_device_is_identified_by_its_node_and_says_so`(...) → None
`test_endpoint_for_devnode_reads_the_owning_pci_device_from_sysfs`(...) → None
`test_a_discovered_linux_device_is_identified_by_its_pci_endpoint`(...) → None
`write_fake_xdma_device`(root, *[, index, magic, ...]) → FakeXdmaPaths
`write_u32`(register_image, register_window_offset, ...) → None
`write_u64`(register_image, register_window_offset, ...) → None

Module Contents¶

class test_discovery.FakeXdmaPaths¶

user: pathlib.Path¶

h2c: pathlib.Path¶

c2h: pathlib.Path¶

test_discovery.test_discover_devices_returns_empty_list_when_no_xdma_paths(tmp_path: pathlib.Path) → None¶

test_discovery.test_discover_devices_uses_macos_backend_on_darwin_default_dev_root(monkeypatch: pytest.MonkeyPatch) → None¶

test_discovery.test_identify_device_rejects_generic_xdma_bitstream(tmp_path: pathlib.Path) → None¶

test_discovery.test_identify_device_reports_unhealthy_bar_when_magic_reads_all_ones(tmp_path: pathlib.Path) → None¶

test_discovery.test_discover_devices_reports_one_matching_fake_device(tmp_path: pathlib.Path) → None¶

test_discovery.test_discover_devices_decodes_the_concrete_contract_on_register_map_0_2(tmp_path: pathlib.Path) → None¶: Register map 0.2: OPERATOR_BITMAP is hardware truth (typed INT32 at register level, no five-type expansion) and HOST_OPCODE_BITMAP carries the host-computed opcodes (AVERAGE = SUM/COUNT divide) separately.

test_discovery.test_identify_device_supports_register_window_offset(tmp_path: pathlib.Path) → None¶

test_discovery.test_identify_device_retries_transient_zero_magic_read(tmp_path: pathlib.Path, monkeypatch: pytest.MonkeyPatch) → None¶

test_discovery.test_identify_device_reports_unadvertised_metadata_honestly(tmp_path: pathlib.Path) → None¶

test_discovery.test_an_undecoded_operator_word_advertises_nothing(tmp_path: pathlib.Path) → None¶: MAGIC reads, so the path is healthy, but the operator word is all-ones. Read literally that word claims every opcode the encoding has a bit for — including AVERAGE, which is host-computed and must never be submitted to a device. Silence is the only honest decode.

test_discovery.test_device_decodes_status_and_counters_from_register_block(tmp_path: pathlib.Path) → None¶

test_discovery.test_device_reads_register_block_snapshot_from_dau_core_contract(tmp_path: pathlib.Path) → None¶

test_discovery.test_read_u64_uses_two_u32_register_reads_for_xdma_user_bar(tmp_path: pathlib.Path, monkeypatch: pytest.MonkeyPatch) → None¶

test_discovery.test_device_bar_health_check_reports_all_ones_for_selected_register(tmp_path: pathlib.Path) → None¶

test_discovery.test_device_validates_dma_transfer_shape_before_real_xdma_io(tmp_path: pathlib.Path) → None¶

test_discovery._sysfs_owner(root: pathlib.Path, bdf: str, node: str) → None¶

test_discovery.test_a_fake_device_is_identified_by_its_node_and_says_so(tmp_path: pathlib.Path) → None¶

test_discovery.test_endpoint_for_devnode_reads_the_owning_pci_device_from_sysfs(tmp_path: pathlib.Path) → None¶

test_discovery.test_a_discovered_linux_device_is_identified_by_its_pci_endpoint(tmp_path: pathlib.Path, monkeypatch: pytest.MonkeyPatch) → None¶

test_discovery.write_fake_xdma_device(root: pathlib.Path, *, index: int = 0, magic: int = DAU_MAGIC_WORD, platform_id: str = 'DPV1', register_map_version: dau_core.registers.RegisterMapVersion | None = None, stream_protocol_version: dau_core.registers.StreamProtocolVersion | None = None, operator_bitmap: int = 1 << OperationCode.AVERAGE, lane_count: int = 0, host_opcode_bitmap: int = 0, sort_capacity: int = 0, status: int = 0, last_error: int = 0, h2c_bytes: int = 0, c2h_bytes: int = 0, rows: int = 0, batches: int = 0, stalls: int = 0, register_window_offset: int = 0) → FakeXdmaPaths¶

test_discovery.write_u32(register_image: bytearray, register_window_offset: int, offset: dau_core.registers.RegisterOffset, value: int) → None¶

test_discovery.write_u64(register_image: bytearray, register_window_offset: int, offset: dau_core.registers.RegisterOffset, value: int) → None¶