Echelon IzoT Resource Editos Instrukcja Użytkownika

078-0508-01ACreate, view, and modify resource definitions forIzoT™ and LONWORKS® applications and devices. IzoTTM Resource Editor’s Guide

2 Introduction to Resource Files Introduction to Resource Files Resource files provide definitions of functional profiles, type definitions, enumera

IzoT Resource Editor User's Guide 3 contain a single value or they can contain a structure or union containing multiple fields (for example, th

4 Introduction to Resource Files text information is contained in separate language files. There is one language file for every language your resou

IzoT Resource Editor User's Guide 5 2 Getting Started This chapter describes how to install and start the IzoT Resource Editor.

6 Getting Started Installing the Resource Editor The IzoT Resource Editor is available as a standalone application, and is also available as part of

IzoT Resource Editor User's Guide 7 Starting the Resource Editor You can use the IzoT Resource Editor to create, modify, and view resource file

IzoT Resource Editor User's Guide 9 3 Using Resource Folders This chapter describes how to use the resource catalog to view all available res

10 Using Resource Folders Introduction to Resource Folders A resource folder is a directory containing one or more resource file sets. You will typ

IzoT Resource Editor User's Guide 11 To view or modify the contents of a resource file set, expand it using the button. When you expand a

ii Echelon, FTXL, LonScanner, LonSupport, LON, LonWorks, Neuron, 3120, 3150, LonMark, LonPoint, LonTalk, NodeBuilder, ShortStack, and the Echelon log

12 Using Resource Folders Adding a Resource Folder You can add a new resource folder to the resource catalog. This makes all resource file sets con

IzoT Resource Editor User's Guide 13 Refreshing the Resource Catalog The resource catalog may get out of sync with the resource files on your c

14 Using Resource Folders example, you can enter “switch” to search for SNVT_switch. Look In The resource catalog, resource folder, resource file se

IzoT Resource Editor User's Guide 15 4 Creating and Modifying a Resource File Set This chapter describes how to create or modify a resource f

16 Creating and Modifying a Resource File Set Creating and Modifying a Resource File Set You can create a new scope 3, 4, 5, or 6 resource file set

IzoT Resource Editor User's Guide 17 3. Enter the following information about the resource file set: Scope/Program ID Locked Prevents modifi

18 Creating and Modifying a Resource File Set Program ID setting is always ignored for resource files and should be cleared. The required values fo

IzoT Resource Editor User's Guide 19 4. Click the File Header tab. 5. Enter the following company information for the resource file se

20 Creating and Modifying a Resource File Set address fields in this tab will not update this string. 6. Click OK. If you are creating a new resou

IzoT Resource Editor User's Guide 21 This dialog allows you to choose a value for each part of the standard program ID. The Program ID field a

IzoT Resource Editor User's Guide iii Table of Contents Preface ...

22 Creating and Modifying a Resource File Set  If you are using a standard functional profile other than functional profiles 0 through 6 and the f

IzoT Resource Editor User's Guide 23 from a list of channel types maintained by the LONMARK association. You can update the list by downloadin

24 Creating and Modifying a Resource File Set any type of device. See the Using the Resource Editor chapter in this document and the Neuron C Progr

IzoT Resource Editor User's Guide 25 5 Creating and Modifying Resources This chapter describes how to define new resources and how to modify

26 Creating and Modifying Resources Introduction to Creating and Modifying Resources You can create and modify any resources within a scope 3, 4, 5

IzoT Resource Editor User's Guide 27 The figure above shows the New or Existing Configuration Property Type dialog. The New Network Variabl

28 Creating and Modifying Resources If you are defining a configuration property type, and the type depends on the type of a network variable that t

IzoT Resource Editor User's Guide 29 SIGNED_SHORT An 8-bit signed integer value. STRUCTURE A structure containing multiple fields. See Creatin

30 Creating and Modifying Resources 6. Enter or link to text to provide a language-dependent name for the type, a language-dependent comment about

IzoT Resource Editor User's Guide 31 raw values between 0 and 255. By changing the scale, it could be used to represent values from 50-305, or

iv Preface Using a Scaling Factor and Unit String ... 61 Using Localized List Separators ...

32 Creating and Modifying Resources Creating and Modifying a Structure or Union NV or CP Type You can create network variable and configuration prop

IzoT Resource Editor User's Guide 33 3. Set Enum Scope to the scope of the resource file set containing the enumeration type. You can selec

34 Creating and Modifying Resources bitfield can contain positive or negative values with negative numbers values stored using twos complement notat

IzoT Resource Editor User's Guide 35 2. Set Type Scope to the scope of the resource file set containing the referenced network variable type.

36 Creating and Modifying Resources 4. Enter the following information about this functional profile in the Member Details pane: Inherit Members

IzoT Resource Editor User's Guide 37 can override them, or add additional network variables and configuration properties. To override an inher

38 Creating and Modifying Resources type. A principal network variable may also be used to assist the network integrator by highlighting the prime

IzoT Resource Editor User's Guide 39 2. Select the new network variable to set options for it. The Members Details pane (rightmost) appears as

40 Creating and Modifying Resources Member numbers may start with a “#” or “|” character. The “#” prefix identifies members within a user functiona

IzoT Resource Editor User's Guide 41 more restrictive than the range restriction for the network variable type. You can enter raw data into t

IzoT Resource Editor User's Guide v Preface This document describes LONMARK resource files and how to use the IzoT Resource Editor to view, cre

42 Creating and Modifying Resources 2. Select the new configuration property to set options for it. The Properties (rightmost) pane appears as fol

IzoT Resource Editor User's Guide 43 identifies member numbers in a scope 0 profile, both for scope 0 profiles as well as profiles with members

44 Creating and Modifying Resources applies to a network variable, Applies To also specifies the specific network variable. If the configuration pro

IzoT Resource Editor User's Guide 45 It is possible that cascading resource file sets will contain resources using the same name. For example,

46 Creating and Modifying Resources 2. Enter or change the name of the enumeration type in Tag Name. This name is called the tag name. By conve

IzoT Resource Editor User's Guide 47 Member The name of the enumerator. The name must be unique for all enumeration types that may be used in

48 Creating and Modifying Resources Creating and Modifying a Language String You can create and edit language strings that may be referenced by ne

IzoT Resource Editor User's Guide 49 selected language resource file. See Setting Resource Editor Options for information about setting the ac

50 Creating and Modifying Resources The title of the field may vary (this one is intended for entering comments about the resource file element be

IzoT Resource Editor User's Guide 51 2. Type a string into Highlight Strings Containing This Text to have all strings containing the specifie

vi Preface Purpose This document describes resource files and how to use the IzoT Resource Editor to view, create, and modify them. Audience This

52 Creating and Modifying Resources You can also search for a language string when using the Link button in the Strings tab when creating or modify

IzoT Resource Editor User's Guide 53 Creating, Modifying, and Translating a Language File You can create a new language file to hold language s

54 Creating and Modifying Resources This figure shows the American English language resource file for the Echelon resource file set. 3. In the T

IzoT Resource Editor User's Guide 55 You can export the selected language files to text files for use by translation services. To export the s

56 Creating and Modifying Resources 3. Enter the following information: Network Variables Creates a network variable format. Configuration Prop

IzoT Resource Editor User's Guide 57 network variable or configuration property type, but may not always conform to ANSI C language syntax. Mod

58 Creating and Modifying Resources int — The value will be displayed or entered as a signed, 32-bit integer. discrete — The value will be displayed

IzoT Resource Editor User's Guide 59 EXAMPLE 1: A simple integer that does not require localization, with a “%d” decimal conversion specificati

60 Creating and Modifying Resources <text format list> = <text format list> ',' <text format> = <text format> &l

IzoT Resource Editor User's Guide 61 long, bitfield, or enum. You can use a backslash (‘\’) character as an escape character to include other f

IzoT Resource Editor User's Guide vii LONMARK SNVT and SCPT Guide Documents the standard network variable types (SNVTs), standard configuratio

62 Creating and Modifying Resources Following are example formats using scaling factors. EXAMPLE 1: The following format definitions define SI and U

IzoT Resource Editor User's Guide 63 1. The time format specifier does not support AM/PM time formats, so this type of time format will be con

64 Creating and Modifying Resources reflected in your new profile. See Creating and Editing a Functional Profile for more information. Removing and

IzoT Resource Editor User's Guide 65 all deleted resources from the resource file. You must be careful not to purge a resource file that conta

66 Creating and Modifying Resources File Type Format Version Format Changes Minimum Required Resource File API Functional Profile 1 Initial release.

IzoT Resource Editor User's Guide 67 To convert the format of a resource file, follow these steps: 1. Click the Windows Start button, point to

68 Creating and Modifying Resources 6. Click Convert. You may choose to convert and purge a resource file set at the same time. In this case, the

IzoT Resource Editor User's Guide 69 6 Generating Resource Files This chapter describes how to generate resource files once you have made cha

70 Generating Resource Files Generating Resource Files You can generate a resource file set at any time while editing a resource file set. If you h

IzoT Resource Editor User's Guide 71 This dialog displays the current versions of the type file, functional profile file, and the language fi

viii Preface Region Languages Supported Contact Information Japan Japanese Echelon Japan Holland Hills Mori Tower, 18F 5-11-2 Toranomon, Minato-ku

72 Generating Resource Files See the Resource Report Generator User’s Guide for more information on creating resource reports, available from the Wi

IzoT Resource Editor User's Guide 73 Appendix A Language File Extensions This appendix lists the file extensions used for language files.

74 Appendix A: Language File Extensions Language File Extensions Network variable types, configuration property types, functional profiles, and enum

IzoT Resource Editor User's Guide 75 Appendix B NodeBuilder Resource Editor Software License Agreement When installing the NodeBuilder Resourc

76 Appendix B: NodeBuilder Resource Editor Software License Agreement NodeBuilder® Resource Editor NOTICE This is a legal agreement between you and

IzoT Resource Editor User's Guide 77  “Standard Resource File” means a Resource File included as part of the Licensed Software.  “User Reso

78 Appendix B: NodeBuilder Resource Editor Software License Agreement This license is not a sale. Title, copyrights and all other rights to the Li

IzoT Resource Editor User's Guide 79 THE SUPPLY OR USE OF THE LICENSED SOFTWARE, HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY (INCLUDING WITHO

80 Appendix B: NodeBuilder Resource Editor Software License Agreement SUPPORT You acknowledge that You shall either (i) inform the end-user that Yo

IzoT Resource Editor User's Guide 81 Licensor is Echelon Corporation, 550 Meridian Avenue, San Jose, CA 95126. If You are not a LONMARK Member

IzoT Resource Editor User's Guide 1 1 Introduction to Resource Files This chapter presents an introduction to resource files. It describes th