bindings/csharp: pluto example

- How to use C# bindings to control libiio devices.
- Configure Pluto and use RX and TX interfaces to send and receive data.
- Nice to have for EZ questions such as:  https://ez.analog.com/adieducation/university-program/f/q-a/574101/adalam-pluto-sdr-via-c

Signed-off-by: Adrian Stanea <[email protected]>

Author: Adrian-Stanea

bindings/csharp/examples/PlutoExample.cs

@@ -0,0 +1,151 @@
+/*
+ * Copyright (C) 2023 Analog Devices, Inc.
+ * Author: Adrian Stanea <[email protected]>
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License
+ * as published by the Free Software Foundation; either version 2
+ * of the License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+ * */
+
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using iio;
+
+namespace IIOCSharp
+{
+    class PlutoExample
+    {
+        static void Main(string[] args)
+        {
+            Context ctx = new Context("192.168.2.1");
+            if (ctx == null)
+            {
+                Console.WriteLine("Unable to create IIO context");
+                return;
+            }
+
+            string TXLO = "1000000000";
+            string TXBW = "5000000";
+            string TXFS = "3000000";
+            string RXLO = TXLO;
+            string RXBW = TXBW;
+            string RXFS = TXFS;
+            string gain_ctrl_mode = "slow_attack";
+            string hw_gain = "-30";
+
+            // get reference to devices
+            var ctrl = ctx.find_device("ad9361-phy"); //configure transciever
+            var tx_dac = ctx.find_device("cf-ad9361-dds-core-lpc");
+            var rx_adc = ctx.find_device("cf-ad9361-lpc");
+
+            rx_config(ctrl, RXLO, RXBW, RXFS, gain_ctrl_mode);
+            tx_config(ctrl, TXLO, TXBW, TXFS, hw_gain);
+
+            // Enable all IQ channels
+            enable_tx(tx_dac);
+            enable_rx(rx_adc);
+
+            // Cyclic buffer to output perdiodic waveforms
+            int samples_per_channel = (int)Math.Pow(2, 15);
+
+            var tx_buf = new IOBuffer(tx_dac, (uint)samples_per_channel, true);
+            var rx_buff = new IOBuffer(rx_adc, (uint)samples_per_channel, false);
+
+            byte[] iqBytes = generate_sine(samples_per_channel, RXFS);
+
+            // Send data to TX buffer
+            tx_buf.fill(iqBytes);
+            tx_buf.push();
+
+            // read data on rx buffer
+            (List<int> reals, List<int> imags) = read_rx_data(rx_buff, 10, samples_per_channel);
+        }
+
+        static void rx_config(Device device, string rx_lo, string rx_bw, string rx_fs, string gain_ctrl_mode)
+        {
+            var rx_chn = device.find_channel("voltage0", false);
+
+            device.find_channel("RX_LO", true).find_attribute("frequency").write(rx_lo);
+            rx_chn.find_attribute("rf_bandwidth").write(rx_bw);
+            rx_chn.find_attribute("sampling_frequency").write(rx_fs);
+            rx_chn.find_attribute("gain_control_mode").write(gain_ctrl_mode);
+        }
+
+        static void tx_config(Device device, string tx_lo, string tx_bw, string tx_fs, string hw_gain)
+        {
+            var tx_chn = device.find_channel("voltage0", true);
+
+            device.find_channel("TX_LO", true).find_attribute("frequency").write(tx_lo);
+            tx_chn.find_attribute("rf_bandwidth").write(tx_bw);
+            tx_chn.find_attribute("sampling_frequency").write(tx_fs);
+            tx_chn.find_attribute("hardwaregain").write(hw_gain);
+        }
+
+        static void enable_tx(Device tx_adc)
+        {
+            tx_adc.find_channel("voltage0", true).enable();
+            tx_adc.find_channel("voltage1", true).enable();
+        }
+
+        static void enable_rx(Device rx_dac)
+        {
+            rx_dac.find_channel("voltage0", false).enable();
+            rx_dac.find_channel("voltage1", false).enable();
+        }
+
+        static byte[] generate_sine(int samples_per_channel, string rx_fs)
+        {
+            int fc = 10000;
+            double ts = 1.0 / int.Parse(rx_fs);
+            double[] t = Enumerable.Range(0, samples_per_channel).Select(i => i * ts).ToArray();
+
+            double[] i = t.Select(x => (Math.Sin(2 * Math.PI * x * fc) * Math.Pow(2, 14))).ToArray();
+            double[] q = t.Select(x => (Math.Cos(2 * Math.PI * x * fc) * Math.Pow(2, 14))).ToArray();
+
+            int[] iq = new int[i.Length + q.Length];
+            for (int j = 0; j < i.Length; j++)
+            {
+                iq[j * 2] = Convert.ToInt16(i[j]);
+                iq[j * 2 + 1] = Convert.ToInt16(q[j]);
+            }
+
+            byte[] iqBytes = iq.SelectMany(BitConverter.GetBytes).ToArray();
+            return iqBytes;
+        }
+
+        static (List<int> reals, List<int> imags) read_rx_data(IOBuffer rx_buff, int num_readings, int samples_per_channel)
+        {
+            List<int> reals = new List<int>();
+            List<int> imags = new List<int>();
+
+            byte[] data = new byte[samples_per_channel];
+            for (int k = 0; k < num_readings; k++)
+            {
+                rx_buff.refill();
+                rx_buff.read(data);
+
+                short[] data_casted = new short[data.Length / 2];
+                Buffer.BlockCopy(data, 0, data_casted, 0, data.Length);
+                for (int idx = 0; idx < data_casted.Length; idx += 2)
+                {
+                    reals.Add(data_casted[idx]);
+                    imags.Add(data_casted[idx + 1]);
+                }
+            }
+            return (reals, imags);
+        }
+    }
+}