Skip to content
binho.io (opens in a new tab)Contact Us

Adapter Stops Responding

Most cases recover without unplugging anything. Start at the top of the ladder and go down only when a step does not help. Then check Known Situations for a documented cause and fix.

StepHowWhat it clears
1. ReconnectMission Control 3: Disconnect, then Connect. PyCosmicSDK: close the Device and open a new one.A stuck session in the host software
2. Reset the adapterPyCosmicSDK: device.reboot(into=ResetTarget.RUNTIME), then open the adapter again.Interface roles left configured, a stuck SPI bulk transfer, a busy I3C engine
3. Replug USBUnplug the adapter’s USB cable, wait 5 seconds, plug it back in.An adapter that no longer answers any command, including the reset
4. Power-cycle the targetSet the target voltage to 0 V and back, or switch the target’s own supply off and on.A target that holds the bus or dropped off it
import time
import pycosmicsdk
from pycosmicsdk import Device, ResetTarget
serial = pycosmicsdk.list_devices()[0].serial_number # pick the adapter
with Device.open(serial=serial) as device:
device.reboot(into=ResetTarget.RUNTIME)
# The adapter re-enumerates; wait until it is listed again (typically under 1 s).
while not any(d.serial_number == serial for d in pycosmicsdk.list_devices()):
time.sleep(0.1)
with Device.open(serial=serial) as device:
print(device.info.fw_version)

What a reset keeps and what it does not:

  • Every interface must be initialized again.
  • A reset cannot help an adapter that has stopped decoding commands: the reset command never arrives. Replug USB.

Replug, do not just reset, when:

  • Every command times out, or PyCosmicSDK raises AdapterNotAnsweringError again on a new handle.
  • A program crashed, or was killed, in the middle of a transfer.
  • The adapter is listed but no program can open it.
SymptomCauseFix
A flash status (WIP) poll over SPI does not finishThe SPI read clock is above what the wiring supports, so read data can be shifted by one bitLower the SPI clock for reads, verify the data, and bound the poll.

Older firmware has other known problems that later releases fixed, so update to the latest firmware first. To check the firmware version and update it, see Updating Firmware.

Send these to [email protected]:

  1. Adapter, serial number and firmware version:

    python -c "import pycosmicsdk; print([(d.model.name, d.serial_number, d.hw_version, d.fw_version) for d in pycosmicsdk.list_devices()])"

    On Linux, an empty serial number means the udev rule is missing. See Solving USB Connection Issues on Linux.

  2. Host: operating system and version, and whether the adapter is on a hub.

  3. Software and version: Mission Control 3 (desktop or mc3.binho.io) or PyCosmicSDK (python -c "import pycosmicsdk; print(pycosmicsdk.__version__)").

  4. Actions taken: the last commands before it stopped, the wiring and the target voltage. In Mission Control 3, export the Transaction Log from the tool.

  5. What recovered it: reconnect, reset, replug, or none.

  6. On Linux: the kernel log from the moment it stopped: sudo dmesg | tail -n 50.