Module 37 - A208
A208: Using the ATC 5401 Application Programming Interface Standard to Leverage ITS Infrastructures
HTML of the Student Supplement
(Note: This document has been converted from the Student Supplement to 508-compliant HTML. The formatting has been adjusted for 508 compliance, but all the original text content is included, plus additional text descriptions for the images, photos and/or diagrams have been provided below.)
(Extended Text Description: Large graphic cover page with dark blue background with the title in white letters "A208: Using the ATC 5401 Application Programming Interface (API) Standard to Leverage ITS Infrastructures." At the middle left is the "Standards ITS Training" logo with a white box and letters in blue and green. The words "Student Supplement" and "RITA Intelligent Transportation Systems Joint Program Office" in white lettering are directly underneath the logo. Three light blue lines move diagonally across the middle of the blue background.)
A208: Using the ATC 5401 Application Programming Interface Standard to Leverage ITS Infrastructures
Table of Contents
Introduction/Purpose - 2
Traffic Concepts - 2
ATC Concepts - 5
Glossary - 8
Reference to Other Standards - 11
References - 11
Study Questions - 12
1. Introduction/Purpose
A208: Using the ATC 5401 Application Programming Interface Standard to Leverage ITS Infrastructures is the third module in the Professional Capacity Building (PCB) program on using the Advanced Transportation Controller (ATC) standards. Module A208 identifies the features of the ATC 5401 Standard, it describes the API Software defined by the standard, describes how ATC 5401 works with other ITS standards, and helps users specify ATC equipment that includes API Software for procurements.
2. Traffic Concepts
Intersection Actuation - The extent at which an intersection is equipped for vehicle detection.
(Extended Text Description: This graphic consists of three graphics each representing a 4 way intersection. The intersection graphics are arranged such that two are evenly distributed across the page. The third intersection graphic is below the first two and aligned center on the page. Each graphic is depicted as two two-lane roads intersecting perpendicularly North/South and East/West in the shape of a cross (it is assumed that upward is north). There is a centerline on each road to differentiate the northbound lane from the southbound lane and the eastbound lane from the westbound lane. The area where the roads cross (center of the cross) is blank (no lines running through it). In the bottom graphic, the southbound, northbound, westbound, and eastbound approaches to the intersection contain rectangles extending across the width of the lane (total four lanes). The rectangles have one edge at the point where the blank center area begins and extends back into the lane about 1 ½ times their width. This graphic is labeled "Actuated." The graphic to the upper right has the rectangles on the southbound and northbound directions only. This graphic is labeled "Semi-Actuated." The graphic on the upper left does not contain any of the rectangles. This graphic is labeled "Non-Actuated.")
Graphics: Ralph W. Boaz
Figure 1. Diagram illustrating different types of actuation in an intersection.
Cycle - The time required for one complete revolution of the timing dial (old definition). One complete sequence of signal indications.
Interval - Any one of the several divisions of the time cycle during which signal indications do not change. Examples:
Phase - Any combination of traffic movements receiving right-of-way simultaneously during one or more intervals
Overlap - A traffic movement timed concurrently with one or more phases (parent phases). Typically, the yellow and red clearance timing of the overlap is equal to that of the phase terminating the overlap.
Standard Quad or 8-Phase Intersection. The odd numbered phases represent left turn movements. The even numbered phases represent though movements. Overlaps are indicated by the plus signs and indicate that the right arrow would appear during the timing of the two phases indicated. Example: The overlap 08 + 01 would be allowed during the timing of 08 and 01. No U-turns on left arrow allowed.
(Extended Text Description: This is a graphic representing of a 4 way intersection. It is depicted as two four-lane roads intersecting perpendicularly North/South and East/West in the shape of a large cross (it is assumed that upward is north). There is a center median about the same width as the lanes on each road to differentiate the northbound lanes from the southbound lanes and the eastbound lanes from the westbound lanes. On each side of the median are parallel dotted lines to identify the two lanes on each side. The area where the roads cross (center of the cross) is blank (no lines running through it). For each of the southbound, northbound, westbound, and eastbound approaches to the intersection, the center medians narrow to provide an additional left turn lane for each approach (total 4). The straight through lanes and adjacent left turn lanes on each approach are separated by a dotted line. Each approach has its lanes identified as described below:
)
Graphics: Ralph W. Boaz
Figure 2. Diagram illustrating a "Standard Quad" or 8-Phase intersection.
Ring - Consists of two or more sequentially timed and individually selected conflicting phases so arranged as to occur in an established order.
Barrier - A reference point in the preferred sequence of a multi-ring controller at which all rings are interlocked. Barriers assure there will be no concurrent selection and timing of conflicting phases for traffic movements in different rings. All rings cross the barrier simultaneously to select and time phases on the other side.
Concurrent Groups - All of the phases between two barriers. Typically, they are the left turn and through movements on a single street.
Dual Ring Operation for a Standard Quad - See diagram below. There are two rings. The first consists of phases 1-4 and the second consists of phases 5-8. A phase in Ring 1 can time with a phase in Ring 2 provided they are a part of the same concurrent group.
(Extended Text Description: This is a graphic representing the flow of service for each of the turning movements in a 4 way intersection. There are eight squares arranged in a two columns and four rows all evenly spaced. Above the left column of squares is a label "RING 1." Above the right column of squares is a label "RING 2." There is a dashed line extending vertically from between the labels to the bottom of the graphic. The dashed line is centered between the columns of squares. There is a horizontal dashed line extending across the graphic evenly between the second and third row of squares. The line is labeled "BARRIER." There is a second such dashed line and label extending across the graphic below the fourth row of squares. To the right of the graphic is a large right bracket highlighting the top four squares (above the first barrier line) with the label "CONCURRENT GROUP." To the right of the graphic is a large right bracket highlighting the bottom four squares (below the first barrier line) labeled "CONCURRENT GROUP."
Each square contains a number and an arrow. The left column of squares contains the following (top to bottom):
The right column of squares contains the following (top to bottom):
There are solid lines connecting the numbered squares as follows:
)
Graphics: Ralph W. Boaz
Figure 3. Diagram illustrating a "Standard Quad" or 8-Phase intersection.
3. ATC Concepts
(Extended Text Description: This is a graphic of 5x5 crisscrossing perpendicular lines representing a downtown "grid" of intersecting streets. The grid forms a 4x4 (rows and columns) representation of city blocks. In the bottom left side of each city block (except for the first block in the third row) is a TFCS (each TFCS is about 2/3 of the height of block. The leftmost TFCSs in row 3 and 4 have the abbreviation "FMS" above them (stands for Field Management Station). Left of the grid is a graphic of a building which represents a traffic management center (TMC).
The TFCSs are associated to different field architectures. Dotted lines are used to represent communications.
)
Graphics: Ralph W. Boaz
Figure 4. Field architectures using Transportation Field Cabinet Systems (TFCSs) for Performing Traffic Management.
(Extended Text Description: This graphic contains a horizontal arrow that stretches almost the entire width of the graphic at the bottom. There are years listed beneath the timeline (not evenly spaced) as follows: "1940s," "1976," "1980s," "1992," "1998," and "2006." Above the timeline are labeled photographs of TFCSs of different shapes and sizes as follows:
)
Graphics: Ralph W. Boaz
Figure 5. Evolution of Transportation Control Equipment.
(Extended Text Description: This graphic illustrates that the field cabinet contains various equipment. There are two large graphics. The leftmost graphic is the aluminum looking cabinet. The cabinet has a door with a horizontal handle on the left side of the cabinet and two vent slots in the center top. The cabinet is about 2.5 times high as it is tall. Above it is the label "Housing." The graphic on the right is about twice the size of the cabinet on the left. It is an enlargement of the aluminum cabinet without a door and showing the contents of the cabinet. Inside the cabinet are six labeled cuboids that extend almost the width of the cabinet. They are evenly distributed vertically. Starting from the top the cuboids are labeled "Input," "Controller," "Outputs," "Monitoring," "Power Supply," and "Internal Bus." There is a large left bracket between the cabinet graphic on the left and the enlarged cabinet on the right emphasizing that the right graphic represents the contents of the cabinet on the left.)
Graphics: Ralph W. Boa
Figure 6. Basic TFCS components.
(Extended Text Description: On the upper right side of this graphic is the intersection graphic labeled "Actuated" as described in Section 2 Definition of "Intersection Actuation." In this case, the graphic is labeled "Field Sensors." In the lower right of the graphic is a graphic of a traffic signal mast arm. On the mast are three traffic signal heads. This graphic is labeled "Field Displays." On the left side of the graphic are four cuboids each the same size and about 5 times wider than their height or depth. They are evenly spaced and aligned with each other. They are labeled top to bottom "Inputs, Controller, Outputs and Monitoring." There are arrows showing the flow of information through the TFCS. There is an arrow extending out of the top of the Field Sensors graphic into the Inputs cuboid. There is an arrow extending out of the bottom of the of the Inputs cuboid to the Controller cuboid. There is an arrow extending out of the Controller cuboid to the Outputs cuboid. There is an arrow extending out of the Outputs cuboid to the Monitoring cuboid. There is a double arrow extending from the left side of the Monitoring cuboid back up to the left side of the Controller cuboid. This line has a label associated with via a dotted line. The label says "Controller/Monitor Communications Used in NEMA TS 2 and ITS Cabinets." There is a line extending from the ride side of the Outputs cuboid to the top of the Field Displays graphic.)
Graphics: Ralph W. Boaz
Figure 7. Basic TFCS Operation.
Table 1. Differences in Transportation Field Cabinet Systems.
TFCS | Physical Mounting | Internal Bus | Signal Monitor | Input Channels | Monitored Output Channels |
---|---|---|---|---|---|
NEMATS1 | Shelf | Parallel / Discrete Wiring | Conflict Monitor | 8 | 3/6/12/18 |
Caltrans Model 33X | Rack | Parallel / Discrete Wiring | Conflict Monitor | 44 | 16/18 |
NEMATS 2 | Shelf | Serial 153.6 kbps | Malfunction Management Unit | 64 | 16 |
ITS Cabinet v01 | Rack | Serial 614.4 kbps | Cabinet Monitor Unit | 120 | 28 |
(Extended Text Description: This graphic illustrates a TFCS being used in multiple applications areas. There is an aluminum looking cabinet in the center of the graphic. The cabinet has a door with a horizontal handle on the left side of the cabinet and two vent slots in the center top. The cabinet is about 2.5 times high as it is long. It is about 25% of the graphic height. To the left, to the right, lower left and lower right of the cabinet graphic are four rounded rectangles. There are double arrows between the cabinet and the rounded rectangles. The left and right rounded rectangles are about 30% of the height and 25% of the width of the graphic. The lower rounded rectangles are about 20% the height of the graphic and 25% of the width of the graphic. The rounded rectangle to the left has a label "Intersection Control" on the inside top. The remainder of the rounded rectangle is a graphic of a roadway intersection. The view of the intersection is such that two traffic signals are shown. The rounded rectangle to the right has a label "Ramp Metering" on the inside top. The remainder of the rounded rectangle is a graphic of freeway on-ramp. A freeway is depicted and a traffic signal with a sign "One Vehicle Per Green" is shown at the edge of the onramp. The rounded rectangle to the lower left has a label "Connected Vehicle V2I" on the inside top. The remainder of the rounded rectangle is a graphic of a 2-door sedan sitting next to a TFCS. The rounded rectangle to the lower right has a label "Other Application" centered within the rectangle with no other graphics included. In the upper part of the graphic is a square about 25% the height of the graphic representing a LCD screen and keypads portion of a transportation controller.)
Figure 8. ATC 5401 Standard allows applications to share the resources of the ATC Controller Unit and TFCS.
4. Glossary
TERM | DEFINITION |
---|---|
Model 170 | A traffic control device that meets one of the California Department of Transportation (Caltrans) standards for Model 170 traffic control devices. |
Model 2070 | A traffic control device that meets one of the California Department of Transportation (Caltrans) standards for Model 2070 traffic control devices or one of the standards for the ATC 2070 traffic control devices. |
AASHTO | American Association of State Highway and Transportation Officials |
API | Application Programming Interface. In this standard, when API is used by itself as a noun it refers to the software that is compliant to the ATC API Standard. |
API Managers | API software that manages an ATC resource for use by concurrently running application programs. |
API Utilities | API software not included in the API Managers that is used for configuration purposes. |
Application Program | Any program designed to perform a specific function directly for the user or, in some cases, for another application program. Examples of application programs include word processors, database programs, Web browsers and traffic control programs. Application programs use the services of a computer's O/S and other supporting programs such as an application programming interface. |
ASCII | American Standard Code for Information Interchange. A standard character-coding scheme used by most computers to display letters, digits and special characters. See ANSI-X3.4-1986(R 1997). |
ATC | Advanced Transportation Controller |
ATC Device Drivers | Low-level software not included in standard Linux distributions that is necessary for ATC-specific devices to operate in a Linux O/S environment. |
Aux Switch | A physical "auxiliary" switch on the Front Panel of ATC 2070 controllers that may be used by application programs. |
BIU | Bus Interface Unit. A transportation cabinet device which is used for communications within some cabinet systems. |
Board Support Package | Software usually provided by processor board manufacturers which provides a consistent software interface for the unique architecture of the board. In the case of the ATC, the Board Support Package also includes the O/S. |
BSP | See Board Support Package. |
CMU | Cabinet Monitor Unit. A transportation cabinet device which monitors the operational status of some cabinet systems. |
CPU | Central Processing Unit. A programmable logic device that performs the instruction, logic and mathematical processing in a computer. |
Device Driver | A software routine that links a peripheral device to the operating system. It acts like a translator between a device and the application programs that use it. |
TERM | DEFINITION |
DRAM | Dynamic Random Access Memory |
DST | Daylight Saving Time |
EEPROM | Electrically Erasable, Programmable, Read-Only Memory. EEPROMs differ from DRAMs in that the memory is saved even if electrical power is lost. |
ELF | Executable and Linking Format. A software library format. |
Epoch | An origin of time measurement commonly used in computers. It is midnight UTC of January 1, 1970. |
FAT | File Allocation Table. A Microsoft Windows file system format. |
FHWA | Federal Highway Administration |
FIFO | First In/First Out. A method of storage in which the data stored for the longest time will be retrieved first. |
FIO | Field Input and Output |
FSA | Failed State Action |
FTP | File Transfer Protocol. A protocol used to transfer files between computers on a network. |
GMT | Greenwich Mean Time |
I/O | Input/Output |
IEC | International Engineering Consortium |
IEEE | Institute of Electrical and Electronics Engineers |
IPv4 | Internet Protocol version 4. The fourth revision in the development of the Internet Protocol (IP). Addresses are usually written in dot-decimal notation, which consists of four octets of the address expressed in decimal and separated by periods. |
ISO | International Organization for Standardization |
ITE | Institute of Transportation Engineers |
ITS | Intelligent Transportation Systems |
JC | Joint Committee |
kbps | Kilobits per second (thousands of bits per second) |
LED | Light Emitting Diode. A display technology that uses a semiconductor diode that emits light when charged. |
Linux Device Drivers | Low-level software that is freely available in the Linux community for use with common hardware components operating in a standard fashion. |
Linux Kernel | The Unix-like operating system kernel that was begun by Linus Torvalds in 1991. The Linux Kernel provides general O/S functionality. This includes functions for things typical in any computer system such as file I/O, serial I/O, interprocess communication and process scheduling. It also includes Linux utility functions necessary to run programs such as shell scripts and console commands. It is generally available as open source (free to the public). The Linux Kernel referenced in this standard is defined in the ATC Controller Standard, Section 2.2.5, Annex A and Annex B. |
Mb/s | Mega/Million Bits per Second |
TERM | DEFINITION |
MMU | Malfunction Management Unit. A transportation cabinet device which monitors the operational status of some cabinet systems. |
Ms | Millisecond. One thousandth (10-3) of a second. |
NEMA | National Electrical Manufacturers Association |
NEMA Controller | A traffic control device that meets one of the NEMA standards for traffic control devices. |
Operational User | A technician or transportation engineer who uses the controller to perform its operational tasks. |
O/S | Operating System |
PCB | Printed Circuit Board |
Process | A process is an instance of a program running in a computer. In Linux, a process is started when a program is initiated (either by a user entering a shell command or by another program). A process is a running program in which a particular set of data and unique process identifier (ID) is associated so that the process can be managed by the operating system. |
Programmatic | Having to do with a computer program or software. |
RAM | Random Access Memory |
RTC | Real-Time Clock |
SDD | Software Design Document |
SDLC | Synchronous Data Link Control. A communication protocol used in some transportation cabinet systems. |
SDO | Standards Development Organization |
SIU | Serial Interface Unit. A transportation cabinet device which is used for communications within some cabinet systems. |
SRAM | Static Random Access Memory |
SW | Software |
Telnet | Teletype Network. A network protocol used on the Internet or local area networks to provide a bidirectional interactive communications facility. |
TFCS | Transportation Field Cabinet System |
TOD | Time of Day |
TTL | Transistor Transistor Logic |
WG | Working Group |
USDOT | United States Department of Transportation |
USB | Universal Serial Bus. An external peripheral interface standard for communication between a computer and external peripherals. |
User Developer | A software developer that designs and develops programs for controllers. |
UTC | Coordinated Universal Time. A high-precision atomic time standard. Time zones around the world are expressed as positive or negative offsets from UTC. As the zero-point reference, UTC is also referred to as Zulu time (Z). UTC is often referred to as Greenwich Mean Time (GMT) when describing time zones. |
5. Reference to Other Standards
6. References
7. Study Questions
1) Which of the following elements of the TFCS is not shared by API Software?
2) Which of the following statements is TRUE regarding the operation of the Front Panel Manager Window?
3) Which of the following is TRUE in regards to the Field I/O Management of API Software?
4) Which of the following is not a standard utility provided in API Software?
5) Which of following parts of the ATC Engine Board is not managed by API Software?
6) What must a User Developer do to make an application portable and compatible on two different ATC controllers in different TFCS architectures? Choose the best answer.
7) What is NOT a benefit of the API Reference Implementation?