PakBus Networking Guide Revision: 10/08 C o p y r i g h t © 2 0 0 4 - 2 0 0 8 C a m p b e l l S c i e n t i f i c , I n c .
PakBus Networking Guide Table of Contents PDF viewers note: These page numbers refer to the printed version of this document. Use the Adobe Acrobat® bookmarks tab for links to specific sections. 1. Introduction..................................................................1 2. PakBus Network Terminology ....................................1 3. PakBus Concepts ........................................................3 3.1 3.2 3.3 3.4 Protocol Description ..................................................
This is a blank page.
PakBus Networking Guide 1. Introduction PakBus® describes a proprietary family of protocols created by Campbell Scientific, Inc. for communication between connected devices. Similar in many ways to TCP/IP, PakBus is a packet-switched network protocol with routing capabilities. These data communication packets contain a header, a message body, and an error-checking segment.
PakBus Networking Guide Beacon: A broadcast message sent over the network by a node. All PakBus devices must respond to a beacon by initiating a hello exchange unless an allowed neighbor list prohibits communication with that node. Beacon Interval: The interval specifying the rate at which beacons will be issued to the network by a PakBus node. Destination Address: The PakBus address of the node where a packet is being sent. Hello Exchange: The process of verifying a node as a neighbor.
PakBus Networking Guide Routing Table: A list of the most direct routes between nodes on the network. Routers calculate the most direct path between nodes based on the hop metrics of the available routes. Source Address: The PakBus address of the node sending the packet. Verify Interval (Communication Verification Interval or CVI): The interval at which communication must occur between established neighbors to maintain the list of known neighbor routes.
PakBus Networking Guide 1 byte Header (8 bytes) Message (0...
PakBus Networking Guide the allowed neighbor list can be set in a datalogger to limit communication between devices. Allowed neighbor lists specify neighbors to which a datalogger will respond and cause it to ignore all other devices. However, packets sent from a neighbor with a PakBus address greater than or equal to 4000 can not be filtered or ignored even if an allowed neighbor list has been declared in a datalogger.
PakBus Networking Guide 3.3 Routers A router is a PakBus device that can accept a packet and forward it toward its ultimate network destination. Routing is fundamentally driven by the router’s ability to learn about neighbors and the sharing of that information with other routers in the network. When a change occurs in a router on the network, that router will exchange the new neighbor information with other known routers.
PakBus Networking Guide paths and possibly using marginal routes of communication. The PakBus address and the communication interface of the neighbor device in the allowed neighbor list must be entered correctly for discovery to work. If communication fails to a node declared in an allowed neighbor list, the datalogger will continually attempt communication to that node until it is discovered with a successful hello exchange.
PakBus Networking Guide 3.6 Concurrent Communication The packets in PakBus networking are small and the communication links are only active for a short period of time while the packet is being transmitted. Longer messages can be broken into several smaller packets and sent individually between devices. Since these packets do not require a dedicated link, other related or unrelated packets can be sent over the same link at approximately the same time.
PakBus Networking Guide neighbor added or removed, the router shares that information with other routers on the network at a random interval. When devices establish each other as neighbors, they must also know the port or interface on the device they are using for communication. This port information is included in the list of known neighbor routes.
PakBus Networking Guide 4.1 CRBasic Dataloggers (CR800, CR850, CR1000, and CR3000) PakBus settings for these dataloggers are entered with the Device Configuration Utility, which is used to administer configurable Campbell Scientific devices. Once connected to the datalogger with the Device Configuration Utility, the PakBus address of the datalogger can be set. Keep in mind that each PakBus device in the network must have a unique address.
PakBus Networking Guide 4.2 CR200 Series Datalogger The CR200 Series dataloggers are programmed using the CRBasic editor. However, unlike other CRBasic dataloggers, the CR200 Series has limited memory and requires the datalogger program to be compiled before it is sent to the datalogger. Additionally, the CR200 Series datalogger can only act as a leaf node in a PakBus network. The PakBus settings in the CR200 Series datalogger are entered using the Device Configuration Utility.
PakBus Networking Guide Once connected to the datalogger with the Device Configuration Utility, the PakBus address of the datalogger can be set on the Deployment tab. Other radio settings can be changed on this screen, but there are no other PakBus settings that can be changed using Device Configuration Utility. 4.3 Edlog Dataloggers (CR510-PB, CR10X-PB and CR23X-PB) A PakBus operating system is available for the CR510, CR10X and CR23X dataloggers.
PakBus Networking Guide Since the preferred method of entering PakBus settings is with Device Configuration Utility, the next section describes some of the settings and choices available for these dataloggers. Open the Device Configuration Utility software and connect to the datalogger. Once a connection is established, the PakBus settings for the datalogger can be adjusted.
PakBus Networking Guide 5. PakBus Troubleshooting Tools 5.1 PakBus Graph PakBus Graph is a LoggerNet utility that graphically depicts the devices and connection in a PakBus datalogger network. In PakBus graph, the PakBus devices are represented at least by their PakBus address and by their name if the device has been configured in the LoggerNet Setup screen. Some PakBus settings are viewable and editable through PakBus Graph. Right-clicking on a device in the map will expose available options.
PakBus Networking Guide Open LogView and add a log file for viewing by choosing File | Open Log. If the log file is a low-level log containing PakBus packet information, a filter can be applied to show the packet information in a format that is easier to understand. Select the open low-level log file and choose View | Add PakBus Filter. After the filter has been applied, a split screen will show the low-level log and the translation of that information.
PakBus Networking Guide 16
Appendix A. Entering CR10X-PB PakBus Settings with a Keyboard Display If using a keyboard display to enter PakBus settings, they can be configured using *D settings anytime after downloading a PakBus operating system to the datalogger and either before or after sending the program to the datalogger. Pressing *0 recompiles the datalogger and saves the *D settings to FLASH memory.
Appendix A.
Appendix A. Entering CR10X-PB PakBus Settings with a Keyboard Display *D18 01 :xxxx 02 :xxxx 03 :xxxx 04 :xxxx Enter the interval in seconds for CSDC 7 Enter the interval in seconds for CSDC 8 Enter the interval in seconds for ME Enter the interval in seconds for RS-232 A value of “0” turns off beacons.
Appendix A. Entering CR10X-PB PakBus Settings with a Keyboard Display NOTE A-4 If a “17”, for example, is typed over an existing “02” without first typing “0” and A to enter, the result will be two ports 02 and 17.
This is a blank page.
Campbell Scientific Companies Campbell Scientific, Inc. (CSI) 815 West 1800 North Logan, Utah 84321 UNITED STATES www.campbellsci.com info@campbellsci.com Campbell Scientific Africa Pty. Ltd. (CSAf) PO Box 2450 Somerset West 7129 SOUTH AFRICA www.csafrica.co.za cleroux@csafrica.co.za Campbell Scientific Australia Pty. Ltd. (CSA) PO Box 444 Thuringowa Central QLD 4812 AUSTRALIA www.campbellsci.com.au info@campbellsci.com.au Campbell Scientific do Brazil Ltda.
