Device Drivers Project

From DDCIDeos
Jump to navigationJump to search

Device Drivers TBD - need description

Overview

Device Drivers are...

Status

BSP Specific Device Drivers

Device Driver BSP Vfile compatible State Assignee
dma-nxp t2080rdb, nai68ppc2, celestial 6.0.1 Done Chris
edma-nxp ls1043ardb 6.0.1 Done Chris
gpio-nai-fpga celestial, nai68ppc2 6.0.1 Done Jared
gpio-zus zcu102, pim-ddp 6.0.1 Done Chuck
di2c-nxp t2080rdb, nai68ppc2, celestial 6.0.1 Done Jared
i2c-ls ls1043ardb, ls10x8ardb, de-ls1043a 6.0.1 Done Chris
lpi2c-imx imx8qm (spear) 6.0.1 Done Chuck
mil1553-hi6131 pim-ddp 6.0.1 Done Chuck
espi-nxp celestial 6.0.1 Done Jared
spi-nxp de-ls1048a, ls1043ardb 6.0.1 Done Chuck
spi-zus zcu102, pim-ddp 6.0.1 Done Chuck
duart-nxp t2080rdb, nai68ppc2, celestial, ls1048ardb, ls10x8ardb 6.0.1 Done Chris
uart-imx imx8qm 6.0.1 Done Chris
uart-jacinto jacinto7evm 6.0.1 Done Chris
uart-zus zcu102 pim-ddp 6.0.1 Done Chuck

Tasks

I've unreleased vfile-6.0.0 for jupiter and vfile-7.0.0 for kismet.

The previous unrelease of vfile-6.0.0 that was for kismet is now a jupiter unrelease.

This had to be done because a backward-incompatible change was made to vfile as part of preparations for verification, so jupiter vfile needed to roll from vfile-5.1.2 to vfile-6.0.0.

The backward-incompatible change has to do with the conversion of some macros to functions to aid structural coverage in drivers.

Here's a list of the changes:

The macro that was... Is now the API...
CREATE_DIR createDirectory
CREATE_PROCFS_GROUP createProcfsGroup
CREATE_PROCFS_FILE_RO createProcfsFile*
CREATE_PROCFS_FILE_WO createProcfsFile*
CREATE_PROCFS_FILE_RW createProcfsFile*
CREATE_SYSFS_GROUP createSysfsGroup
CREATE_SYSFS_ATTR_RO createSysfsAttribute*
CREATE_SYSFS_ATTR_WO createSysfsAttribute*
CREATE_SYSFS_ATTR_RW createSysfsAttribute*
DEFAULT_PROCFS_OPEN removed, not needed
DEFAULT_PROCFS_IOCTL removed, not needed
DEFAULT_PROCFS_CLOSE removed, not needed
  • The obfuscation of functions provided via the macros is now exposed at the API interface.

Consult the vfile UG for the API signatures.

Driver authors will want to make sure to convert to the APIs as soon as possible for drivers in active development or verification.

Addendum: Drivers that do not use any of the macros listed above will likely work as-is (no migration necessary) with vfile 6.

Staff

Problem Reporting

Open PCRs against each driver-tbd

Configuration Management

TBD

Be A Maintainer

Install Cygwin with Deos and OpenArbor

tbd

You now should have an environment rigged suitable for device driver development work.


Try an Example

Build a Device Driver Component

tbd

See Also

General