CSM-MassData-Parameter-Support - GitLite

KO | EN

gitlite — search

#open-source #codex #database #python #windows #android #nodejs #java #pdf #animation

CSM-MassData-Parameter-Support

(★ 19)

Addon for Data support of Communicable State Machine(CSM)

File Explorer

ZIP Download

- - labview-ci.yml
- settings.json
- - README.md
- - README.md
- - DataSimulateModule.vi
  - Main.vi
- - csm_massdata.py
  - README.md
- CSM MassData APIOnly.lvproj
- MassData Parameter Support Demo.vi
- Test Data Type.vi
- test.vi
- - CSM - Config MassData Parameter Cache Size.vi
  - CSM - Convert Argument to MassData.vim
  - CSM - Convert MassData to Argument With DataType.vim
  - CSM - Convert MassData to Argument.vim
  - CSM - MassData Data Type String.vi
  - CSM - MassData Parameter Status.vi
  - CSM MassData Parameter Support.lvlib
  - dir.mnu
- MassData Argument.mnu
- CSM-MassData Cache Status Viewer.vi
- 1. MassData Argument Format.vi
- 2. Show MassData Cache Status in FP.vi
- 3. MassData in Non-CSM Framework.vi
- 4. MassData in CSM.vi
.gitignore
.markdownlint.json
CSM-MassData-Parameter-Support.lvproj
CSM-MassData-Parameter-Support.vipb
DEV ENVIRONMENT LabVIEW 2017
LICENSE
README(zh-cn).md
README.md

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

Command Glossary

Commands referenced in this DOCs, explained below.

🔍

`size`

View Details ▼

Display the sizes of sections inside binary files.

size {{path/to/file}}

Display the size of sections in a given object or executable file:

size {{[-o|--radix=8]}} {{path/to/file}}

Display the size of sections in a given object or executable file in [o]ctal:

size {{[-d|--radix=10]}} {{path/to/file}}

Display the size of sections in a given object or executable file in [d]ecimal:

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[English](./README.md) | [中文](./README(zh-cn).md)

[![Image](https://www.vipm.io/package/nevstop_lib_csm_massdata_parameter_support/badge.svg?metric=installs)](https://www.vipm.io/package/nevstop_lib_csm_massdata_parameter_support/)
[![Image](https://www.vipm.io/package/nevstop_lib_csm_massdata_parameter_support/badge.svg?metric=stars)](https://www.vipm.io/package/nevstop_lib_csm_massdata_parameter_support/)
[![GitHub all releases](https://img.shields.io/github/downloads/NEVSTOP-LAB/CSM-MassData-Parameter-Support/total)](https://github.com/NEVSTOP-LAB/CSM-MassData-Parameter-Support/releases)

## Overview

CSM-MassData-Parameter-Support is an add-on for the Communicable State Machine (CSM) framework that enables efficient transfer of large datasets between CSM modules. Instead of encoding large data directly into the API string, it uses a reference mechanism to pass data by reference, overcoming the limitations of API strings for large data transfer.

## Why MassData Support?

In LabVIEW test and measurement applications, handling large data types such as waveforms and 1D/2D arrays is common, especially in high-sampling-rate and multi-channel systems. Transferring such data using traditional API string encoding is inefficient due to:

- Extra memory overhead from plaintext encoding
- Performance cost of encoding/decoding large data
- Excessive log noise that degrades debug readability

## How It Works

MassData Support is based on the following principle:

1. **Encode**: Convert large data into a compact reference string ("address") instead of encoding the data inline
2. **Transmit**: Send the reference string through CSM's invisible bus
3. **Decode**: The receiving CSM module uses the reference string to retrieve the original data

The reference string contains three fields — `flag`, `start position`, and `size` — which together act as a locator for the actual data stored in a shared memory buffer.

## Key Benefits

1. **Efficient Transmission**: Only a compact reference string is transferred, avoiding full data copies
2. **Memory Efficient**: Large data is stored once regardless of the number of receivers
3. **Cleaner Logs**: Compact reference strings keep CSM log output concise and readable

## Data Lifecycle

- MassData uses a circular buffer internally
- When the buffer is full, new data overwrites old data from the beginning
- Overwritten data cannot be recovered; decoding will fail
- All CSM modules in the same application share the same MassData buffer

## Best Practices

1. **Avoid Long-Lived Data**: Do not use MassData for data that must persist indefinitely
2. **Set an Appropriate Cache Size**: Use `Config MassData Parameter Cache Size.vi` to configure the buffer size
   - Too large wastes memory
   - Too small causes frequent overwrites
3. **Monitor Cache Usage**: Use the provided debugging tools to observe cache usage and tune the configuration

## Installation

Install via VIPM (VI Package Manager). After installation, find it in the CSM add-ons palette.

## Usage

1. Use encoding VIs to convert large data into MassData arguments
2. Pass these arguments between CSM modules via CSM's parameter passing mechanism
3. Use decoding VIs at the receiving end to retrieve the original data

## Examples

See the example folder for demonstrations of:

1. MassData argument format
2. Displaying MassData cache status on the front panel
3. Using MassData in non-CSM frameworks
4. Using MassData with CSM

## Development Environment

LabVIEW 2017 or later

## License

This project is licensed under the MIT License — see the LICENSE file for details.