Loring Roaster Core Library

A comprehensive .NET library for interfacing with Loring Smart Roast coffee roasting equipment and managing roasting data, recipes, and device communications.

Overview

The Loring Roaster Core Library provides a robust foundation for building applications that interface with Loring's professional coffee roasting equipment. It includes comprehensive support for:

• Device Communication: Modbus TCP/RTU, OPC, Serial, and network protocols
• Recipe Management: Loading, saving, and managing roast profiles and recipes
• Data Acquisition: Real-time data collection and roast logging
• File Format Support: Native Loring file formats (.lrcp, .lcfg, .csv)
• Hardware Abstraction: Unified interface for different roaster models (S15, S35, S70, etc.)

Installation

Install the package via NuGet Package Manager:

dotnet add package roaster_core

Or via Package Manager Console:

Install-Package roaster_core

Quick Start

Basic Device Connection

using roaster_core.InterfaceLibrary.Device;
using roaster_core.InterfaceLibrary.LSRConnections;

// Create a TCP connection to your roaster
var connection = new LSRTCP("192.168.1.100", 502);
var roaster = new Loring2Dot4Roaster(connection);

// Connect and start data acquisition
await roaster.ConnectAsync();
var temperature = roaster.BeanTemperature.Value;

Recipe Management

using roaster_core.FileFormats;

// Load a recipe file
var recipe = Recipe2XBase.LoadFromFile("my-roast-profile.lrcp");

// Access recipe properties
Console.WriteLine($"Recipe: {recipe.RecipeName}");
Console.WriteLine($"Batch Size: {recipe.BatchSize} lbs");

// Modify and save
recipe.Notes = "Updated roast profile";
recipe.SaveToFile("updated-profile.lrcp");

Data Logging

using roaster_core.InterfaceLibrary.DataAq;

// Set up data acquisition engine
var dataEngine = new DA_HBEngineRRCSV(roaster);
dataEngine.StartLogging("roast-log.csv");

// Log data points during roast
dataEngine.LogDataPoint();

Core Components

Device Interface Layer

• DeviceInterface: Base abstraction for all roaster devices
• LSRTCP/LSRSerial: Communication protocol implementations
• Modbus Support: Native Modbus TCP/RTU client implementations

File Format Support

• Recipe2XBase: Loring recipe file (.lrcp) management
• LSR Configuration: Device configuration files (.lcfg)
• CSV Data: Roast Reporter log file parsing and generation

Data Management

• RoastAnnotation: Time-based roast event markers
• ValueAtTimePoint: Temperature and sensor data points
• SignalArrayType: Real-time signal processing

Hardware Abstraction

• HBRoaster: High-level roaster control interface
• TagStore: Unified tag-based data access
• PollingSession: Automatic data collection management

Supported Hardware

• Loring S15: 15kg capacity roasters
• Loring S35: 35kg capacity roasters
• Loring S70: 70kg capacity roasters
• Legacy Models: Support for older firmware versions
• Multiple Protocols: Modbus TCP/RTU, OPC UA, Serial RS-485

Configuration

The library supports multiple configuration approaches:

// Load device configuration
var config = DeviceConfig.LoadFromFile("roaster.config");

// Manual configuration
var roaster = new Loring2Dot4Roaster("192.168.1.100", 502)
{
    PollRate = TimeSpan.FromMilliseconds(500),
    EnableDataLogging = true
};

Advanced Features

• Real-time Data Streaming: Sub-second data acquisition rates
• Recipe Validation: Automatic profile validation and error checking
• Network Discovery: Automatic roaster detection on local networks
• Batch Processing: Support for multi-batch roasting operations
• Extensible Architecture: Plugin-based device support

Documentation

Full API documentation is included with IntelliSense support. Key namespaces:

• roaster_core.FileFormats - File I/O and data structures
• roaster_core.InterfaceLibrary - Device communication
• roaster_core.Managers - High-level control interfaces
• roaster_core.Models - Data models and types

Requirements

• .NET Standard 2.0 or higher
• Windows, Linux, or macOS
• Network connectivity to roaster equipment (for networked models)

Support

This library is designed for integration with Loring Smart Roast equipment. For technical support and documentation:

• Review the comprehensive XML documentation included with the package
• Consult your Loring equipment documentation
• Contact Loring technical support for hardware-specific questions

License

Copyright © 2024-2025 Loring, Inc. All rights reserved.

Loring Smart Roast - Professional Coffee Roasting Solutions