Header Files

Header files provide the following definitions:

• Data structures specific to the device, such as a structure representing the device registers

• Data structures defined by the driver for maintaining state information

• Defined constants, such as those representing the bits of the device registers

• Macros, such as those defining the static mapping between the minor device number and the instance number

Some of the header file definitions, such as the state structure, might be needed only by the device driver. This information should go in private header files that are only included by the device driver itself.

Any information that an application might require, such as the I/O control commands, should be in public header files. These files are included by the driver and by any applications that need information about the device.

While there is no standard for naming private and public files, one convention is to name the private header file xximpl.h and the public header file xxio.h.