FF-900 FS 6.0 Fieldbus Specification Device Description Language

Size: px

Start display at page:

Download "FF-900 FS 6.0 Fieldbus Specification Device Description Language"

Wesley Lindsey
5 years ago
Views:

1 FF-900 FS 6.0 Fieldbus Specification Device Description Language Table of Contents 1 Introduction Scope References Overview Architecture DDL Model Device Description Source Device Description Binary (DD Binary) DDL Usage Design Phase Device Description Tokenizer Device Description Language Introduction Preprocessor Overview Syntax Notation Conventions Item Groupings Item Arrays and Collections Records, Arrays, and Variable Lists Blocks Characteristics Block Attribute Label Block Attribute Parameters Block Attribute Local Parameters Block Attribute Help Block Attribute Parameter Lists Block Attribute Item Lists Block Attribute Charts Block Attribute Lists Block Attribute Graphs Block Attribute Grids Block Attribute Menus Block Attribute Methods Block Attribute Files Block Attribute Plugins Block Attribute Variables Class Variable Attribute Type Variable Attribute Arithmetic Types Display/Edit Format Arithmetic Attributes Minimum/Maximum Value Arithmetic Attributes Scaling Factor Arithmetic Attribute Enumeration Types String Types Index Type Date / Time Types Minimum/Maximum Value Date/Time Attributes Time Format Date/Time Attributes Boolean Type Constant Unit Variable Attribute Handling Variable Attribute Help Variable Attribute Label Variable Attribute Pre/Post Edit Actions Variable Attribute Pre/Post Read Actions Variable Attribute Pre/Post Write Actions Variable Attribute Refresh Actions Variable Attribute Page 4 Fieldbus Foundation

2 Device Description Language Fieldbus Specification FF-900 FS Read/Write Timeout Variable Attributes Validity Variable Attribute Response Codes Variable Attribute Write Mode Variable Attribute Private Variable Attribute Visibility Variable Attribute Height Variable Attribute Width Variable Attribute Default Value Variable Attribute Menus Label Menu Attribute Items Menu Attribute Style Menu Attribute Validity Menu Attribute Visibility Menu Attribute Help Menu Attribute Pre/Post Read Actions Menu Attribute Pre/Post Write Actions Menu Attribute Init Actions Menu Attribute Exit Actions Menu Attribute Edit Displays Edit Items Edit Display Attribute Label Edit Display Attribute Display Items Edit Display Attribute Pre/Post Edit Actions Edit Display Attribute Methods Parameters may be specified using a subset of ANSI C programming language (ANSI/ISO ). Parameters may be passed by value or passed by reference including passing arrays.class Method Attribute Definition Method Attribute Help Method Attribute Label Method Attribute Validity Method Attribute Private Method Attribute Visibility Method Attribute Type Method Attribute Relations Refresh Relation Unit Relation Write-As-One Relation Item Arrays Elements Item Array Attribute Help Item Array Attribute Label Item Array Attribute Validity Item Array Attribute Collections Members Collection Attribute Help Collection Attribute Label Collection Attribute Validity Collection Attribute Visibility Collection Attribute Records Members Record Attribute Help Record Attribute Label Record Attribute Response Codes Record Attribute Validity Record Attribute Write Mode Record Attribute Private Record Attribute Visibility Record Attribute Arrays Type Array Attribute Number of Elements Array Attribute Fieldbus Foundation Page 3

3 FF-900 FS 6.0 Fieldbus Specification Device Description Language Help Array Attribute Label Array Attribute Response Codes Array Attribute Validity Array Attribute Write Mode Array Attribute Private Array Attribute Visibility Array Attribute Variable Lists Members Variable List Attribute Help Variable List Attribute Label Variable List Attribute Response Codes Variable List Attribute Programs Domains Response Codes Axis Label Axis Attribute Help Axis Attribute Minimum Value Axis Attribute Maximum Value Axis Attribute Scaling Axis Attribute Constant Unit Axis Attribute Chart Members Chart Attribute Cycle Time Chart Attribute Height Chart Attribute Width Chart Attribute Help Chart Attribute Label Chart Attribute Length Chart Attribute Type Chart Attribute Validity Chart Attribute Visibility Chart Attribute File Members File Attribute Help File Attribute Label File Attribute Grid Vectors Grid Attribute Height Grid Attribute Width Grid Attribute Handling Grid Attribute Help Grid Attribute Label Grid Attribute Orientation Grid Attribute Validity Grid Attribute Visibility Grid Attribute Graph Members Graph Attribute Height Graph Attribute Width Graph Attribute Cycle Time Graph Attribute Help Graph Attribute Label Graph Attribute X Axis Graph Attribute Validity Graph Attribute Visibility Graph Attribute Image Link Image Attribute Path Image Attribute Validity Image Attribute Help Image Attribute Page 4 Fieldbus Foundation

4 Device Description Language Fieldbus Specification FF-900 FS Label Image Attribute Visibility Image Attribute List Type List Attribute Capacity List Attribute Count List Attribute Help List Attribute Label List Attribute Validity List Attribute Visibility List Attribute Source Members Source Attribute Emphasis Source Attribute Help Source Attribute Label Source Attribute Line Color Source Attribute Line Type Source Attribute Y Axis Source Attribute Init Actions Source Attribute Refresh Actions Source Attribute Exit Actions Source Attribute Validity Source Attribute Visibility Source Attribute Waveform Type Waveform Attribute XY Waveform Type Attribute X Values Waveform XY Type Attribute Y Values Waveform XY Type Attribute Number of Points Waveform XY Type Attribute YT Waveform Type Attribute X Initial Waveform YT Type Attribute X Increment Waveform YT Type Attribute Y Values Waveform YT Type Attribute Number of Points Waveform YT Type Attribute Horizontal Waveform Type Attribute Y Values Waveform Horizontal Type Attribute Vertical Waveform Type Attribute X Values Waveform Vertical Type Attribute Emphasis Waveform Attribute Help Waveform Attribute Label Waveform Attribute Line Type Waveform Attribute Line Color Waveform Attribute Y Axis Waveform Attribute Init Actions Waveform Attribute Exit Actions Waveform Attribute Refresh Actions Waveform Attribute Key Points Waveform Attribute X Values Waveform Key Points Attribute Y Values Waveform Key Points Attribute Handling Waveform Attribute Validity Waveform Attribute Visibility Waveform Attribute Template Default Values Template Attribute Label Template Attribute Help Template Attribute Validity Template Attribute Fieldbus Foundation Page 5

5 FF-900 FS 6.0 Fieldbus Specification Device Description Language 2.29 Plug-in UUID Plug-in Attribute Help Plug-in Attribute Label Plug-in Attribute Validity Plug-in Attribute Visibility Plug-in Attribute Device Description Information Output Redirection (OPEN and CLOSE Keywords) Creating Similar Items (LIKE Keyword) Importing Device Descriptions Importing Items Importing All Items Importing Items of a Specific Type Importing a Specific Item Redefining Blocks Deleting a Block Redefining a Block Redefining Block Attributes Redefining Variables Deleting a Variable Redefining a Variable Redefining Variable Attributes Redefining Records Deleting a Record Redefining a Record Redefining Record Attributes Redefining Item Arrays Deleting an Item Array Redefining an Item Array Redefining Item Array Attributes Redefining Menus Deleting a Menu Redefining a Menu Redefining Menu Attributes Redefining Edit Displays Deleting an Edit Display Redefining an Edit Display Redefining Edit Display Attributes Redefining Methods Deleting a Method Redefining a Method Redefining Method Attributes Redefining Relations Deleting a Refresh Relation Deleting a Unit Relation Deleting a Write As One Relation Redefining a Refresh Relation Redefining a Unit Relation Redefining a Write As One Relation Redefining Arrays Deleting an Array Redefining an Array Redefining Array Attributes Redefining Collections Deleting a Collection Redefining a Collection Redefining Collection Attributes Redefining Variable Lists Deleting a Variable List Redefining a Variable List Redefining Variable List Attributes Redefining Programs Redefining Domains Page 6 Fieldbus Foundation

6 Device Description Language Fieldbus Specification FF-900 FS Redefining Response Codes Deleting a Response Codes Redefining a Response Codes Deleting, Redefining, and Adding Response Codes Redefining Axes Deleting an Axis Redefining a Axis Redefining Axis Attributes Redefining Charts Deleting a Chart Redefining a Chart Redefining Chart Attributes Redefining Files Deleting a File Redefining a File Redefining File Attributes Redefining Graphs Deleting a Graph Redefining a Graph Redefining Graph Attributes Redefining Grids Deleting a Grid Redefining a Grid Redefining Grid Attributes Redefining Images Deleting an Image Redefining an Image Redefining Image Attributes Redefining Lists Deleting a List Redefining a List Redefining List Attributes Redefining Sources Deleting a Source Redefining a Source Redefining Source Attributes Redefining Waveforms Deleting a Waveform Redefining a Waveform Redefining Waveform Attributes Redefining Templates Deleting a Template Redefining a Template Redefining Template Attributes Redefining Plug-ins Deleting a Plug-in Redefining a Plug-in Redefining Plug-in Attributes Conditionals IF Conditional IF-ELSE Conditional Select Conditional References Referencing Items Referencing the Members of a Record Referencing the Elements of an Array Referencing the Members of a Collection Referencing the Elements of an Item Array Referencing the Members of a Variable List Referencing the Members of a File Referencing the Elements of a List Referencing the Members of a Chart Referencing the Members of a Graph Fieldbus Foundation Page 7

7 FF-900 FS 6.0 Fieldbus Specification Device Description Language Referencing the X Axis of a Graph Referencing the Members of a Source Referencing the Y Axis of a Source Referencing the Y Axis of a Waveform Referencing the Bits of a Bit-enumerated Variable Referencing the Parameters of a Block Referencing Local Block Parameters Referencing the Parameter Lists of a Block Referencing the Characteristics of a Block Referencing the Parameters of a Specific Block Referencing the Local Parameters of a Specific Block Referencing the Characteristics of a Specific Block Referencing the Charts of a Specific Block Referencing the Lists of a Specific Block Referencing the Graphs of a Specific Block Referencing the Grids of a Specific Block Referencing the Menus of a Specific Block Referencing the Methods of a Specific Block Referencing the Plug-ins of a Specific Block Expressions Primary Expressions Unary Expressions Binary Expressions Multiplicative Operators Additive Operators Shift Operators Relational Operators Equality Operators Bitwise Operators Logical Operators Strings Specifying a String as a String Literal Specifying a String as a String Variable Specifying a String as a Enumeration Value Specifying a String as a Dictionary Reference Specifying a String as a String Attribute Reference Specifying a String via String Concatenation Lexical Conventions Integer Constants Floating Point Constants String Literals A. Formal DDL Syntax A.1 Device Description A.2 Blocks A.3 Variables A.4 Menus A.5 Edit Displays A.6 Methods A.7 Relations A.8 Item Arrays A.9 Collections A.10 Records A.11 Arrays A.12 Variable Lists A.13 Programs A.14 Domains A.15 Response Codes A.16 Axis A.17 Chart A.18 File Page 8 Fieldbus Foundation

8 Device Description Language Fieldbus Specification FF-900 FS 6.0 A.19 Graph A.20 Grid A.21 Image A.22 List A.23 Source A.24 Waveform A.25 Template A.26 Plugin A.27 References A.28 Imported Device Descriptions A.29 Block Redefinitions A.30 Variable Redefinitions A.31 Menu Redefinitions A.32 Edit Display Redefinitions A.33 Method Redefinitions A.34 Relation Redefinitions A.35 Item Array Redefinitions A.36 Collection Redefinitions A.37 Record Redefinitions A.38 Array Redefinitions A.39 Response Codes Redefinitions A.40 Variable List Redefinitions A.41 Program Redefinitions A.42 Domain Redefinitions A.43 Axis Redefinitions A.44 Chart Redefinitions A.45 File Redefinitions A.46 Graph Redefinitions A.47 Grid redefinitions A.48 Image redefinitions A.49 List redefinitions A.50 Source Redefinitions Waveform Redefinitions A.51 Template Redefinitions A.52 Plug-in Redefinitions A.53 Open and Close A.54 Like A.55 Expressions A.56 Lexical Conventions A.57 List of Keywords B. Method Interpreter and Built-in Function Library B.1 Method Interpreter Architecture B.2 Built-in Function Overview B.2.1 User Interface Built-in Functions B.2.2 Parameter Access Built-in Functions B.2.3 Communications Built-in Functions B.2.4 Translation Built-in Functions B.2.5 Normal Termination Built-in Functions B.2.6 Abnormal Termination Built-in Functions B.2.7 Diagnostic Built-in Functions B.2.8 Scaling Built-in Functions B.2.9 List Built-in Functions B.3 Built-in Function Reference B.3.1 abort_on_all_comm_errors() B.3.2 abort_on_all_response_codes() B.3.3 abort_on_comm_error() B.3.4 abort_on_response_code() B.3.5 abs() Fieldbus Foundation Page 9

9 FF-900 FS 6.0 Fieldbus Specification Device Description Language B.3.6 acos() B.3.7 AddTime() B.3.8 asin() B.3.9 add_abort_method() B.3.10 assign() B.3.11 assign2() B.3.12 atan() B.3.13 BUILD_MESSAGE() B.3.14 cbrt() B.3.15 ceil() B.3.16 cos() B.3.17 cosh() B.3.18 delayfor() B.3.19 delayfor2() B.3.20 DICT_ID() B.3.21 DiffTime() B.3.22 discard_on_exit() B.3.23 display_builtin_error() B.3.24 display_comm_error() B.3.25 display_dynamics() B.3.26 display_dynamics2() B.3.27 display_message() B.3.28 display_message2() B.3.29 display_response_code() B.3.30 drand() B.3.31 dseed() B.3.32 edit_device_value() B.3.33 edit_device_value2() B.3.34 edit_local_value() B.3.35 edit_local_value2() B.3.36 exp() B.3.37 fail_on_all_comm_errors() B.3.38 fail_on_all_response_codes() B.3.39 fail_on_comm_error() B.3.40 fail_on_response_code() B.3.41 floor() B.3.42 fmod() B.3.43 fpclassify() B.3.44 get_acknowledgement() B.3.45 get_acknowledgement2() B.3.46 get_block_instance_by_object_index() B.3.47 get_block_instance_by_tag() B.3.48 get_block_instance_count() B.3.49 get_comm_error() B.3.50 get_comm_error_string() B.3.51 get_date() B.3.52 get_date_lelem() B.3.53 get_date_lelem2() B.3.54 get_date_value() B.3.55 get_date_value2() B.3.56 get_dds_error() B.3.57 get_double() B.3.58 get_double_lelem() B.3.59 get_double_lelem2() B.3.60 get_double_value() B.3.61 get_double_value2() B.3.62 get_float() B.3.63 get_float_lelem() B.3.64 get_float_lelem2() B.3.65 get_float_value() B.3.66 get_float_value2() B.3.67 get_resolve_status() B.3.68 get_response_code() Page Fieldbus Foundation

10 Device Description Language Fieldbus Specification FF-900 FS 6.0 B.3.69 get_response_code_string() B.3.70 get_sel_double() B.3.71 get_sel_double2() B.3.72 get_sel_string() B.3.73 get_signed() B.3.74 get_signed_lelem() B.3.75 get_signed_lelem2() B.3.76 get_signed_value() B.3.77 get_signed_value2() B.3.78 get_status_string() B.3.79 get_stddict_string() B.3.80 get_string() B.3.81 get_string_lelem() B.3.82 get_string_lelem2() B.3.83 get_string_value() B.3.84 get_string_value2() B.3.85 get_unsigned() B.3.86 get_unsigned_lelem() B.3.87 get_unsigned_lelem2() B.3.88 get_unsigned_value() B.3.89 get_unsigned_value2() B.3.90 GetCurrentDate() B.3.91 GetCurrentDateAndTime() B.3.92 GetCurrentTime() B.3.93 is_nan() B.3.94 isoffline() B.3.95 ITEM_ID() B.3.96 ListDeleteElementAt() B.3.97 ListDeleteElementAt2() B.3.98 ListInsert() B.3.99 ListInsert2() B log() B log10() B log2() B Make_Time() B MEMBER_ID() B method_abort() B MenuDisplay() B nan() B nanf() B NaN_value() B pow() B put_date() B put_date_value() B put_date_value2() B put_double() B put_double_value() B put_double_value2() B put_float() B put_float_value() B put_float_value2() B put_signed() B put_signed_value() B put_signed_value2() B put_string() B put_string_value() B put_string_value2() B put_unsigned() B put_unsigned_value() B put_unsigned_value2() B read_value() B read_value2() B remove_abort_method() Fieldbus Foundation Page

11 FF-900 FS 6.0 Fieldbus Specification Device Description Language B remove_all_abort_methods() B resolve_array_ref() B resolve_array_ref2() B resolve_block_ref() B resolve_block_ref2() B resolve_list_ref() B resolve_local_ref() B resolve_local_ref2() B resolve_param_list_ref() B resolve_param_ref() B resolve_param_ref2() B resolve_record_ref() B resolve_record_ref2() B ret_double_value() B ret_double_value2() B ret_float_value() B ret_float_value2() B ret_signed_value() B ret_signed_value2() B ret_unsigned_value() B ret_unsigned_value2() B retry_on_all_comm_errors() B retry_on_all_response_codes() B retry_on_comm_error() B retry_on_response_code() B round() B save_on_exit() B seconds_to_time_value() B select_from_menu() B select_from_menu2() B send_all_values() B send_on_exit() B send_value() B send_value2() B sin() B sinh() B sqrt() B strcmp() B strleft() B strlen() B strlwr() B strmid() B strright() B strstr() B strtrim() B strupr() B tan() B tanh() B TIME_VALUE_to_Hour() B TIME_VALUE_to_Minute() B TIME_VALUE_to_Second() B TIME_VALUE_to_seconds() B TIME_VALUE_to_string() B timet_to_string() B timet_to_time_value() B To_TIME_VALUE() B trunc() C. Builtins Return Codes C.1 Where Builtin Return Codes are Defined C.2 Return Code Descriptions D. Device Description Language Profile D.1 Language Elements Profile Page Fieldbus Foundation

12 Device Description Language Fieldbus Specification FF-900 FS 6.0 D.2 Built-in Functions Profile Fieldbus Foundation Page xiii

Built-in Types of Data

Built-in Types of Data Types A data type is set of values and a set of operations defined on those values Python supports several built-in data types: int (for integers), float (for floating-point numbers),