Moku API Home | Moku APIMoku API Home | Moku API
Liquid InstrumentsLiquid Instruments
User Manual for Liquid Instruments models including: Moku Pro Data Logger, Moku Pro, Data Logger, Logger
Feb 22, 2023 — The Moku:Pro Data Logger instrument records time series voltages from up to four channels at rates from 10 samples per second up to 10 MSa/s.
File Info : application/pdf, 13 Pages, 1.74MB
DocumentDocumentData Logger Moku:Pro User Manual The Moku:Pro Data Logger instrument records time series voltages from up to four channels at rates from 10 samples per second up to 10 MSa/s. The data can be logged to the onboard SSD storage or can be streamed directly to the computer using the Moku API. s The resulting logs can be shared to email or cloud services such as iCloud or Dropbox. The Moku:Pro Data Logger also includes an embedded four-channel waveform generator. V23-0130 liquidinstruments.com 2023 Liquid Instruments. All rights reserved. Table of contents User Interface....................................................................................................................................... 4 Main Menu ............................................................................................................................................ 5 Preferences........................................................................................................................................... 6 Data Logger control panel.................................................................................................................. 7 Sharing and saving data ..................................................................................................................... 8 Settings ................................................................................................................................................. 9 Acquisition 9 Output 10 Instrument Reference......................................................................................................................... 11 Recording a Session 11 Channel Configuration 11 Acquisition Parameters 11 File Types 11 Starting the Log 11 Data streaming 12 Accessing your Data 12 2 | Moku:Pro Data Logger User Manual © 2023 Liquid Instruments. All rights reserved. Ensure Moku:Pro is fully updated. For the latest information, visit: liquidinstruments.com 3 | Moku:Pro Data Logger User Manual © 2023 Liquid Instruments. All rights reserved. User Interface ID Button/icon 1 Main menu 2 Autoscale 3 Ref 4 Time window 5 Settings 6 Clear 7 Signal display 8 Bottom left 9 Grid Description The main menu contains controls for switching instruments, switching devices, selecting device clock and user interface modes, and more. See Main Menu. Toggle continuous autoscaling on/off. Capture/clear a reference trace. Overview of the logging time history. Drag bars to zoom/select different timescales/time windows. Show/hide the settings. Clear the trace history. Data traces are displayed in this area. By default, red represents channel 1, blue represents channel 2, teal represents channel 3, yellow green represents channel 4. Double tap here to view entire log history. Double tap on the grid to on-time autoscale. 4 | Moku:Pro Data Logger User Manual © 2023 Liquid Instruments. All rights reserved. Main Menu The main menu can be accessed by pressing the icon, allowing you to: 5 | Moku:Pro Data Logger User Manual © 2023 Liquid Instruments. All rights reserved. Preferences The preferences pane can be accessed via the main menu. In here, you can reassign the color representations for each channel, connect to Dropbox, etc. Throughout the manual, the default colors (shown in the figure below) are used to present instrument features. ID Description 1 Tap to change the color associated with input channels. 2 Tap to change the color associated with output channels. 3 Tap to change the color associated with math channel. 4 Indicate touch points on the screen with circles. This can be useful for demonstrations. 5 Change the currently linked Dropbox account to which data can be uploaded. 6 Notify when a new version of the app is available. 7 Moku:Pro automatically saves instrument settings when exiting the app, and restores them again at launch. When disabled, all settings will be reset to defaults on launch. 8 Moku:Pro can remember the last used instrument and automatically reconnect to it at launch. When disabled, you will need to manually connect every time. 9 Reset all instruments to their default state. 10 Save and apply settings. 6 | Moku:Pro Data Logger User Manual © 2023 Liquid Instruments. All rights reserved. Data Logger control panel Below the main Data Logger trace display is the control panel ID Button/icon 1 Status 2 Share 3 Memory 4 Mode 5 Filename 6 Comment 7 Start/stop 8 Log format 9 Duration 10 Start 11 Acquisition rate Description Logger status, either idle, aborted, waiting, or logging. The sharing button gives access to controls that allow you to save and share your data. See Saving and sharing data. Displays the used and remaining memory available for logging. Set acquisition mode as normal or precision. Configure the prefix to be used on the data filename. Text entered here will be saved in the file header. Tap to start and top data logging. Tap to select log format, CSV or LI binary format. Tap to set log duration, up to 10,000 hours1. Tap to configure start delay, up to 240 hrs. Tap to configure acquisition rate. 1 Log may not reach this duration, for example if on-board memory becomes full. 7 | Moku:Pro Data Logger User Manual © 2023 Liquid Instruments. All rights reserved. Sharing and saving data Tap the share button to access the file manager, allowing saving and sharing of the captured data logs. Dropbox, Mail, and iCloud service settings are configured in the iPad preferences. ID Button/icon 1 All 2 None 3 Save options Description Tap to select all files. Tap to deselect all files. Tap to share data files to "My Files" or any of these online services. 8 | Moku:Pro Data Logger User Manual © 2023 Liquid Instruments. All rights reserved. Settings Acquisition The acquisition sidebar configures the acquisition parameters of both input channels. The channel 1, channel 2, channel 3, channel 4, and acquisitions sub-panels may be dragged into the main display by tap/hold and dragging. ID Button Description 1 Channels 1 settings Channel 1 (red by default; configurable in main menu preferences), channel 2, channel 3, and channel 4 settings are configurable independently. 2 Coupling Select AC or DC coupling. 3 Impedance Select high 1 M or 50 input impedance. 4 Range Selects the input range, one of 400 mV, 4 V, or 40 V peak-topeak. 58 Channel 2 settings Configure channel 2 as described above for channel 1. 9 Acquisition settings Configure acquisition settings. 10 Rate Adjust the data acquisition rate. 11 Mode Precision, normal. 9 | Moku:Pro Data Logger User Manual © 2023 Liquid Instruments. All rights reserved. Output The Moku:Pro Data Logger has a built-in waveform generator capable of generating basic waveforms on the four output channels. For more complex waveforms, see the Moku:Pro Waveform Generator and Arbitrary Waveform Generator user manuals. ID Button Description 1 Configure channels Tap to configure settings for channels 1 to 4. As illustrated, settings apply to channel 1. 2 Current waveform Graphical representation of the selected waveform. 3 Waveform selection Tap to choose between Sine, Square, Ramp, Pulse, or DC waveforms. 4 Enable Tap to enable/disable channel output. 5 Load Tap to select either 50 or 1 M output load. 6 Waveform parameters Tap to configure the selected waveform parameters varying according the waveform type selected. 10 | Moku:Pro Data Logger User Manual © 2023 Liquid Instruments. All rights reserved. Instrument Reference The Moku:Pro Data Logger is designed to be intuitive and straightforward to use. Up to four channels of time-series voltages are recorded by Moku:Pro, for a specified duration, and at a specified rate. Recording a Session Recording data is done as follows: 1. Configure the channel(s) you wish to record using the acquisition sidebar. Ensure the voltage range, coupling, and impedance are all appropriate for your signals. Use the plotter window to ensure your signal is correctly connected and configured. 2. Configure the acquisition rate and acquisition mode, either normal or precision. 3. Set the recording duration and any comments you want to be saved with the file. 4. Optionally configure the waveform generator outputs. 5. Tap "record". Channel Configuration Each channel can be enabled or disabled, set to a maximum range of 400 mVpp, 4 Vpp, or 40Vpp, AC or DC-coupled, and 50 or 1 M terminated. Acquisition Parameters The acquisition parameters refer to the logging rate and the down-sampling mode used to reduce the Moku:Pro native sampling rate to the logging rate. The logging rate must be between 10 Sa/s and 10 MSa/s. The maximum logging rate is 10 MSa/s for 1 channel, 5 MSa/s for 2 channels, and 2.5 MSa/s for 4 channels. Acquisition mode may be either normal or precision. Normal mode down-samples by discarding points between those needed. This causes signals to alias; not desirable for most signals but can be useful for viewing frequency components outside the logging rate. Precision mode down-samples by averaging, increasing precision and reducing noise. This mode is preferred for most applications. File Types The binary file format is proprietary to Moku:Pro and has been optimized for speed and size. Using the binary format, Moku:Pro is able to reach very high logging rates and very low memory usage. The binary file can be converted to other formats by the iPad app or the file converter software available from the Liquid Instruments website. This software can convert the binary file to CSV, MATLAB, or NPY formats for access in major scientific software. Starting the Log The red record button should be tapped to start. The status indicator at the top of the control panel will display logging progress. 11 | Moku:Pro Data Logger User Manual © 2023 Liquid Instruments. All rights reserved. The log will stop either when the specified duration has been reached, or when the user taps the record button again to abort. Data streaming When configured through the Moku API, the Data Logger can stream over a network, instead of saving directly to the device. More streaming information is in our API documents at apis.liquidinstruments.com. Accessing your Data Data logs can be shared to My Files, Dropbox, Mail, or iCloud. Refer to Sharing and saving data above. 12 | Moku:Pro Data Logger User Manual © 2023 Liquid Instruments. All rights reserved. Ensure Moku:Pro is fully updated. For the latest information, visit: www.liquidinstruments.com 13 | Moku:Pro Data Logger User Manual © 2023 Liquid Instruments. All rights reserved.