vxbAccesDio - ACCES I/O Products DIO Driver for VxWorks 7 RELEASE NOTES Copyright (c) 2018, 2019 ACCES I/O Products, Inc. 10623 Roselle Street San Diego, CA 92121-1506 858-550 9559, 800-326-1649, sales@accesio.com The right to copy, distribute, modify, or otherwise make use of this software may be pursuant to the terms of an applicable ACCES I/O Products, Inc. (ACCES) license agreement, or in the absence of such agreement, is limited to use with ACCES hardware products. Contents - DESCRIPTION - RELEASE CONTENTS - INSTALLATION INSTRUCTIONS - BUILD INSTRUCTIONS - USAGE INSTRUCTIONS - VERSION HISTORY ================================================================================ DESCRIPTION This is the driver for ACCES I/O Products, Inc., Digital I/O (DIO) PCI/e cards for Wind River VxWorks 7. It has been tested with the PCIe-DIO-24HS and Wind River VxWorks 7 release SR0600. For support for other cards or versions of VxWorks, contact ACCES. ================================================================================ RELEASE CONTENTS Four files comprise Release 1: * vxbAccesDio.h Header file: Introduces the supported ACCES card and this driver; has references to the card, the Intel 8255 it partly emulates and extends with Change-of-State interrupts, and PCI; has defines and prototypes for all user-callable functions with comments describing use, limitations, and errors. This file and these Release Notes comprise the documentation for use of the driver. * vxbAccesDio.c C file implementing the driver. * ACCES-PCIe-DIO-24HS.c Test/demo sample program for the driver. Some of the test programs use the "PCI/PCIE DIO24D LED FIXTURE" available from ACCES. This board has 24 LEDs connected to the PCIe-DIO-24HS pins. Examine this file to discover the expected LED patterns and other results with this fixture. * vxbAccesDio_Driver_for_VxWorks_7-Release_Notes-version_1.2.txt These Release Notes. ================================================================================ INSTALLATION INSTRUCTIONS The reader is assumed to be familiar with VxWorks 7 overall directory structure, environment variables, and build techniques. For purposes of installation, image type is assumed to use PROFILE_STANDALONE_DEVELOPMENT, but the driver should work with any VxWorks profile. Consult ACCES or Wind River as needed. Unzip the delivery file to a convenient location. Then copy the files in it as follows: File Copy To ------------------- ---------------------------------------------------------- * vxbAccesDio.h Your VxWorks Image Project (VIP) directory (e.g., ~/workspace/VIP.../) * vxbAccesDio.c: Your VxWorks Image Project (VIP) directory (e.g., ~/workspace/VIP.../) * ACCES-PCIe-DIO-24HS.c OPTIONAL - This file contains sample and test routines, including the Acceptance Test, and presumably would not be delivered with production images to end-users. Your VxWorks Image Project (VIP) directory (e.g., ~/workspace/VIP.../) Please note that the VSB should not have to be rebuilt after copying these files into your VIP directory. ================================================================================ BUILD INSTRUCTIONS The reader is assumed to be familiar with VxWorks 7 build techniques and be able to build a VxWorks image suitable. NOTE: The driver is kernel-mode only (no RTP support). These instructions build a VxWorks Kernel Image Project (VIP). Instructions are provided for Workbench. Building from the command line requires the corresponding steps. There are multiple ways to build VxWorks. The kernel image with test/demo sample program was created in Workbench as a complete UEFI-bootable VxWorks Kernel Image Project (VIP) based on a VxWorks Souce Build (VSB) project with PROFILE_STANDALONE_DEVELOPMENT for debugging. The key instructions and parameters required to build that VSB and VIP are below (given in Workbench over several dialogs; parameters not shown below were either not used or the default was accepted). Create the VSB VxWorks Source Build Project: - Build type: Source Build - BSP: itl_generic** - Active CPU: * - Address Mode: * - Compiler support: * - Processor mode: * - Debug mode: * - IP version setting: * - Link in source to project [enable checkbox for debugging] Build the VSB. Create the VIP VxWorks Kernel Image Project: - Build type: Kernel Image - Base on: a source build project - Project: - BSP: * - Tool chain: * - Options: * - Profile: * ** only 80x86 BSPs are supported in this revision. Contact ACCES with any portability questions. * these choices, like most, should not affect use or operation of this driver. Configure the image using the Kernel Configuration Editor: - Include the VxWorks kernel shell to conveniently invoke the test programs in the test/demo sample file. - Proceed as usual with other kernel configuration, build the image, and transfer to the target as usual. ================================================================================ USAGE INSTRUCTIONS The header file, vxbAccesDio.h, includes an introduction to all user-callable functions in the driver. Typical sequences of function calls may be found in the tests in ACCES-PCIe-DIO-24HS.c. Please consult the header file to use this driver. NOTE: A copy of the header file may be placed in the same directory as a calling program to access the defines and prototypes using: #include "vxbAccesDio.h" NOTE: Do not use "#include " ================================================================================ VERSION HISTORY RElease 1.2b j2h 2019-02-19 - changed installation to "copy files to VIP" and simplified files and instructions. Release 1.1b j2h 2019-02-18 - forked to PCIe-DIO-24HS from mPCIe-DIO-24S, genericized instructions, updated for 0600 Release 1.0 2018-06-21