CatNet Systems CH-1 Help
|
General Introduction Toolbar Device Tree Tutorial User Groups Users Templates Control Points Graphics Viewing Editing Components Schedules Viewing/Editing Trends Viewing/Editing Alarms Viewing Editing Runtimes Viewing Editing Calculations Viewing/Editing |
LonWorks Point Addressing LonWorks addressing supports three separate modes: Mode 1
Mode 1 is the standard mode and can be used with the majority of LonWorks points.
The format is: 1,NVindex,SNVT NVindex = The Network Variable Index of the point. SNVT = The Standard Network Variable Type of the point. Example: 1,15,9 Mode=1, NV index=15, SVNT=9 (count_inc) Mode 2
Mode 2 is the most flexible, but also the most complicated. It is used to access non-standard data structures, or individual elements of standard data structures.
Many systems will not need to use this addressing mode and it can usually be ignored because most points can be imported with a point scan or an XIF file import. The format is: 2,NVindex,SNVT,Offset,DataType,[Extra] NVindex = The Network Variable Index of the point. SNVT = The Standard Network Variable Type to use when converting the data. Offset = This is the offset (starting at 0) of the data within the data structure returned by the device DataType = The raw data type of the data. See below for a list of supported data types. [Extra] = Extra data required only if the data type is ASCII/International String or BitField Supported data types are:
Examples: 2,12,9,4,0 Mode=2, NV index=12, SVNT=9 (count_inc), Offset=4, DataType=0 (unsigned short) This example will read the data structure at NV Index 12, take a single byte (DataType 0) starting at byte 4 in the structure, and convert it to a value of type count_inc (SNVT 9). 2,23,48,9,4 Mode=2, NV index=23, SVNT=48 (amp_f), Offset=9, DataType=4 (floating point) This example will read the data structure at NV Index 23, take 4 bytes (DataType 4) starting at byte 9 in the structure, and convert it to a floating point value (SNVT 48). 2,18,0,14,1,12 Mode=2, NV index=18, SVNT=0 (no conversion), Offset=14, DataType=0 (unsigned short), Extra=12 This example will read the data structure at NV Index 18, take 1 byte (DataType 0) starting at byte 14 in the structure, and convert it to a raw integer value (SNVT 0, no conversion) Bit Field Notes: Bits are numbered from right to left. Bit 0 is the right-most, or least-significant bit. For bit field data types the "Extra" value should be an 8-bit mask to logically AND with the raw data byte. The result is always returned right-shifted to the lowest significant bit. For example, with a bit mask of 12 (binary 00001100), the resulting value would always be between 0 and 3 because after the AND operation the result is right-shifted twice. If the user changes the value it is automatically left-shifted twice, then AND/OR'd back in to the original raw data before it is sent to the device. This allows the point to always be treated as an integer value and avoids any manual shifting of bits. As another example, if a single byte in the structure contains the status of 8 relays and you want a point for the status of just relay 5, the mask would be 16 (binary 00010000). After the data is read from the device, the value of the point will be 0 or 1 to reflect the state of the relay. The best way to calculate a mask is to determine which bits are significant and use the Windows calculator to translate it to a decimal value (the calculator may need to be changed to "scientific" mode). String Notes: For string data types the "Extra" value should be set to the maximum length of the string, including the NULL terminator. Mode 3
Mode 3 is only used with custom device modules. All available points will be imported during a device point scan so the format is very simple and inflexible.
The format is: 3,pointName pointName=The point name assigned to the point by the device module. Supported SNVTs
Below is a list of supported Standard Network Variable Types. See documentation from Echelon for more information about these SNVTs.1 - amp 2 - amp_mil 3 - angle 4 - angle_vel 5 - btu_kilo 6 - btu_mega 7 - char_ascii 8 - count 9 - count_inc 10 - date_cal 11 - date_day 12 - date_time 13 - elec_kwh 14 - elec_whr 15 - flow 16 - flow_mil 17 - length 18 - length_kilo 19 - length_micr 20 - length_mil 21 - lev_cont 22 - lev_disc 23 - mass 24 - mass_kilo 25 - mass_mega 26 - mass_mil 27 - power 28 - power_kilo 29 - ppm 30 - press 31 - res 32 - res_kilo 33 - sound_db 34 - speed 35 - speed_mil 36 - str_asc 37 - str_int 38 - telcom 39 - temp 40 - time_passed 41 - vol 42 - vol_kilo 43 - vol_mil 44 - volt 45 - volt_dbmv 46 - volt_kilo 47 - volt_mil 48 - amp_f 49 - angle_f 50 - angle_vel_f 51 - count_f 52 - count_inc_f 53 - flow_f 54 - length_f 55 - lev_cont_f 56 - mass_f 57 - power_f 58 - ppm_f 59 - press_f 60 - res_f 61 - sound_db_f 62 - speed_f 63 - temp_f 64 - time_f 65 - vol_f 66 - volt_f 67 - btu_f 68 - elec_whr_f 69 - config_src 70 - color 71 - grammage 72 - grammage_f 73 - file_req 74 - file_status 75 - freq_f 76 - freq_hz 77 - freq_kilohz 78 - freq_milhz 79 - lux 80 - ISO_7811 81 - lev_percent 82 - multiplier 83 - state 84 - time_stamp 85 - zero_span 86 - magcard 87 - elapsed_tm 88 - alarm 89 - currency 90 - file_pos 91 - muldiv 92 - obj_request 93 - obj_status 94 - preset 95 - switch 96 - trans_table 97 - override 98 - pwr_fact 99 - pwr_fact_f 100 - density 101 - density_f 102 - rpm 103 - hvac_emerg 104 - angle_deg 105 - temp_p 106 - temp_setpt 107 - time_sec 108 - hvac_mode 109 - occupancy 110 - area 111 - havc_overid 112 - havc_status 113 - press_p 114 - address 115 - scene 116 - scene_cfg 117 - setting 118 - evap_state 119 - therm_mode 120 - defr_mode 121 - defr_term 122 - defr_state 123 - time_min 124 - time_hour 125 - ph 126 - ph_f 127 - chlr_status 128 - tod_event 129 - smo_obscur 130 - fire_test 131 - temp_ror 132 - fire_init 133 - fire_indcte 134 - time_zone 135 - earth_pos 136 - reg_val 137 - reg_val_ts 138 - volt_ac 139 - amp_ac 140 - reserved140 141 - reserved141 142 - reserved142 143 - turbidity 144 - turbidity_f 145 - hvac_type 146 - elec_kwh_l 147 - temp_diff_p 148 - ctrl_req 149 - ctrl_resp 150 - ptz 151 - privacyzone 152 - pos_ctrl 153 - enthalpy 154 - gfci_status 155 - motor_state 156 - pumpset_mn 157 - ex_control 158 - pumpset_sn 159 - pump_sensor 160 - abs_humid 161 - flow_p 162 - dev_c_mode 163 - valve_mode 164 - alarm_2 165 - state_64 166 - nv_type 167 - reserved167 168 - ent_opmode 169 - ent_state 170 - ent_status 171 - flow_dir 172 - hvac_satsts 173 - dev_status 174 - dev_fault 175 - dev_maint 176 - date_event |
Copyright 2008, CatNet Systems |