1 / 11

Updates and Common Questions Asked by Simulation Developers

Updates and Common Questions Asked by Simulation Developers. Peter Shier Architect Windows Devices and Storage Technologies pshier@microsoft.com. Agenda. Interface association descriptors Choosing polled or event-driven data transfer Implementing event sinks for multiple endpoints

trula
Download Presentation

Updates and Common Questions Asked by Simulation Developers

An Image/Link below is provided (as is) to download presentation Download Policy: Content on the Website is provided to you AS IS for your information and personal use and may not be sold / licensed / shared on other websites without getting consent from its author. Content is provided to you AS IS for your information and personal use only. Download presentation by click this link. While downloading, if for some reason you are not able to download a presentation, the publisher may have deleted the file from their server. During download, if you can't get a presentation, the file might be deleted by the publisher.

E N D

Presentation Transcript

  1. Updates and Common Questions Asked by Simulation Developers Peter Shier Architect Windows Devices and Storage Technologies pshier@microsoft.com

  2. Agenda • Interface association descriptors • Choosing polled or event-driven data transfer • Implementing event sinks for multiple endpoints • Implementing mass storage simulation • Testing selective suspend • Using endpoint diagnostics • Using managed code with simulations

  3. Interface Association Descriptors • DSF enables specifying an IAD • Create a SAFEARRAY of VT_UI1 and fill it with the binary content of your IAD • Call ISoftUSBConfiguration::put_DeviceSpecificDescriptor to add it to your descriptor set. • See http://msdn.microsoft.com/en-us/library/bb201470.aspx for more info and code sample

  4. Choosing Polled or Event-Driven Data Transfer • Control (device requests): event driven typically easiest unless data volume and frequency are high • Bulk: use event-driven if volume and frequency allow • Interrupt: event driven is best • Isochronous: must use polled

  5. Implementing Event Sinks for Multiple Endpoints • Define an event sink class that implements ISoftUSBEndpointEvents • Add a public Init function that takes a pointer to your main simulator class and the ISoftUSBEndpoint interface • Add public functions to your simulator class for each event you need to handle. • Parameters should be same as event plus the ISoftUSBEndpoint interface pointer (or anything you want to identify the source endpoint) • Event handlers just call into the simulator class to report the event. • Add a Terminate function to the event sink class so that it can remove its event sink on the endpoint and release its back pointer to the simulator class.

  6. Implementing Mass Storage Simulation • This is not trivial but it has been done and works well. • The USB portions are not too hard but the bus-independent storage portion can be a large body of code depending on how much you need to implement. • Overview: • Implement as an in-proc COM object • Use event-driven transfers on bulk endpoints if possible. If not then use dedicated thread to keep data moving. • Use a worker thread to execute storage commands • Communicate with worker thread from endpoint data handling threadevents that will occur in arbitrary thread • If using a file as backing store then use overlapped I/O with FILE_FLAG_NO_BUFFERING • Use a sparse array for simulating large volumes. • We have some design details available. Send email to dsfsupp@microsoft.com if you’d like a copy.

  7. Testing Selective Suspend • DSF implements selective suspend on root hub and external hub ports. • If the driver implements selective suspend then DSF will respond to it. • SoftUSBDevice.State changes to SoftUSBDeviceStateSuspended when device is suspended. • There is no event for this. To test whether your device suspends: • Stop submitting I/O to device • Poll SoftUSBDevice.State at some reasonable frequency (e.g. 200ms) for a period that matches the driver’s idle detection to check that the device suspends in a timely manner. • For a device-initiated resume call SoftUSBDevice.Resume

  8. Using Endpoint Diagnostics • Connect test machine to kernel debugger • Alternatively use a Virtual PC for your test machine • In Vista, at the debugger command line enter: • ednt!kd_default_mask 8 • In your test app (C++) call: • ISoftUSBEndpoint::QueryInterface(__uuidof(IDSFDebug), …) • IDSFDebug::SetObjectFlags(SOFTUSBENDPOINT_OBJECTFLAGS, <trace flags>) • In your test app (script) call: • SoftUSBEndpoint.SetObjectFlags 100, <trace flags> • Trace flags available: • SOFTUSBENDPOINT_TRACETRANSFERINPUT • SOFTUSBENDPOINT_TRACETRANSFEROUPUT • SOFTUSBENDPOINT_TRACETRANSFERINPUTANDOUPUT • SOFTUSBENDPOINT_TRACEOUTLISTOVERFLOW • More info at http://msdn.microsoft.com/en-us/library/aa938720.aspx

  9. Using Managed Code with Simulators • Simulators should be written in C++ • Simulators can expose interfaces that are usable from managed code • Write test apps in managed code

  10. Resources • DSF on MSDN: • Under Win32 and COM Development/Windows Driver Kit/Other Tools. Currently at http://msdn.microsoft.com/en-us/library/bb981657.aspx • Tech support questions: • dsfsupp@microsoft.com

More Related