ccn-CcnDevice
Figure 3. CcnDevice properties
To access these properties, expand and double-click CcnDevice.
In addition to the standard driver properties (Status, Enabled, Health, Fault Cause), these properties are unique to this component.
| Property | Value | Description |
|---|---|---|
| Bus No | number | Defines the network bus on which the device is installed. |
| Elem No | number | Defines the element address of the device. |
| Device Name | text | Sets up the device name. |
| Pic Type | read-only | Reports the Pic Type retrieved from the device with the fetch command. |
| Application Version | read-only | Reports the app version retrieved from the device with the fetch command. |
| Device Status | read-only | Reports the current condition of the device (online or offline). |
| Device Description | read-only | Reports the device description retrieved from the device with the fetch command. |
| Location | Reports the device location retrieved from the device with the fetch command. | |
| Part No | read-only | Reports the device part number retrieved with the fetch command. |
| Model No | read-only | Reports the device model number retrieved from the device with the fetch command. |
| Serial No | Reports the device serial number retrieved from the device with the fetch command. | |
| Reference No | read-only | Reports a number retrieved from the device with the fetch command. |
| Platform No | read-only | Reports a number retrieved from the device with the fetch command. |
| Os Version | read-only | Reports the current version of the operating system as retrieved from the device with the fetch command. |
| Device Type | read-only | Reports the type of device (Bridge or NonBridge). |
| Primary Baud Rate | read-only | Reports the baud rate as retrieved from the device with the fetch command. |
| Secondary Baud Rate | read-only | Reports a second baud rate retrieved from the device with the fetch command. |
| Max Table Number | number | Identifies the device using a number. This is beneficial, because it shortens the discovery job. Some devices do not support
the technique used to automatically learn the Max Table Number, so you may enter this value if you know it.
|
| Table Learn Count | read-only | Reports the number of tables discovered during latest discovery job. |
| Learn Status | read-only | Reports the status of the network-level learn command (busy, idle or error).
|
| Table Create Count | read-only | Reports the number of tables created during the latest create process. |
| Debug On | true or false (default)
|
Turns debugging on (true) and off (false).
|
| Debug Discovery On | true or false (default)
|
Turns debugging during a discovery job on (true) and off (false).
|
| Device Time | read-only | Reports the latest device date and time as returned in response to a query of the device’s Date Time Table sent by the ping
process.
Device date and time are not used for any purpose other than a short and quick message to perform a device status check, so if they are not current and the next property (Device Ping Status) indicates “skipped, not needed as the last ping communicated the child object." This is a good sign in that adequate successful comm activity is occurring and the Device Ping that updates Device Time is not required to run. |
| Device Ping Status | read-only | Reports the success or failure status of the device ping.
The ping process alternately retrieves the date and the time block. A success message would be: "succeeded and parsed date from ping message" "succeeded and parsed time from ping message" "skipped, not needed since child object communicated since last ping" "received date response but with NAK" "received time response but with NAK" ** The NAK response means the specific device does not maintain date and/or time data. Failure messages would be:"skipped, device is out of service" "failed, no response to date request" "failed, no response to time request" "could not complete last ping:" |
| Ccn Device Enabled | true or false (default)
|
Turns the connection to the device on (true) and off (false).
|
| Is Enhanced Version | read-only | Indicates if the controller license designates this device as enhanced or not.
If enhanced, access to configuration table data is supported. If not enhanced, access is limited to Display, Setpoint, and Time Schedule Data. |
| Status Display | true or false (default)
|
Enables (true) and disables (false) the status display.
|
| User Configuration | true or false (default)
|
Enables (true) and disables (false) the use of configuration settings to discover proxy points.
|
| Maintenance | true or false (default)
|
Enables (true) and disables (false) the use of maintenance information in the point discovery job.
|
| Service Configuration | true or false (default)
|
Enables (true) and disables (false) the use of service information in the point discovery job.
|
| Set Points | true or false (default)
|
Enables (true) and disables (false) the use of point values in the discovery job.
|
| Time Schedules | true or false (default)
|
Enables (true) and disables (false) the use of time schedules in the point discovery job.
|
| Alarm History | true or false (default)
|
Enables (true) and disables (false) the use of alarm conditions in the point discovery job.
|
| Holiday | true or false (default)
|
Enables (true) and disables (false) the use of holidays in the point discovery job.
|
CcnDevice Actions
Ping accesses the CCN device and updates device the ping status properties.
Upload uploads a list of CcnTables blocks from a CcnDevice’s, CcnPicTables, CcnPocTables, CcnDataTables and CcnFidTables and updates all Station resident data to match the data retrieved from the field device.
Download constructs each CCN device’s non-real-time table’s value blocks from the station-resident data into CcnPicTables, CcnPocTables, CcnDataTables and CcnFidTables and downloads the tables to the field device.
Fetch retrieves additional information from the device when you manually add a new device with the correct bus and element numbers.