Skip to main content

CN1 SDK Framework Guide

The CN1 SDK is a collection of libraries to make interoperability between different file formats easier to handle in an FMIS. The documentation for the SDK has been included in full with your download.

CN1 is the file format generated by the Case IH Pro 700 and the New Holland IntelliView IV displays.

Download Latest​

The latest version is 5.0.0 and was released on 08/12/2026. Supports .Net Standard 2.0.

Version Details​

Changes across versions are listed below.

5.0.0​

Getting Started / Usage​

Creating a card​

Use CNHV2ClassFactory to create card instances. No license key is needed:

using CNHVoyager2;

// Read a .cn1 card
ICNHV2Card card = CNHV2ClassFactory.CreateCard();
card.OpenCard(@"C:\path\to\card.cn1");

// Read with an explicit language code for correct text encoding
card.OpenCard(@"C:\path\to\card.cn1", "fr");  // ISO 639-1 code, e.g. "en", "fr", "de", "ja"

// Setup card (for reading display configuration / merged grower-farm-field data)
ICNHV2SetupCard setupCard = CNHV2ClassFactory.CreateSetupCard();
setupCard.OpenCard(@"C:\path\to\setup.cn1", "en");

// Export card (for writing a new .cn1 card)
ICNHV2ExportCard exportCard = CNHV2ClassFactory.CreateExportCard();
exportCard.OpenCard(@"C:\path\to\output.cn1", "en");

The isoLanguageCode parameter is optional and defaults to "". Pass an ISO 639-1 two-letter code when working with cards from displays configured for non-Latin or UTF-8-only languages. This affects how string fields (grower names, field names, operator names, etc.) are encoded and decoded.

Migrating from the license-key API​

Replace the old CreateInstanceLic calls:

// Before (now [Obsolete] — produces compiler warning)
CNHV2ClassFactory.CreateInstanceLic("1C675C9A-...", out ICNHV2Card card);

// After
ICNHV2Card card = CNHV2ClassFactory.CreateCard();

Breaking Changes​

  • License-key overloads deprecated. The CreateInstanceLic(string licenseKey, out ...) overloads are now marked [Obsolete] and will produce compiler warnings. Use CreateCard(), CreateSetupCard(), and CreateExportCard() instead. No license key is required.

New Features​

  • Transport event log datasets now include summary properties. Reading a transport event log task will now expose AccumulatedWeight and AccumulatedCounts in the dataset property collection.

  • Forage harvest KPS Score Offset exposed. Forage harvest datasets now include a KPSScoreOffset summary property (type CNHV2PropertyTypeKPSScoreOffset) when a KPS sensor was present.

  • Three new per-sample attributes on forage harvest logs:

    • CNHV2AttributeTypeKPSScore — per-sample KPS quality score (0–100).
    • CNHV2AttributeTypeKPSHeaderClearance — per-sample KPS header clearance distance.
    • CNHV2AttributeTypeRelativeYield — dimensionless throughput signal (0–300 scale) for windrower and conditioner swath operations.

  • Improved character encoding support. String fields in .cn1 cards containing non-ASCII characters (regional language names, operator names, field notes) are now read and written using the code page declared in the card's setup record. Cards from displays using UTF-8-only languages are handled correctly. Previously all text was decoded with a single fallback encoding, which could corrupt non-Latin characters on read/write round-trips.

4.2.0​

  • Fix for Product Names and Types (CN1 .TSA)
  • Fix for Sugar Cane yield values
  • Fix to issue in application summaries when multiple products present

4.1.7​

  • Additional Fixes to ICNHV2ExportCard

4.1.6​

  • Fixes to ExportCard functionality.

4.1.5​

  • Improvement in Error Handling.

4.1.4​

  • Improved Stability: Prevents null reference exceptions caused by empty .tso files.
  • Reliable Data Processing: Excludes invalid files from the output to ensure consistent data handling.
  • Error Handling Enhancements: Catches non-critical errors that were blocking data export.
  • Data Folder Determination: Uses index.vy1 location vs. .CN1 folders to accurately determine data folders.

4.1.3​

  • Logged Data Availability: Logged data is now available even without the Harvest Log files.
  • Task Start Time: Task start time is now available under Dataset Collection.
  • GPS Width Fix: Fixed an issue with recording GPS width.
  • New Property Type: CNHV2PropertyTypeAreaApplied is now available with AreaSummary.

4.1.2​

  • Fixed issue with flow rate.

4.1.1​

  • Fixed issues with Linux system.
  • Fixed sample application issues.
  • Upgraded sample application to 8.0.
  • Fixed other CN1 related bugs.

4.1.0​

  • Improved error handling and the detection of bad records. New errors collection made available to ADAPT Plugin.

4.0.1​

  • Upgraded to .NET Standard 2.0.