To avoid this from occurring, the pci_tdm_timing and pci_tdm_init library functions have been modified to set the clock divider on IMHC4 modules to its highest value before changing the TDM subsystem clock.

Due to the changes in the library functions application programs must be sure to set the IMHC4's clock divider to the correct value after calling either of those two functions. This is done by calling the imhc4_tdmclkdiv function with a PCI_MOD pointer for the IMHC4 module and a divider value of:

0 for a 16.384 MHz TDM clock
1 for a 8.192 MHz TDM clock
2 for a 4.096 MHz TDM clock
3 for a 2.048 MHz TDM clock

For example:

    PCI_TDM  *tdm = pci_tdmopen("pci0");
    PCI_MOD  *hc4 = pci_open("pci0c");

    imhc4_init(hc4);
    pci_tdm_timing(tdm, TDM_BASECLK, 2, 8, 32, 16);
    imhc4_tdmclkdiv(hc4, 3);

In the case that the PLL does run out of control, the codecs will fail to complete their initialization and never clear the INIT status bit. The imhc4_init library function is modified to time out and return an error status with errno set to EIO if the codecs fail to complete their initialization. Previous versions of this function would wait indefinitely for the INIT status to clear.

The pciinit program is also modified to set the IMHC4's clock divider when the module is initialized. The divider is set for a 2.048 MHz clock on V6M6 boards and for a 8.192 MHz clock on V6M6HS boards.

These programs are not normally installed by customers as they are primarily used for in-house serialization, and configuration of boards prior to shipment. However, they are included in the software distribution in case they are required.

Even if they had been compiled and used, it is not likely that they were installed to a directory outside of their source directory. In case they were installed at one time, please run the following commands to be sure that any old versions of these programs will be uninstalled:

    cd $CAC/pci/pciutils
    make clean

    CAC=/usr/cac

Other additions to this file include more samples of the chmod command used to set access permissions for V6M6 devices and commented example for using the new vme_misc_ctl program, described below.