MX Foundation 4
ar708_periodic.cs
/******************************************************************************
//
// File:
// ar708_periodic.cs
//
// Copyright (c) MAX Technologies Inc. 1988-2019, All Rights Reserved.
// CONFIDENTIAL AND PROPRIETARY INFORMATION WHICH IS THE
// PROPERTY OF MAX TECHNOLOGIES INC.
//
// This demo shows how to set a basic periodic transmission
// based on ARINC 708 protocol.
//
// Hardware requirements:
// - MAXT FlexMulti-1553 or FlexMulti-629 with A708 option.
// - Loopback between TX and RX channels if internal loopback is not used.
//
*******************************************************************************/
#define LOOPBACK
//#define LOCAL
using System;
using static MAXT.MXFoundation.mxf;
using System.Runtime.InteropServices;
using System.Text;
namespace ar708_example
{
class ar708_periodic
{
private const int MAX_TX_RECORDS_TO_TRANSMIT = 4;
private const int BUFFER_SIZE = 4096;
static void Main(string[] args)
{
UInt32 rc;
UInt64 server = 0;
UInt64 device = 0;
var module = new UInt64[1];
var rxChannel = new UInt64[1];
var txChannel = new UInt64[1];
UInt64 rxBuffer = 0;
UInt64 txBuffer = 0;//= new UInt64[1];
IntPtr rec = IntPtr.Zero;
UInt64 dev, mod, port;
UInt64 moduleCount = 0;
UInt64 channelCount = 0;
#if (LOCAL)
rc = mxfServerConnect("0.0.0.0", "", "", Convert.ToUInt64(false), out server);
#else
rc = mxfServerConnect("192.168.0.1", "admin", "admin", Convert.ToUInt64(false), out server);
#endif
if (rc != MAXT_SUCCESS)
{
Console.Write("Failed to connect; rc=0x{0:x8}", rc);
Console.WriteLine();
Console.WriteLine("Press a key to terminate");
Console.Read();
return;
}
// Initialize the server
Console.WriteLine();
Console.WriteLine("Starting");
rc = mxfSystemInit(server);
// Get the device handle
if (rc == MAXT_SUCCESS)
rc = mxfSystemDeviceGet(server, 0, out device);
//Get Module handle
if (rc == MAXT_SUCCESS)
rc = mxfDeviceModuleAllGet(device, MXF_MODULE_A708_EH, 1, out moduleCount, module);
// If module not found, return an error
if (rc == MAXT_SUCCESS && moduleCount == 0)
rc = MAXT_ERROR_NOT_FOUND;
// Activates the ARINC 708 module (because the MIL-STD-1553 is by default activated, except on FM1553-2)
if (rc == MAXT_SUCCESS)
rc = mxfAttributeUint64Set(module[0], KMXF_A708_MODULE_ACTIVE, Convert.ToUInt64(true));
if (rc == MAXT_ERROR_NOT_SUPPORTED)
rc = MAXT_SUCCESS;
//Get handle of first ARINC 708 RX Channel
if (rc == MAXT_SUCCESS)
rc = mxfModuleChannelAllGet(module[0], MXF_CLASS_A708, MXF_SCLASS_RX_CHANNEL, 1, out channelCount, rxChannel);
//Get handle of first A708 Tx Channel
if (rc == MAXT_SUCCESS)
rc = mxfModuleChannelAllGet(module[0], MXF_CLASS_A708, MXF_SCLASS_TX_CHANNEL, 1, out channelCount, txChannel);
//Enables Loopback
#if (LOOPBACK)
if (rc == MAXT_SUCCESS)
rc = mxfAttributeUint64Set(rxChannel[0], KMXF_A708_TX_RX_TEST_LB, VMXF_ENABLE);
#endif
//Sets timebase to 64 bit microseconds
if (rc == MAXT_SUCCESS)
rc = mxfSystemTimeBaseSet(server, MXF_TIMEBASE_DEVICE_USEC);
//Get the physical port
if (rc == MAXT_SUCCESS)
{
rc = mxfChannelLocationGet(rxChannel[0], out dev, out mod, out port);
if (rc == MAXT_SUCCESS)
{
Console.WriteLine();
Console.WriteLine("Acquisition Channel (RX) location = {0}.{1}.{2}", dev, mod, port);
}
}
if (rc == MAXT_SUCCESS)
{
rc = mxfChannelLocationGet(txChannel[0], out dev, out mod, out port);
if (rc == MAXT_SUCCESS)
{
Console.WriteLine();
Console.WriteLine("Transmitter Channel (TX) location = {0}.{1}.{2}", dev, mod, port);
}
}
//Allocate RX Acquisition Buffer
if (rc == MAXT_SUCCESS)
rc = mxfRxAcqBufferAlloc(rxChannel[0], BUFFER_SIZE, out rxBuffer, IntPtr.Zero);
//Allocate TX Periodic Update buffer
if (rc == MAXT_SUCCESS)
rc = mxfTxPeriodicUpdateMsgBufferAlloc(txChannel[0], 0, BUFFER_SIZE, out txBuffer, IntPtr.Zero);
//ALlocate host buffer
if (rc == MAXT_SUCCESS)
{
try
{
rec = Marshal.AllocHGlobal(BUFFER_SIZE);
}
catch (OutOfMemoryException)
{
rc = MAXT_ERROR_MEM;
}
}
//Start the acquisition process
if (rc == MAXT_SUCCESS)
rc = mxfRxAcqModeSet(rxBuffer, MXF_RXACQ_MODE_LINEAR);
if (rc == MAXT_SUCCESS)
rc = mxfRxAcqStart(rxBuffer, MXF_RXACQ_FLAG_DEFAULT, 0, 0);
//Start data transmission
if (rc == MAXT_SUCCESS)
{
rc = PeriodicScheduling(txChannel[0], txBuffer, rec);
if (rc == MAXT_SUCCESS)
rc = ReadAcquisitionData(rxBuffer, rec);
}
//Stops Acquisition
if (rc == MAXT_SUCCESS)
rc = mxfRxAcqStop(rxBuffer);
if (rc == MAXT_SUCCESS)
{
rc = mxfRxAcqClear(rxBuffer);
if (rc == MAXT_SUCCESS)
Console.WriteLine("Acquisition Stopped");
}
//Free device and host buffers
if (rxBuffer != 0)
mxfRxAcqBufferFree(rxBuffer);
if (txBuffer != 0)
if (rec != IntPtr.Zero)
Marshal.FreeHGlobal(rec);
//Get error
if (rc != MAXT_SUCCESS)
{
StringBuilder buffer = new StringBuilder(256);
if (mxfSystemErrorStringGet(server, rc, 256, buffer) != MAXT_SUCCESS)
buffer.Append(string.Format("ERROR # 0x{0:x8}", rc));
Console.WriteLine(buffer);
}
Console.WriteLine();
Console.WriteLine("Terminating...");
Console.WriteLine();
Console.WriteLine("Press enter to terminate");
Console.Read();
return;
}
/***********************************************************************/
//ReadAcquisitionData
/***********************************************************************/
private static UInt32 ReadAcquisitionData(UInt64 rxBuffer, IntPtr rxHostBuffer)
{
UInt64 status, msgsCount, bytesCount;
UInt32 rc = 0;
//Read and display records
Console.WriteLine();
Console.WriteLine("Receiving!");
rc = mxfA708RxAcqRead(rxBuffer, 0, BUFFER_SIZE, out status, out msgsCount, out bytesCount, rxHostBuffer);
if (rc == MAXT_SUCCESS)
{
Console.WriteLine();
Console.WriteLine("String received count: {0}", msgsCount);
}
//Display Strings
if (rc == MAXT_SUCCESS)
DisplayDataArray(msgsCount, rxHostBuffer);
if (rc != MAXT_SUCCESS)
{
Console.WriteLine();
Console.WriteLine("Acquisition read failed.");
}
return rc;
}
/***********************************************************************/
//DisplayDataArray
/***********************************************************************/
private static void DisplayDataArray(UInt64 recNum, IntPtr rxHostBuffer)
{
UInt64 iRec, iData;
IntPtr p = rxHostBuffer;
Console.WriteLine();
for (iRec = 0; iRec < recNum; iRec++)
{
rec = (MXF_A708_DATAREC)Marshal.PtrToStructure(p, typeof(MXF_A708_DATAREC));
Console.WriteLine("{0}: Timetag: {1} Control: {2:x2} Size: {3}", iRec, rec.timeTag, rec.control, rec.dataSize);
Console.Write("Data: ");
for (iData = 0; iData < rec.dataSize/2; iData++)
{
Console.Write("{0:x2}", rec.data[iData]);
}
Console.WriteLine();
}
}
/***********************************************************************/
//PeriodicScheduling
/***********************************************************************/
private static UInt32 PeriodicScheduling(UInt64 txChannel, UInt64 txBuffer, IntPtr recA708)
{
UInt64 schedule;
UInt64 msg = 0;
UInt32 rc;
UInt64 data, word;
rec.data = new UInt16[128];
var txBufferArray = new UInt64[] { txBuffer };
IntPtr recPtr = recA708;
//Create the periodic scheduler
rc = mxfTxPeriodicScheduleNew(txChannel, out schedule);
//Set scheduling values: rate = 5ms, Phase = 0us
if (rc == MAXT_SUCCESS)
rc = mxfTxPeriodicScheduleMsgAdd(schedule, 5000, 0, out msg);
//Define the number of buffers for the list and link to it
if (rc == MAXT_SUCCESS)
rc = mxfTxPeriodicScheduleBufferListAdd(msg, 1, 0, txBufferArray);
//Set records for the buffers
if (rc == MAXT_SUCCESS)
{
for (data = 0; data < MAX_TX_RECORDS_TO_TRANSMIT; data++)
{
rec.timeTag = 0;
rec.control = 0;
rec.repeatCount = 1;
rec.dataSize = 200;
for (word = 0; word < rec.dataSize / 2; word++)
{
switch (word)
{
case 0:
rec.data[word] = 055; //Label
break;
case 1:
case 2:
case 3:
rec.data[word] = 0x0000;
break;
default:
rec.data[word] = (UInt16)(0x0101 * data);
break;
}
}
Marshal.StructureToPtr(rec, recPtr, false);
rc = mxfA708NextDataRecordPtrGet(recPtr, out recPtr);
}
}
//DisplayDataArray(MAX_TX_RECORDS_TO_TRANSMIT, recPtr);
if (rc == MAXT_SUCCESS)
rc = mxfA708TxPeriodicUpdateMsgWrite(txBufferArray[0], MAX_TX_RECORDS_TO_TRANSMIT, recA708);
//Run the scheduler and update records
if (rc == MAXT_SUCCESS)
{
Console.WriteLine();
Console.WriteLine("Running periodic transmission...");
//Run schedule
rc = mxfTxPeriodicScheduleRun(schedule);
}
if (rc == MAXT_SUCCESS)
{
mxfSleep(1000);
rc = mxfTxPeriodicScheduleFree(schedule);
}
if (rc == MAXT_SUCCESS)
{
Console.WriteLine();
Console.WriteLine("Transmission stopped.");
}
return rc;
}
}
}
Updated 10/23/2023