The free OSR Learning Library has more than 50 articles on a wide variety of topics about writing and debugging device drivers and Minifilters. From introductory level to advanced. All the articles have been recently reviewed and updated, and are written using the clear and definitive style you've come to expect from OSR over the years.
Check out The OSR Learning Library at: https://www.osr.com/osr-learning-library/
In our current WDF seminar, we use a super simple PCI device as an example of a backplane bus type device, and we've written a SUPER simple driver for this device as an instructional illustration.
The device we currently use is a PCI device, which is a clone of the venerable Intel 8255. This is a super simple, incredibly common, digital I/O device, with a ridiculously simple register map:
This device, and its accompanying example, has served us well for many years.
It is now more than a little obsolete. The primary problem with these devices is that the registers are in Port I/O space (to maintain compat with the old 8255). It also uses a Line Base Interrupt.
I'm looking for a replacement device to use as a sample in our learning environment. The device and its register map have to be simple enough that any engineer can understand how to use the device quickly. After all, the goal isn't to teach people how to program this device, it's to teach them how to write WDF drivers for a PCI device. The device details need to "get out of the way" so we can discuss, for example, how you claim resources, connect to interrupts, service I/O Requests, and process interrupts and DPCs.
Obviously, a data sheet for the device that includes the register map and control info for the device needs to be available. The device needs to be a PCIe device (not trad PCI... though I'd accept a M.2 or MiniPCI device that can be plugged into a PCIe carrier, if necessary)... because showing how to write a driver for a backplane bus connected device is the entire point of this exercise. I would love the device to support MSI, and multiple MSIs would be great addition.
It needs to be a PIO device... We do not have the time to properly discuss DMA in this seminar. One must crawl before one can walk.
I don't care what KIND of device it is, though it would be nice if the device could do something, or be connected to something, where it could be SEEN working. And, as I previously mentioned, it needs to be easy to understand (even for those who are not necessarily device experts).
IF somebody in the community suggests a device that we wind up using, I'll commit to:
1. Write a WDF driver for the device that illustrates best practices
2. Write an accompanying tutorial, describing how to write a WDF driver, using this device as an example
3. Make the driver source code available on GitHub
4. Use the example in our seminar
Anybody have any good device suggestions to share???
It looks like you're new here. If you want to get involved, click one of these buttons!
|Upcoming OSR Seminars|
|OSR has suspended in-person seminars due to the Covid-19 outbreak. But, don't miss your training! Attend via the internet instead!||Kernel Debugging||30 Mar 2020||OSR Seminar Space|
|Developing Minifilters||15 Jun 2020||LIVE ONLINE|
|Writing WDF Drivers||22 June 2020||LIVE ONLINE|
|Internals & Software Drivers||28 Sept 2020||Dulles, VA|