PICO PicoLog CM3 Programmer's Manual

Current data logger
Hide thumbs Also See for PicoLog CM3:

Advertisement

Quick Links

®
PicoLog
CM3
Current Data Logger
Programmer's Guide
plcm3pg r4

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the PicoLog CM3 and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for PICO PicoLog CM3

  • Page 1 ® PicoLog Current Data Logger Programmer's Guide plcm3pg r4...
  • Page 3: Table Of Contents

    6 PLCM3IpDetails ................................8 7 PLCM3OpenUnit ................................9 8 PLCM3OpenUnitViaIp ..............................10 9 PLCM3SetChannel ................................ 11 10 PLCM3SetMains ................................. 12 11 Constants and enumerated types .......................... 13 Index ............................15 Copyright © 2011–2019 Pico Technology Ltd. All rights reserved. plcm3pg r4...
  • Page 5: Introduction

    Usage. The software in this release is for use only with Pico products or with data collected using Pico products. Copyright. Pico Technology Ltd. claims the copyright of, and retains the rights to, all material (software, documents, etc.) contained in this SDK except the example programs.
  • Page 6: Minimum Pc Requirements

    PicoLog are internationally registered trademarks. Minimum PC requirements To ensure that your PicoLog CM3 operates correctly, you must have a computer with at least the minimum system requirements to run one of the supported operating systems, as shown in the following table. The performance of the data logger will be better with a more powerful PC.
  • Page 7: Driver Information

    C; you can use the API with any programming language that supports standard C calls. Two applications can access the PicoLog CM3 at the same time, one through the USB port and one through the Ethernet port, with each application having its own instance of the driver with its own handle. In this configuration, power must be supplied by the USB port and not by Power over Ethernet.
  • Page 8: Plcm3Closeunit

    Driver information PLCM3CloseUnit PICO_STATUS PLCM3CloseUnit int16_t handle This routine disconnects the driver from the device. Arguments: handle, identifies the device to close PicoStatus.h Returns: defined in plcm3pg r4 Copyright © 2011–2019 Pico Technology Ltd. All rights reserved.
  • Page 9: Plcm3Enumerate

    * details, uint32_t * length, PLCM3_COMMUNICATION_TYPE type This routine returns a list of all the attached PicoLog CM3 devices of the specified port type. details, length Arguments: a string buffer to receive a maximum of characters. The string is a comma-separated list of attached devices of the selected type.
  • Page 10: Plcm3Getunitinfo

    The following types are defined in PicoStatus.h: PICO_DRIVER_VERSION PICO_USB_VERSION PICO_HARDWARE_VERSION PICO_VARIANT_INFO PICO_BATCH_AND_SERIAL PICO_CAL_DATE PICO_KERNEL_DRIVER_VERSION PICO_MAC_ADDRESS PicoStatus.h Returns: defined in plcm3pg r4 Copyright © 2011–2019 Pico Technology Ltd. All rights reserved.
  • Page 11: Plcm3Getvalue

    * value, Once you open the driver and define some channels, the driver begins to take continuous readings from the PicoLog CM3. When you call this routine, it immediately sets data to the most recent reading for the specified channel.
  • Page 12: Plcm3Ipdetails

    Can be either of the following types: PLCM3_IDT_GET, to read information from the driver PLCM3_IDT_SET, to write information to the driver PicoStatus.h Returns: defined in plcm3pg r4 Copyright © 2011–2019 Pico Technology Ltd. All rights reserved.
  • Page 13: Plcm3Openunit

    * handle, int8_t * serial This routine obtains a handle for the PicoLog CM3 device with the given serial number. If you wish to use more than one device, you must call the routine once for each of them. handle, Arguments: output: handle of the device that was opened.
  • Page 14: Plcm3Openunitviaip

    Using IP address identification, a device anywhere on the internet or local network can be opened. · Using serial number identification, only a device on the local network can be opened. If you wish to use more than one PicoLog CM3, you must call the routine once for each device. handle, Arguments: output: handle of the device that was opened.
  • Page 15: Plcm3Setchannel

    PLCM3_DATA_TYPES type, This routine configures a single channel of the specified PicoLog CM3. It can be called any time after calling PLCM3OpenUnit. The fewer channels selected, the more frequently they will be updated. Measurement takes around 720 ms per active channel.
  • Page 16: Plcm3Setmains

    This routine is used to inform the driver of the local mains (line) frequency. This helps the driver to filter out electrical noise. handle, Arguments: identifies the device to be configured sixty_hertz, for 50 Hz set to 0; for 60 Hz set to 1 PicoStatus.h Returns: defined in plcm3pg r4 Copyright © 2011–2019 Pico Technology Ltd. All rights reserved.
  • Page 17: Constants And Enumerated Types

    PLCM3_OFF, PLCM3_1_MILLIVOLT, PLCM3_10_MILLIVOLTS, PLCM3_100_MILLIVOLTS, } PLCM3_DATA_TYPES; typedef enum enIpDetailsType PLCM3_IDT_GET, PLCM3_IDT_SET, } PLCM3_IP_DETAILS_TYPE; typedef enum enCommunicationType PLCM3_CT_USB = 0x00000001, PLCM3_CT_ETHERNET = 0x00000002, PLCM3_CT_ALL = 0xFFFFFFFF } COMMUNICATION_TYPE; Copyright © 2011–2019 Pico Technology Ltd. All rights reserved. plcm3pg r4...
  • Page 19: Index

    IP details 8 IP_DETAILS_TYPE type 13 Kernel driver version 6 Legal information 1 Mains frequency 12 Opening a unit 9 PC requirements 2 PLCM3_CHANNELS type 13 PLCM3_DATA_TYPES type 13 PLCM3CloseUnit 4 Copyright © 2011–2019 Pico Technology Ltd. All rights reserved. plcm3pg r4...
  • Page 20 Shanghai 200070 PE19 8YP PR China United Kingdom Tel: +44 (0) 1480 396 395 Tel: +1 800 591 2796 Tel: +86 21 2226-5152 sales@picotech.com sales@picotech.com pico.china@picotech.com support@picotech.com support@picotech.com www.picotech.com plcm3pg r4 2019-11-05 Copyright © 2011–2019 Pico Technology Ltd. All rights reserved.

Table of Contents