MX Foundation 4
ar664_com_queuing_basic.cs
/*******************************************************************************
//
// File:
// ar664_com_queuing_basic.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 do basic transmission and reception using COM queuing
// port.
//
// Hardware Requirements:
// - MAXT Flex with ARINC 664 channel.
//
*******************************************************************************/
#define LOOPBACK
//#define LOCAL
#define ARINC664
//#define AIRBUS
//#define BOEING
using System;
using System.Net;
using System.Runtime.InteropServices;
using static MAXT.MXFoundation.mxf;
namespace ar664_example
{
public class ar664_com_queuing_basic
{
private const UInt32 TEST_DATASIZE = 64;
private const UInt64 DATARECS_BUFFER_SIZE_MAX = 64 * 1024;
private const string SRC_IP_ADRS = "10.0.0.111";
private const UInt32 SRC_UDP_PORT = 1234;
private const string DST_IP_ADRS = "10.0.0.222";
private const UInt32 DST_UDP_PORT = 5678;
static void Main(string[] args)
{
UInt64 server = 0;
UInt64 portTx = 0;
UInt64 portRx = 0;
UInt64 vlTx = 0, vlRx = 0;
UInt64 rxBuffer = 0;
var data = new MXF_A664_DATAREC();
var module = new UInt64[1];
UInt64 device = 0;
var phyChn = new UInt64[1];
IntPtr recPtr = IntPtr.Zero;
IntPtr rxRec = IntPtr.Zero;
IntPtr txRec = IntPtr.Zero;
var vlParamTx = new MXF_A664_VL_PARAM_TX();
var vlParamRx = new MXF_A664_VL_PARAM_RX();
var portParam = new MXF_A664_PORT_PARAM();
int srcIpAdrs = 0, dstIpAdrs = 0;
UInt64 status;
UInt64 usedBytes, freeBytes;
UInt64 msgCount = 0;
UInt64 acqStopTime;
UInt32 recordIdx, dataIdx;
UInt32 maxTxRecords = 16;
UInt32 vlid = 100;
UInt32 rc;
UInt64 count = 0;
UInt64 frameType = MXF_A664_FRAME_TYPE_ARINC664;
#if LOCAL
rc = mxfServerConnect("0.0.0.0", "", "", VMXF_DISABLE, out server);
#else
rc = mxfServerConnect("192.168.0.1", "admin", "admin", 0, out server);
#endif
if (rc != MAXT_SUCCESS)
{
Console.Write("Failed to connect; rc=0x{0:x8}\n", rc);
Console.Write("\nPress a key to terminate\n");
Console.ReadKey();
return;
}
// Initialize server, allocate base resources
rc = mxfSystemInit(server);
if (rc == MAXT_ERROR_MANY_MASTER)
rc = MAXT_SUCCESS;
// Get the first device handle
if (rc == MAXT_SUCCESS)
rc = mxfSystemDeviceGet(server, 0, out device);
// Get the first A664 module
if (rc == MAXT_SUCCESS)
rc = mxfDeviceModuleAllGet(device, MXF_MODULE_A664, 1, out count, module);
// Obtain the first ARINC 664 Phy channel (Phy logical #0)
if (rc == MAXT_SUCCESS && count > 0)
rc = mxfModuleChannelAllGet(module[0], MXF_CLASS_A664, MXF_SCLASS_ALL, 1, out count, phyChn);
// If module or channel not found, return an error
if (rc == MAXT_SUCCESS && count == 0)
rc = MAXT_ERROR_NOT_FOUND;
// Set mode to redundant
if (rc == MAXT_SUCCESS)
rc = mxfAttributeUint64Set(module[0], KMXF_A664_ES_MODE, VMXF_A664_ES_MODE_REDUNDANT);
// Set speed to 10Mbps
if (rc == MAXT_SUCCESS)
rc = mxfAttributeUint64Set(phyChn[0], KMXF_A664_PHY_SPEED, VMXF_A664_PHY_SPEED_10Mbits);
#if LOOPBACK
if (rc == MAXT_SUCCESS)
rc = mxfAttributeUint64Set(phyChn[0], KMXF_A664_PHY_LOOPBACK, VMXF_A664_PHY_LOOPBACK_EXTERNAL);
#endif
// Set Timebase
if (rc == MAXT_SUCCESS)
rc = mxfSystemTimeBaseSet(server, MXF_TIMEBASE_DEVICE_NSEC);
if (rc == MAXT_SUCCESS)
{
# if AIRBUS
frameType = MXF_A664_FRAME_TYPE_AIRBUS;
#else
# if BOEING
frameType = MXF_A664_FRAME_TYPE_BOEING;
#endif
#endif
}
// Create the transmission (TX) virtual link
if (rc == MAXT_SUCCESS)
{
vlParamTx.dir.Tx.subVl = new MXF_A664_VL_PARAM_TX.Dir.TX.SubVl[4];
vlParamTx.direction = MXF_A664_VL_DIR_TX;
vlParamTx.VLId = vlid;
vlParamTx.frameType = frameType;
vlParamTx.frameSizeMax = 512;
vlParamTx.dir.Tx.subVlNumber = 1;
vlParamTx.dir.Tx.bag = 1 * 1000 * 1000; // 1ms
vlParamTx.dir.Tx.netSelection = MXF_A664_NETSELECT_ALL;
vlParamTx.dir.Tx.Ede.enable = VMXF_DISABLE;
vlParamTx.dir.Tx.subVl[0].bufferSize = vlParamTx.frameSizeMax;
vlParamTx.dir.Tx.subVl[0].maxBuffers = maxTxRecords;
rc = mxfA664VlCreate(phyChn[0], ref vlParamTx, out vlTx);
}
// Create the transmission COM port
if (rc == MAXT_SUCCESS)
{
srcIpAdrs = BitConverter.ToInt32(IPAddress.Parse(SRC_IP_ADRS).GetAddressBytes(), 0);
srcIpAdrs = IPAddress.HostToNetworkOrder(srcIpAdrs); // address is in host byte order
dstIpAdrs = BitConverter.ToInt32(IPAddress.Parse(DST_IP_ADRS).GetAddressBytes(), 0);
dstIpAdrs = IPAddress.HostToNetworkOrder(dstIpAdrs);
portParam = new MXF_A664_PORT_PARAM();
portParam.portType = MXF_A664_PORT_TYPE_COM;
portParam.family = MXF_A664_PORT_FAMILY_IPV4;
portParam.mode = MXF_A664_PORT_MODE_QUEUING;
portParam.type.COM.destAddress.port = DST_UDP_PORT;
portParam.type.COM.destAddress.version.IPv4.address = (UInt32)dstIpAdrs;
portParam.type.COM.srcAddress.port = SRC_UDP_PORT;
portParam.type.COM.srcAddress.version.IPv4.address = (UInt32)srcIpAdrs;
rc = mxfA664PortCreate(vlTx, ref portParam, out portTx);
}
if (rc == MAXT_SUCCESS)
{
try
{
txRec = Marshal.AllocHGlobal((int)DATARECS_BUFFER_SIZE_MAX);
}
catch (OutOfMemoryException)
{
rc = MAXT_ERROR_MEM;
}
}
// Create the reception (RX) virtual link
if (rc == MAXT_SUCCESS)
{
vlParamRx = new MXF_A664_VL_PARAM_RX();
vlParamRx.VLId = vlid;
vlParamRx.frameType = frameType;
vlParamRx.direction = MXF_A664_VL_DIR_RX;
vlParamRx.frameSizeMax = 512;
vlParamRx.dir.Rx.Mac.skewMax = 4 * 1000 * 1000;
vlParamRx.dir.Rx.Mac.rmPSNRange = 2;
rc = mxfA664VlCreate(phyChn[0], ref vlParamRx, out vlRx);
}
// Create COM RX port
if (rc == MAXT_SUCCESS)
{
portParam = new MXF_A664_PORT_PARAM();
portParam.portType = MXF_A664_PORT_TYPE_COM;
portParam.family = MXF_A664_PORT_FAMILY_IPV4;
portParam.mode = MXF_A664_PORT_MODE_QUEUING;
portParam.dir.Rx.network = MXF_A664_NETSELECT_ALL;
portParam.dir.Rx.maxBuffers = maxTxRecords;
portParam.dir.Rx.bufferSize = 1518;
portParam.type.COM.destAddress.port = DST_UDP_PORT;
portParam.type.COM.destAddress.version.IPv4.address = (UInt32)dstIpAdrs;
portParam.type.COM.srcAddress.port = SRC_UDP_PORT;
portParam.type.COM.srcAddress.version.IPv4.address = (UInt32)srcIpAdrs;
rc = mxfA664PortCreate(vlRx, ref portParam, out portRx);
}
// Get buffer handle automatically allocated for the port
if (rc == MAXT_SUCCESS)
rc = mxfRxAcqBufferGet(portRx, out rxBuffer);
if (rc == MAXT_SUCCESS)
{
try
{
rxRec = Marshal.AllocHGlobal((int)DATARECS_BUFFER_SIZE_MAX);
}
catch (OutOfMemoryException)
{
rc = MAXT_ERROR_MEM;
}
}
// Set acquisition mode
if (rc == MAXT_SUCCESS)
rc = mxfRxAcqModeSet(rxBuffer, MXF_RXACQ_MODE_LINEAR);
// Start acquisition, check status
if (rc == MAXT_SUCCESS)
rc = mxfRxAcqStart(rxBuffer, MXF_RXACQ_FLAG_DEFAULT, 0, 0);
if (rc == MAXT_SUCCESS)
{
rc = mxfRxAcqBufferStatusGet(rxBuffer, out status, out msgCount, out usedBytes, out freeBytes);
if (rc == MAXT_SUCCESS && (status & MXF_RXACQ_STATUS_RUNNING) > 0)
Console.Write("Acquisition Running\n\n");
}
recPtr = txRec;
// Build the Transmit Records
for (recordIdx = 0; recordIdx < maxTxRecords && rc == MAXT_SUCCESS; recordIdx++)
{
data = new MXF_A664_DATAREC();
data.data = new byte[8192];
data.control = 0;
data.dataSize = TEST_DATASIZE;
data.repeatCount = 1;
for (dataIdx = 0; dataIdx < TEST_DATASIZE; dataIdx++)
data.data[dataIdx] = (byte)((dataIdx + ((recordIdx * TEST_DATASIZE) & 0xff)));
Marshal.StructureToPtr(data, recPtr, false);
rc = mxfA664NextDataRecordPtrGet(recPtr, out recPtr);
}
// Transmit the data
if (rc == MAXT_SUCCESS)
{
rc = mxfA664TxAperiodicWrite(portTx, MXF_TXAPERIODIC_FLAG_DEFAULT, 0, maxTxRecords, txRec, out count);
Console.Write("{0} frames transmitted\n\n", count);
// Wait for complete transmission
mxfSleep(500);
}
// Receive the data
if (rc == MAXT_SUCCESS)
rc = readAcquisitionData(rxBuffer, rxRec);
// Terminate Acquisition
if (rc == MAXT_SUCCESS)
rc = mxfRxAcqStop(rxBuffer);
if (rc == MAXT_SUCCESS)
rc = mxfRxAcqClear(rxBuffer);
// Make sure the acquisition if stopped
if (rc == MAXT_SUCCESS)
{
rc = mxfRxAcqBufferStatusGet(rxBuffer, out status, out msgCount, out usedBytes, out freeBytes);
if (rc == MAXT_SUCCESS && (status & MXF_RXACQ_STATUS_STOPPED) > 0 )
{
rc = mxfRxAcqStopTimeGet(rxBuffer, out acqStopTime);
if (rc == MAXT_SUCCESS)
Console.Write("\nAcquisition stopped at {0}\n", acqStopTime);
}
}
if (rc == MAXT_SUCCESS)
rc = mxfRxAcqBufferFree(rxBuffer);
// Free COM ports
if (rc == MAXT_SUCCESS)
rc = mxfA664PortRelease(portTx);
if (rc == MAXT_SUCCESS)
rc = mxfA664PortRelease(portRx);
// Free VL(s)
if (rc == MAXT_SUCCESS)
rc = mxfA664VlRelease(vlRx);
if (rc == MAXT_SUCCESS)
rc = mxfA664VlRelease(vlTx);
// Free datarec buffers
if (txRec != IntPtr.Zero)
Marshal.FreeHGlobal(txRec);
if (rxRec != IntPtr.Zero)
Marshal.FreeHGlobal(rxRec);
Console.Write("\n\nPress a key to terminate rc=0x{0:X8}\n", rc);
Console.ReadKey();
return;
}
private static UInt32 readAcquisitionData(UInt64 rxBuffer, IntPtr rec664)
{
IntPtr recPtr = rec664;
var rxRec664 = new MXF_A664_DATAREC();
UInt64 recordIdx, dataIdx;
UInt64 status, msgsCount, bytesCount;
UInt32 dataSize;
UInt32 rc = 0;
// Read and display records
rc = mxfA664RxAcqRead(rxBuffer, 0, DATARECS_BUFFER_SIZE_MAX, out status, out msgsCount, out bytesCount, rec664);
if (rc == MAXT_SUCCESS)
Console.Write("{0} records received\n\n", msgsCount);
for (recordIdx = 0; recordIdx < msgsCount && rc == MAXT_SUCCESS; recordIdx++)
{
rxRec664 = (MXF_A664_DATAREC)Marshal.PtrToStructure(recPtr, typeof(MXF_A664_DATAREC));
Console.Write(" {0}: timeTag={1:D12}, Size={2}\n", recordIdx, rxRec664.timeTag, rxRec664.dataSize);
Console.Write("\n data=");
dataSize = rxRec664.dataSize;
for (dataIdx = 0; dataIdx < dataSize; dataIdx++)
{
Console.Write("{0:X2} ", rxRec664.data[dataIdx]);
if (((dataIdx + 1) % 8) == 0 && (dataIdx + 1 < rxRec664.dataSize))
Console.Write("\n ");
}
Console.Write("\n\n");
mxfA664NextDataRecordPtrGet(recPtr, out recPtr);
}
return rc;
}
}
}
Updated 10/23/2023