beautypg.com

Dfu clear status request, Dfu get state request, Dfu abort request – Maxim Integrated 73S1217F Device Firmware Upgrade Host Driver/Application User Manual

Page 8: Manifestation phase – device restart

background image

73S1215, 73S1217F DFU Host Driver/Application Development User’s Guide

UG_12xxF_029

8

Rev. 1.00

2.3.3 DFU Clear Status Request

IOCTL :

IOCTL_DFUTSC_DFU_CLRSTATUS

SCARD_CTL_CODE(2104)

IN

: not required

OUT : not required
RETURN: NTSTATUS
Supported driver :

tscdfu.sys


Any time the firmware detects an error and reports an error status to the host in the response to a
DFU_GETSTATUS request, it enters dfuERROR state. The firmware cannot by itself transition from the
dfuERROR state. It is the host application/driver’s responsibility to clear an error state by sending a
DFU_CLRSTATUS request.

The host application shall send IOCTL_DFUTSC_DFU_CLRSTATUS to the driver tscdfu.sys. The driver,
in turn, sends the DFU_CLRSTATUS command to the firmware. Upon receipt of DFU_CLRSTATUS, the
firmware sets its status to OK and transitions to the dfuIDLE state.

2.3.4 DFU Get State Request

IOCTL :

IOCTL_DFUTSC_DFU_GETSTATE

SCARD_CTL_CODE(2105)

IN

: input (request) buffer length (size 1)

IN

: input (request) buffer (of 1 byte)

OUT : output(response) buffer length
OUT : output(response) buffer
RETURN: NTSTATUS
Supported driver :

tscdfu.sys


This request solicits a report about current state of the firmware. The state reported is the current state of
the firmware with no change in state upon transmission of the response. The values specified in the
output buffer field are identical to those reported in DFU_GETSTATUS

2.3.5 DFU Abort Request

IOCTL :

IOCTL_DFUTSC_DFU_ABORT

SCARD_CTL_CODE(2106)

IN

: not required

OUT : not required
RETURN: NTSTATUS
Supported driver :

tscdfu.sys


The DFU_ABORT request enables the host to exit from certain states and return to the DFU_IDLE state.
The firmware sets the OK status on receipt of this request. See the 73S1215F, 73S1217F Boot Loader –
DFU Class Firmware Application Note
for more information on the firmware’s behavior.

2.4 Manifestation Phase – Device Restart

Read the 73S1215F, 73S1217F Boot Loader – DFU Class Firmware Application Note for details of this
phase’s operations. There is no IOCTL for this phase.

This manual is related to the following products: