Movensys.BlackBox.Core 1.0.46

Movensys.BlackBox.Core

A library for collecting motion, digital I/O, and analog I/O status data from WMX3-based systems. It records data in real-time using WMX3��s memory logging feature and saves the data with pre/post trigger conditions. CSV and JSON files are automatically generated for analysis with MotionScope.

Requirements

• .NET Framework 4.5 or later
• WMX3 Runtime must be installed

Features

• Real-time data logging with WMX3 Memory Log
• Configurable monitored axes and I/O channels
• Pre-trigger / Post-trigger data collection support
• Auto-generation of CSV + JSON files compatible with MotionScope
• Launch MotionScope directly with the generated data

Basic Usage Example

using Movensys.BlackBox.Core;
using Movensys.BlackBox.Core.Models;

// Initialization
var blackBox = BlackBoxManager.GetBlackBoxService();
blackBox.CreateDevice();
blackBox.InitMemoryLog();

// Configure axes
blackBox.SetBlackBoxAxes(new List<BlackBoxAxisInfo>
{
    new BlackBoxAxisInfo { AxisIndex = 0, AxisDataType = AxisDataType.CommandPos, Name = "Axis0" },
    new BlackBoxAxisInfo { AxisIndex = 1, AxisDataType = AxisDataType.FeedbackVelocity, Name = "Axis1" },
});

// Configure Digital I/O
blackBox.SetBlackBoxDigitalIO(new List<DigitalIOAddress>
{
    new DigitalIOAddress { Byte = 0, Bit = 0, Name = "Start", Type = IoType.Input },
    new DigitalIOAddress { Byte = 1, Bit = 0, Name = "AlarmReset", Type = IoType.Output }
});

// Start logging
blackBox.SetLoggingCycle(preCycleCount: 10000, postCycleCount: 500);
blackBox.StartBlackBox();

// Trigger occurs
blackBox.SaveBlackBoxData();

// Stop logging after completion
blackBox.StopBlackBox();

// Open MotionScope with saved data
blackBox.StartMotionScope(@"C:\BlackBoxLogs\20250717\BlackBoxData_Alarm.csv");

Log Storage Path

By default, log files are stored in the application��s working directory. You can change the location with SetLogFilePath(). Log files are saved in a date/time-based folder structure and include both CSV data and JSON metadata.

Important Notes

• Requires a valid WMX3 license and driver installation.
• Make sure to call Close() after CreateDevice() to release resources properly.