Program

Device firmware and gateware programming.

Handle device programming for firmware and gateware.

For finer control on updating, use the jsdrv example application. For example:

jsdrv reset update1 && jsdrv mem_erase c/upd2 && jsdrv mem_write c/upd2 “C:/joulescope/js220/images/ctrl_release/updater2/js220_ctrl_updater2_1_0_1.img” && jsdrv reset update2 jsdrv reset update2 && jsdrv mem_erase c/upd1 && jsdrv mem_write c/upd1 “C:/joulescope/js220/images/ctrl_release/updater1/js220_ctrl_updater1_1_0_1.img” && jsdrv reset update1 jsdrv reset update1 && jsdrv mem_erase c/app && jsdrv mem_write c/app “C:/joulescope/js220/images/ctrl_release/app/js220_ctrl_app_1_0_1.img” && jsdrv reset app jsdrv reset update1 && jsdrv mem_erase s/app1 && jsdrv mem_write s/app1 “C:/joulescope/js220/images/fpga_release/js220_fpga_1_0_1.img” && jsdrv reset app

pyjoulescope_driver.program.release_program(driver: Driver, device_path: str, image: bytes, force_program=None, progress=None)[source]

Program a device with an official release.

Parameters:

  • driver – The driver instance.

  • device_path – The device path string for the target device.

  • image – The binary release image to program. See pyjoulescope_driver.release.release_get().

  • force_program – Force device programming for all segments. Normally, programming for segments with matching versions are skipped.

  • progress – An optional callable(completion: float, msg: str) callback. When provided, this function will be called to provide progress updates. * completion: The completion status from 0.0 (not started) to 1.0 (done). * msg: A user-meaningful status message.

JS320 firmware update via the in-driver fwup manager.

Mirrors the C definitions in include_private/jsdrv_prv/devices/js320/js320_fwup_mgr.h. The full update sequence runs in a worker thread inside the driver; this module just publishes the request and watches the status topic.

pyjoulescope_driver.program_js320.program_js320(driver: Driver, device_path: str, package_path: str = None, flags: int = 0, progress=None, timeout: float = 600.0)[source]

Program a JS320 device using the firmware update manager.

Publishes the request to fwup/@/!add and monitors the per-worker fwup/NNN/status topic until the worker reports a terminal DONE or ERROR state.

The driver must be initialized but the device must NOT already be open: the worker opens the device internally in raw mode.

Parameters:

  • driver – The driver instance.

  • device_path – The target device path (e.g., u/js320/8w2a).

  • package_path – The path to the manufacturing ZIP package. None (default) uses the firmware embedded in the driver build.

  • flags – Bitmask of FWUP_FLAG_SKIP_* flags.

  • progress – An optional callable(completion: float, msg: str).

  • timeout – Maximum total time to wait, in seconds.

Raises:

  • RuntimeError – If the firmware update fails.

  • TimeoutError – If the firmware update does not complete in time.