async_rx_acquisition_trigger.cs

/*******************************************************************************
//
//   File:
//      async_rx_acquisition_trigger.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 illustrates how to use the trigger functionality
//   to start acquisition on a receive channel.
//
//   The program first starts the acquisition and waits for first byte of the
//   message to have a value of 07. Aperiodic transmission is then done to fire
//   the trigger.
//
//   Note that this uses RS-422 instead of the default RS-485.
//
//   Hardware Requirements:
//       - MAXT Flex device with ASYNC support
//
*******************************************************************************/

#define LOOPBACK
//#define LOCAL

using System;
using static MAXT.MXFoundation.mxf;
using System.Runtime.InteropServices;
using System.Text;

namespace async_example
{
    class async_rx_acquisition_trigger
    {
        private const int MAX_TX_RECORDS_TO_TRANSMIT = 100;
        private const int BUFFER_SIZE = MAX_TX_RECORDS_TO_TRANSMIT * 256;

        static void Main(string[] args)
        { 
            UInt32 rc;
            UInt64 server = 0;
            var rxChannel = new UInt64[1];
            var txChannel =  new UInt64[1];
            UInt64 rxBuffer = 0;
            UInt64 txBuffer = 0;
            IntPtr recAsync = IntPtr.Zero;
            UInt64 count = 0;
            UInt64 dev, mod, port;
            MXF_RXACQ_TRIG_COND_RDATA_DW_PARM condParam;
            UInt64 condList = 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);

            // Obtain the first ASYNC Protocol RX channel (RX logical #0)
            if (rc == MAXT_SUCCESS)
                rc = mxfChannelAllGet(server, MXF_CLASS_ASYNC_ENHANCED, MXF_SCLASS_RX_CHANNEL, MXF_MODULE_ALL, 1, out count, rxChannel);

            // Obtain the first ASYNC Protocol TX channel (TX logical #0)
            if ((rc == MAXT_SUCCESS) && (count != 0))
                rc = mxfChannelAllGet(server, MXF_CLASS_ASYNC_ENHANCED, MXF_SCLASS_TX_CHANNEL, MXF_MODULE_ALL, 1, out count, txChannel);

            if ((rc == MAXT_SUCCESS) && (count == 0))
                rc = MAXT_ERROR_NOT_FOUND;

            //Sets timebase to computer time 64-bit microseconds
            if (rc == MAXT_SUCCESS)
                rc = mxfSystemTimeBaseSet(server, MXF_TIMEBASE_COMPUTER_USEC);

            //Get the physical port location
            if (rc == MAXT_SUCCESS)
            {
                rc = mxfChannelLocationGet(rxChannel[0], out dev, out mod, out port);

                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);

                Console.WriteLine("Transmitter Channel (TX) Location: {0}.{1}.{2}", dev, mod, port);
            }

            //Enables Loopback
#if (LOOPBACK)
            if (rc == MAXT_SUCCESS)
                rc = mxfAttributeUint64Set(rxChannel[0], KMXF_ASYNCEH_TX_RX_TEST_LB, VMXF_ENABLE);
#endif

            //Set electrical interface to RS-422
            if (rc == MAXT_SUCCESS)
                rc = mxfAttributeUint64Set(txChannel[0], KMXF_ASYNCEH_ELECTRICAL_INTERFACE, VMXF_ASYNCEH_ELECTRICAL_INTERFACE_RS422);

            // Allocate RX acquisition buffer
            if (rc == MAXT_SUCCESS)
            {
                rc = mxfRxAcqBufferAlloc(rxChannel[0], BUFFER_SIZE, out rxBuffer, IntPtr.Zero);
            }

            // Allocate TX Aperiodic buffer
            if (rc == MAXT_SUCCESS)
            {
                //Allocates Tx Aperiodic static buffer for HIGH priority queue
                rc = mxfTxAperiodicBufferAlloc(txChannel[0], 0, BUFFER_SIZE, out txBuffer, IntPtr.Zero);
            }

            //Host buffer allocation
            if (rc == MAXT_SUCCESS)
            {
                try
                {
                    recAsync = Marshal.AllocHGlobal(BUFFER_SIZE);
                }
                catch (OutOfMemoryException)
                {
                    rc = MAXT_ERROR_MEM;
                }
            }

            //Configure trigger and create the condition list
            if (rc == MAXT_SUCCESS)
                rc = mxfRxAcqTrigConditionListAlloc(server, out condList);

            //Condition will be triggered on the 8th record
            if (rc == MAXT_SUCCESS)
            {
                condParam.mask = 0x000000ff;
                condParam.data = 7;
                condParam.offset = 0;
                condParam.options = MXF_RXACQ_TRIG_COND_RDATA_OPTIONS_EQUAL;

                rc = mxfRxAcqTrigConditionAdd(condList, MXF_RXACQ_TRIG_COND_ID_RDATA_DW, ref condParam);
            }

            //Set the trigger with a pretrig count of 3 which allows some records to be read before the condition was triggered
            if (rc == MAXT_SUCCESS)
                rc = mxfRxAcqTrigSet(rxBuffer, condList, 3);

            //Start Acquisition
            if (rc == MAXT_SUCCESS)
                rc = mxfRxAcqModeSet(rxBuffer, MXF_RXACQ_MODE_LINEAR);
            if (rc == MAXT_SUCCESS)
            {
                rc = mxfRxAcqStart(rxBuffer, MXF_RXACQ_FLAG_DEFAULT, 0, 0);
                if (rc == MAXT_SUCCESS)
                    Console.WriteLine("Acquisition started.");
            }

            if (rc == MAXT_SUCCESS)
                mxfSleep(1);

            //Start ASYNC data transmission
            if (rc == MAXT_SUCCESS)
            {
                rc = TransmitAperiodicData(txBuffer, recAsync);
                if (rc == MAXT_SUCCESS)
                    rc = ReadAcquisitionData(rxBuffer, recAsync);
            }

            //Stops Acquisition
            if (rc == MAXT_SUCCESS)
                rc = mxfRxAcqStop(rxBuffer);
            if (rc == MAXT_SUCCESS)
            {
                rc = mxfRxAcqClear(rxBuffer);
                if (!rc)
                    printf("\nAcquisition stopped\n\r");
            }

            // Free trigger condition list
            if (rc == MAXT_SUCCESS)
                rc = mxfRxAcqTrigConditionListFree(condList);

            // Catch any previous 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);
            }

            //Free device and host buffers
            if (rxBuffer != 0)
                mxfRxAcqBufferFree(rxBuffer);
            if (txBuffer != 0)
                mxfTxAperiodicBufferFree(txBuffer);

            Console.WriteLine();
            Console.WriteLine("Terminating...");

            mxfSystemTerminate(server);
            mxfServerDisconnect(server);

            Console.WriteLine();
            Console.WriteLine("Press enter to terminate");
            Console.Read();

            return;
        }

        private static UInt32 TransmitAperiodicData(UInt64 txBuffer, IntPtr recAsync)
        {
            UInt32 rc;
            var rec = new MXF_ASYNCEH_DATAREC();
            UInt64 data, byteByte;
            IntPtr recPtr = recAsync;
            rec.data = new byte[256];

            // Prepare string array (8 bytes per string with minimum delay between each)
            for (data = 0; data < MAX_TX_RECORDS_TO_TRANSMIT; data++)
            {
                rec.timeTag = 0;
                rec.control = 0;
                rec.repeatCount = 1;
                rec.dataSize = 8;
                for (byteByte = 0; byteByte < rec.dataSize; byteByte++)
                {
                    rec.data[byteByte] = (byte)(Convert.ToBoolean(byteByte) ? byteByte : data);
                }
                Marshal.StructureToPtr(rec, recPtr, false);
                mxfASYNCEHNextDataRecordPtrGet(recPtr, out recPtr);
            }

            Console.WriteLine("Transmitting ...\n");
            rc = mxfASYNCEHTxAperiodicWrite(txBuffer, MXF_TXAPERIODIC_FLAG_DEFAULT, 0, MAX_TX_RECORDS_TO_TRANSMIT, recAsync);

            // Wait a little for transmission to occur
            if (rc == MAXT_SUCCESS)
                mxfSleep(1000);

            return rc;
        }

        private static UInt32 ReadAcquisitionData(UInt64 rxBuffer, IntPtr recAsync)
        {
            IntPtr recPtr = recAsync;
            MXF_ASYNCEH_DATAREC rec = new MXF_ASYNCEH_DATAREC();
            UInt64 status, msgsCount, bytesCount;
            UInt64 j, trigTime = 0;
            UInt32 rc;
            UInt64 usec;
            UInt64 byteByte;

            //Check trigger happened
            rc = mxfRxAcqBufferStatusGet(rxBuffer, out status, IntPtr.Zero, IntPtr.Zero, IntPtr.Zero);
            if (rc == MAXT_SUCCESS)
            {
                if ((status & MXF_RXACQ_STATUS_TRIG_OCCURRED) > 0)
                {
                    //Display the trigger time
                    rc = mxfRxAcqTrigTimeGet(rxBuffer, out trigTime);
                    if (rc == MAXT_SUCCESS)
                    {
                        var offset = TimeZoneInfo.Local.GetUtcOffset(DateTime.UtcNow);
                        var time = new DateTime(1970, 1, 1).AddTicks(offset.Ticks);

                        time = time.AddMilliseconds(trigTime / 1000);
                        usec = trigTime % 1000;

                        Console.WriteLine();
                        Console.WriteLine("Event trigggered at: {0}:{1:000}", time.ToString("yyyy-MM-dd HH:mm:ss:fff"), usec);
                    }
                }
                else
                    Console.WriteLine("Trigger not fired");
            }

            //Read and display records
            rc = mxfASYNCEHRxAcqRead(rxBuffer, 0, BUFFER_SIZE, out status, out msgsCount, out bytesCount, recAsync);
            for (j = 0; j<msgsCount && (rc == MAXT_SUCCESS); j++)
            {
                rec = (MXF_ASYNCEH_DATAREC)Marshal.PtrToStructure(recPtr, typeof(MXF_ASYNCEH_DATAREC));
                Console.WriteLine();
                Console.WriteLine("{0}: Timetag: {1}, Size: {2}", j, rec.timeTag, rec.dataSize);
                Console.Write("Data: ");
                for(byteByte = 0; byteByte < rec.dataSize; byteByte++)
                {
                    Console.Write("{0}", rec.data[byteByte]);
                }

                mxfASYNCEHNextDataRecordPtrGet(recPtr, out recPtr);
            }

            return rc;
        }
    }
}