devpci for 3rd Ed.
Note: the 4th ed. devpnp supplies much of this same functionality, but is read only.
This little program allows me to read/write to random memory addresses from userland. Russ Cox indicated that he has something similar, but since i wanted to learn how to write /dev/ stuff i decided to give it a try myself... I find it helpful when debugging vga (for example) from serial console. Maybe some of you will find it helpful for other things :) Something to note: it is unsafe to use peek and poke at the hardware from userland. There are so many ways to render your machine inoperable that I'm not going to bother listing them here. (Normally a reboot fixes things, but...) Don't take it out on me or on LANL if your hardware chokes as a consequence of pcidev. Do not attempt to remove bread stuck in a plugged toaster with a knife either. *shrug*... You know all this, bot nevertheless you have been warned. Pcidev (sorry, couldn't think of a better name) sits between you and the hardware devices on your computer. It allows the user to read/write (standard inb, inw, inl, outb, outw, outl) using simple shell scripts. Pcidev could be found as a drive named #Z. When bound to a directory it presents itself as a sigle file named 'base'. This file takes as input a memory address, to which the user wants to write or read. Having been given an address, pcidev creates a directory named after the it and populates it with 6 files used for reading/writing, namely: inb -> read a byte inw -> read a word (16 bits) inl -> read a long outb -> write to the port (byte) outw -> short outl -> long That's pretty much it.. It's really simple. Here's a sample session with it: ---- % bind -a '#Z' /tmp/z % cd /tmp/z % ls base % echo 0x3cc > base # address should be a valid atol()-understandable string, 0xF, 0F, 15 -> all accepted % ls 0x3cc # 0x3cc is VGA's Miscellaneous Output Register base % cd 0x3cc % ls inb inl inw outb outl outw % cat inb 0xe3% # no \n appended... % cat inl 0xff0800e3% % cd .. % echo 0x80 > base % rm 0x3cc % ls 0x80 # a pci post-card. write-only base % cd 0x80 % echo 0xf > outb # 0F shows on the device, % echo 14 > outb # 0D shows on the device ---- That's about it. The maximum addresses opened at a single time is 128. Just rm some stuff to open up space (rm base will not work, of course). To compile a kernel with pcidev: cd /sys/src/9/pc cp devpcidev.c . edit pcdisk and add 'pcidev' at the bottom of the 'dev' list mk 'CONF=9pcdisk' (or your favorite way ofdoing it) 9fat:; cp 9pcdisk /n/9fat reboot... Sorry, there is no man page for it, but there are no plans to put it into the official distribution either :) While discussing the 'design' with Ron Minnich another way of doing it came up -- have a single file for input, another one for output and manage the addresses with seek(). That way a 5-line C program could read and report the entire status of a device. I'm posting this implementation because it's a bit more complex (dealing with subdirectories, adding/deleting addresses) and not because it's necessarily the better way to present files for inb and outb.
Last Modified: May 24 2002