Welcome to the Industrial Automation website!

NameDescriptionContent
XING-Automation
E-mail  
Password  
  
Forgot password?
  Register
当前位置:

CENTUM CS 1000/CS 3000 Electronic Document

F: | Au:佚名 | DA:2024-01-03 | 589 Br: | 🔊 点击朗读正文 ❚❚ ▶ | Share:

SHIMIZU Hideto1

Printed bookbinding paper product manuals have been provided with Yokogawa's control systems represented by CENTUM CS so far.

In 1997 and 1998, new production control system CENTUM CS 1000 and integrated production control system CENTUM CS 3000 (hereinafter referred as CS 1000/CS3000) were released one after another, their operation and the engineering functions run on the open-architecture Windows NT.

In cooperation with the new product development, we achieved to provide users the documents and online manuals in electronic data for the first time. So that our company has broke away from the paper documentation era.

The file format and the electronics data are PDF (Portable Document Format) compliant, copyrighted by United States Adobe Systems which has been widely accepted as the standard electronic document format and the internet document format on Web. The needs for paper documents are also taken care of in our electronic document construction.

This article outlines the planning and production of the electronic documents for CENTUM CS 1000/CS 3000 functional online manuals.

Industrial Automation Systems Business Division

INTRODUCTION

The manuals of control systems such as a DCS provide a vast amount of information depending on their multi-functionality and functional integration. A conventional large-scale control system our company offers comes with more than 10,000 pages of paper documents. Manuals of those systems are a practical way to produce original information about the operational verifications of products in accordance with development specifications issued from the Product Development Department, and to edit it into book-bound information for each system function block, such as operation functions and control functions or information for each product software package.

However, the wide dispersion of information on CD-ROMs and electronic media on the Internet has disproved the concept that "a document equals paper." To meet the needs of the time, Yokogawa has planned and produced electronic media to replace manuals for control systems, and has developed control systems bound for the open and global markets. It has also completed both Japanese and English versions of electronic documents for the CS 1000 and CS 3000 series products. Electronic documents for the CS 1000/CS 3000 offer a vast amount of information not only via CD-ROM media, but also by online manuals included in the control system, that make full use of PDF properties, and paper documents that are excellent for quick reference.

BACKGROUND OF ELECTRONIC DOCUMENTS

 Figure 1 CS 1000/CS 3000 Document Map 

Yokogawa established a project team for the purpose of improving product manuals several years ago. The project team has mainly grappled with the following subjects.

Subjects regarding the systems between the Product Development Department and documentation personnel.

Subjects regarding documentation including the presentation media, authoring tools, and documentation cost.

Subjects regarding the quality of manuals, including the solicitation of user requests and improvement measures.

In the process of discussing these subjects, the project team started electronic document planning and electronic media became an essential component of document presentation media.

According to the needs of the time for electronic media, the widespread use of highly functional PCs, and the presence of international de facto standards such as PDF and HTML, it has become essential to plan and produce electronic-based documents. The following points were taken into account when planning electronic documents.

Comparing electronic and paper documents, and the proper use of them.

Selecting DTP (Desktop Publishing) tools and electronic tools.

Reducing the production period of documentation and producing concurrent Japanese/English versions.

Supporting online help (situation-dependent help)

Utilizing intranets and the Internet.

POLICY

  

Figure 2 Pictograms for Defining the Difference

between the CS 1000 and CS 3000 

CS 1000/CS 3000 electronic documents were planned and produced in accordance with the policy of supporting flexible maintenance for future changes in technology and situations, in addition to improving the problems associated with conventional documents. Especially when a document such as an online manual was planned, mutual cooperation between development department personnel and documentation personnel was indispensable, since the document requires an interface with the product system software.

This led to the policy described below.

Since the product documents are an important part of the product, the highest priority is given to synchronizing the documentation with the product release schedule. Also, the Japanese and English versions of the documents should be released at the same time.

The offering of product documents on CD-ROM in the same way the product system software is supplied. The documents are laid out so that they can be offered either on electronic media or on paper, with consideration for bookbinding.

The total size of the documents should be reduced.

The complete documents should be structured such that their readability is the prime purpose. They should not stick to such a structure as the conventional system block for each function of the development specifications or for each software package.

Tools and devices suppress the increase in documentation man-hours required due to the production of electronic documents or the usage of new techniques.

DOCUMENT PLANNING

 Figure 3 Body Layout Example 

It was the first attempt to put thousands of pages of control system documentation into online manuals. Prior to starting this documentation a significant amount of time was spent on document planning. For readability that is compatible between documents on a CRT and paper, it became necessary to examine the following guidelines.

User interface including startup and link.

Structured documentation appropriate for browsing information.

Expression of indexes, lead sentences, reference cues, etc., that are understandable at a glance.

Rules for producing characters, figures and tables, templates, etc., and rules for data storage.

Information management of version numbers, documentation date, etc., that are interchangeable for each page.

Expression of security, PL measures, trademarks, and copyrights.

Taking these guidelines into account, we listened to users in various fields, identified all the described items, then devised a detailed plan and design for the entire documentation policy and structure including the table of contents for each document. In planning, the emphasis was put on the following items.

To offer the necessary information to those who need it, the intended readers should be clearly defined, such as engineers, plant operators, and maintenance personnel.

To remove the duplication of descriptions and browsing difficulties by defining the positioning and contents of each document, a simple and comprehensible document system should be established. (See Figure 1, CS 1000/CS 3000 document map.)

The documents should be clearly categorized by their objectives— one that must be read, and ones for reference, thus reducing the number of documents that must be read.

The documents should be well structured so that they are easy to read and easy to revise if the product specification is modified or if the documents are to be altered for use with other product models.

The documentation development methodology should adopt the structured programming methodology of s

CS 1000/CS 3000 documents should be prepared so that they can be provided on CD-ROM. These documents should also be laid out with consideration for bookbinding and the printing of specific pages on demand.

PDF should be employed as the data format of electronic documents. While making the most of PDF files, a function equivalent to situation-dependent help is implemented. Acrobat Reader supplied free from Adobe Systems Inc., is redistributed with the CD-ROM for use as the PDF browsing software. Each PDF file is designed such that the standard Find function of Acrobat Reader can be used.

To improve the browsing performance for retrieving the desired information, an electronic document should be provided with link settings (linking to related information), which is a convenient PDF function. Link resettings may be required if document revision increases or reduces the number of pages; unnecessarily complex link settings should not be made.

The information required first by the user and the designation of PL, trademarks, etc., should be presented with paper documents accompanying the CD-ROM.

Revisions to each document are informed to respective overseas offices and translated into various languages, and hence they should be supplied in detail to users all over the world.

DOCUMENTATION DESIGN

 Figure 5 Calling Relationship between Online Manuals 

 Figure 6 Startup from the Windows Start Menu 

One point of the documentation design is to achieve the "Create Once Use Many Times" concept and also to be aware of the data structure that can be utilized in the future. It is a matter of course that the design conforms to the basic rules of technical communication associated with general documentation.

Sharing the Document Source Data

We rolled out the CENTUM CS 1000, and then CENTUM CS 3000 within a short period of time. They have many common functions in their control systems, and both models have a significant amount of descriptions overlap in their documents. We applied the concept of "Use the same source for all applicable purposes" and isolated common functions from functions, which differed between the models. In the development of the CS 3000 we restructured the document map (Figure 1) to common manuals and individual manuals, compiling the CS 1000 and CS 3000 documents into one set of documents.

Additionally, the pictograms that indicate each definition shown in Figure 2 are used in documents so as to denote at a glance CS 1000 and CS 3000 specific parts. This makes it possible to improve the efficiency of the next revision and to greatly reduce the number of pages.

Layout Design

The page layout is designed in consideration of browsing a manual on a CRT, printing the necessary pages on demand, or reading the manual as a book-bound document.

The layout of the body, table of contents, index, etc., was determined with the aim of readability within the permissible range for both browsing on a CRT and reading in black and white printed form. For the ease of identification the number of colors are kept to a minimum with information required for browsing on a CRT and the information required for the printed version.

Documents are printed in A4 size, but only about half a page can be read on a CRT without scrolling. Also, since the English version has a little more volume of text that th

User Interface Design

 Figure 7 Startup from [Help] in the Builder Window 

The user interface has implemented the information retrieval capability that allows a description that is possibly dependent on an operating situation to be referred to or browsed, in addition to the PDF properties that allow an electronic document to be browsed and retrieved using the Acrobat Reader, and the contents as viewed on a CRT to be printed on demand.

This interface provides a document in the PDF file format that can not only be read with the Acrobat Reader, but can also be improved for use as an online manual for system software.

Practically, the user interface uses the developing tool in the Acrobat Reader's browsing function, and also allows the document on a CRT to jump to the desired topic by setting links in a PDF file. The interface provides especially easy access to the desired information when referring to detailed information about the engineering item from the window for performing engineering work.

Form functions on Acrobat and JavaScript are installed as a part of the interface, and they can also function as manual information displays through a pop-up menu and user selectable list boxes.

The major items of the user interface design are described below. The information retrieval capability has been improved through appropriate links.

Document startup method.

Approaching each manual from the document map.

Link (jump) to a relevant page from the table of contents or index.

Installing a link button in the page header.

Starting from the builder window to perform engineering work.

Designing a definition item list file (Figure 4) in which engineering items are listed.

Setting definition item names (keywords) in a body to which to link (jump).

File Design

The items to be discussed concerning the design of PDF files include the directory structure and file names in a CD-ROM, and the display magnification, thumbnails and bookmarks, to be set. Also, electronic documents require a rule for security and must be designed such th

FUNCTIONS

 Figure 8 Linking to an Objective Description

Page from the Builder Window 

It is regrettable that the functions cannot be actually shown. We have achieved the first installation of the electronic documents on the control system by putting stress on document planning and design. There are about 6,000 pages of documentation and 25,000 PDF link settings in the most recent Japanese version. The numbers are similar for the English version.

Calling and Developing

Figure 5 shows the calling relationship between the CS 1000/ CS 3000 online manuals. There are two methods of retrieving the required information, as shown below. The setting of links in the reference manual enables the user to freely browse between documents.

Starting from [Document Map] or [Reference Index] in the Windows Start menu. (Figure 6).

Starting from [Help]-[Builder Definition Items...], or [Reference Index...] in the Builder window for engineering work (Figure 7).

The definition items in the window of the current engineering work are displayed as a list by calling them from the Builder window. By selecting an item the engineer wishes to inquire about from the list, the page where the item is described can be jumped to (Figure 8). The definition item list changes the display contents for each Builder window. In other words, the definition item list is a sort of situation-dependent online manual. 

Retrieval Function

There are various methods for retrieving information. The general retrieval procedure is given below. The objective information can be accessed by approaching each manual from the document map, or by retrieving the information from a main index item and definition item.

Opening a document to be browsed from the document map.

Opening the relevant page from a term in the table of contents or index.

Opening the relevant page from [Help] on the Builder window.

Searching all the text and figures/tables with the retrieval function in the Acrobat Reader.

Since the Acrobat Reader's retrieval function searches all data in the currently

PROGRAM TO BE SOLVED IN FUTURE

CS 1000/CS 3000 electronic documents are presently planned and designed by taking into consideration the engineering work. In future it will be necessary to map out a plan to produce an online manual dependent on the situation of the so-called plant operation. Users require an online manual from which they can quickly access information about various events that occur during plant operation.

Also, approaching is a wave technological innovation in DTP and other electronic tools. A de facto standard may appear in place of the PDF file format. With a close eye on such technological trends, it is necessary to produce more user-friendly electronic documents and electronic documents that have greater reusability.

CONCLUSION

With respect to the conventional distribution of documents, a great number of man-hours and cost is required to pack and deliver paper documents. Electronic documents, however, can easily be distributed through CD-ROMs or transmitted via an intranet or the Internet. However convenient and advanced the electronic document technology and tools are, primary importance must remain attached to the content rather than the form.

With attention to user requirements, we intend to create electronic documents that have a sophisticated user interface and enriched content.


  • Mannesmann Rexroth VT3006-36 Analog Amplifier Card
  • Bosch Rexroth R900086160 PGF1 Gear Pump
  • Bosch Rexroth R911173263 VDP15.3 Touch Display
  • Bosch Rexroth PPC-R22.1 RJ522 Industrial Controller
  • Bosch Rexroth MSK060C-0300-NN-S1-UG0-NNNN Servo Motor
  • Bosch Rexroth R911325068 NYS04.1 Controller
  • Bosch Rexroth R911335439 CSH01.1C Control Unit
  • Bosch Rexroth R917010287 BODAS RC10 Controller
  • Bosch Rexroth R911329791 CSH01.1C Drive Controller
  • Bosch Rexroth R182432310 Runner Block Guide
  • Bosch Rexroth VT-VSPA2-1-11 Amplifier Card R900021909
  • Bosch Rexroth MKD090B-047-KG1-KN Servo Motor
  • Bosch Rexroth LTU350 Servo Amplifier 0608750108
  • Bosch Rexroth 5610102050 Pneumatic Vacuum Regulator
  • Bosch Rexroth VT5041-23/3-OV PLC Control Board
  • Bosch Rexroth VT3015 S10/E Servo Amplifier Board
  • Bosch Rexroth MSK070D-0300-NN-M2-UG1 Servo Motor
  • Bosch Rexroth 3DREP6C-21 Valve R900955887
  • Bosch Rexroth R151244013 Ball Screw Bearing Unit
  • Bosch Rexroth MSM031C-0300 Servomotor R911325140
  • Bosch Rexroth EMD-B16.1-DC024N Box R911291681
  • Bosch Rexroth MKD071B-061-GP0-KN Servo Motor
  • Bosch Rexroth MSK030C-0900-NN-M1-UG1 Servo Motor
  • Bosch Rexroth EcoDrive DKC01.3-004-3-MGP-01 Servo Controller (299772)
  • Bosch Rexroth DKC02.3-040-7 EcoDrive Controller
  • Bosch Rexroth CLC-D02.3 CLC Motion Control Board
  • Bosch Rexroth HDS05.2-W300N Drive R911190019
  • Bosch Rexroth DKCXX.3-100-7 Servo Drive Unit
  • Bosch Rexroth CSE02.1A-S3-EC Control Unit R911339030
  • Bosch Rexroth MSK040C-0600-NN-S1-UP0 Servo Motor
  • Bosch Rexroth VT3013 S36 R5 Circuit Board Card
  • Bosch Rexroth VT3000-36A Amplifier Card R90020298
  • Bosch Rexroth VPB40.3 IndraControl Module R911374113
  • Bosch Rexroth HCS02.1E-W0054-A-03-NNNN Converter with R911332574 Control Unit
  • Bosch Rexroth MHD071B-061-PG1-UN Servo Motor
  • Bosch Rexroth A2F5/60W-B3-S Piston Motor R909418904
  • Bosch Rexroth HCS01.1E-W0018-A-03-B-ET-EC-NN-NN-NN-FW IndraDrive Cs Converter
  • Bosch Rexroth 4WRPEH 6 C4B40P-2X/G24K0/A1M Proportional Directional Valve (0 811 404 647)
  • Bosch Rexroth R911405975 ctrlX OS PLC Controller
  • Bosch Rexroth CSB02.1B-ET-EC-NN-S4-NN-NN-FW Servo Control Card R911338543
  • Rexroth MSK050B-0300-NN-M1-UG0-NNN Servo Motor
  • Rexroth IndraControl VEPXX.5-ATOM Set R911374889 Panel
  • Rexroth 1070089906-GC1 1070089907-201 Board
  • Rexroth CSB01.1C-SE-ENS-EN2-NN-S-NN-FW Control Unit
  • Rexroth MKD071B-024-KG3-KN Servo Motor
  • Rexroth Indramat DKC02.3-040-7-FW Controller
  • Rexroth HCS02.1E-W0028-A-03-NNNN Servo Module
  • Rexroth HMD01.1N-W0036-A-07-NNNN Drive Module
  • Rexroth MSK050C-0600-NN-M1-UG0-NNN Servo Motor
  • Rexroth DKC02.3-040-7-FW Servo Controller
  • Bosch Rexroth VT-5014S30-R1 Amplifier Card
  • Bosch Rexroth MSK040C-0600-NN-M1-UG1 Servo Motor
  • Bosch Rexroth MKD071B-061-GG0-KN Servo Motor
  • Bosch Rexroth VT5012-S45-R1 Amplifier Card
  • Bosch Rexroth SHL03.1-NNN-S-NNN Encoder Module
  • Bosch Rexroth EFC3600-0K75 Frequency Converter
  • Bosch Rexroth VFC3610-1K50-3P4-MNA-7P-NNNNN-NNNN 1.5kW Frequency Inverter
  • Bosch Rexroth EFC5610-2K20-3P4-MDA-7P-NNNNN-L1NN 2.2kW Frequency Converter
  • Bosch Rexroth XM21 XM2100.01 PLC Control Unit
  • Rexroth CSH01.1C-ET-ENS R911328178 HMS01.1N-W0020 Drive Package
  • April AXI0010 - Single Axis Servo Controller
  • Rexroth DKC10.3-004-3-MGP-01VRS Servo Drive
  • Bosch DKC02.3-040-7-FW Servo Drive
  • Rexroth DKC06.3-040-7-FW Servo Drive Controller
  • Rexroth VPB40.3 SE T R911374113 Control Module
  • Rexroth S20-SSI-AO-1/1 R911172544-AB1 Module
  • Rexroth R911173004 AC1 GH1 PLC Control Set
  • Rexroth VPB40.3D1L-1G0NN-D1D-DN-NN-FW Module
  • Rexroth MDD071B-N-040-N2T-095GB1 Servo Motor
  • Bosch Rexroth DM15K1101-D Servo Drive Module
  • Rexroth CSH01.3C-PB-ENS-MA1-CCD-S2-S-NN-FW Drive
  • Rexroth HMS01.1N-W0036 CSB02.1B Drive Package
  • Rexroth MSK070E-0300-NN-M2-UG0-RNN Servo Motor
  • Rexroth AZPF-1X-004RCB20KB Gear Pump
  • Rexroth NFD03.1-480-055 Powerline Filter
  • Rexroth VT-VARAP1-537-20/V0 Valve Amplifier
  • Rexroth HVE04.2-W075N Supply Module
  • Rexroth HMD01.1N-W0020-A-07-NNNN Drive Controller
  • Rexroth VDP40.3DIN-D1-NN-CG HMI Computer
  • Rexroth HDS05.2-W300N-HS12-01FW Drive Module
  • Rexroth HMS01.1N-W0070-A-07-NNNN Power Section
  • Rexroth Indramat MKD071B-061-GP0-KN Servo Motor
  • Rexroth HDS03.2-W075N-HS12-01-FW Control Unit
  • Rexroth HCS02.1E-W0054-A-03-NNNN Servo Drive
  • Rexroth CML40.2-SP-330-NA-NNNN-NW IndraControl
  • Rexroth CSH01.1C-PB-ENS-NNN-MA1-S2-S-NN-FW Drive
  • Rexroth PPC-R22.1 DAQ03 Servo Drive
  • Rexroth HCS02.1E-W0070-A-03-NNNN Servo Drive
  • Rexroth RF-FLS PB M12 DIO 8/8 M12 Module
  • Rexroth Indramat TBM 1.2-40-W1-024 Servo Bleeder
  • Rexroth Indramat MKD071B-061-KG1-KN Servo Motor
  • Rexroth CML40.2-SP-330-NA-NNNN-NW IndraControl L40
  • Rexroth VCP08.2DTN-003-NN-NN-PW Operator Panel
  • Bosch Rexroth DM30K1101-D Servo Drive 670V DC
  • Rexroth PPC-R22.1N-N-Q1-NN-NN-FW Motion Controller
  • Rexroth MSK040C-0600-NN-M1-UG1-NNNN Servo Motor
  • Rexroth CSH01.1C-S3-ENS-NNN-NNN-S2-S-NN-FW Drive Controller
  • Rexroth PPC-R22.1 Motion Control Module 004566384
  • Rexroth CSH01.1C-PB-ENS-NNN-MA1-S2-S-NN-FW Controller
  • Rexroth CML25.1-3N-400-NN-NNC1-NW IndraControl L25
  • Rexroth MSK030C-0900-NN-M1-UP1-NSNN Servo Motor
  • Rexroth HCS02.1E-W0028-A-03 CSH01.1C-PB Drive Package
  • Bosch Rexroth VT-VARAP 1-537-20/V0 Amplifier
  • Bosch Rexroth PPC-R02.2N R911285402 Control Unit
  • National Instruments PCI-7342 Motion Controller
  • National Instruments PXIe-6535 Digital I/O Module
  • National Instruments PCIe-6738 Analog Output Card
  • National Instruments NI-6583 Digital I/O Adapter Module
  • National Instruments NI TB-9214 Terminal Block
  • National Instruments NI 9222 Simultaneous Analog Input Module
  • National Instruments PXIe-8364 MXI-Express Module
  • National Instruments PXI-8185 Embedded Controller
  • National Instruments PCI-1405 Device
  • National Instruments SCXI-1160 Module
  • National Instruments PCI-MIO-16E-1 Device
  • National Instruments USB-6216 Device
  • National Instruments PXIe-2543 Module
  • National Instruments PCI-5102 Digitizer
  • National Instruments PXI-6284 DAQ Device
  • National Instruments PXI-7330 Controller
  • National Instruments cFP-2100 Controller
  • National Instruments USB-6002 DAQ Device
  • National Instruments PCIe-6374 Multifunction DAQ Card
  • National Instruments PXIe-4610 Power Amplifier Module
  • National Instruments PXIe-4154 Battery Simulator
  • National Instruments PXIe-7858R Reconfigurable I/O Module
  • National Instruments BNC-2090A BNC Terminal Block
  • National Instruments cRIO-9066 CompactRIO Controller