Concurrent Technologies RCIM Series User manual

Artisan Technology Group is your source for quality
new and certied-used/pre-owned equipment
• FAST SHIPPING AND
DELIVERY
• TENS OF THOUSANDS OF
IN-STOCK ITEMS
• EQUIPMENT DEMOS
• HUNDREDS OF
MANUFACTURERS
SUPPORTED
• LEASING/MONTHLY
RENTALS
• ITAR CERTIFIED
SECURE ASSET SOLUTIONS
SERVICE CENTER REPAIRS
Experienced engineers and technicians on staff
at our full-service, in-house repair center
WE BUY USED EQUIPMENT
Sell your excess, underutilized, and idle used equipment
We also offer credit for buy-backs and trade-ins
www.artisantg.com/WeBuyEquipment
REMOTE INSPECTION
Remotely inspect equipment before purchasing with
our interactive website at www.instraview.com
LOOKING FOR MORE INFORMATION?
Visit us on the web at www.artisantg.com for more
information on price quotations, drivers, technical
specications, manuals, and documentation
Contact us: (888) 88-SOURCE | [e-mail] | www.artisantg.com
SM
View
Instra

Real-Time Clock and Interrupt Module (RCIM)
Userís Guide
0898007-600
December 2011
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com

Copyright 2011 by Concurrent Computer Corporation. All rights reserved. This publication or any part thereof is
intended for use with Concurrent Computer Corporation products by Concurrent Computer Corporation personnel,
customers, and end–users. It may not be reproduced in any form without the written permission of the publisher.
The information contained in this document is believed to be correct at the time of publication. It is subject to change
without notice. Concurrent Computer Corporation makes no warranties, expressed or implied, concerning the
information contained in this document.
To report an error or comment on a specific portion of the manual, photocopy the page in question and mark the
correction or comment on the copy. Mail the copy (and any additional comments) to Concurrent Computer Corpora-
tion, 2881 Gateway Drive Pompano Beach, FL 33069. Mark the envelope “Attention: Real-Time OS Publications
Department.” This publication may not be reproduced for any other reason in any form without written permission
of the publisher.
Concurrent Computer Corporation and its logo are registered trademarks of Concurrent Computer Corporation. All
other Concurrent product names are trademarks of Concurrent while all other product names are trademarks or
registered trademarks of their respective owners. Linux® is used pursuant to a sublicense from the Linux Mark
Institute.
Printed in U. S. A.
Revision History: Level: Effective With:
Original Release -- August 2002 000 RedHawk Linux Release 1.1
Previous Release -- December 2003 210 RedHawk Linux Release 2.0
Current Release -- May 2005 300 RedHawk Linux Release 2.3
Update -- September 2005 310 RedHawk Linux Release 2.3-4.1
Update -- May 2007 320 RedHawk Linux Release 4.2
Update -- April 2008 330 RedHawk Linux Release 5.1
Update -- June 2008 400 RedHawk Linux Release 5.1
Update -- October 2010 500 RedHawk Linux Release 5.4
Update -- December 2011 600 RedHawk Linux Release 6.0
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com

iii
Preface
Scope of Manual
This manual is intended for users responsible for the installation and use of the Real-Time
Clock and Interrupt Module (RCIM) on Concurrent Computer Corporation’s iHawkTM
systems under the RedHawkTM Linux® operating system.
NOTE
Three RCIM models are described in this guide: RCIM I,
RCIM II and RCIM III. The use of the term “RCIM” refers to
functionality common to all three boards. “RCIM I”, “RCIM II”
and “RCIM III” refer to the specific boards. Refer to the section
“Specifications” on page 1-2 for specifications for each of the
boards.
Structure of Manual
This manual consists of the following:
•Chapter 1, Introduction, contains a general overview and specifications for
the RCIM boards.
•Chapter 2, Hardware, Installation and Configuration, provides a
description of the RCIM boards and connectors, as well as installation and
configuration instructions.
•Chapter 3, Functional Description, provides the general operation, user
interfaces and configuration options for the clocks and interrupts available
on the RCIM.
•Appendix A, Registers, describes the RCIM registers.
•Appendix B, Calculating RCIM Cable Propagation Delays, provides a
formula for guarding against propagation delay when chaining RCIMs.
•The Index contains an alphabetical reference to key terms and concepts and
the pages where they occur in the text.
Syntax Notation
The following notation is used throughout this guide:
italic Books, reference cards, and items that the user must specify appear in
italic type. Special terms may also appear in italic.
list bold User input appears in list bold type and must be entered exactly
as shown. Names of directories, files, commands, options and man
page references also appear in list bold type.
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com

RCIM User’s Guide
iv
list Operating system and program output such as prompts, messages and
listings of files and programs appears in list type.
[] Brackets enclose command options and arguments that are optional.
You do not type the brackets if you choose to specify these options or
arguments.
hypertext links When viewing this document online, clicking on chapter, section,
figure, table and page number references will display the
corresponding text. Clicking on Internet URLs provided in blue type
will launch your web browser and display the web site. Clicking on
publication names and numbers in red type will display the
corresponding manual PDF, if accessible.
Related Publications
Title Pub No.
RedHawk Linux Release Notes Version x.x 0898003
RedHawk Linux User’s Guide 0898004
RedHawk Linux Frequency-Based Scheduler (FBS) User’s Guide 0898005
iHawk Optimization Guide 0898011
where x.x = release version
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com

v
Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . iii
Chapter 1 Introduction
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
Specifications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
Chapter 2 Hardware, Installation and Configuration
Board Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
RCIM III. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
Board Illustration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
Connectors and LEDs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
LED Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
Input and Output Cables and Connectors . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4
Oscillators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4
GPS Antenna . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5
External Interrupt I/O Connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5
System Identification. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7
Daisy Chain Cable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7
RCIM II . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-8
Board Illustration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-8
Connectors and LEDs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-8
LED Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-9
Input and Output Cable Connectors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-10
Oscillators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-10
GPS Antenna . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-10
External Interrupt I/O Connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-10
System Identification. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-12
Daisy Chain Cable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-12
RCIM I . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-13
Board Illustration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-13
Connectors and LEDs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-14
LED Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-14
Output Cable Connector (P2) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-15
Input Cable Connector (P3). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-16
External Interrupts Connector (P4) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-16
Debug Visibility Connector (P5). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-17
In-System Programming Interface Connector (P6). . . . . . . . . . . . . . . . . . . 2-17
System Identification. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-17
Connection Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-18
Unpacking the RCIM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-18
Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-19
Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-20
Kernel Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-20
Driver Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-20
Static Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-20
Dynamic Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-21
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com

vi
RCIM User’s Guide
General Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-22
MSI Interrupt Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-22
ntp Configuration for GPS Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-23
Verifying ntp/GPS Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-23
Chapter 3 Functional Description
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1
Clocks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1
The Tick Clock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
The POSIX Clock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
Direct Access to the Clocks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3
Synchronizing the Clocks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3
The rcim_clocksync Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3
Synchronizing the Tick Clock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5
RCIM Masterclock Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5
Synchronizing the POSIX Clock. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5
Automatic Synchronization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-6
Using GPS for System Timekeeping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-6
Interrupt Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-8
Interrupt Processing Logic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-8
Arming and Enabling DIs and ETIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-9
Interrupt Recognition Logic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-9
Setting up Distributed Interrupts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-10
Obtaining RCIM Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-11
Edge-Triggered Interrupts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-12
ETI Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-12
ETI Device Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-13
User Interface to ETIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-13
Distributed ETIs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-14
Real-Time Clocks (RTCs). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-14
RTC Device Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-14
Distributed RTCs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-14
User Interface to RTCs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-15
External Output Interrupts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-15
Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-16
Programmable Interrupt Generators (PIGs) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-16
PIG Device File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-16
Distributed PIGs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-17
Distributed Interrupts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-17
DI Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-18
DI Device Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-19
User Interface to DIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-19
Appendix A Registers
RCIM III Registers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1
RCIM III Address Map. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1
RCIM III Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-3
RCIM II Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-21
RCIM II Address Map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-21
RCIM II Registers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-23
RCIM I Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-36
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com

vii
Contents
RCIM I Address Map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-36
RCIM I Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-37
Appendix B Calculating RCIM Cable Propagation Delays
RCIM III . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-1
RCIM II . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-1
RCIM I. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-2
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Index-1
Illustrations
Figure 2-1 RCIM III Board . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
Figure 2-2 RCIM III Connectors and LED Locations . . . . . . . . . . . . . . . . . . . . . . . 2-3
Figure 2-3 RCIM III External Interrupt I/O Connector Pin-outs . . . . . . . . . . . . . . 2-6
Figure 2-4 RCIM II Board . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-8
Figure 2-5 RCIM II Connectors and LED Locations . . . . . . . . . . . . . . . . . . . . . . . 2-9
Figure 2-6 RCIM II External Interrupt I/O Connector Pin-outs . . . . . . . . . . . . . . . 2-11
Figure 2-7 RCIM I Board . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-13
Figure 2-8 RCIM I Connectors and LED Locations . . . . . . . . . . . . . . . . . . . . . . . . 2-14
Figure 2-9 RCIM I Output Cable Connector (P2) Pin-outs . . . . . . . . . . . . . . . . . . . 2-15
Figure 2-10 RCIM I Input Cable Connector (P3) Pin-outs . . . . . . . . . . . . . . . . . . . 2-16
Figure 2-11 RCIM I External Interrupts Connector (P4) Pin-outs . . . . . . . . . . . . . 2-17
Figure 3-1 Interrupt Processing Logic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-8
Figure 3-2 Distributed Interrupt Operation Example . . . . . . . . . . . . . . . . . . . . . . . 3-10
Figure A-1 RCIM III Board Status/Control Register (BSCR) . . . . . . . . . . . . . . . . A-3
Figure A-2 RCIM III Firmware Revision/Options Present Register (FWOP) . . . . A-4
Figure A-3 RCIM III Interrupt Enable/Request/Pending/Clear/Arm/Level/Polarity
Registers (IER, IRR, IPR, ICR, IAR, ISLR, ISPR) . . . . . . . . . . . . . . . A-5
Figure A-4 RCIM III External Interrupt Routing Registers (EIRR) . . . . . . . . . . . . A-6
Figure A-5 RCIM III Cable Interrupt Routing Registers (CIRR) . . . . . . . . . . . . . . A-7
Figure A-6 RCIM III PPS Snapshot Register (PPS) . . . . . . . . . . . . . . . . . . . . . . . . A-8
Figure A-7 RCIM III Cable Snapshot Register (CSR) . . . . . . . . . . . . . . . . . . . . . . A-8
Figure A-8 RCIM III Cable Master Time Register (CMTR) . . . . . . . . . . . . . . . . . A-8
Figure A-9 RCIM III Clear Cable Errors Register (CCERR) . . . . . . . . . . . . . . . . . A-9
Figure A-10 RCIM III Output Cable Status Register (OCSR) . . . . . . . . . . . . . . . . A-9
Figure A-11 RCIM III Input Cable Status Register (ICSR) . . . . . . . . . . . . . . . . . . A-10
Figure A-12 RCIM III Tick Clock Upper Register (TCU) . . . . . . . . . . . . . . . . . . . A-10
Figure A-13 RCIM III Tick Clock Lower Register (TCL) . . . . . . . . . . . . . . . . . . . A-11
Figure A-14 RCIM III Tick Clock Status/Control Register (TCSC) . . . . . . . . . . . . A-11
Figure A-15 RCIM III POSIX Clock Seconds Register (PCS) . . . . . . . . . . . . . . . . A-12
Figure A-16 RCIM III POSIX Clock Nanoseconds Register (PCN) . . . . . . . . . . . A-12
Figure A-17 RCIM III POSIX Clock Status/Control Register (PCSC) . . . . . . . . . A-13
Figure A-18 RCIM III POSIX Clock Skip/Add Time Register (PCSAT) . . . . . . . . A-13
Figure A-19 RCIM III Clock Frequency Adjust Register (CFAR) . . . . . . . . . . . . . A-14
Figure A-20 RCIM III RTC Timer Registers (RTCT) . . . . . . . . . . . . . . . . . . . . . . . A-14
Figure A-21 RCIM III RTC Repeat Registers (RTCR) . . . . . . . . . . . . . . . . . . . . . . A-14
Figure A-22 RCIM III RTC Control Registers (RTCC) . . . . . . . . . . . . . . . . . . . . . A-15
Figure A-23 RCIM III Programmable Interrupt Generator Register (PIG) . . . . . . A-16
Figure A-24 RCIM III Programmable Interrupt Set/Clear Registers (PIGS, PIGC) A-16
Figure A-25 RCIM III SPI Count Register (SCR) . . . . . . . . . . . . . . . . . . . . . . . . . A-17
Figure A-26 RCIM III GPS Receive Pointers (GRXP) . . . . . . . . . . . . . . . . . . . . . . A-17
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com

viii
RCIM User’s Guide
Figure A-27 RCIM III GPS Transmit Pointers (GTXP) . . . . . . . . . . . . . . . . . . . . . A-18
Figure A-28 RCIM III GPS Debug Control Register (GDCR) . . . . . . . . . . . . . . . . A-18
Figure A-29 RCIM III GPS Communication Error Register (GCER) . . . . . . . . . . . A-19
Figure A-30 RCIM III SPI Data Buffer (SDB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-19
Figure A-31 RCIM III GPS Receive Data Buffer (GRDB) . . . . . . . . . . . . . . . . . . . A-19
Figure A-32 RCIM III GPS Transmit Data Buffer (GRDB) . . . . . . . . . . . . . . . . . . A-20
Figure A-33 RCIM II Board Status/Control Register (BSCR) . . . . . . . . . . . . . . . . A-23
Figure A-34 RCIM II Firmware Revision/Options Present Register (FWOP) . . . . A-24
Figure A-35 RCIM II Interrupt Enable/Request/Pending/Clear/Arm/Level/Polarity
Registers (IER, IRR, IPR, ICR, IAR, ISLR, ISPR) . . . . . . . . . . . . . . A-25
Figure A-36 RCIM II External Interrupt Routing Registers (EIRR) . . . . . . . . . . . . A-26
Figure A-37 RCIM II Cable Interrupt Routing Registers (CIRR) . . . . . . . . . . . . . . A-27
Figure A-38 RCIM II PCI Interrupt Routing Registers (PARR, PBRR, PCRR, PDRR)
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-28
Figure A-39 RCIM II DDS Adjust Register (DDS) . . . . . . . . . . . . . . . . . . . . . . . . . A-28
Figure A-40 RCIM II PPS Snapshot Register (PPS) . . . . . . . . . . . . . . . . . . . . . . . . A-29
Figure A-41 RCIM II GPS Transmit/Receive Register (GPS) . . . . . . . . . . . . . . . . A-29
Figure A-42 RCIM II Clear Cable Errors Register (CCERR) . . . . . . . . . . . . . . . . . A-29
Figure A-43 RCIM II Tick Clock Upper Register (TCU) . . . . . . . . . . . . . . . . . . . . A-30
Figure A-44 RCIM II Tick Clock Lower Register (TCL) . . . . . . . . . . . . . . . . . . . . A-30
Figure A-45 RCIM II Tick Clock Status/Control Register (TCSC) . . . . . . . . . . . . A-30
Figure A-46 RCIM II POSIX Clock Seconds Register (PCS) . . . . . . . . . . . . . . . . . A-31
Figure A-47 RCIM II POSIX Clock Nanoseconds Register (PCN) . . . . . . . . . . . . A-31
Figure A-48 RCIM II POSIX Clock Status/Control Register (PCSC) . . . . . . . . . . A-32
Figure A-49 RCIM II POSIX Clock Skip/Add Time Register (PCSAT) . . . . . . . . A-32
Figure A-50 RCIM II RTC Timer Registers (RTCT) . . . . . . . . . . . . . . . . . . . . . . . A-33
Figure A-51 RCIM II RTC Repeat Registers (RTCR) . . . . . . . . . . . . . . . . . . . . . . . A-33
Figure A-52 RCIM II RTC Control Registers (RTCC) . . . . . . . . . . . . . . . . . . . . . . A-34
Figure A-53 RCIM II Programmable Interrupt Generator Register (PIG) . . . . . . . A-35
Figure A-54 RCIM II Programmable Interrupt Set/Clear Registers (PIGS, PIGC) A-35
Figure A-55 RCIM I Board Status/Control Register (BSCR) . . . . . . . . . . . . . . . . . A-37
Figure A-56 RCIM I Interrupt Enable/Request/Pending/Clear/ARM/Level/Polarity
Registers (IER, IRR, IPR, ICR, IAR, ISLR, ISPR) . . . . . . . . . . . . . . A-38
Figure A-57 RCIM I External Interrupt Routing Register (EIRR) . . . . . . . . . . . . . A-39
Figure A-58 RCIM I Cable Interrupt Routing Register (CIRR) . . . . . . . . . . . . . . . A-40
Figure A-59 RCIM I Tick Clock Upper Register (TCU) . . . . . . . . . . . . . . . . . . . . . A-41
Figure A-60 RCIM I Tick Clock Lower Register (TCL) . . . . . . . . . . . . . . . . . . . . . A-41
Figure A-61 RCIM I Tick Clock Status/Control Register (TCSC) . . . . . . . . . . . . . A-41
Figure A-62 RCIM I POSIX Clock Seconds Register (PCS) . . . . . . . . . . . . . . . . . A-42
Figure A-63 RCIM I POSIX Clock Nanoseconds Register (PCN) . . . . . . . . . . . . . A-42
Figure A-64 RCIM I POSIX Clock Status/Control Register (PCSC) . . . . . . . . . . . A-42
Figure A-65 RCIM I RTC Control Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-43
Figure A-66 RCIM I RTC Timer Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-43
Figure A-67 RCIM I Programmable Interrupt Generator Register (PIG) . . . . . . . . A-44
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com

1-1
1
Chapter 1Introduction
1
This chapter provides an overview and specifications for the Real-Time Clock and
Interrupt Module (RCIM).
NOTE
Three RCIM models are described in this guide: RCIM I,
RCIM II and RCIM III. The use of the term “RCIM” refers to
functionality common to all three boards. “RCIM I”, “RCIM II”
and “RCIM III” refer to the specific boards. The section “Specifi-
cations” provides specifications for each of the boards.
Overview 1
The Real-Time Clock and Interrupt Module (RCIM) is a PCI-based card that supports
time-critical applications that require rapid response to external events, synchronized
clocks and/or synchronized interrupts.
When RCIM boards of various systems are chained together, an interrupt can be
simultaneously distributed to all connected RCIMs, and from the RCIMs to all the
associated host systems.
A synchronized high-resolution clock is provided so that all the RCIMs in an RCIM chain
on multiple systems can share a common time base. It also provides a local POSIX 1003.1
compliant high resolution clock. An optional GPS module allows alignment of the clock
to GPS standard time. A high stability oscillator is standard. Optional oscillators improve
the accuracy of times measured with the RCIM.
In addition to the clocks, this multi-purpose PCI-based card has the following
functionality:
•connection of external device interrupts
•real time clock timers that can interrupt the system
•programmable interrupt generators which allow generation of an interrupt
from an application program
These functions can all generate local interrupts on the system where the RCIM card is
installed. When systems are chained together, multiple input and output interrupts can be
distributed to other RCIM-connected systems. This allows one timer or one external
interrupt or one application program to interrupt multiple RedHawk Linux systems almost
simultaneously to create synchronized actions.
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com

RCIM User’s Guide
1-2
Specifications 1
Feature RCIM III RCIM II RCIM I
Clocks
POSIX
Length 64 bits (two 32-bit words) 64 bits (two 32-bit words) 64 bits (two 32-bit words)
Resolution High-order 32 bits–1 second
Low-order 32 bits–400 nsec
High-order 32 bits–1 second
Low-order 32 bits–400 nsec
High-order 32 bits–1 second
Low-order 32 bits–400 nsec
Oscillator stability +/-2.5 PPM +/-20 PPM +/-100 PPM
Tick Timer
Length 64 bits (two 32-bit words) 64 bits (two 32-bit words) 64 bits (two 32-bit words)
Resolution 64 bit counter of 400 ns ticks 64 bit counter of 400 ns ticks 64 bit counter of 400 ns ticks
Real-Time Clocks
Number 8 8 4
Length 32 bits 32 bits 32 bits
Resolution 1 microsecond
(larger values programmable)
1 microsecond
(larger values programmable)
1 microsecond
(larger values programmable)
Oscillator stability +/-2.5 PPM +/-20 PPM +/-100 PPM
Local Interrupts
External Edge-Triggered Interrupts 12 12 4
External Output Interrupts 12 12 4
Real-Time Clocks 8 8 4
Distributed Interrupts
Input 12 12 8
Output 12 12 8
Interrupt Response Time
Interrupt to user process < 8 microseconds < 8 microseconds < 8 microseconds
Packaging
Form Factor PCIe PCI PCI
Maximum cable length
(See Appendix B for calculations.)
30 meters 32 ft. 10 ft.
External Connectors Molex LFH-60 Molex LFH-60 16 position .1’’ Latching Header
PCI Performance x1 66 MHz 64-bit 33 MHz 32-bit
Options GPS Module, Oven Oscillator GPS Module, Oven Oscillator None
Environmental
Operating Temperature 10οto 40oC 10οto 40oC 10oto 40oC
Storage Temperature -40oto 65oC -40oto 65oC -40oto 65oC
Relative Humidity 10 to 90% (non-condensing) 10 to 90% (non-condensing) 10 to 80% (non-condensing)
Power
Consumption ~5 watts ~5 watts ~5 watts
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com

2-1
2
Chapter 1Hardware, Installation and Configuration
2
1
This chapter provides a description of the RCIM PCI-based boards as well as installation
and configuration information.
Board Descriptions 1
This section provides illustrations and descriptions of the RCIM III, RCIM II and RCIM I
boards.
RCIM II and RCIM I boards mount in a standard PCI slot and the RCIM III board mounts
into a standard PCI-e slot on a host system. A connector is mounted on each RCIM for
connection to external interrupts, and a synchronization cable is included for daisy-
chaining a master RCIM to one or more slave RCIMs.
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com

RCIM User’s Guide
2-2
RCIM III 1
Board Illustration 1
Figure 2-1 shows the RCIM III board with optional high stability OCXO (Oven
Controlled Crystal Oscillator) and GPS modules installed.
Figure 2-1 RCIM III Board
GPS Module
Connectors
Oven
Controlled
Crystal
Oscillator
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com

Hardware, Installation and Configuration
2-3
Connectors and LEDs 1
Figure 2-2 shows the input/output connectors and LEDs on the RCIM III board. Detailed
information on the LEDs and each of the connectors is provided in the following sections.
Figure 2-2 RCIM III Connectors and LED Locations
LED Functions 1
There are two bi-colored status LEDs near the input and output connectors on the
RCIM III board. They will both glow dimly RED when the board is in reset mode
Output
Status LED Input
Status LED
SFP Input
Connector
SFP Output
Connector
GPS Antenna
Connector External Interrupt
I/O Controller
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com

RCIM User’s Guide
2-4
followed by brief intervals of bright RED and GREEN as a test. During normal operation
of the board the LEDs function as follows:
Input and Output Cables and Connectors 1
The RCIM III uses a pair of standard SFP (small form-factor pluggable) connectors
installed in cages to interface to the RCIM III cable. The cable is used to communicate
interrupts, time stamps and a reference clock between RCIM III boards. The output cable
connector is used when the RCIM is either the master or a slave in the middle of an RCIM
chain (see page 2-18 for a description of RCIM modes). The input cable connector is used
when the RCIM is acting in slave mode or in the middle of an RCIM chain. The cable part
number (HS002-3CBL-xx where xx is length in meters) includes an LC fiber optic cable
and two SFPs that are installed in the empty cages on the master and slave RCIMs. Refer
to the section “Daisy Chain Cable” for more information about the cable.
NOTE
The cable SFPs should only be installed and removed with the
system containing the RCIM III powered down. See the Installa-
tion section for ESD caution. Care should be taken to insure that
the SFP modules lock into position and that the RCIM III is not
pushed out of its PCIe slot during the installation of the SFPs. The
fiber optic cables themselves can be installed and removed at any
time without damaging the RCIM III.
Oscillators 1
The temperature compensated crystal oscillator (TCXO) provided with RCIM III has an
accuracy of +/- 2.5 PPM (parts per million).
Two optional oven controlled crystal oscillators (OCXO) provide a temperature stability
of +/- 210 PPB (parts per billion) or +/- 10 PPB (parts per billion).
LED description Function
Output
Status
LED
RED solid 10 MHz clock failure
RED 2/sec flash cable option installed but not synchronized or miss-
ing, POSIX clock stopped
GREEN 1/sec flash POSIX clock running without cable option
GREEN 1/sec blink POSIX clock running with cable attached and syn-
chronized
RED/GREEN alter-
nating 2/sec flash
POSIX clock running with cable unsychronized or
missing
Input
Status
LED
RED 2/sec flash cable option installed but cable unsynchronized or
missing
GREEN solid cable attached and synchronized
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com

Hardware, Installation and Configuration
2-5
GPS Antenna 1
The GPS option on the RCIM III includes an active GPS antenna and coaxial cable.
The antenna receives the GPS satellite signals and passes them to the receiver. The GPS
signals are spread spectrum signals in the 1575 MHz range and do not penetrate
conductive or opaque surfaces. Therefore, the antenna must be located outdoors with a
clear view of the sky.
If a different antenna or cable is used, it should match the following specifications:
•50 Ohm impedence
•27 dB gain
•3.3 volt DC power max 30 ma.
External Interrupt I/O Connector 1
The external interrupt I/O connector on the RCIM III is a Molex LFH-60 (Low Force
Helix) that provides twelve outputs and twelve inputs.
The external outputs allow equipment to be attached and controlled by the RCIM. The
outputs are driven by a multiplexer which can select any of the programmable interrupt
generators (PIGs), real-time clock timers (RTCs), edge-triggered interrupts (ETIs) or
distributed interrupts (DIs) to drive the output. The selection is controlled by a set of
configuration registers.
See Chapter 3 for information on using external output interrupts and programmable
interrupts.
The pin-outs for the external interrupt I/O connector are shown in Figure 2-3.
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com

RCIM User’s Guide
2-6
Figure 2-3 RCIM III External Interrupt I/O Connector Pin-outs
The external interrupt input signals are 5 volt ttl levels. The external interrupt outputs
(labeled EXT_PIG[0-11]) are driven using a 74ABT16240 line driver. The external interrupt
inputs are terminated with 180 ohms to +5 volts, 330 ohms and 0.1 uf to ground. To drive
this input requires a line driver that can sink at least 30 ma. The input termination limits
the speed of the external interrupt signals and helps prevent noise from causing spurious
interrupts. Since most line drivers can sink more current than they can source, the falling
edge of the signal will be faster.
The signals EXT_CLKIN and EXT_CLKOUT are used for external 10MHz clocks in or out. An
external clock driving the RCIM III should be capable of driving a 5V ttl signal into a 50
ohm load. The RCIM III will automatically switch to using the external clock if one is
present. The external clock output from the RCIM III is driven using a 74ABT16240 line
driver.
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com

Hardware, Installation and Configuration
2-7
The signals EXT_RXD1, EXT_TXD1, EXT_RXD2, and EXT_TXD2 are RS-232 level signals.
They are currently used for debug purposes.
System Identification 1
The following output to lspci(8) shows the PCI class, vendor and device IDs for the
RCIM III (0e:04.0 (bus:slot.function) will differ on your system):
#lspci -v | grep -i rcim
0e:04.0 System peripheral: Concurrent Computer Corporation RCIM III
Real-Time Clock & Interrupt Module (PCIe) (rev 01)
#lspci -ns 0e:04.0
0e:04.0 Class 0880: 1542:9271 (rev 01)
Daisy Chain Cable 1
The RCIM III uses a fiber optic serial synchronization cable with SFP (small form-factor
pluggable) connectors (part no. HS002-3CBL-xx) to connect RCIM IIIs in an RCIM
chain. The serial data on the cable includes parity and framing information which allow
cable problems to be detected. Polling is done continuously and messages that report the
status of the RCIM III daisy chain cables are output when an error condition is detected.
Messages indicating problems will appear on the systems directly connected by a failing
link.
The serial cables are point to point connections. The “input” cable refers to the cable going
upstream towards the master RCIM. The “output” cable is the downstream connection
away from the master.
RCIM: Input cable disconnected.
RCIM: Input cable connected.
RCIM: Input cable connected but not synchronized.
RCIM: Input cable unsynchronized.
RCIM: Input cable O.K.
RCIM: Output cable disconnected.
RCIM: Output cable connected.
RCIM: Output cable connected but not synchronized.
RCIM: Output cable unsynchronized.
RCIM: Output cable O.K.
RCIM: Cable error on input cable.
RCIM: Cable error on output cable.
The “disconnected” and “connected” messages will only occur based on whether an SFP
is installed in the appropriate cage of the RCIM III.
They will not occur when the optical cable is inserted or removed. They should not occur
during normal operation unless the SFP is not installed correctly or it is malfunctioning.
The “not synchronized” and “unsynchronized” messages indicate that the cable is not
answering attempts to communicate. These messages will occur when the optical cable is
installed or removed. They will also occur when a connected system is powered off.
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com

RCIM User’s Guide
2-8
The last two messages indicate transient errors such as cable parity errors or temporary
loss of cable synchronization. If a transient error occurs, it may require a link in the cable
to resynchronize. If a distributed interrupt is being broadcast on the cable, it may be lost.
Transient errors also affect the synchronization of the tick timers since the cable clock will
not reach all of the systems. Refer to Chapter 3 for instructions for synchronizing clocks.
RCIM II 1
Board Illustration 1
Figure 2-4 shows the RCIM II board with optional high stability OCXO (Oven Controlled
Crystal Oscillator) and GPS modules installed.
Figure 2-4 RCIM II Board
Connectors and LEDs 1
Figure 2-5 shows the input/output connectors and LEDs on the RCIM II board.
Oven Controlled
Crystal Oscillator
(OCXO)
GPS Module
Connectors
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com

Hardware, Installation and Configuration
2-9
Detailed information on the LEDs and each of the connectors is provided in the following
sections.
Figure 2-5 RCIM II Connectors and LED Locations
LED Functions 1
The four LEDs for the RJ45 input and output connectors on the RCIM II board function as
follows:
Connector LED Function
RJ45 Output
Cable Connector
LED 1 Red -- Failure, Green -- Activity
LED 2 Cable status:
off cable not connected
yellow cable connected but not synchronized
green cable connected and synchronized
RJ45 Input
Cable Connector
LED 3 Always flashing green
LED 4 Cable status:
off cable not connected
yellow cable connected but not synchronized
green cable connected and synchronized
RJ45Cable
Connector
LEDs 1-4
RJ45 Output
Cable Connector GPS Antenna Connector Externalinterrupt I/O Connector
RJ45 Input
Cable Connector
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com