Liquid Instruments Moku:go Digital Filter Box User Manual

LIQUID INSTRUMENTS Moku: Go Digital Filter Box

Product Information

Digital Filter Box Moku
The Moku: Go Digital Filter Box is a device that allows users to design and generate different types of infinite impulse response filters with sampling rates of 61.035 kHz, 488.28 kHz and 3.9063 MHz. It offers four filter shapes, namely low pass, high pass, band pass, and band stop filter shapes, with up to eight fully configurable types including Butterworth, Chebyshev, and Elliptic.

The device features a user interface with different configuration options:

User Interface

• Main menu
• Input configuration for Channel 1 and 2
• Control matrix
• Configuration for filters 1 and 2
• Output switch for Channel 1 and 2
• Enable/disable the Oscilloscope view
• Enable/disable the Data Logger view

Main Menu
The main menu can be accessed by pressing the icon in the top-left corner. The following options are available:

• Search for Moku devices.
• Switch instruments on this Moku: Go.
• Save/recall settings: Ctrl+S, Ctrl+O.
• Show the current instrument settings.
• Reset the instrument to its default state: Ctrl+R.
• Access the Power Supply control window.*
• Open the file manager tool.**
• Open file converter tool.**
• Help: Ctrl+H, F1.

Product Usage Instructions

Before using the device, ensure that Moku: Go is fully updated. For the latest information, visit liquidinstruments.com.

To use the Digital Filter Box Moku: Go, follow these steps:

1. Access the main menu by pressing the icon on the top-left corner of the user interface.
2. Select the desired filter shape from the configuration options available.
3. Configure the filter characteristics according to your needs, including sampling rates, filter types, filter orders, ripples, and coefficient quantization.
4. If necessary, you can create a custom filter by selecting the “Custom filter” option and providing the details in the “Custom filter details” section.
5. Select the output switches for Channel 1 and 2 as needed.
6. You can enable or disable the Oscilloscope view and Data Logger view as needed.

For more information on using the device’s additional tools such as the Power Supply control window, file manager tool, and file converter tool, refer to the product user manual.

With the Moku:Go Digital Filter Box, you can interactively design and generate different types of infinite impulse response filters with sampling rates of 61.035 kHz, 488.28 kHz and 3.9063 MHz. Select between low pass, high pass, band pass, and band stop filter shapes with up to eight fully configurable types including Butterworth, Chebyshev, and Elliptic.

User interface

Main menu

The main menu can be accessed by pressing the icon on the top-left corner.

• Power Supply is available on Moku:Go M1 and M2 models. Detailed information about Power Supply can be found in the Moku:Go Power Supply section toward the end of this user manual.
• Detailed information about the file manager and file converter can be found toward the end of this user manual.

Input configuration

The input configuration can be accessed by clicking the or icon, allowing you to adjust the coupling and input attenuation (and therefore voltage range) for each input channel.

Details about the probe points can be found in the Probe Points section.

Control matrix

The control matrix combines, rescales, and redistributes the input signal to the two independent filters. The output vector is the product of the control matrix multiplied by the input vector.

For example, a control matrix equally combines Input 1 and Input 2 to the top Path1 (filter 1), multiples Input 2 by a factor of two, and then sends it to the bottom Path2 (filter 2). The value of each element in the control matrix can be set between -20 to +20 with 0.1 increments when the absolute value is less than 10, or 1 increment when the absolute value is between 10 and 20. Click the element to adjust the value.

Digital filters

The two independent, real-time configurable digital IIR filter paths follow the control matrix in the block diagram, represented in green and purple for filters 1 and 2, respectively.

User interface

Configure IIR filter characteristics

Detailed filter interface

Click the icon to open the full filter view.

Filter shapes
The shape of the filter can be selected by clicking the 4 button. There are four pre-defined filter shapes and a fully customizable filter option.

Sampling rates
Users can select between 3.9063 MHz, 488.28 kHz, or 61.035 kHz of output sampling rate based on the desired corner frequencies. The following table summarizes the lower and upper bounds for each shape of pre-defined filters with different sampling rates:

Filter types
The type of filter can be selected by pressing the 6 button. There are seven pre-defined filter types with user-selectable filter orders from 2 up to 8, depending on the filter shapes.

Filter orders
For single sided filters, the order of the filter can be set to 2, 4, 6, or 8. For double sided filters, the order of the filter can be 2 or 4.

Ripples
Chebyshev I, II, and Elliptic filters have ripples on either passband, stopband, or both. The following table summarize the adjustable range for the passband and stopband ripples for these filter types.

Coefficient quantization
Due to the limited precision with which a coefficient can be digitally represented, quantization error is pronounced at certain IIR filter settings. A red coefficient quantization warning may appear on the bottom of the response plot with a red trace in the transfer function showing the closest achievable filter response to the ideal value in green.

Custom filter
Additionally, you can upload filter coefficients for a custom filter type from the clipboard or a local file. Click the icon to see explanation of the coefficients and file format.

Custom filter details
The Moku:Go Digital Filter Box implements infinite impulse response (IIR) filters using four cascaded Direct Form I second-order stages with a final output gain stage. The total transfer function can be written:

To specify a filter, you must supply a text file containing the filter coefficients. The file should have six coefficients per line, with each line representing a single stage. If output scaling is required, this should be given on the first line:

Each coefficient must be in the range [-4.0,+4.0). Internally, these are represented as signed 48-bit fixed-point numbers, with 45 fractional bits. The output scaling can be up to 8,000,000. Filter coefficients can be computed using signal processing toolboxes in e.g. MATLAB or SciPy. Some coefficients may result in overflow or underflow, which degrade filter performance. Check filter responses prior to use.

Output switches

Connect or disconnect the output signal using switches. When a switch is in the open state, the output signal will be the output offset voltage.

Probe points

The Moku:Go Digital Filter Box has an integrated oscilloscope that can be used to probe the signal at the input, pre-filter, and output stages. Add the probe points by clicking the icon.

Oscilloscope

Detailed instructions for the oscilloscope instrument can be found in the Moku:Go Oscilloscope manual.

Data Logger

The Embedded Data Logger can stream over a network or save data on the Moku. For details, refer to the Data Logger user manual. More streaming information is in our API documents at apis.liquidinstruments.com.

Additional tools

The Moku:
Go app has two built-in file management tools: File Manager and File Converter. The File Manager allows users to download the saved data from Moku:Go to a local computer, with optional file format conversion. The file converter converts the Moku:Go binary (.li) format on the local computer to either .csv, .mat, or .npy format.

File Manager

Once a file is transferred to the local computer, a icon shows up next to the file.

File Converter

The converted file is saved in the same folder as the original file.

Liquid Instruments File Converter has the following menu options:

Power Supply

The Moku:Go Power Supply is available on M1 and M2 models. M1 features a 2-channel Power Supply, while M2 features a 4-channel Power Supply. Access the Power Supply control window in all instruments under the main menu.

The Power Supply operates in two modes: constant voltage (CV) or constant current (CC) mode. For each channel, the user can set a current and voltage limit for the output. Once a load is connected, the Power Supply operates either at the set current or set voltage, whichever comes first. If the Power Supply is voltage limited, it operates in the CV mode. If the Power Supply is current limited, it operates in the CC mode.

Ensure Moku:Go is fully updated. For the latest information, visit: liquidinstruments.com.
Moku:Go Digital Filter Box User Manual

© 2023 Liquid Instruments. All rights reserved.

References

• Moku API Home | Moku API
• Moku API Home | Moku API
• Liquid Instruments
• Liquid Instruments