M7RHB1_E.PDF

Preface, Table of Contents

Function Groups

SIMATIC

Type Identifiers

Data Structures

System Software

for M7-300 and M7-400

System and Standard

Functions, Volume 1

Error Codes and Messages

M7 API

RMOS API

Reference Manual

Index

This manual is part of the documentation

package with the order number:

6ES7802–0FA14–8BA0

C79000–G7076–C852–02

Safety Guidelines

This manual contains notices which you should observe to ensure your own personal safety, as well as to

protect the product and connected equipment. These notices are highlighted in the manual by a warning

triangle and are marked as follows according to the level of danger:

Danger

indicates that death, severe personal injury or substantial property damage will result if proper precau-

tions are not taken.

Warning

indicates that death, severe personal injury or substantial property damage can result if proper precau-

tions are not taken.

Caution

indicates that minor personal injury or property damage can result if proper precautions are not taken.

Note

draws your attention to particularly important information on the product, handling the product, or to a

particular part of the documentation.

Qualified Personnel

Only qualified personnel should be allowed to install and work on this equipment. Qualified persons are

defined as persons who are authorized to commission, to ground, and to tag circuits, equipment, and sys–

tems in accordance with established safety practices and standards.

Correct Usage

Note the following:

Warning

This device and its components may only be used for the applications described in the catalog or the

technical description, and only in connection with devices or components from other manufacturers which

have been approved or recommended by Siemens.

This product can only function correctly and safetly if it is transported, stored, set up and installed cor-

rectly, and operated and maintained as recommended.

Trademarks

are registered trademarks of SIEMENS AG.

Some of the other designations used in these documents are also registered trademarks; the owner’s

rights may be violated if they are used by third parties for their own purposes.

, SIMATIC HMI

and SIMATIC NET

The reproduction, transmission or use of this document or its contents is not

permitted without express written authority. Offenders will be liable for

damages. All rights, including rights created by patent grant or registration of

a utility model or design, are reserved.

Disclaimer of Liability

We have checked the contents of this manual for agreement with the

hardware and software described. Since deviations cannot be preclu-

ded entirely, we cannot guarantee full agreement. However, the data in

this manual are reviewed regularly and any necessary corrections inc-

luded in subsequent editions. Suggestions for improvement are welco-

med.

Siemens AG

Automation and Drives Group

Industrial Automation Systems

P.O.Box 4848, D- 90327 Nuremberg

System Software for M7-300 and M7-400, System and Standard Functions, Volume 1

C79000–G7076–C852–02

Siemens AG 1998

Technical data subject to change.

Index-2

Siemens Aktiengesellschaft

C79000–G7076–C852–02

SIMATIC

Preface

Purpose

This manual supports you when programming M7 300 and M7 400 automa-

tion computers in C under the M7 RMOS32 operating system. It provides

you with detailed information on the range of functions for the call interface

of M7 RMOS32. The information contained in the manual includes:

Notations and data types

Functional classification of the various calls

Data structures used

Error codes and messages

Detailed information on the function calls

Audience

This manual is intended primarily for C programmers of M7 300 and M7 400

automation computers.

Scope of this Ma-

nual

This manual is valid for M7 300 and M7 400 automation computers with the

system software M7–SYS RT from V 4.0.

Scope of the

Documentation

Package

The system software for automation computers M7 300 and M7 400 with M7

RMOS32 is documented in several manuals, which can be ordered separately

from each product. The manuals are listed in the following table.

Manual

Contents

System Software for M7-300/400

Installation and Operation, User

Manual

Installation and operation of M7-300/400 automation

computers.

System Software for M7-300/400

Program Design,

Programming Manual

Design and creation of C/C++ programs

System Software for M7-300/400

System and Standard

Functions, Reference Manual

Detailed information for programming with M7

RMOS32.

System Software for M7-300/400

Writing Loadable Drivers

Electronic Manual

Designing and writing loadable device drivers for

M7 RMOS32, programming and reference informa-

tion.

System Software for M7-300 and M7–400, System and Standard Functions, Volume 1

C79000–G7076–C852–02

iii

Preface

How to Use this

Manual

This Reference Manual supports you primarily when programming applica-

tions for M7 RMOS32. It is your main reference document for programming,

testing and checking the source code. The manual is divided into two volu-

mes containing the following:

Volume 1

Function groups

Chapter 1 p rovides an introduction and presents the programming functions

in logical order. If you are looking for a function to perform a specific task,

you can find it here.

This chapter also describes the conditions required for the use of the individ-

ual groups of calls. You will find a detailed description of the individual

functions in Chapter s 5 a n d 6 o f Volume 1 and Chapters 1 to 3 of Volume 2 .

Type identifiers

The second chapter contains the main type identifiers used when program-

ming. It lists the identifiers for the system messages, S7 objects and data

types used.

Data structures

The third chapter describes the data structures used in the RMOS API, M7

API and socket calls.

Error codes and messages

The fourth chapter explains the error codes and messages returned by the M7

RMOS32 kernel and the individual function calls.

Description of the function calls

Chapters 5 a n d 6 p rovide a detailed description, in alphabetical order, of the

M7 API and RMOS API calls.

Volume 2

Libraries

Chapters 1, 2 and 3 provide a detailed description, in alphabetical order, of

the C runtime librarycalls, the socket library calls and miscellaneous function

calls.

Index

Each volume contains an index which helps you to find text relating to im-

portant topics quickly.

Manual and Online

Help

This manual is available both in printed form and in electronic format as part

of the SIMATC Manual Collection. Its contents is also available in the on-

line help file M7SYS40B.HLP in the S7BIN directory of STEP 7. You can

include this file in the search range of the OpenHelp function of the Borland

IDE for context–sensitive support during programming.

System Software for M7-300 and M7–400, System and Standard Functions, Volume 1

C79000–G7076–C852–02

Preface

Feedback

We need your help to enable us to provide you and future M7-SYS users with

optimum documentation. If you have any questions or comments on this

manual or the online help , please fill in the remarks form at the end of the

manual and return it to the address shown on the form. We would be grateful

if you could also take the time to answer the questions giving your personal

opinion of the manual.

SIMATIC Customer

Support Hotline

Contactable worldwide round the clock:

Nuremberg

Johnson City

Singapore

Simatic Basic Hotline

Nuremberg

SIMATIC BASIC Hotline

Johnson City

SIMATIC BASIC Hotline

Local time: Mo.-Fr. 8:00 to 18:00

Phone:

+49 (911) 895-7000

Local time: Mo.-Fr. 8:00 to 17:00

Phone:

+1 423 461-2522

Fax:

+49 (911) 895-7002

Fax:

+1 423 461-2231

E-Mail:

simatic.support@

nbgm.siemens.de

E-Mail:

simatic.hotline@

sea.siemens.com

SIMATIC Premium Hotline

(Calls billed, only with

SIMATIC Card)

Time:

Mo.-Fr. 0:00 to 24:00

Singapore

SIMATIC BASIC Hotline

Local time: Mo.-Fr. 8:30 to 17:30

Phone:

+65 740-7000

Phone:

+49 (911) 895-7777

Fax:

+65 740-7001

Fax:

+49 (911) 895-7001

E-Mail:

simatic@

singnet.com.sg

System Software for M7-300 and M7–400, System and Standard Functions, Volume 1

C79000–G7076–C852–02

Plik z chomika:

Inne pliki z tego folderu:

Inne foldery tego chomika: