feat: 根据HJSL硬件修改相关profile

This reverts commit 268e724c72ca625fadaad6897a273ffc21e3f723.

caldata

@@ -0,0 +1,441 @@
+declare -A calMap
+calMap[JG01]="\{\n\
+	\{     0,    406, -10530,  -8223\}, \{     0,    697,  -9933,  -7988\},\n\
+	\{     0,    296, -10497,  -8272\}, \{     0,    515, -10264,  -8093\},\n\
+	\{     0,    689, -10212,  -8064\}, \{     0,     40, -10960,  -8572\},\n\
+	\{     0,    722, -10878,  -8518\}, \{     0,     59, -10987,  -8962\},\n\
+	\{     0,     56, -11264,  -8770\}, \{     0,   -464, -11341,  -9159\},\n\
+	\{     0,     19, -10924,  -8887\}, \{     0,   -669, -10927,  -8679\},\n\
+	\{     0,   -701, -11154,  -8712\}, \{     0,   -255, -10739,  -8009\},\n\
+	\{     0,   -192, -10509,  -8242\}, \{     0,  -1057, -11183,  -9007\},\n\
+	\{     0,    -57, -10606,  -8350\}, \{     0,   -719, -10949,  -8880\},\n\
+	\{     0,   -760, -11084,  -8660\}, \{     0,   -457, -10735,  -8833\},\n\
+	\{     0,   -188, -10623,  -9119\}, \{     0,   -628, -12609, -10119\},\n\
+	\{     0,   -434, -12714, -10225\}, \{     0,   -727, -13074, -10685\},\n\
+	\{     0,    -12, -12408, -10190\}, \{     0,     33, -12790, -10624\},\n\
+	\{     0,     93, -13235, -10819\}, \{     0,   -363, -13301, -11183\},\n\
+	\{     0,   -514, -13955, -11557\}, \{     0,   -458, -13878, -11722\},\n\
+	\{     0,     93, -13086, -11726\}, \{     0,   -663, -13597, -11868\},\n\
+	\{     0,    174, -12814, -11295\}, \{     0,    121, -12278, -11150\},\n\
+	\{     0,    425, -11255, -10363\}, \{     0,    430, -11645, -10189\},\n\
+	\{     0,    277, -11844,  -9499\}, \{     0,   -132, -12241,  -9420\},\n\
+	\{     0,    448, -11934,  -9612\}, \{     0,    200, -11778,  -9582\},\n\
+	\{     0,    -40, -12069,  -9336\}, \{     0,   1692, -11315,  -9085\},\n\
+	\{     0,  -1753, -11445,  -9482\}, \{     0,  -2520, -12620, -10068\},\n\
+	\{     0,  -1976, -12674, -10218\}, \{     0,  -1984, -12525, -10354\},\n\
+	\{     0,  -2272, -13476, -10932\}, \{     0,  -2123, -13918, -11095\},\n\
+	\{     0,  -2883, -14447, -11659\}, \{     0,  -2826, -13946, -11563\},\n\
+	\{     0,  -2697, -13680, -11328\}, \{     0,  -3068, -13393, -11614\},\n\
+	\{     0,  -2935, -13074, -11882\}, \{     0,  -3017, -13038, -11163\},\n\
+	\{     0,  -2490, -12379, -11288\}, \{     0,  -2463, -12286, -10726\},\n\
+	\{     0,  -2686, -12167, -10673\}, \{     0,  -2428, -12077, -10555\},\n\
+	\{     0,  -2282, -12564, -10388\}, \{     0,  -2017, -12303, -10844\},\n\
+	\{     0,  -2329, -12637, -11250\}, \{     0,  -2703, -13362, -11807\},\n\
+	\{     0,  -1820, -12605, -11733\}, \{     0,    596, -10833,  -9852\},\n\
+	\{     0,      9, -11140,  -9776\}, \{     0,     41, -11168,  -9478\},\n\
+	\{     0,   -261, -11368,  -9752\}, \{     0,    226, -11282,  -9879\},\n\
+	\{     0,    -68, -11454, -10148\}, \{     0,   -314, -12278, -10716\},\n\
+	\{     0,    -66, -11998, -10762\}, \{     0,    -58, -11469, -10664\},\n\
+	\{     0,    319, -10759, -10212\}, \{     0,    122, -11041,  -9901\},\n\
+	\{     0,   -269, -11085, -10008\}, \{     0,    637, -10569,  -9674\},\n\
+	\{     0,   1185, -10632,  -9521\}, \{     0,    902, -11053,  -9681\},\n\
+	\{     0,    560, -11408,  -9588\}, \{     0,   1162, -11079,  -9371\},\n\
+	\{     0,   1780, -10547,  -9133\}, \n\
+};"
+
+calMap[JG02]="\{\n\
+	\{     0,    509,  -2785,  -4375\}, \{     0,    655,  -3482,  -4447\},\n\
+	\{     0,    520,  -3231,  -4651\}, \{     0,    680,  -3122,  -4790\},\n\
+	\{     0,    328,  -3648,  -4712\}, \{     0,    260,  -3454,  -4515\},\n\
+	\{     0,    433,  -3027,  -4446\}, \{     0,     34,  -4304,  -4676\},\n\
+	\{     0,     54,  -3707,  -4650\}, \{     0,    -19,  -3829,  -5231\},\n\
+	\{     0,   -156,  -4018,  -5292\}, \{     0,   -331,  -4155,  -5423\},\n\
+	\{     0,   -424,  -4210,  -5207\}, \{     0,   -592,  -4131,  -5572\},\n\
+	\{     0,   -494,  -4135,  -5732\}, \{     0,   -687,  -4055,  -5030\},\n\
+	\{     0,  -1000,  -4456,  -5228\}, \{     0,   -337,  -3931,  -5340\},\n\
+	\{     0,   -168,  -3962,  -5326\}, \{     0,   -852,  -4534,  -5798\},\n\
+	\{     0,   -541,  -4458,  -5156\}, \{     0,   -842,  -5570,  -6166\},\n\
+	\{     0,  -1490,  -5883,  -6645\}, \{     0,  -1036,  -5917,  -6151\},\n\
+	\{     0,  -1369,  -5946,  -5969\}, \{     0,   -916,  -5927,  -6200\},\n\
+	\{     0,   -521,  -5595,  -6066\}, \{     0,   -823,  -5731,  -5925\},\n\
+	\{     0,   -262,  -5267,  -5315\}, \{     0,   -697,  -5434,  -5676\},\n\
+	\{     0,   -362,  -5193,  -4887\}, \{     0,   -430,  -5147,  -4911\},\n\
+	\{     0,    -94,  -5403,  -5159\}, \{     0,   -747,  -5796,  -4772\},\n\
+	\{     0,   -679,  -4909,  -4531\}, \{     0,   -500,  -5364,  -4694\},\n\
+	\{     0,   -147,  -5225,  -4463\}, \{     0,   -283,  -5815,  -4360\},\n\
+	\{     0,   -724,  -6148,  -4647\}, \{     0,   -295,  -6069,  -4375\},\n\
+	\{     0,   -397,  -6086,  -4105\}, \{     0,   -116,  -6343,  -4698\},\n\
+	\{     0,   -589,  -6398,  -5353\}, \{     0,  -1068,  -6640,  -5014\},\n\
+	\{     0,   -785,  -7017,  -5093\}, \{     0,    -29,  -6238,  -5186\},\n\
+	\{     0,    380,  -6370,  -5063\}, \{     0,   -239,  -7191,  -5605\},\n\
+	\{     0,    321,  -7256,  -5177\}, \{     0,    430,  -6673,  -4887\},\n\
+	\{     0,    226,  -7136,  -5687\}, \{     0,    142,  -7175,  -5498\},\n\
+	\{     0,    333,  -6596,  -5434\}, \{     0,    315,  -6574,  -5520\},\n\
+	\{     0,   -109,  -6681,  -5798\}, \{     0,   -587,  -7290,  -5748\},\n\
+	\{     0,   -229,  -7105,  -5463\}, \{     0,   -480,  -7092,  -6033\},\n\
+	\{     0,  -1162,  -7488,  -6578\}, \{     0,  -1244,  -8230,  -6838\},\n\
+	\{     0,   -941,  -7941,  -6976\}, \{     0,  -1181,  -7816,  -6868\},\n\
+	\{     0,  -1792,  -8128,  -6590\}, \{     0,   -644,  -7614,  -4524\},\n\
+	\{     0,   -873,  -7358,  -3775\}, \{     0,  -1250,  -7370,  -4506\},\n\
+	\{     0,   -819,  -7520,  -4500\}, \{     0,  -1579,  -8679,  -4626\},\n\
+	\{     0,  -1332,  -7353,  -4338\}, \{     0,  -1128,  -7821,  -5030\},\n\
+	\{     0,   -927,  -7988,  -4954\}, \{     0,  -2035,  -7884,  -5097\},\n\
+	\{     0,  -2533,  -8953,  -6171\}, \{     0,  -1576,  -8029,  -5542\},\n\
+	\{     0,  -1185,  -7297,  -5523\}, \{     0,  -2139,  -8830,  -6236\},\n\
+	\{     0,  -2137,  -8976,  -6225\}, \{     0,  -1387,  -8252,  -6043\},\n\
+	\{     0,  -1139,  -8286,  -5988\}, \{     0,  -1252,  -8224,  -6388\},\n\
+	\{     0,  -1617,  -8211,  -5983\}, \n\
+};"
+
+calMap[JG03]="\{\n\
+	\{     0,  -5670, -14728, -16999\}, \{     0,  -5942, -14703, -17077\},\n\
+	\{     0,  -5889, -14421, -16670\}, \{     0,  -6039, -14464, -16644\},\n\
+	\{     0,  -5991, -14403, -16390\}, \{     0,  -6103, -14418, -16510\},\n\
+	\{     0,  -5953, -14364, -16180\}, \{     0,  -6154, -14364, -16125\},\n\
+	\{     0,  -5945, -14263, -15929\}, \{     0,  -6075, -14327, -15930\},\n\
+	\{     0,  -5928, -14392, -15878\}, \{     0,  -5986, -14443, -15932\},\n\
+	\{     0,  -5783, -14256, -15873\}, \{     0,  -5945, -14360, -15887\},\n\
+	\{     0,  -5749, -14536, -15874\}, \{     0,  -5733, -14684, -15887\},\n\
+	\{     0,  -5630, -14594, -15987\}, \{     0,  -5752, -14743, -16002\},\n\
+	\{     0,  -5490, -14694, -15993\}, \{     0,  -5481, -14866, -16056\},\n\
+	\{     0,  -5293, -14807, -16060\}, \{     0,  -7935, -20143, -18383\},\n\
+	\{     0,  -7733, -20142, -18482\}, \{     0,  -7628, -20060, -18538\},\n\
+	\{     0,  -7437, -20112, -18495\}, \{     0,  -7314, -20012, -18544\},\n\
+	\{     0,  -7072, -19980, -18573\}, \{     0,  -6986, -20006, -18632\},\n\
+	\{     0,  -6718, -20048, -18569\}, \{     0,  -6601, -19987, -18517\},\n\
+	\{     0,  -6485, -20035, -18537\}, \{     0,  -6292, -20047, -18537\},\n\
+	\{     0,  -6105, -20153, -18482\}, \{     0,  -6081, -20314, -18501\},\n\
+	\{     0,  -5865, -19916, -18164\}, \{     0,  -5786, -20218, -18174\},\n\
+	\{     0,  -5728, -20282, -18110\}, \{     0,  -5690, -20451, -18135\},\n\
+	\{     0,  -5643, -20768, -18154\}, \{     0,  -5603, -20874, -18273\},\n\
+	\{     0,  -5621, -21190, -18095\}, \{     0,  -5522, -21547, -18146\},\n\
+	\{     0,  -5549, -20721, -16825\}, \{     0,  -5547, -21087, -17001\},\n\
+	\{     0,  -5491, -21394, -17040\}, \{     0,  -5484, -21696, -17064\},\n\
+	\{     0,  -5542, -22265, -17091\}, \{     0,  -5483, -22543, -17198\},\n\
+	\{     0,  -5460, -22748, -17254\}, \{     0,  -5417, -22961, -17307\},\n\
+	\{     0,  -5455, -23299, -17323\}, \{     0,  -5445, -23552, -17382\},\n\
+	\{     0,  -5426, -23645, -17428\}, \{     0,  -5480, -23902, -17349\},\n\
+	\{     0,  -5558, -24011, -17360\}, \{     0,  -5569, -24032, -17326\},\n\
+	\{     0,  -5614, -24067, -17305\}, \{     0,  -5656, -24000, -17251\},\n\
+	\{     0,  -5739, -23971, -17228\}, \{     0,  -5777, -23886, -17215\},\n\
+	\{     0,  -5832, -23823, -17051\}, \{     0,  -5891, -23719, -16957\},\n\
+	\{     0,  -6007, -23598, -16925\}, \{     0,  -5893, -20829, -15256\},\n\
+	\{     0,  -5886, -20669, -15091\}, \{     0,  -5883, -20496, -14990\},\n\
+	\{     0,  -5969, -20469, -14898\}, \{     0,  -5971, -20245, -14876\},\n\
+	\{     0,  -5996, -20108, -14764\}, \{     0,  -5979, -19934, -14694\},\n\
+	\{     0,  -5997, -19721, -14571\}, \{     0,  -6046, -19573, -14456\},\n\
+	\{     0,  -6001, -19418, -14381\}, \{     0,  -5942, -19239, -14265\},\n\
+	\{     0,  -5978, -19040, -14240\}, \{     0,  -5928, -18873, -14317\},\n\
+	\{     0,  -5917, -18715, -14238\}, \{     0,  -5865, -18576, -14201\},\n\
+	\{     0,  -5750, -18386, -14200\}, \{     0,  -5772, -18299, -14235\},\n\
+	\{     0,  -5754, -18187, -14300\}, \n\
+};"
+
+calMap[JG05]="\{\n\
+	\{     0,    178,  -7222,   8474\}, \{     0,    218,  -7139,   8383\},\n\
+	\{     0,    215,  -7438,   8352\}, \{     0,    198,  -7247,   8498\},\n\
+	\{     0,    138,  -7640,   8644\}, \{     0,    158,  -7805,   8610\},\n\
+	\{     0,    135,  -7804,   8531\}, \{     0,    143,  -7881,   8575\},\n\
+	\{     0,    165,  -8096,   8584\}, \{     0,    118,  -7962,   8558\},\n\
+	\{     0,    148,  -7947,   8550\}, \{     0,    118,  -8193,   8494\},\n\
+	\{     0,    149,  -8042,   8441\}, \{     0,     59,  -8207,   8454\},\n\
+	\{     0,    101,  -8029,   8575\}, \{     0,    156,  -8029,   8422\},\n\
+	\{     0,    205,  -8074,   8451\}, \{     0,    167,  -7912,   8405\},\n\
+	\{     0,    263,  -7980,   8405\}, \{     0,    258,  -8007,   8404\},\n\
+	\{     0,    288,  -7790,   8342\}, \{     0,   -802, -10286,   6559\},\n\
+	\{     0,   -717, -10120,   6574\}, \{     0,   -590,  -9884,   6675\},\n\
+	\{     0,   -446,  -9651,   6686\}, \{     0,   -371,  -9600,   6700\},\n\
+	\{     0,   -259,  -9243,   6756\}, \{     0,    -77,  -9216,   6768\},\n\
+	\{     0,    108,  -8979,   6844\}, \{     0,    220,  -8769,   6970\},\n\
+	\{     0,    348,  -8820,   6991\}, \{     0,    569,  -8618,   7028\},\n\
+	\{     0,    688,  -8430,   7162\}, \{     0,    798,  -8520,   7293\},\n\
+	\{     0,   1050,  -8141,   7758\}, \{     0,   1284,  -7775,   7850\},\n\
+	\{     0,   1447,  -7625,   7967\}, \{     0,   1527,  -7708,   8032\},\n\
+	\{     0,   1661,  -7547,   8153\}, \{     0,   1784,  -7532,   8169\},\n\
+	\{     0,   1863,  -7560,   8430\}, \{     0,   1977,  -7617,   8609\},\n\
+	\{     0,   1318,  -6902,   8849\}, \{     0,   1390,  -7060,   8848\},\n\
+	\{     0,   1470,  -6967,   8872\}, \{     0,   1532,  -6958,   8915\},\n\
+	\{     0,   1607,  -7162,   8946\}, \{     0,   1718,  -7119,   9030\},\n\
+	\{     0,   1781,  -6970,   9113\}, \{     0,   1807,  -6943,   9071\},\n\
+	\{     0,   1831,  -7114,   9061\}, \{     0,   1899,  -7105,   9088\},\n\
+	\{     0,   1935,  -7026,   9070\}, \{     0,   2040,  -6685,   9125\},\n\
+	\{     0,  -8187,  -6757,   9115\}, \{     0, -10749,  -6464,   9194\},\n\
+	\{     0, -21024,  -6513,   9071\}, \{     0,   6072,  -6529,   9040\},\n\
+	\{     0, -22290,  -6590,   9075\}, \{     0, -12054,  -6510,   9114\},\n\
+	\{     0, -18487,  -6491,   9179\}, \{     0, -12050,  -6878,   9144\},\n\
+	\{     0,  -4425,  -6526,   9189\}, \{     0,   2575,  -4991,  10202\},\n\
+	\{     0,   2566,  -4792,  10308\}, \{     0,   2596,  -4920,  10513\},\n\
+	\{     0,   2585,  -5106,  10573\}, \{     0,   2538,  -5290,  10578\},\n\
+	\{     0,   2560,  -5424,  10627\}, \{     0,   2613,  -5352,  10915\},\n\
+	\{     0,   2531,  -5578,  10919\}, \{     0,   2545,  -5652,  11012\},\n\
+	\{     0,   2646,  -5819,  11079\}, \{     0,   2661,  -6046,  11136\},\n\
+	\{     0,   2692,  -6314,  11187\}, \{     0,   2759,  -6284,  11209\},\n\
+	\{     0,   2739,  -6557,  11185\}, \{     0,   2815,  -6469,  11256\},\n\
+	\{     0,   2849,  -6807,  11103\}, \{     0,   2850,  -6769,  11097\},\n\
+	\{     0,   2923,  -6999,  11232\}, \n\
+};"
+
+calMap[JG06]="\{\n\
+	\{     0,  -3836,  -1067,   4891\}, \{     0,  -4831,  -2098,   4103\},\n\
+	\{     0,  -4849,  -1871,   4566\}, \{     0,  -4534,  -1666,   4512\},\n\
+	\{     0,  -5764,  -2767,   4245\}, \{     0,  -5591,  -2123,   4174\},\n\
+	\{     0,  -4727,  -1565,   4368\}, \{     0,  -5834,  -2262,   3942\},\n\
+	\{     0,  -5421,  -2062,   3790\}, \{     0,  -4996,  -1380,   4260\},\n\
+	\{     0,  -5538,  -1861,   3494\}, \{     0,  -5272,  -1652,   3740\},\n\
+	\{     0,  -5561,  -1802,   4038\}, \{     0,  -5320,  -1734,   3742\},\n\
+	\{     0,  -4354,  -1230,   4170\}, \{     0,  -5705,  -1862,   3840\},\n\
+	\{     0,  -6223,  -2211,   3218\}, \{     0,  -5048,  -1596,   3669\},\n\
+	\{     0,  -5235,  -1541,   3735\}, \{     0,  -6009,  -2219,   3301\},\n\
+	\{     0,  -5545,  -1879,   3686\}, \{     0,  -7174,  -2853,   -434\},\n\
+	\{     0,  -6759,  -3117,     56\}, \{     0,  -7376,  -3291,    221\},\n\
+	\{     0,  -7601,  -3243,    150\}, \{     0,  -7065,  -2752,    -42\},\n\
+	\{     0,  -7701,  -2828,   -144\}, \{     0,  -7598,  -3002,    464\},\n\
+	\{     0,  -7312,  -2476,    399\}, \{     0,  -7939,  -2374,    -62\},\n\
+	\{     0,  -7622,  -2213,    482\}, \{     0,  -6715,  -1688,   1033\},\n\
+	\{     0,  -6755,  -1445,    722\}, \{     0,  -6817,  -1385,   1061\},\n\
+	\{     0,  -6155,   -864,   1431\}, \{     0,  -6700,  -1746,   1070\},\n\
+	\{     0,  -6973,  -1127,    835\}, \{     0,  -6456,  -1152,    686\},\n\
+	\{     0,  -6542,  -1505,   1059\}, \{     0,  -6659,  -1374,    584\},\n\
+	\{     0,  -6605,   -983,    630\}, \{     0,  -6366,  -1046,    800\},\n\
+	\{     0,  -4668,    343,   1086\}, \{     0,  -5072,    560,    468\},\n\
+	\{     0,  -4124,   1399,   1284\}, \{     0,  -3465,  10068,  22599\},\n\
+	\{     0,  -4167,   2018,   1119\}, \{     0,  -4910,   1612,    717\},\n\
+	\{     0,  -4917,   1600,    968\}, \{     0,  -4171,   1731,    430\},\n\
+	\{     0,  -3432,  13873,    166\}, \{     0,  -3571,   2840,    870\},\n\
+	\{     0,  -3060,   2468,    463\}, \{     0,  -2858,   2369,    373\},\n\
+	\{     0,  -2948,   3186,    438\}, \{     0,  -3305,   2984,   -160\},\n\
+	\{     0,  -2027,   3128,   -798\}, \{     0,  -2663,   3320,   -865\},\n\
+	\{     0,  -3992,   -562,  -1509\}, \{     0,  -2913,   2844,  -1081\},\n\
+	\{     0,  -3205,   3373,  -1418\}, \{     0,  -3366,   3063,  -1645\},\n\
+	\{     0,  -3878,   2873,   -920\}, \{     0,  -1801,   6168,   2384\},\n\
+	\{     0,  -1252,   6409,   2308\}, \{     0,  -1724,   6027,   2474\},\n\
+	\{     0,  -1937,   5849,   2730\}, \{     0,  -1921,   5622,   2349\},\n\
+	\{     0,  -2162,   5995,  -1804\}, \{     0,  -1707,   6306,   2744\},\n\
+	\{     0,  -1334,   5651,   3112\}, \{     0,  -2132,   5216,   2588\},\n\
+	\{     0,  -1878,   5912,   2448\}, \{     0,  -1233,   5205,   2467\},\n\
+	\{     0,  -1139,   5350,   2967\}, \{     0,  -2373,   5368, -23580\},\n\
+	\{     0,  -1706,   5450,   2374\}, \{     0,  -1718,   5876,   2333\},\n\
+	\{     0,  -1569,   5961,   2570\}, \{     0,  -1177,   6423,   2665\},\n\
+	\{     0,  -1210,   5976,   2608\}, \n\
+};"
+
+calMap[LJ01]="\{\n\
+	\{     0,   5716,  -1041, -12697\}, \{     0,   5110,  -1450, -13222\},\n\
+	\{     0,   4487,  -1630, -13282\}, \{     0,   4606,  -1821, -13197\},\n\
+	\{     0,   4663,  -2299, -13302\}, \{     0,   4092,  -2324, -13451\},\n\
+	\{     0,   4233,  -2419, -13189\}, \{     0,   3702,  -2961, -14147\},\n\
+	\{     0,   3167,  -3408, -14660\}, \{     0,   3564,  -3255, -13877\},\n\
+	\{     0,   3320,  -3407, -13671\}, \{     0,   3137,  -3350, -13820\},\n\
+	\{     0,   3342,  -3703, -13808\}, \{     0,   3519,  -3970, -14069\},\n\
+	\{     0,   2983,  -4415, -14335\}, \{     0,   3636,  -3825, -13840\},\n\
+	\{     0,   3461,  -3922, -14323\}, \{     0,   3419,  -4022, -14031\},\n\
+	\{     0,   3763,  -4066, -13832\}, \{     0,   3929,  -3504, -13827\},\n\
+	\{     0,   3634,  -4035, -14096\}, \{     0,   3195,  -6232, -14808\},\n\
+	\{     0,   3428,  -6179, -14913\}, \{     0,   3506,  -5525, -14510\},\n\
+	\{     0,   3754,  -5724, -14134\}, \{     0,   3630,  -5791, -14743\},\n\
+	\{     0,   3857,  -5548, -14269\}, \{     0,   4654,  -4964, -13701\},\n\
+	\{     0,   4853,  -4388, -13822\}, \{     0,   4735,  -4632, -13864\},\n\
+	\{     0,   4981,  -4381, -13979\}, \{     0,   5528,  -3984, -13626\},\n\
+	\{     0,   5130,  -4326, -13639\}, \{     0,   5095,  -3792, -13638\},\n\
+	\{     0,   5346,  -3366, -13030\}, \{     0,   5498,  -3496, -13682\},\n\
+	\{     0,   5144,  -3120, -13986\}, \{     0,   5427,  -2871, -12931\},\n\
+	\{     0,   5939,  -2824, -12646\}, \{     0,   6030,  -2983, -12662\},\n\
+	\{     0,   5959,  -3142, -12116\}, \{     0,   5903,  -2700, -11731\},\n\
+	\{     0,   6256,  -3546, -10932\}, \{     0,   6384,  -3767, -11326\},\n\
+	\{     0,   6086,  -3399, -11769\}, \{     0,   5915,  -3257, -12066\},\n\
+	\{     0,   6257,  -4021, -12273\}, \{     0,   6084,  -4192, -12153\},\n\
+	\{     0,   5482,  -4102, -12637\}, \{     0,   5836,  -3698, -12767\},\n\
+	\{     0,   6025,  -4014, -13219\}, \{     0,   5713,  -3812, -14315\},\n\
+	\{     0,   5997,  -3855, -14788\}, \{     0,   5866,  -3905, -15408\},\n\
+	\{     0,   5328,  -4627, -16458\}, \{     0,   5686,  -3646, -14885\},\n\
+	\{     0,   5551,  -3407, -15112\}, \{     0,   5720,  -3165, -14247\},\n\
+	\{     0,   6044,  -3818, -14224\}, \{     0,   5963,  -3342, -14531\},\n\
+	\{     0,   6128,  -3225, -13495\}, \{     0,   6564,  -3662, -13408\},\n\
+	\{     0,   6000,  -3479, -13609\}, \{     0,   5876,  -3190, -11817\},\n\
+	\{     0,   7165,  -2876, -10874\}, \{     0,   6593,  -4000, -11565\},\n\
+	\{     0,   6207,  -3694, -11278\}, \{     0,   6732,  -2326, -11167\},\n\
+	\{     0,   6335,  -3650, -11508\}, \{     0,   6220,  -4220, -12438\},\n\
+	\{     0,   6069,  -3838, -12545\}, \{     0,   6182,  -4635, -12472\},\n\
+	\{     0,   5696,  -4834, -12334\}, \{     0,   6047,  -4121, -11691\},\n\
+	\{     0,   6324,  -4125, -10980\}, \{     0,   6102,  -3923, -10939\},\n\
+	\{     0,   6091,  -3829, -10736\}, \{     0,   5858,  -4001, -10473\},\n\
+	\{     0,   5473,  -4773, -11209\}, \{     0,   6045,  -4642, -10361\},\n\
+	\{     0,   5494,  -4391, -10203\}, \n\
+};"
+
+calMap[LJ02]="\{\n\
+	\{     0,   -726,    598,  -2561\}, \{     0,   -743,    864,  -2549\},\n\
+	\{     0,   -769,    992,  -2477\}, \{     0,   -905,    665,  -2742\},\n\
+	\{     0,   -944,    665,  -2710\}, \{     0,  -1180,    727,  -2794\},\n\
+	\{     0,  -1012,    642,  -2599\}, \{     0,  -1195,    690,  -2770\},\n\
+	\{     0,  -1191,    667,  -2846\}, \{     0,  -1173,    684,  -2759\},\n\
+	\{     0,  -1158,    708,  -2795\}, \{     0,  -1072,    678,  -2852\},\n\
+	\{     0,  -1175,    872,  -2747\}, \{     0,  -1011,    862,  -2673\},\n\
+	\{     0,  -1086,    755,  -2927\}, \{     0,  -1042,   1076,  -2731\},\n\
+	\{     0,  -1042,    914,  -2765\}, \{     0,   -758,   1182,  -2443\},\n\
+	\{     0,   -757,   1219,  -2500\}, \{     0,   -534,   1472,  -2295\},\n\
+	\{     0,   -497,   1543,  -2104\}, \{     0,  -1267,   -632,  -3273\},\n\
+	\{     0,  -1133,   -761,  -3048\}, \{     0,  -1065,   -375,  -2952\},\n\
+	\{     0,   -722,   -133,  -2551\}, \{     0,   -586,     52,  -2505\},\n\
+	\{     0,   -546,     67,  -2219\}, \{     0,   -477,    177,  -2017\},\n\
+	\{     0,   -317,    317,  -1888\}, \{     0,   -161,    364,  -1712\},\n\
+	\{     0,      5,    359,  -1770\}, \{     0,   -283,    214,  -1901\},\n\
+	\{     0,    -59,    353,  -1551\}, \{     0,    108,    454,  -1465\},\n\
+	\{     0,    -74,    796,  -1225\}, \{     0,     41,    685,  -1221\},\n\
+	\{     0,     84,    576,  -1318\}, \{     0,     14,    504,  -1313\},\n\
+	\{     0,     37,    448,  -1301\}, \{     0,     18,    344,  -1408\},\n\
+	\{     0,    -70,    240,  -1384\}, \{     0,    -27,    186,  -1595\},\n\
+	\{     0,    622,    981,   -855\}, \{     0,    351,    889,  -1188\},\n\
+	\{     0,    475,    758,  -1328\}, \{     0,    305,   1025,  -1222\},\n\
+	\{     0,    526,    609,  -1397\}, \{     0,    398,    426,  -1695\},\n\
+	\{     0,    237,    543,  -1835\}, \{     0,    357,    739,  -1747\},\n\
+	\{     0,    400,    699,  -1834\}, \{     0,    319,    943,  -1998\},\n\
+	\{     0,    244,    783,  -2197\}, \{     0,    249,    976,  -2195\},\n\
+	\{     0,    266,    859,  -2406\}, \{     0,    332,    959,  -2477\},\n\
+	\{     0,    225,    968,  -2554\}, \{     0,     97,    808,  -2815\},\n\
+	\{     0,     73,    895,  -2852\}, \{     0,   -155,    877,  -2986\},\n\
+	\{     0,    -71,    914,  -2943\}, \{     0,   -232,    862,  -2966\},\n\
+	\{     0,   -347,    772,  -3176\}, \{     0,    675,    250,   -956\},\n\
+	\{     0,    589,    204,   -935\}, \{     0,    459,    110,   -867\},\n\
+	\{     0,    149,    -88,  -1251\}, \{     0,    272,   -145,   -930\},\n\
+	\{     0,    304,    -62,   -857\}, \{     0,     24,   -487,  -1384\},\n\
+	\{     0,     51,    -31,   -984\}, \{     0,    154,    -77,   -992\},\n\
+	\{     0,    -23,   -238,  -1234\}, \{     0,     28,   -331,  -1323\},\n\
+	\{     0,    104,   -415,  -1424\}, \{     0,   -177,   -633,  -1704\},\n\
+	\{     0,     21,   -514,  -1572\}, \{     0,    210,   -796,  -1584\},\n\
+	\{     0,    133,   -693,  -1782\}, \{     0,    161,   -882,  -1824\},\n\
+	\{     0,    118,  -1098,  -1994\}, \n\
+};"
+
+calMap[LJ03]="\{\n\
+	\{     0,  13063,  -4747, -10433\}, \{     0,   3443,  -4140,  -9849\},\n\
+	\{     0,   7069,  -4629, -10540\}, \{     0,  13946,  -4544, -10775\},\n\
+	\{     0,  12968,  -4307, -10347\}, \{     0,  20281,  -5019, -11282\},\n\
+	\{     0,  22661,  -5079, -11148\}, \{     0,  16734,  -4442, -10374\},\n\
+	\{     0,  15423,  -4074, -10422\}, \{     0,  22851,  -4441, -10405\},\n\
+	\{     0,  14291,  -3978,  -9960\}, \{     0,   4367,  -3954,  -9810\},\n\
+	\{     0,  11785,  -3957, -10150\}, \{     0,   3218,  -3775,  -9825\},\n\
+	\{     0,   3344,  -3314,  -9254\}, \{     0,   6873,  -3528,  -9614\},\n\
+	\{     0,   3630,  -3230,  -9069\}, \{     0,   3442,  -3275,  -9653\},\n\
+	\{     0,   3346,  -3858,  -9895\}, \{     0,   3721,  -3391,  -9296\},\n\
+	\{     0,   3261,  -3428,  -9383\}, \{     0, -24770,  -8031, -10490\},\n\
+	\{     0, -24608,  -7690, -10198\}, \{     0, -24868,  -7897,  -9937\},\n\
+	\{     0, -24880,  -7994, -10295\}, \{     0, -24908,  -7089, -10312\},\n\
+	\{     0, -24547,  -7588, -10044\}, \{     0, -24905,  -8076,  -9985\},\n\
+	\{     0, -24646,  -7229,  -9709\}, \{     0, -24916,  -7800, -10193\},\n\
+	\{     0, -25334,  -8019, -10733\}, \{     0, -24839,  -7637, -10037\},\n\
+	\{     0, -25020,  -7138,  -9907\}, \{     0, -24502,  -7503, -10369\},\n\
+	\{     0, -24471,  -7222, -10546\}, \{     0, -24537,  -7066, -10359\},\n\
+	\{     0, -24407,  -6616,  -9797\}, \{     0, -23898,  -7370, -10755\},\n\
+	\{     0, -24587,  -7630, -10656\}, \{     0, -24411,  -7258, -11072\},\n\
+	\{     0, -24028,  -7203, -10471\}, \{     0, -24139,  -7585, -10014\},\n\
+	\{     0, -23817,  -6456, -10002\}, \{     0, -24122,  -6453, -10354\},\n\
+	\{     0,  25236,  -6345,  -9380\}, \{     0,  25260,  -6144,  -9727\},\n\
+	\{     0, -25031,  -6591, -10264\}, \{     0,  11624,  -6478, -10071\},\n\
+	\{     0,  11896,  -5407,  -9780\}, \{     0,  14144,  -5554, -10328\},\n\
+	\{     0,   5556,  -5558, -10775\}, \{     0,   3406,  -5945, -10115\},\n\
+	\{     0,   3384,  -5384, -10050\}, \{     0,   3263,  -4468,  -9634\},\n\
+	\{     0,   5991,  -4734,  -9494\}, \{     0,   3953,  -5377, -10430\},\n\
+	\{     0,   4514,  -3687,  -9547\}, \{     0,   4487,  -3691,  -9332\},\n\
+	\{     0,   5085,  -4417,  -9657\}, \{     0,   5222,  -3694,  -9115\},\n\
+	\{     0,   4960,  -4086,  -8862\}, \{     0,   4994,  -4292,  -9127\},\n\
+	\{     0,   5162,  -4509,  -8554\}, \{     0,   4337,  -5390,  -8443\},\n\
+	\{     0,   4628,  -4976,  -9047\}, \{     0,   4293,  -4876,  -9218\},\n\
+	\{     0,   4465,  -5352,  -9014\}, \{     0,   4428,  -4936,  -9521\},\n\
+	\{     0,   4048,  -5497,  -9795\}, \{     0,   4290,  -6034,  -9032\},\n\
+	\{     0,   4184,  -4996,  -8434\}, \{     0,   3950,  -4983,  -8474\},\n\
+	\{     0,   4247,  -4407,  -7955\}, \{     0,   4386,  -4769,  -8079\},\n\
+	\{     0,   4311,  -5367,  -8478\}, \{     0,   4283,  -4809,  -8025\},\n\
+	\{     0,   3885,  -4011,  -7495\}, \{     0,   3885,  -4593,  -7577\},\n\
+	\{     0,   3622,  -5239,  -8157\}, \{     0,   3576,  -5007,  -7816\},\n\
+	\{     0,   3778,  -3793,  -7362\}, \n\
+};"
+
+calMap[LJ04]="\{\n\
+	\{     0,  -3188,  -5668,  -7029\}, \{     0,  -3144,  -5592,  -6708\},\n\
+	\{     0,  -3332,  -5859,  -7135\}, \{     0,  -3402,  -5694,  -6908\},\n\
+	\{     0,  -3376,  -5858,  -7070\}, \{     0,  -3383,  -5474,  -6886\},\n\
+	\{     0,  -3518,  -5487,  -6925\}, \{     0,  -3383,  -5342,  -6659\},\n\
+	\{     0,  -3487,  -5535,  -6848\}, \{     0,  -3472,  -5206,  -6576\},\n\
+	\{     0,  -3432,  -5335,  -6581\}, \{     0,  -3502,  -5071,  -6421\},\n\
+	\{     0,  -3549,  -5020,  -6390\}, \{     0,  -3618,  -4961,  -6310\},\n\
+	\{     0,  -3774,  -4938,  -6377\}, \{     0,  -3868,  -5039,  -6488\},\n\
+	\{     0,  -3865,  -4778,  -6328\}, \{     0,  -3812,  -4602,  -6360\},\n\
+	\{     0,  -3990,  -4498,  -6189\}, \{     0,  -3820,  -4493,  -6070\},\n\
+	\{     0,  -3793,  -4262,  -5963\}, \{     0,  -4355,  -5745,  -6648\},\n\
+	\{     0,  -4372,  -5742,  -6633\}, \{     0,  -4458,  -5618,  -6650\},\n\
+	\{     0,  -4484,  -5695,  -6732\}, \{     0,  -4367,  -5513,  -6642\},\n\
+	\{     0,  -4433,  -5498,  -6628\}, \{     0,  -4364,  -5480,  -6563\},\n\
+	\{     0,  -4344,  -5382,  -6497\}, \{     0,  -4255,  -5470,  -6465\},\n\
+	\{     0,  -4154,  -5145,  -6183\}, \{     0,  -4211,  -5200,  -6136\},\n\
+	\{     0,  -4086,  -5205,  -6195\}, \{     0,  -4113,  -5261,  -6338\},\n\
+	\{     0,  -4069,  -4832,  -5831\}, \{     0,  -3835,  -4826,  -5801\},\n\
+	\{     0,  -4030,  -5011,  -6065\}, \{     0,  -3711,  -4838,  -5795\},\n\
+	\{     0,  -3644,  -4881,  -5899\}, \{     0,  -3507,  -4813,  -5800\},\n\
+	\{     0,  -3453,  -4947,  -5520\}, \{     0,  -3374,  -4954,  -5642\},\n\
+	\{     0,  -4837,  -5736,  -7500\}, \{     0,  -4470,  -5620,  -7385\},\n\
+	\{     0,  -4401,  -5408,  -7370\}, \{     0,  -4271,  -5626,  -7496\},\n\
+	\{     0,  -4286,  -5828,  -7556\}, \{     0,  -4184,  -5982,  -7565\},\n\
+	\{     0,  -3923,  -5491,  -7415\}, \{     0,  -3926,  -5554,  -7685\},\n\
+	\{     0,  -3657,  -5235,  -7542\}, \{     0,  -3530,  -5104,  -7717\},\n\
+	\{     0,  -3370,  -4853,  -7737\}, \{     0,  -3224,  -4703,  -7679\},\n\
+	\{     0,  -3100,  -4620,  -7733\}, \{     0,  -3010,  -4547,  -7648\},\n\
+	\{     0,  -2838,  -4318,  -7619\}, \{     0,  -2907,  -4260,  -7604\},\n\
+	\{     0,  -2883,  -4306,  -7768\}, \{     0,  -2878,  -3949,  -7601\},\n\
+	\{     0,  -2927,  -4097,  -7840\}, \{     0,  -2816,  -3790,  -7544\},\n\
+	\{     0,  -2853,  -3654,  -7534\}, \{     0,  -2052,  -2142,  -3986\},\n\
+	\{     0,  -2109,  -2259,  -4027\}, \{     0,  -2132,  -2002,  -3745\},\n\
+	\{     0,  -2275,  -2181,  -3810\}, \{     0,  -2353,  -1951,  -3419\},\n\
+	\{     0,  -2428,  -2046,  -3391\}, \{     0,  -2537,  -1974,  -3301\},\n\
+	\{     0,  -2568,  -1805,  -3074\}, \{     0,  -2764,  -1930,  -3068\},\n\
+	\{     0,  -2793,  -1922,  -2816\}, \{     0,  -2931,  -2060,  -2982\},\n\
+	\{     0,  -3118,  -2158,  -2858\}, \{     0,  -3370,  -2240,  -3088\},\n\
+	\{     0,  -3411,  -2369,  -3055\}, \{     0,  -3867,  -2590,  -3016\},\n\
+	\{     0,  -3965,  -2696,  -3099\}, \{     0,  -4112,  -2907,  -3438\},\n\
+	\{     0,  -4226,  -2747,  -3341\}, \n\
+};"
+
+calMap[LJ06]="\{\n\
+	\{     0,  -4989,  -7102,  -2178\}, \{     0,  -5092,  -7204,  -2325\},\n\
+	\{     0,  -4959,  -7013,  -2137\}, \{     0,  -4960,  -6784,  -1920\},\n\
+	\{     0,  -5025,  -6734,  -2104\}, \{     0,  -5181,  -6637,  -2017\},\n\
+	\{     0,  -5262,  -6792,  -2110\}, \{     0,  -5362,  -6621,  -2110\},\n\
+	\{     0,  -5258,  -6451,  -2031\}, \{     0,  -5375,  -6390,  -2064\},\n\
+	\{     0,  -5280,  -6288,  -2052\}, \{     0,  -5445,  -6434,  -2101\},\n\
+	\{     0,  -5553,  -6402,  -2272\}, \{     0,  -5603,  -6628,  -2477\},\n\
+	\{     0,  -5661,  -6626,  -2492\}, \{     0,  -5731,  -6618,  -2616\},\n\
+	\{     0,  -5746,  -6626,  -2664\}, \{     0,  -6007,  -7024,  -2951\},\n\
+	\{     0,  -6018,  -7010,  -2969\}, \{     0,  -5746,  -6939,  -2833\},\n\
+	\{     0,  -5770,  -7034,  -3026\}, \{     0,  -8509,  -8777,  -6863\},\n\
+	\{     0,  -8593,  -9060,  -6868\}, \{     0,  -8514,  -9104,  -6795\},\n\
+	\{     0,  -8401,  -9387,  -6931\}, \{     0,  -8236,  -9191,  -6586\},\n\
+	\{     0,  -8155,  -9371,  -6595\}, \{     0,  -8192,  -9551,  -6363\},\n\
+	\{     0,  -7995,  -9550,  -6185\}, \{     0,  -7968,  -9690,  -6220\},\n\
+	\{     0,  -7826,  -9694,  -6052\}, \{     0,  -7694,  -9660,  -5763\},\n\
+	\{     0,  -7857, -10020,  -5947\}, \{     0,  -7543,  -9682,  -5463\},\n\
+	\{     0,  -7184,  -9071,  -4747\}, \{     0,  -7282,  -9220,  -4767\},\n\
+	\{     0,  -7417,  -9371,  -4765\}, \{     0,  -7238,  -9321,  -4430\},\n\
+	\{     0,  -7320,  -9420,  -4560\}, \{     0,  -7254,  -9185,  -4270\},\n\
+	\{     0,  -7378,  -9262,  -4324\}, \{     0,  -7078,  -9074,  -3976\},\n\
+	\{     0, -10047, -10956,  -7258\}, \{     0, -10107, -10961,  -7192\},\n\
+	\{     0, -10264, -11167,  -7427\}, \{     0, -10160, -10823,  -7282\},\n\
+	\{     0, -10276, -11378,  -7508\}, \{     0, -10576, -11282,  -7688\},\n\
+	\{     0, -10801, -11460,  -7845\}, \{     0, -10822, -10983,  -7809\},\n\
+	\{     0, -10947, -10998,  -8018\}, \{     0, -11215, -10876,  -8255\},\n\
+	\{     0, -11247, -10590,  -8188\}, \{     0, -11302, -10269,  -8237\},\n\
+	\{     0, -11583, -10213,  -8413\}, \{     0, -11561, -10001,  -8448\},\n\
+	\{     0, -11482,  -9425,  -8273\}, \{     0, -11573,  -9203,  -8344\},\n\
+	\{     0, -11661,  -8895,  -8267\}, \{     0, -11843,  -8879,  -8259\},\n\
+	\{     0, -11799,  -8715,  -8112\}, \{     0, -12002,  -8422,  -8238\},\n\
+	\{     0, -12022,  -8434,  -8409\}, \{     0,  -8755,  -4274,  -4932\},\n\
+	\{     0,  -9183,  -4523,  -5458\}, \{     0,  -9293,  -4300,  -5260\},\n\
+	\{     0,  -9530,  -4543,  -5569\}, \{     0,  -9573,  -4168,  -5429\},\n\
+	\{     0,  -9847,  -4448,  -5638\}, \{     0,  -9999,  -4504,  -5969\},\n\
+	\{     0,  -9858,  -4176,  -5716\}, \{     0,  -9988,  -4378,  -5978\},\n\
+	\{     0,  -9760,  -3942,  -5627\}, \{     0, -10072,  -4163,  -6002\},\n\
+	\{     0,  -9892,  -4091,  -5833\}, \{     0,  -9873,  -3867,  -5828\},\n\
+	\{     0,  -9911,  -4149,  -5877\}, \{     0,  -9844,  -4016,  -5908\},\n\
+	\{     0,  -9528,  -3912,  -5604\}, \{     0,  -9432,  -3911,  -5648\},\n\
+	\{     0,  -9314,  -3730,  -5422\}, \n\
+};"
+

calibration_data/dataGen.m

@@ -0,0 +1,40 @@
+clear;clc;
+
+fid = fopen("../caldata", "w");
+fprintf(fid, "declare -A calMap\n");
+
+for i = 1:6
+    id = sprintf("JG%02d", i);
+    write_data(fid, pwd, id);
+end
+
+for i = 1:6
+    id = sprintf("LJ%02d", i);
+    write_data(fid, pwd, id);
+end
+
+fclose(fid);
+
+function write_data(fid, folder_name, dev_id)
+    file_path = sprintf("%s/phase_%s.mat", folder_name, dev_id);
+    if ~isfile(file_path)
+         warning('[%s] dose not exist.\n', file_path);
+         return;
+    end
+    load(file_path);
+    data = sortrows(dataDec1, 1);
+    fprintf(fid, 'calMap[%s]="\\{\\n\\\n', dev_id);
+    for i = 1:size(data,1)
+        if (mod(i, 2) == 1)
+            fprintf(fid, "\t");
+        end
+        fprintf(fid, "\\{%6d, %6d, %6d, %6d\\},", ...
+            data(i,2), data(i,3), data(i,4), data(i,5));
+        if (mod(i, 2) == 1)
+            fprintf(fid, " ");
+        else
+            fprintf(fid, "\\n\\\n");
+        end
+    end
+    fprintf(fid, '\\n\\\n};"\n\n');
+end

comtool-plugin-duifei.py

@@ -22,7 +22,7 @@ except ImportError:
     from COMTool.widgets import statusBar
 
 class Plugin(Plugin_Base):
-    id = "DEIFEI"
+    id = "DUIFEI"
     name = _("DUIFEI")
     showReceiveDataSignal = pyqtSignal(str)
 
@@ -181,7 +181,7 @@ class Plugin(Plugin_Base):
         self.config["customSendItems"] = newItems
         self.showReceiveDataSignal.connect(self.showReceivedData)
         # frame struct
-        self.structSelfTestRsp = Struct("<BB B BBBbbb BbBBB H")
+        self.structSelfTestRsp = Struct("<BB B BBBbbb BbBBB BB")
         self.structStatusCheckRsp = Struct("<BB Q      HIII      IBBBBI BBHH HHHIIIIII i II 4s      IIII d Q dBB dB H B 3s      BBBbbb BbBBB 2s")
         self.structFljData = Struct("<dddd IHI fff fff")
         self.structLjData = Struct("<IHI ffff IHI fff fff fff IHI fff fff fff IHI fff fff fff I")
@@ -260,6 +260,8 @@ class Plugin(Plugin_Base):
 
         ret = "----------- 自检回令 -----------\n"
 
+        ret += f"节点编号: 0x{payload[-2]:02X}\n"
+
         ret += "节点类型: "
         if payload[1] == 0xDD:
             ret += f"K频段 (0x{payload[1]:02X})\n"

df_datalink_ge/build/src/dev_profile/subdir.mk

@@ -23,7 +23,7 @@ C_DEPS += \
 src/dev_profile/%.o: ../src/dev_profile/%.c
 	@echo 'Building file: $<'
 	@echo 'Invoking: ARM v7 gcc compiler'
-	$(CC) -Wall -O0 -g3 -I../bsp/ps7_cortexa9_0/include -I../src/include -c -fmessage-length=0 -MT"$@" -mcpu=cortex-a9 -mfpu=vfpv3 -mfloat-abi=hard -MMD -MP -MF"$(@:%.o=%.d)" -MT"$(@)" -o "$@" "$<"
+	$(CC) -std=c17 -pedantic -Wall -O0 -g3 -I../bsp/ps7_cortexa9_0/include -I../src/include -c -fmessage-length=0 -MT"$@" -mcpu=cortex-a9 -mfpu=vfpv3 -mfloat-abi=hard -MMD -MP -MF"$(@:%.o=%.d)" -MT"$(@)" -o "$@" "$<"
 	@echo 'Finished building: $<'
 	@echo ' '
 

df_datalink_ge/build/src/mpc/subdir.mk

@@ -20,7 +20,7 @@ C_DEPS += \
 src/systembus/%.o: ../src/systembus/%.c
 	@echo 'Building file: $<'
 	@echo 'Invoking: ARM v7 gcc compiler'
-	$(CC) -Wall -O0 -g3 -I../bsp/ps7_cortexa9_0/include -I../src/include -c -fmessage-length=0 -MT"$@" -mcpu=cortex-a9 -mfpu=vfpv3 -mfloat-abi=hard -MMD -MP -MF"$(@:%.o=%.d)" -MT"$(@)" -o "$@" "$<"
+	$(CC) -std=c17 -pedantic -Wall -O0 -g3 -I../bsp/ps7_cortexa9_0/include -I../src/include -c -fmessage-length=0 -MT"$@" -mcpu=cortex-a9 -mfpu=vfpv3 -mfloat-abi=hard -MMD -MP -MF"$(@:%.o=%.d)" -MT"$(@)" -o "$@" "$<"
 	@echo 'Finished building: $<'
 	@echo ' '
 

df_datalink_ge/build/src/networking/link_layer/geometry/subdir.mk

@@ -23,7 +23,7 @@ C_DEPS += \
 src/networking/link_layer/geometry/%.o: ../src/networking/link_layer/geometry/%.c
 	@echo 'Building file: $<'
 	@echo 'Invoking: ARM v7 gcc compiler'
-	$(CC) -Wall -O0 -g3 -I../bsp/ps7_cortexa9_0/include -I../src/include -c -fmessage-length=0 -MT"$@" -mcpu=cortex-a9 -mfpu=vfpv3 -mfloat-abi=hard -MMD -MP -MF"$(@:%.o=%.d)" -MT"$(@)" -o "$@" "$<"
+	$(CC) -std=c17 -pedantic -Wall -O0 -g3 -I../bsp/ps7_cortexa9_0/include -I../src/include -c -fmessage-length=0 -MT"$@" -mcpu=cortex-a9 -mfpu=vfpv3 -mfloat-abi=hard -MMD -MP -MF"$(@:%.o=%.d)" -MT"$(@)" -o "$@" "$<"
 	@echo 'Finished building: $<'
 	@echo ' '
 

df_datalink_ge/build/src/networking/link_layer/subdir.mk

@@ -38,7 +38,7 @@ C_DEPS += \
 src/networking/link_layer/%.o: ../src/networking/link_layer/%.c
 	@echo 'Building file: $<'
 	@echo 'Invoking: ARM v7 gcc compiler'
-	$(CC) -Wall -O0 -g3 -I../bsp/ps7_cortexa9_0/include -I../src/include -c -fmessage-length=0 -MT"$@" -mcpu=cortex-a9 -mfpu=vfpv3 -mfloat-abi=hard -MMD -MP -MF"$(@:%.o=%.d)" -MT"$(@)" -o "$@" "$<"
+	$(CC) -std=c17 -pedantic -Wall -O0 -g3 -I../bsp/ps7_cortexa9_0/include -I../src/include -c -fmessage-length=0 -MT"$@" -mcpu=cortex-a9 -mfpu=vfpv3 -mfloat-abi=hard -MMD -MP -MF"$(@:%.o=%.d)" -MT"$(@)" -o "$@" "$<"
 	@echo 'Finished building: $<'
 	@echo ' '
 

df_datalink_ge/build/src/networking/phy_layer/subdir.mk

@@ -20,7 +20,7 @@ C_DEPS += \
 src/networking/phy_layer/%.o: ../src/networking/phy_layer/%.c
 	@echo 'Building file: $<'
 	@echo 'Invoking: ARM v7 gcc compiler'
-	$(CC) -Wall -O0 -g3 -I../bsp/ps7_cortexa9_0/include -I../src/include -c -fmessage-length=0 -MT"$@" -mcpu=cortex-a9 -mfpu=vfpv3 -mfloat-abi=hard -MMD -MP -MF"$(@:%.o=%.d)" -MT"$(@)" -o "$@" "$<"
+	$(CC) -std=c17 -pedantic -Wall -O0 -g3 -I../bsp/ps7_cortexa9_0/include -I../src/include -c -fmessage-length=0 -MT"$@" -mcpu=cortex-a9 -mfpu=vfpv3 -mfloat-abi=hard -MMD -MP -MF"$(@:%.o=%.d)" -MT"$(@)" -o "$@" "$<"
 	@echo 'Finished building: $<'
 	@echo ' '
 

df_datalink_ge/build/src/subdir.mk

@@ -23,7 +23,7 @@ C_DEPS += \
 src/%.o: ../src/%.c
 	@echo 'Building file: $<'
 	@echo 'Invoking: ARM v7 gcc compiler'
-	$(CC) -Wall -O0 -g3 -I../bsp/ps7_cortexa9_0/include -I../src/include -c -fmessage-length=0 -MT"$@" -mcpu=cortex-a9 -mfpu=vfpv3 -mfloat-abi=hard -MMD -MP -MF"$(@:%.o=%.d)" -MT"$(@)" -o "$@" "$<"
+	$(CC) -std=c17 -pedantic -Wall -O0 -g3 -I../bsp/ps7_cortexa9_0/include -I../src/include -c -fmessage-length=0 -MT"$@" -mcpu=cortex-a9 -mfpu=vfpv3 -mfloat-abi=hard -MMD -MP -MF"$(@:%.o=%.d)" -MT"$(@)" -o "$@" "$<"
 	@echo 'Finished building: $<'
 	@echo ' '
 

df_datalink_ge/build/src/time_ctrl/subdir.mk

@@ -17,7 +17,7 @@ C_DEPS += \
 src/time_ctrl/%.o: ../src/time_ctrl/%.c
 	@echo 'Building file: $<'
 	@echo 'Invoking: ARM v7 gcc compiler'
-	$(CC) -Wall -O0 -g3 -I../bsp/ps7_cortexa9_0/include -I../src/include -c -fmessage-length=0 -MT"$@" -mcpu=cortex-a9 -mfpu=vfpv3 -mfloat-abi=hard -MMD -MP -MF"$(@:%.o=%.d)" -MT"$(@)" -o "$@" "$<"
+	$(CC) -std=c17 -pedantic -Wall -O0 -g3 -I../bsp/ps7_cortexa9_0/include -I../src/include -c -fmessage-length=0 -MT"$@" -mcpu=cortex-a9 -mfpu=vfpv3 -mfloat-abi=hard -MMD -MP -MF"$(@:%.o=%.d)" -MT"$(@)" -o "$@" "$<"
 	@echo 'Finished building: $<'
 	@echo ' '
 

df_datalink_ge/build/src/util/subdir.mk

@@ -32,7 +32,7 @@ C_DEPS += \
 src/util/%.o: ../src/util/%.c
 	@echo 'Building file: $<'
 	@echo 'Invoking: ARM v7 gcc compiler'
-	$(CC) -Wall -O0 -g3 -I../bsp/ps7_cortexa9_0/include -I../src/include -c -fmessage-length=0 -MT"$@" -mcpu=cortex-a9 -mfpu=vfpv3 -mfloat-abi=hard -MMD -MP -MF"$(@:%.o=%.d)" -MT"$(@)" -o "$@" "$<"
+	$(CC) -std=c17 -pedantic -Wall -O0 -g3 -I../bsp/ps7_cortexa9_0/include -I../src/include -c -fmessage-length=0 -MT"$@" -mcpu=cortex-a9 -mfpu=vfpv3 -mfloat-abi=hard -MMD -MP -MF"$(@:%.o=%.d)" -MT"$(@)" -o "$@" "$<"
 	@echo 'Finished building: $<'
 	@echo ' '
 

df_datalink_ge/src/config/app_config.h

@@ -35,6 +35,8 @@
 // 2 - print warnings and errors
 // 1 - print only errors
 // other - print nothing
+
+#define APP_EMULATE_DATA
 #define DATALINK_ENABLE_AUTORECONNECT
 #define DATALINK_ENABLE_AUTOTIMESYNC
 //#define DATALINK_ENABLE_BERTEST

df_datalink_ge/src/main.c

@@ -88,7 +88,6 @@ L2_CONFIG linkConfig =
 	.clustId = 1,
 	.myId = 1,
 	.headId = 1,
-	.bkpHeadId = 0,
 	.netScale = 2,
 	.phyInstPtr = NULL, // physical layer reference
 	.tmcInstPtr = NULL
@@ -99,7 +98,6 @@ L2_CONFIG linkConfig =
 // 	.clustId = 1,
 // 	.myId = 2,
 // 	.headId = 1,
-// 	.bkpHeadId = 0,
 // 	.netScale = 2,
 // 	.phyInstPtr = NULL, // physical layer reference
 // 	.tmcInstPtr = NULL
@@ -132,6 +130,47 @@ static MPC_CONFIG mpcConfig = {
 	.txQueueMax = 16,
 	.rxQueueMax = 16
 };
+
+#ifdef APP_EMULATE_DATA
+uint8_t testDataLj[] =
+{
+	0xEA, 0xDF, 0x3F, 0x27, 0xCE, 0x9B, 0xE6, 0x3F,
+	0xB5, 0xA3, 0x38, 0x47, 0x1D, 0x1D, 0xFA, 0x3F,
+	0x39, 0xB4, 0xC8, 0x76, 0xBE, 0xAB, 0x8E, 0x40,
+	0xC9, 0xE8, 0x80, 0x24, 0xEC, 0xCB, 0x13, 0x40,
+	0x37, 0x38, 0x7F, 0x22, 0x72, 0x06, 0xF0, 0x01,
+	0x00, 0x00, 0xB8, 0xAA, 0x08, 0x47, 0x1E, 0xC6,
+	0xB0, 0x47, 0x54, 0xFD, 0xEB, 0x45, 0xA1, 0x8A,
+	0x86, 0x44, 0x43, 0xB6, 0xC8, 0x44, 0x4E, 0x19,
+	0xA8, 0x42
+};
+
+uint8_t testDataFlj[] =
+{
+	0xFD, 0x1E, 0xA5, 0x22, 0x72, 0x02, 0x5A, 0x02,
+	0x00, 0x00, 0x81, 0x97, 0x39, 0x3F, 0xF1, 0xF4,
+	0xC0, 0x3F, 0x27, 0xF1, 0x65, 0x44, 0x53, 0x5C,
+	0xD3, 0x3F, 0xB5, 0x24, 0xA6, 0x22, 0x72, 0x02,
+	0x83, 0x01, 0x00, 0x00, 0xFC, 0xE0, 0x44, 0x47,
+	0xB7, 0x83, 0x35, 0x47, 0xA4, 0xBF, 0xE5, 0xC4,
+	0xE8, 0xDC, 0xD1, 0x44, 0x5D, 0x5D, 0xE7, 0x44,
+	0x7D, 0x1B, 0xE8, 0xC1, 0x60, 0x97, 0x57, 0x42,
+	0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+	0x5D, 0x86, 0xA6, 0x22, 0x72, 0x02, 0xA5, 0x02,
+	0x00, 0x00, 0x97, 0x4E, 0xB5, 0x47, 0xC4, 0x2A,
+	0xB0, 0x47, 0x2D, 0x00, 0x21, 0xC5, 0x8A, 0x85,
+	0xD1, 0x44, 0x23, 0xFD, 0xC8, 0x44, 0xA1, 0xC4,
+	0xEA, 0xC1, 0x91, 0x4E, 0x71, 0xC2, 0x00, 0x00,
+	0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x6D, 0xAD,
+	0xA6, 0x22, 0x72, 0x02, 0xA5, 0x02, 0x00, 0x00,
+	0xCD, 0x07, 0xD6, 0x47, 0x1D, 0xA4, 0xCE, 0x47,
+	0x6E, 0x61, 0x33, 0xC5, 0x85, 0x55, 0xD1, 0x44,
+	0x9C, 0x16, 0xBD, 0x44, 0x36, 0xC0, 0xEB, 0xC1,
+	0xF0, 0xFF, 0x5B, 0x42, 0x00, 0x00, 0x00, 0x00,
+	0x00, 0x00, 0x00, 0x00, 0x78, 0x25, 0x03, 0x00
+};
+#endif
+
 /************************** Function Prototypes ******************************/
 static struct irq_ctrl_desc *intcDescPtr; // General interrupt controller descriptor
 static struct timer_desc *logTmPtr;
@@ -375,6 +414,10 @@ void ScuTimer_IntrHandler(void *context)
 	{
 		// Refresh log
 		Phy_RefreshHwSate(phyInstPtr);
+		if (TimeCtrl_GetIntCnt(tmcInstPtr) - phyInstPtr->lastLogTime >= PHY_LOG_EXPIRE)
+		{
+			Phy_UpdateLogging(phyInstPtr);
+		}
 
 		if (Mpc_IsEnable(mpcDescPtr))
 		{
@@ -382,6 +425,16 @@ void ScuTimer_IntrHandler(void *context)
 			{
 				DBG_ERROR("Failed to apply remote test.\n");
 			}
+#ifdef APP_EMULATE_DATA
+			if (L2_GetNodeType(linkInstPtr) == L2_NODE_HEAD)
+			{
+				SysMonitor_UpdateSendPayload(testDataFlj, PAYLOAD_LEN_FLJ_TX);
+			}
+			else
+			{
+				SysMonitor_UpdateSendPayload(testDataLj, PAYLOAD_LEN_LJ_TX);
+			}
+#endif
 		}
 
 		XScuTimer_ClearInterruptStatus((XScuTimer *)xdesc->instance);
@@ -443,7 +496,7 @@ int main(void)
 	}
 
 	/* Physical Layer Initialize */
-	Status = Phy_InstInit(&phyInstPtr, &phyConfig);
+	Status = Phy_Init(&phyInstPtr, &phyConfig);
 	if (Status == SUCCESS)
 	{
 		DBG_PRINT("Physical layer Init SUCCESS! \n");

df_datalink_ge/src/mpc/mpc.c

@@ -151,13 +151,14 @@ static int32_t Mpc_GenSelfTestRsp(MPC *instPtr)
 	ASSERT(instPtr != NULL);
 	MPC_HW_FRAME *mpcRsp;
 	uint8_t *msg;
-	if (instPtr->isEnable == false)
+	if (Mpc_IsEnable(instPtr) == false)
 	{
 		DBG_ERROR("System is not enabled!\n");
 		return EIGNORE;
 	}
 	mpcRsp = malloc(sizeof(MPC_HW_FRAME));
-	if (mpcRsp == NULL) {
+	if (mpcRsp == NULL)
+	{
 		DBG_ERROR("Failed to allocate memory for LJ REMOTE TEST Response!\n");
 		return ENOMEM;
 	}
@@ -169,13 +170,13 @@ static int32_t Mpc_GenSelfTestRsp(MPC *instPtr)
 	msg[WD_CMD] = CMD_SELF_TEST;
 	msg[WD_PRD] = MY_PRD_ID;
 	SysMonitor_GetHardwareStatus(hwStatsPtr);
-	if (linkInstPtr->isEnable == false)
+	if (Mpc_IsEnable(instPtr))
 	{
-		msg[WD_ST_RET] = (hwStatsPtr->isSpOk) ? ST_RET_OK : ST_RET_ERROR;
+		msg[WD_ST_RET] = (hwStatsPtr->isSpOk && hwStatsPtr->isAntOk) ? ST_RET_OK : ST_RET_ERROR;
 	}
 	else
 	{
-		msg[WD_ST_RET] = (hwStatsPtr->isSpOk && hwStatsPtr->isAntOk) ? ST_RET_OK : ST_RET_ERROR;
+		msg[WD_ST_RET] = (hwStatsPtr->isSpOk) ? ST_RET_OK : ST_RET_ERROR;
 	}
 	// apply status and omit 2 bytes of overhead.
 	memcpy(msg + WD_SP_FPGA_VOLT, &(hwStatsPtr->spFpgaVolt), ST_RET_INFO_LEN);
@@ -201,47 +202,49 @@ static int32_t Mpc_SystemConfig(MPC *instPtr, uint8_t *msg)
 	if (msg[WD_MODE_CMD] == MODE_CMD_HEAD)
 	{
 		// omit unnecessary reconfiguration
-		if (L2_GetNodeType(linkInstPtr) != L2_NODE_HEAD)
+		reconfig = (L2_NODE_HEAD != L2_GetNodeType(linkInstPtr));
-		{
-			// head node config
 		linkConfig.myType = L2_NODE_HEAD;
-			linkConfig.myId = 1;
+		linkConfig.myId = 2;
-			reconfig = true;
-		}
 	}
 
-	else if (msg[WD_MODE_CMD] == MODE_CMD_MEMBER )
+	else if (msg[WD_MODE_CMD] == MODE_CMD_MEMBER)
 	{
 		// omit unnecessary reconfiguration
-		if (L2_GetNodeType(linkInstPtr) != L2_NODE_MEMBER)
+		reconfig = (L2_NODE_MEMBER != L2_GetNodeType(linkInstPtr));
-		{
-			// member node config
 		linkConfig.myType = L2_NODE_MEMBER;
 		linkConfig.myId = 2;
-			reconfig = true;
-		}
 	}
 	else
 	{
 		// Ignore current command
 		DBG_ERROR("Unexpected config command 0x%02X:0x%02X",
 				  WD_MODE_CMD, msg[WD_MODE_CMD]);
-		return EPARAM;
+		return EIGNORE;
 	}
 
-	if(msg[WD_EN_CMD] == EN_CMD_ON_HIGH_POWER)
+	if (msg[WD_EN_CMD] == EN_CMD_ON_HIGH_POWER)
 	{
 		// high power config
 		Phy_AntConfigMode(phyRef, PHY_ANT_MODE_POWER_FULL);
+		if (reconfig == true || !Mpc_IsEnable(instPtr))
+		{
+			Linklayer_Reconfig(linkInstPtr, &linkConfig);
+		}
+		Linklayer_Start(linkInstPtr);
 		instPtr->isEnable = true;
 	}
-	else if(msg[WD_EN_CMD] == EN_CMD_ON_LOW_POWER)
+	else if (msg[WD_EN_CMD] == EN_CMD_ON_LOW_POWER)
 	{
 		// low power config
 		Phy_AntConfigMode(phyRef, PHY_ANT_MODE_POWER_LOW);
+		if (reconfig == true || !Mpc_IsEnable(instPtr))
+		{
+			Linklayer_Reconfig(linkInstPtr, &linkConfig);
+		}
+		Linklayer_Start(linkInstPtr);
 		instPtr->isEnable = true;
 	}
-	else if(msg[WD_EN_CMD] == EN_CMD_SILENT)
+	else if (msg[WD_EN_CMD] == EN_CMD_SILENT)
 	{
 		// silence config
 		// TODO: better approach?
@@ -256,20 +259,18 @@ static int32_t Mpc_SystemConfig(MPC *instPtr, uint8_t *msg)
 		}
 		Phy_SetupNextSlot(phyRef, PHY_TOR_RX, L1_10KBPS_10MS_FRAME, NULL);
 	}
-	if (reconfig == true)
+	else
 	{
-		Linklayer_Reconfig(linkInstPtr, &linkConfig);
+		// Ignore current command
-	}
+		DBG_ERROR("Unexpected config command 0x%02X:0x%02X",
-	if (instPtr->isEnable == true)
+				  WD_EN_CMD, msg[WD_EN_CMD]);
-	{
+		return EIGNORE;
-		Linklayer_Start(linkInstPtr);
 	}
 	instPtr->mpcLog.lastConfig[0] = msg[WD_MODE_CMD];
 	instPtr->mpcLog.lastConfig[1] = msg[WD_EN_CMD];
 	return SUCCESS;
 }
 
-
 /*****************************************************************************/
 /**
  * @brief   Initialize MPC instance.
@@ -277,7 +278,7 @@ static int32_t Mpc_SystemConfig(MPC *instPtr, uint8_t *msg)
  * @param   InstPtr A double pointer to MPC instance.
  * @param   config  A pointer to MPC configurations.
  *
- * @return  None.
+ * @return  Error code.
  *
  ******************************************************************************/
 int32_t Mpc_Init(MPC **instPtr, MPC_CONFIG *config)
@@ -289,7 +290,7 @@ int32_t Mpc_Init(MPC **instPtr, MPC_CONFIG *config)
 	(*instPtr) = malloc(sizeof(MPC));
 	if ((*instPtr) == NULL)
 	{
-		return FAILURE;
+		return ENOMEM;
 	}
 	(*instPtr)->rxQueue = NULL;
 	(*instPtr)->txQueue = NULL;
@@ -306,14 +307,15 @@ int32_t Mpc_Init(MPC **instPtr, MPC_CONFIG *config)
 	bramConfigPtr = XBram_LookupConfig(config->bramId);
 	if (bramConfigPtr == NULL)
 	{
-		Status = EDCONF;
+		Mpc_Destroy(*instPtr);
-		goto mpc_init_error;
+		return EDCONF;
 	}
 	Status = XBram_CfgInitialize(&mpcBram, bramConfigPtr,
 								 bramConfigPtr->CtrlBaseAddress);
 	if (Status != SUCCESS)
 	{
-		goto mpc_init_error;
+		Mpc_Destroy(*instPtr);
+		return Status;
 	}
 	/*
 	 * Execute the BRAM driver selftest.
@@ -321,7 +323,8 @@ int32_t Mpc_Init(MPC **instPtr, MPC_CONFIG *config)
 	Status = XBram_SelfTest(&mpcBram, 0);
 	if (Status != SUCCESS)
 	{
-		goto mpc_init_error;
+		Mpc_Destroy(*instPtr);
+		return Status;
 	}
 
 	mpcHwConfig.txBuffAddr = mpcBram.Config.MemBaseAddress;
@@ -331,32 +334,47 @@ int32_t Mpc_Init(MPC **instPtr, MPC_CONFIG *config)
 	Status = MpcHw_Init(&((*instPtr)->mpchwDesc), &mpcHwConfig);
 	if (Status != SUCCESS)
 	{
-		Status = ENOMEM;
+		Mpc_Destroy(*instPtr);
-		goto mpc_init_error;
+		return ENOMEM;
 	}
 	if (CircQueueCreate(&((*instPtr)->txQueue), (*instPtr)->config.txQueueMax) == false)
 	{
-		Status = ENOMEM;
+		Mpc_Destroy(*instPtr);
-		goto mpc_init_error;
+		return ENOMEM;
 	}
 	if (CircQueueCreate(&((*instPtr)->rxQueue), (*instPtr)->config.rxQueueMax) == false)
 	{
-		Status = ENOMEM;
+		Mpc_Destroy(*instPtr);
-		goto mpc_init_error;
+		return ENOMEM;
 	}
 	(*instPtr)->isEnable = false; // nothing received.
 	(*instPtr)->isRxDone = false; // nothing received.
 	(*instPtr)->isTxDone = true;  // nothing to be sent.
 	return SUCCESS;
-
-mpc_init_error:
-	free((*instPtr)->mpchwDesc);
-	free((*instPtr)->txQueue);
-	free((*instPtr)->rxQueue);
-	free(*instPtr);
-	return Status;
 }
 
+/*****************************************************************************/
+/**
+ * @brief   Destroy MPC instance.
+ *
+ * @param   InstPtr A pointer to MPC instance.
+ *
+ * @return  None.
+ *
+ ******************************************************************************/
+void Mpc_Destroy(MPC *instPtr)
+{
+	if (instPtr == NULL)
+	{
+		return;
+	}
+	free(instPtr->mpchwDesc);
+	free(instPtr->txQueue);
+	free(instPtr->rxQueue);
+	free(instPtr);
+}
+
+
 /*****************************************************************************/
 /**
  * @brief	Generate a remote test response message.
@@ -371,13 +389,14 @@ int32_t Mpc_PendRemoteTest(MPC *instPtr)
 {
 	MPC_HW_FRAME *mpcRsp;
 	uint8_t *msg;
-	if (instPtr->isEnable == false)
+	if (!Mpc_IsEnable(instPtr))
 	{
 		DBG_ERROR("System is not enabled!\n");
 		return EIGNORE;
 	}
 	mpcRsp = malloc(sizeof(MPC_HW_FRAME));
-	if (mpcRsp == NULL) {
+	if (mpcRsp == NULL)
+	{
 		DBG_ERROR("Failed to allocate memory for LJ REMOTE TEST Response!\n");
 		return ENOMEM;
 	}
@@ -407,7 +426,8 @@ int32_t Mpc_PendRemoteTest(MPC *instPtr)
 	memcpy(msg + WD_PHY_LOG, &(instPtr->phyLog), WD_PHY_LOG_LEN);
 	memcpy(msg + WD_HARDWARE_ST, &(instPtr->hwState.spFpgaVolt), WD_HARDWARE_ST_LEN);
 
-	if (CircQueuePush(instPtr->txQueue, (void *)mpcRsp) == false){
+	if (CircQueuePush(instPtr->txQueue, (void *)mpcRsp) == false)
+	{
 		free(mpcRsp);
 		DBG_WARNING("SystemBus::TX Queue overflowed!\n");
 		return EQUEUE;
@@ -531,17 +551,16 @@ int32_t Mpc_RxIrqHandler(MPC *instPtr)
 	Status = MpcHw_Recv(instPtr->mpchwDesc, mpcReq);
 	if (Status != SUCCESS)
 	{
-		goto recv_error;
+		DBG_ERROR("SystemBus::RX error!\n");
+		free(mpcReq);
+		return Status;
 	}
 	if (CircQueuePush(instPtr->rxQueue, (void *)mpcReq) == false)
 	{
 		DBG_ERROR("SystemBus::RX Queue overflowed!\n");
-		Status = EQUEUE;
+		free(mpcReq);
-		goto recv_error;
+		return EQUEUE;
 	}
 	instPtr->isRxDone = false; // another reception is undergoing.
 	return SUCCESS;
-recv_error:
-	free(mpcReq);
-	return Status;
 }

df_datalink_ge/src/mpc/mpc.h

@@ -52,6 +52,7 @@ typedef struct
 /************************** Function Prototypes ******************************/
 
 int32_t Mpc_Init(MPC **instPtr, MPC_CONFIG *config);
+void Mpc_Destroy(MPC *instPtr);
 
 int32_t Mpc_HandleCmd(MPC *instPtr);
 int32_t Mpc_PendRemoteTest(MPC *instPtr);

df_datalink_sp/bsp/ps7_cortexa9_0/include/xparameters.h

@@ -24,7 +24,7 @@
 
 /* Definitions for interface TMC */
 #define XPAR_TMC_BASEADDR 0x43C30000
-#define XPAR_TMC_HIGHADDR 0x43C3FFFF
+#define XPAR_TMC_HIGHADDR 0x43C30FFF
 
 #include "xparameters_ps.h"
 
@@ -62,22 +62,22 @@
 #define XPAR_PHY_DATA_INTERFACE_ANT_BEAM_BRAM_CTRL_S_AXI_CTRL_HIGHADDR 0xFFFFFFFFU  
 
 
-/* Definitions for peripheral PHY_DATA_INTERFACE_ANT_INFO_BRAM_CTRL */
+/* Definitions for peripheral PHY_DATA_INTERFACE_ANT_CONFIG_BRAM_CTRL */
-#define XPAR_PHY_DATA_INTERFACE_ANT_INFO_BRAM_CTRL_DEVICE_ID 1U
+#define XPAR_PHY_DATA_INTERFACE_ANT_CONFIG_BRAM_CTRL_DEVICE_ID 1U
-#define XPAR_PHY_DATA_INTERFACE_ANT_INFO_BRAM_CTRL_DATA_WIDTH 32U
+#define XPAR_PHY_DATA_INTERFACE_ANT_CONFIG_BRAM_CTRL_DATA_WIDTH 32U
-#define XPAR_PHY_DATA_INTERFACE_ANT_INFO_BRAM_CTRL_ECC 0U
+#define XPAR_PHY_DATA_INTERFACE_ANT_CONFIG_BRAM_CTRL_ECC 0U
-#define XPAR_PHY_DATA_INTERFACE_ANT_INFO_BRAM_CTRL_FAULT_INJECT 0U
+#define XPAR_PHY_DATA_INTERFACE_ANT_CONFIG_BRAM_CTRL_FAULT_INJECT 0U
-#define XPAR_PHY_DATA_INTERFACE_ANT_INFO_BRAM_CTRL_CE_FAILING_REGISTERS 0U
+#define XPAR_PHY_DATA_INTERFACE_ANT_CONFIG_BRAM_CTRL_CE_FAILING_REGISTERS 0U
-#define XPAR_PHY_DATA_INTERFACE_ANT_INFO_BRAM_CTRL_UE_FAILING_REGISTERS 0U
+#define XPAR_PHY_DATA_INTERFACE_ANT_CONFIG_BRAM_CTRL_UE_FAILING_REGISTERS 0U
-#define XPAR_PHY_DATA_INTERFACE_ANT_INFO_BRAM_CTRL_ECC_STATUS_REGISTERS 0U
+#define XPAR_PHY_DATA_INTERFACE_ANT_CONFIG_BRAM_CTRL_ECC_STATUS_REGISTERS 0U
-#define XPAR_PHY_DATA_INTERFACE_ANT_INFO_BRAM_CTRL_CE_COUNTER_WIDTH 0U
+#define XPAR_PHY_DATA_INTERFACE_ANT_CONFIG_BRAM_CTRL_CE_COUNTER_WIDTH 0U
-#define XPAR_PHY_DATA_INTERFACE_ANT_INFO_BRAM_CTRL_ECC_ONOFF_REGISTER 0U
+#define XPAR_PHY_DATA_INTERFACE_ANT_CONFIG_BRAM_CTRL_ECC_ONOFF_REGISTER 0U
-#define XPAR_PHY_DATA_INTERFACE_ANT_INFO_BRAM_CTRL_ECC_ONOFF_RESET_VALUE 0U
+#define XPAR_PHY_DATA_INTERFACE_ANT_CONFIG_BRAM_CTRL_ECC_ONOFF_RESET_VALUE 0U
-#define XPAR_PHY_DATA_INTERFACE_ANT_INFO_BRAM_CTRL_WRITE_ACCESS 0U
+#define XPAR_PHY_DATA_INTERFACE_ANT_CONFIG_BRAM_CTRL_WRITE_ACCESS 0U
-#define XPAR_PHY_DATA_INTERFACE_ANT_INFO_BRAM_CTRL_S_AXI_BASEADDR 0x40004000U
+#define XPAR_PHY_DATA_INTERFACE_ANT_CONFIG_BRAM_CTRL_S_AXI_BASEADDR 0x40004000U
-#define XPAR_PHY_DATA_INTERFACE_ANT_INFO_BRAM_CTRL_S_AXI_HIGHADDR 0x40005FFFU
+#define XPAR_PHY_DATA_INTERFACE_ANT_CONFIG_BRAM_CTRL_S_AXI_HIGHADDR 0x40005FFFU
-#define XPAR_PHY_DATA_INTERFACE_ANT_INFO_BRAM_CTRL_S_AXI_CTRL_BASEADDR 0xFFFFFFFFU  
+#define XPAR_PHY_DATA_INTERFACE_ANT_CONFIG_BRAM_CTRL_S_AXI_CTRL_BASEADDR 0xFFFFFFFFU  
-#define XPAR_PHY_DATA_INTERFACE_ANT_INFO_BRAM_CTRL_S_AXI_CTRL_HIGHADDR 0xFFFFFFFFU  
+#define XPAR_PHY_DATA_INTERFACE_ANT_CONFIG_BRAM_CTRL_S_AXI_CTRL_HIGHADDR 0xFFFFFFFFU  
 
 
 /* Definitions for peripheral PHY_DATA_INTERFACE_RX_FRAME_BRAM_CTRL */
@@ -93,7 +93,7 @@
 #define XPAR_PHY_DATA_INTERFACE_RX_FRAME_BRAM_CTRL_ECC_ONOFF_RESET_VALUE 0U
 #define XPAR_PHY_DATA_INTERFACE_RX_FRAME_BRAM_CTRL_WRITE_ACCESS 0U
 #define XPAR_PHY_DATA_INTERFACE_RX_FRAME_BRAM_CTRL_S_AXI_BASEADDR 0x40000000U
-#define XPAR_PHY_DATA_INTERFACE_RX_FRAME_BRAM_CTRL_S_AXI_HIGHADDR 0x40001FFFU
+#define XPAR_PHY_DATA_INTERFACE_RX_FRAME_BRAM_CTRL_S_AXI_HIGHADDR 0x40000FFFU
 #define XPAR_PHY_DATA_INTERFACE_RX_FRAME_BRAM_CTRL_S_AXI_CTRL_BASEADDR 0xFFFFFFFFU  
 #define XPAR_PHY_DATA_INTERFACE_RX_FRAME_BRAM_CTRL_S_AXI_CTRL_HIGHADDR 0xFFFFFFFFU  
 
@@ -111,7 +111,7 @@
 #define XPAR_PHY_DATA_INTERFACE_TX_FRAME_BRAM_CTRL_ECC_ONOFF_RESET_VALUE 0U
 #define XPAR_PHY_DATA_INTERFACE_TX_FRAME_BRAM_CTRL_WRITE_ACCESS 0U
 #define XPAR_PHY_DATA_INTERFACE_TX_FRAME_BRAM_CTRL_S_AXI_BASEADDR 0x40002000U
-#define XPAR_PHY_DATA_INTERFACE_TX_FRAME_BRAM_CTRL_S_AXI_HIGHADDR 0x40003FFFU
+#define XPAR_PHY_DATA_INTERFACE_TX_FRAME_BRAM_CTRL_S_AXI_HIGHADDR 0x40002FFFU
 #define XPAR_PHY_DATA_INTERFACE_TX_FRAME_BRAM_CTRL_S_AXI_CTRL_BASEADDR 0xFFFFFFFFU  
 #define XPAR_PHY_DATA_INTERFACE_TX_FRAME_BRAM_CTRL_S_AXI_CTRL_HIGHADDR 0xFFFFFFFFU  
 
@@ -135,8 +135,8 @@
 #define XPAR_BRAM_0_CTRL_BASEADDR 0xFFFFFFFFU  
 #define XPAR_BRAM_0_CTRL_HIGHADDR 0xFFFFFFFEU  
 
-/* Canonical definitions for peripheral PHY_DATA_INTERFACE_ANT_INFO_BRAM_CTRL */
+/* Canonical definitions for peripheral PHY_DATA_INTERFACE_ANT_CONFIG_BRAM_CTRL */
-#define XPAR_BRAM_1_DEVICE_ID XPAR_PHY_DATA_INTERFACE_ANT_INFO_BRAM_CTRL_DEVICE_ID
+#define XPAR_BRAM_1_DEVICE_ID XPAR_PHY_DATA_INTERFACE_ANT_CONFIG_BRAM_CTRL_DEVICE_ID
 #define XPAR_BRAM_1_DATA_WIDTH 32U
 #define XPAR_BRAM_1_ECC 0U
 #define XPAR_BRAM_1_FAULT_INJECT 0U
@@ -165,7 +165,7 @@
 #define XPAR_BRAM_2_ECC_ONOFF_RESET_VALUE 0U
 #define XPAR_BRAM_2_WRITE_ACCESS 0U
 #define XPAR_BRAM_2_BASEADDR 0x40000000U
-#define XPAR_BRAM_2_HIGHADDR 0x40001FFFU
+#define XPAR_BRAM_2_HIGHADDR 0x40000FFFU
 #define XPAR_BRAM_2_CTRL_BASEADDR 0xFFFFFFFFU  
 #define XPAR_BRAM_2_CTRL_HIGHADDR 0xFFFFFFFEU  
 
@@ -182,7 +182,7 @@
 #define XPAR_BRAM_3_ECC_ONOFF_RESET_VALUE 0U
 #define XPAR_BRAM_3_WRITE_ACCESS 0U
 #define XPAR_BRAM_3_BASEADDR 0x40002000U
-#define XPAR_BRAM_3_HIGHADDR 0x40003FFFU
+#define XPAR_BRAM_3_HIGHADDR 0x40002FFFU
 #define XPAR_BRAM_3_CTRL_BASEADDR 0xFFFFFFFFU  
 #define XPAR_BRAM_3_CTRL_HIGHADDR 0xFFFFFFFEU  
 
@@ -346,7 +346,7 @@
 
 /* Definitions for peripheral SYSTEMBUS */
 #define XPAR_SYSTEMBUS_BASEADDR 0x43C10000
-#define XPAR_SYSTEMBUS_HIGHADDR 0x43C11FFF
+#define XPAR_SYSTEMBUS_HIGHADDR 0x43C10FFF
 
 
 /******************************************************************/

df_datalink_sp/bsp/ps7_cortexa9_0/libsrc/bram_v4_3/src/xbram_g.c

@@ -62,23 +62,23 @@ XBram_Config XBram_ConfigTable[] =
 		XPAR_PHY_DATA_INTERFACE_ANT_BEAM_BRAM_CTRL_S_AXI_CTRL_HIGHADDR
 	},
 	{
-		XPAR_PHY_DATA_INTERFACE_ANT_INFO_BRAM_CTRL_DEVICE_ID,
+		XPAR_PHY_DATA_INTERFACE_ANT_CONFIG_BRAM_CTRL_DEVICE_ID,
-		XPAR_PHY_DATA_INTERFACE_ANT_INFO_BRAM_CTRL_DATA_WIDTH,
+		XPAR_PHY_DATA_INTERFACE_ANT_CONFIG_BRAM_CTRL_DATA_WIDTH,
-		XPAR_PHY_DATA_INTERFACE_ANT_INFO_BRAM_CTRL_ECC,
+		XPAR_PHY_DATA_INTERFACE_ANT_CONFIG_BRAM_CTRL_ECC,
-		XPAR_PHY_DATA_INTERFACE_ANT_INFO_BRAM_CTRL_FAULT_INJECT,
+		XPAR_PHY_DATA_INTERFACE_ANT_CONFIG_BRAM_CTRL_FAULT_INJECT,
-		XPAR_PHY_DATA_INTERFACE_ANT_INFO_BRAM_CTRL_CE_FAILING_REGISTERS,
+		XPAR_PHY_DATA_INTERFACE_ANT_CONFIG_BRAM_CTRL_CE_FAILING_REGISTERS,
 		0,
-		XPAR_PHY_DATA_INTERFACE_ANT_INFO_BRAM_CTRL_UE_FAILING_REGISTERS,
+		XPAR_PHY_DATA_INTERFACE_ANT_CONFIG_BRAM_CTRL_UE_FAILING_REGISTERS,
 		0,
-		XPAR_PHY_DATA_INTERFACE_ANT_INFO_BRAM_CTRL_ECC_STATUS_REGISTERS,
+		XPAR_PHY_DATA_INTERFACE_ANT_CONFIG_BRAM_CTRL_ECC_STATUS_REGISTERS,
-		XPAR_PHY_DATA_INTERFACE_ANT_INFO_BRAM_CTRL_CE_COUNTER_WIDTH,
+		XPAR_PHY_DATA_INTERFACE_ANT_CONFIG_BRAM_CTRL_CE_COUNTER_WIDTH,
-		XPAR_PHY_DATA_INTERFACE_ANT_INFO_BRAM_CTRL_ECC_ONOFF_REGISTER,
+		XPAR_PHY_DATA_INTERFACE_ANT_CONFIG_BRAM_CTRL_ECC_ONOFF_REGISTER,
-		XPAR_PHY_DATA_INTERFACE_ANT_INFO_BRAM_CTRL_ECC_ONOFF_RESET_VALUE,
+		XPAR_PHY_DATA_INTERFACE_ANT_CONFIG_BRAM_CTRL_ECC_ONOFF_RESET_VALUE,
-		XPAR_PHY_DATA_INTERFACE_ANT_INFO_BRAM_CTRL_WRITE_ACCESS,
+		XPAR_PHY_DATA_INTERFACE_ANT_CONFIG_BRAM_CTRL_WRITE_ACCESS,
-		XPAR_PHY_DATA_INTERFACE_ANT_INFO_BRAM_CTRL_S_AXI_BASEADDR,
+		XPAR_PHY_DATA_INTERFACE_ANT_CONFIG_BRAM_CTRL_S_AXI_BASEADDR,
-		XPAR_PHY_DATA_INTERFACE_ANT_INFO_BRAM_CTRL_S_AXI_HIGHADDR,
+		XPAR_PHY_DATA_INTERFACE_ANT_CONFIG_BRAM_CTRL_S_AXI_HIGHADDR,
-		XPAR_PHY_DATA_INTERFACE_ANT_INFO_BRAM_CTRL_S_AXI_CTRL_BASEADDR,
+		XPAR_PHY_DATA_INTERFACE_ANT_CONFIG_BRAM_CTRL_S_AXI_CTRL_BASEADDR,
-		XPAR_PHY_DATA_INTERFACE_ANT_INFO_BRAM_CTRL_S_AXI_CTRL_HIGHADDR
+		XPAR_PHY_DATA_INTERFACE_ANT_CONFIG_BRAM_CTRL_S_AXI_CTRL_HIGHADDR
 	},
 	{
 		XPAR_PHY_DATA_INTERFACE_RX_FRAME_BRAM_CTRL_DEVICE_ID,

df_datalink_sp/bsp/system.mss

@@ -33,7 +33,7 @@ END
 BEGIN DRIVER
  PARAMETER DRIVER_NAME = bram
  PARAMETER DRIVER_VER = 4.3
- PARAMETER HW_INSTANCE = phy_data_interface_ant_info_bram_ctrl
+ PARAMETER HW_INSTANCE = phy_data_interface_ant_config_bram_ctrl
 END
 
 BEGIN DRIVER

df_datalink_sp/build/src/dev_profile/subdir.mk

@@ -32,7 +32,7 @@ C_DEPS += \
 src/dev_profile/%.o: ../src/dev_profile/%.c
 	@echo 'Building file: $<'
 	@echo 'Invoking: ARM v7 gcc compiler'
-	$(CC) -Wall -Wformat=2 -O0 -g3 -I../bsp/ps7_cortexa9_0/include -I../src/include -c -fmessage-length=0 -MT"$@" -mcpu=cortex-a9 -mfpu=vfpv3 -mfloat-abi=hard -MMD -MP -MF"$(@:%.o=%.d)" -MT"$(@)" -o "$@" "$<"
+	$(CC) -std=c17 -pedantic -Wall -Wformat=2 -O0 -g3 -I../bsp/ps7_cortexa9_0/include -I../src/include -c -fmessage-length=0 -MT"$@" -mcpu=cortex-a9 -mfpu=vfpv3 -mfloat-abi=hard -MMD -MP -MF"$(@:%.o=%.d)" -MT"$(@)" -o "$@" "$<"
 	@echo 'Finished building: $<'
 	@echo ' '
 

df_datalink_sp/build/src/networking/link_layer/geometry/subdir.mk

@@ -23,7 +23,7 @@ C_DEPS += \
 src/networking/link_layer/geometry/%.o: ../src/networking/link_layer/geometry/%.c
 	@echo 'Building file: $<'
 	@echo 'Invoking: ARM v7 gcc compiler'
-	$(CC) -Wall -Wformat=2 -O0 -g3 -I../bsp/ps7_cortexa9_0/include -I../src/include -c -fmessage-length=0 -MT"$@" -mcpu=cortex-a9 -mfpu=vfpv3 -mfloat-abi=hard -MMD -MP -MF"$(@:%.o=%.d)" -MT"$(@)" -o "$@" "$<"
+	$(CC) -std=c17 -pedantic -Wall -Wformat=2 -O0 -g3 -I../bsp/ps7_cortexa9_0/include -I../src/include -c -fmessage-length=0 -MT"$@" -mcpu=cortex-a9 -mfpu=vfpv3 -mfloat-abi=hard -MMD -MP -MF"$(@:%.o=%.d)" -MT"$(@)" -o "$@" "$<"
 	@echo 'Finished building: $<'
 	@echo ' '
 

df_datalink_sp/build/src/networking/link_layer/subdir.mk

@@ -38,7 +38,7 @@ C_DEPS += \
 src/networking/link_layer/%.o: ../src/networking/link_layer/%.c
 	@echo 'Building file: $<'
 	@echo 'Invoking: ARM v7 gcc compiler'
-	$(CC) -Wall -Wformat=2 -O0 -g3 -I../bsp/ps7_cortexa9_0/include -I../src/include -c -fmessage-length=0 -MT"$@" -mcpu=cortex-a9 -mfpu=vfpv3 -mfloat-abi=hard -MMD -MP -MF"$(@:%.o=%.d)" -MT"$(@)" -o "$@" "$<"
+	$(CC) -std=c17 -pedantic -Wall -Wformat=2 -O0 -g3 -I../bsp/ps7_cortexa9_0/include -I../src/include -c -fmessage-length=0 -MT"$@" -mcpu=cortex-a9 -mfpu=vfpv3 -mfloat-abi=hard -MMD -MP -MF"$(@:%.o=%.d)" -MT"$(@)" -o "$@" "$<"
 	@echo 'Finished building: $<'
 	@echo ' '
 

df_datalink_sp/build/src/networking/phy_layer/subdir.mk

@@ -20,7 +20,7 @@ C_DEPS += \
 src/networking/phy_layer/%.o: ../src/networking/phy_layer/%.c
 	@echo 'Building file: $<'
 	@echo 'Invoking: ARM v7 gcc compiler'
-	$(CC) -Wall -Wformat=2 -O0 -g3 -I../bsp/ps7_cortexa9_0/include -I../src/include -c -fmessage-length=0 -MT"$@" -mcpu=cortex-a9 -mfpu=vfpv3 -mfloat-abi=hard -MMD -MP -MF"$(@:%.o=%.d)" -MT"$(@)" -o "$@" "$<"
+	$(CC) -std=c17 -pedantic -Wall -Wformat=2 -O0 -g3 -I../bsp/ps7_cortexa9_0/include -I../src/include -c -fmessage-length=0 -MT"$@" -mcpu=cortex-a9 -mfpu=vfpv3 -mfloat-abi=hard -MMD -MP -MF"$(@:%.o=%.d)" -MT"$(@)" -o "$@" "$<"
 	@echo 'Finished building: $<'
 	@echo ' '
 

df_datalink_sp/build/src/subdir.mk

@@ -26,7 +26,7 @@ C_DEPS += \
 src/%.o: ../src/%.c
 	@echo 'Building file: $<'
 	@echo 'Invoking: ARM v7 gcc compiler'
-	$(CC) -Wall -Wformat=2 -O0 -g3 -I../bsp/ps7_cortexa9_0/include -I../src/include -c -fmessage-length=0 -MT"$@" -mcpu=cortex-a9 -mfpu=vfpv3 -mfloat-abi=hard -MMD -MP -MF"$(@:%.o=%.d)" -MT"$(@)" -o "$@" "$<"
+	$(CC) -std=c17 -pedantic -Wall -Wformat=2 -O0 -g3 -I../bsp/ps7_cortexa9_0/include -I../src/include -c -fmessage-length=0 -MT"$@" -mcpu=cortex-a9 -mfpu=vfpv3 -mfloat-abi=hard -MMD -MP -MF"$(@:%.o=%.d)" -MT"$(@)" -o "$@" "$<"
 	@echo 'Finished building: $<'
 	@echo ' '
 

df_datalink_sp/build/src/systembus/subdir.mk

@@ -20,7 +20,7 @@ C_DEPS += \
 src/systembus/%.o: ../src/systembus/%.c
 	@echo 'Building file: $<'
 	@echo 'Invoking: ARM v7 gcc compiler'
-	$(CC) -Wall -Wformat=2 -O0 -g3 -I../bsp/ps7_cortexa9_0/include -I../src/include -c -fmessage-length=0 -MT"$@" -mcpu=cortex-a9 -mfpu=vfpv3 -mfloat-abi=hard -MMD -MP -MF"$(@:%.o=%.d)" -MT"$(@)" -o "$@" "$<"
+	$(CC) -std=c17 -pedantic -Wall -Wformat=2 -O0 -g3 -I../bsp/ps7_cortexa9_0/include -I../src/include -c -fmessage-length=0 -MT"$@" -mcpu=cortex-a9 -mfpu=vfpv3 -mfloat-abi=hard -MMD -MP -MF"$(@:%.o=%.d)" -MT"$(@)" -o "$@" "$<"
 	@echo 'Finished building: $<'
 	@echo ' '
 

df_datalink_sp/build/src/time_ctrl/subdir.mk

@@ -17,7 +17,7 @@ C_DEPS += \
 src/time_ctrl/%.o: ../src/time_ctrl/%.c
 	@echo 'Building file: $<'
 	@echo 'Invoking: ARM v7 gcc compiler'
-	arm-none-eabi-gcc -Wall -O0 -g3 -I../bsp/ps7_cortexa9_0/include -I../src/include -c -fmessage-length=0 -MT"$@" -mcpu=cortex-a9 -mfpu=vfpv3 -mfloat-abi=hard -MMD -MP -MF"$(@:%.o=%.d)" -MT"$(@)" -o "$@" "$<"
+	arm-none-eabi-gcc -std=c17 -pedantic -Wall -O0 -g3 -I../bsp/ps7_cortexa9_0/include -I../src/include -c -fmessage-length=0 -MT"$@" -mcpu=cortex-a9 -mfpu=vfpv3 -mfloat-abi=hard -MMD -MP -MF"$(@:%.o=%.d)" -MT"$(@)" -o "$@" "$<"
 	@echo 'Finished building: $<'
 	@echo ' '
 

df_datalink_sp/build/src/util/subdir.mk

@@ -32,7 +32,7 @@ C_DEPS += \
 src/util/%.o: ../src/util/%.c
 	@echo 'Building file: $<'
 	@echo 'Invoking: ARM v7 gcc compiler'
-	$(CC) -Wall -Wformat=2 -O0 -g3 -I../bsp/ps7_cortexa9_0/include -I../src/include -c -fmessage-length=0 -MT"$@" -mcpu=cortex-a9 -mfpu=vfpv3 -mfloat-abi=hard -MMD -MP -MF"$(@:%.o=%.d)" -MT"$(@)" -o "$@" "$<"
+	$(CC) -std=c17 -pedantic -Wall -Wformat=2 -O0 -g3 -I../bsp/ps7_cortexa9_0/include -I../src/include -c -fmessage-length=0 -MT"$@" -mcpu=cortex-a9 -mfpu=vfpv3 -mfloat-abi=hard -MMD -MP -MF"$(@:%.o=%.d)" -MT"$(@)" -o "$@" "$<"
 	@echo 'Finished building: $<'
 	@echo ' '
 

df_datalink_sp/src/config/app_config.h

@@ -10,7 +10,7 @@
  * History:
  * [2021-04-28]: Initial edition.
  *
- * Copyright(c) 2021 Beijing Institute of Technology.
+ * Copyright(c) 2024 Beijing Institute of Technology.
  * Lab of Communication and Networking
  *
  ******************************************************************************/
@@ -23,7 +23,7 @@
 #include "xparameters.h"
 
 /******** Software Version ********/
-#define _APP_VER	0x00010008
+#define _APP_VER 0x00010000
 
 #define _APP_VER_MAIN ((_APP_VER & 0xFF000000) >> 24)
 #define _APP_VER_MINOR ((_APP_VER & 0x00FF0000) >> 16)
@@ -38,12 +38,12 @@
 
 #define DATALINK_ENABLE_AUTORECONNECT
 #define DATALINK_ENABLE_AUTOTIMESYNC
-//#define DATALINK_ENABLE_BERTEST
+// #define DATALINK_ENABLE_BERTEST
 
 /************ Hardware Configs ************/
 #define CPU_CLK_HZ XPAR_CPU_CORTEXA9_0_CPU_CLK_FREQ_HZ
-#define GLOBAL_TIMER_CLK_HZ (CPU_CLK_HZ/2)
+#define GLOBAL_TIMER_CLK_HZ (CPU_CLK_HZ / 2)
-#define SCU_TIMER_CLK_HZ 	(CPU_CLK_HZ/2)
+#define SCU_TIMER_CLK_HZ (CPU_CLK_HZ / 2)
 #define FCLK_CLK0_HZ 100000000
 
 /********* Zynq Platform Configs **********/
@@ -52,11 +52,11 @@
 #define SCUTIMER_INTR_ID XPAR_SCUTIMER_INTR
 
 // Physical Layer Configs
-#define PHY_DEVICE_ID 0
+#define PHY_DEVICE_ID 0X00
 #define PHY_BASEADDR XPAR_PHYC_BASEADDR
 #define PHY_BEAM_FORMING_ENABLE
 // -- Antenna Bram Configs
-#define PHY_ANTCONFIG_BRAM_DEVICE_ID XPAR_PHY_DATA_INTERFACE_ANT_INFO_BRAM_CTRL_DEVICE_ID
+#define PHY_ANTCONFIG_BRAM_DEVICE_ID XPAR_PHY_DATA_INTERFACE_ANT_CONFIG_BRAM_CTRL_DEVICE_ID
 #define PHY_ANTINFO_BRAM_DEVICE_ID XPAR_PHY_DATA_INTERFACE_ANT_BEAM_BRAM_CTRL_DEVICE_ID
 // -- Buffers
 #define PHY_TXBUFF_BRAM_DEVICE_ID XPAR_PHY_DATA_INTERFACE_TX_FRAME_BRAM_CTRL_DEVICE_ID
@@ -91,17 +91,7 @@
 #define AD9364_DEVICE 0			/* set it 1 if AD9364 device is used, 0 otherwise */
 #define AD9363A_DEVICE 0		/* set it 1 if AD9363A device is used, 0 otherwise */
 #define HAVE_VERBOSE_MESSAGES	/* Recommended during development prints errors and warnings */
-//#define HAVE_DEBUG_MESSAGES /* For Debug purposes only */
+// #define HAVE_DEBUG_MESSAGES /* For Debug purposes only */
-// -- AD9361 SPI Engine Configuration
-#define AD9361_SPI_DEVICE_ID			0
-#define AD9361_SPI_ENGINE_REF_CLK       FCLK_CLK0_HZ
-#define AD9361_SPI_ENGINE_MAX_SPEED		5000000
-#define AD9361_SPI_ENGINE_BASEADDR		XPAR_AXI_SPI_ENGINE_AXI_SPI_ENGINE_BASEADDR
-#define AD9361_SPI_ENGINE_DATA_WIDTH    8
-#define AD9361_SPI_ENGINE_CS_DELAY		3
-#define AD9361_SPI_CS_AD9361_1          0x01
-#define AD9361_SPI_CS_AD9361_2          0x02
-#define AD9361_TIMEOUT_TH				2000
 // AD9361 GPIO Configurations
 #define AD9361_GPIO_DEVICE_ID 0
 #define AD9361_GPIO_OFFSET 54
@@ -109,67 +99,60 @@
 #define AD9361_GPIO_OUTPUT 1
 #define AD9361_GPIO_DISABLE 0
 #define AD9361_GPIO_ENABLE 1
-// -- AD9361-1
+//  -- AD9361 SPI Engine Configuration
-#define AD9361_1_TXNRX				(AD9361_GPIO_OFFSET+6)
+#define AD9361_SPI_DEVICE_ID 0
-#define AD9361_1_ENABLE				(AD9361_GPIO_OFFSET+7)
+#define AD9361_SPI_ENGINE_REF_CLK FCLK_CLK0_HZ
-#define AD9361_1_EN_AGC				(AD9361_GPIO_OFFSET+8)
+#define AD9361_SPI_ENGINE_MAX_SPEED 5000000
-#define AD9361_1_RESET_B			(AD9361_GPIO_OFFSET+9)
+#define AD9361_SPI_ENGINE_BASEADDR XPAR_AXI_SPI_ENGINE_AXI_SPI_ENGINE_BASEADDR
-#define AD9361_1_CTRL_OUT0			(AD9361_GPIO_OFFSET+10)
+#define AD9361_SPI_ENGINE_DATA_WIDTH 8
-#define AD9361_1_CTRL_OUT1			(AD9361_GPIO_OFFSET+11)
+#define AD9361_SPI_ENGINE_CS_DELAY 3
-#define AD9361_1_CTRL_OUT2			(AD9361_GPIO_OFFSET+12)
+#define AD9361_TIMEOUT_TH 2000
-#define AD9361_1_CTRL_OUT3			(AD9361_GPIO_OFFSET+13)
+#define AD9361_1_SPI_CS 0x01
-#define AD9361_1_CTRL_OUT4			(AD9361_GPIO_OFFSET+14)
+#define AD9361_2_SPI_CS 0x02
-#define AD9361_1_CTRL_OUT5			(AD9361_GPIO_OFFSET+15)
+// -- AD9361-1 GPIO
-#define AD9361_1_CTRL_OUT6			(AD9361_GPIO_OFFSET+16)
+#define AD9361_1_TXNRX (AD9361_GPIO_OFFSET + 4)
-#define AD9361_1_CTRL_OUT7			(AD9361_GPIO_OFFSET+17)
+#define AD9361_1_ENABLE (AD9361_GPIO_OFFSET + 5)
-#define AD9361_1_CTRL_IN0			(AD9361_GPIO_OFFSET+18)
+#define AD9361_1_EN_AGC (AD9361_GPIO_OFFSET + 6)
-#define AD9361_1_CTRL_IN1			(AD9361_GPIO_OFFSET+19)
+#define AD9361_1_RESET_B (AD9361_GPIO_OFFSET + 7)
-#define AD9361_1_CTRL_IN2			(AD9361_GPIO_OFFSET+20)
+#define AD9361_1_CTRL_OUT0 (AD9361_GPIO_OFFSET + 8)
-#define AD9361_1_CTRL_IN3			(AD9361_GPIO_OFFSET+21)
+#define AD9361_1_CTRL_OUT1 (AD9361_GPIO_OFFSET + 9)
-// AD9361-2
+#define AD9361_1_CTRL_OUT2 (AD9361_GPIO_OFFSET + 10)
-#define AD9361_2_TXNRX				(AD9361_GPIO_OFFSET+22)
+#define AD9361_1_CTRL_OUT3 (AD9361_GPIO_OFFSET + 11)
-#define AD9361_2_ENABLE				(AD9361_GPIO_OFFSET+23)
+#define AD9361_1_CTRL_OUT4 (AD9361_GPIO_OFFSET + 12)
-#define AD9361_2_EN_AGC				(AD9361_GPIO_OFFSET+24)
+#define AD9361_1_CTRL_OUT5 (AD9361_GPIO_OFFSET + 13)
-#define AD9361_2_RESET_B			(AD9361_GPIO_OFFSET+25)
+#define AD9361_1_CTRL_OUT6 (AD9361_GPIO_OFFSET + 14)
-#define AD9361_2_CTRL_OUT0			(AD9361_GPIO_OFFSET+26)
+#define AD9361_1_CTRL_OUT7 (AD9361_GPIO_OFFSET + 15)
-#define AD9361_2_CTRL_OUT1			(AD9361_GPIO_OFFSET+27)
+#define AD9361_1_CTRL_IN0 (AD9361_GPIO_OFFSET + 16)
-#define AD9361_2_CTRL_OUT2			(AD9361_GPIO_OFFSET+28)
+#define AD9361_1_CTRL_IN1 (AD9361_GPIO_OFFSET + 17)
-#define AD9361_2_CTRL_OUT3			(AD9361_GPIO_OFFSET+29)
+#define AD9361_1_CTRL_IN2 (AD9361_GPIO_OFFSET + 18)
-#define AD9361_2_CTRL_OUT4			(AD9361_GPIO_OFFSET+30)
+#define AD9361_1_CTRL_IN3 (AD9361_GPIO_OFFSET + 19)
-#define AD9361_2_CTRL_OUT5			(AD9361_GPIO_OFFSET+31)
+// -- AD9361-2 GPIO
-#define AD9361_2_CTRL_OUT6			(AD9361_GPIO_OFFSET+32)
+#define AD9361_2_TXNRX (AD9361_GPIO_OFFSET + 20)
-#define AD9361_2_CTRL_OUT7			(AD9361_GPIO_OFFSET+33)
+#define AD9361_2_ENABLE (AD9361_GPIO_OFFSET + 21)
-#define AD9361_2_CTRL_IN0			(AD9361_GPIO_OFFSET+34)
+#define AD9361_2_EN_AGC (AD9361_GPIO_OFFSET + 22)
-#define AD9361_2_CTRL_IN1			(AD9361_GPIO_OFFSET+35)
+#define AD9361_2_RESET_B (AD9361_GPIO_OFFSET + 23)
-#define AD9361_2_CTRL_IN2			(AD9361_GPIO_OFFSET+36)
+#define AD9361_2_CTRL_OUT0 (AD9361_GPIO_OFFSET + 24)
-#define AD9361_2_CTRL_IN3			(AD9361_GPIO_OFFSET+37)
+#define AD9361_2_CTRL_OUT1 (AD9361_GPIO_OFFSET + 25)
-// AD9361-Status Code
+#define AD9361_2_CTRL_OUT2 (AD9361_GPIO_OFFSET + 26)
-#define AD9361_SYNC					(AD9361_GPIO_OFFSET+38)
+#define AD9361_2_CTRL_OUT3 (AD9361_GPIO_OFFSET + 27)
-#define AD9361_RX_FIFO_RST			(AD9361_GPIO_OFFSET+39)
+#define AD9361_2_CTRL_OUT4 (AD9361_GPIO_OFFSET + 28)
-#define AD9361_1_CAL_START			(AD9361_GPIO_OFFSET+40)
+#define AD9361_2_CTRL_OUT5 (AD9361_GPIO_OFFSET + 29)
-#define AD9361_2_CAL_START			(AD9361_GPIO_OFFSET+41)
+#define AD9361_2_CTRL_OUT6 (AD9361_GPIO_OFFSET + 30)
-#define AD9361_RECAL				(AD9361_GPIO_OFFSET+42)
+#define AD9361_2_CTRL_OUT7 (AD9361_GPIO_OFFSET + 31)
-#define AD9361_TX_SWITCH			(AD9361_GPIO_OFFSET+43)
+#define AD9361_2_CTRL_IN0 (AD9361_GPIO_OFFSET + 32)
-#define AD9361_1_CAL_DONE			(AD9361_GPIO_OFFSET+44)
+#define AD9361_2_CTRL_IN1 (AD9361_GPIO_OFFSET + 33)
-#define AD9361_2_CAL_DONE			(AD9361_GPIO_OFFSET+45)
+#define AD9361_2_CTRL_IN2 (AD9361_GPIO_OFFSET + 34)
-#define AD9361_CAL_RESULT			(AD9361_GPIO_OFFSET+46)
+#define AD9361_2_CTRL_IN3 (AD9361_GPIO_OFFSET + 35)
-
-typedef enum
-{
-	TX_FREQ_125,
-	TX_FREQ_126,
-	TX_FREQ_4125
-} ad9361TxFreq;
 
 // HMC7044 Configurations
 #define HMC7044_GPIO_DEVICE_ID 0
 #define HMC7044_GPIO_OFFSET 54
-#define HMC7044_RESET				(HMC7044_GPIO_OFFSET+0)
+#define HMC7044_RESET (HMC7044_GPIO_OFFSET + 0)
-#define HMC7044_SYNC				(HMC7044_GPIO_OFFSET+1)
+#define HMC7044_SYNC (HMC7044_GPIO_OFFSET + 1)
-#define HMC7044_GPIO_0				(HMC7044_GPIO_OFFSET+2)
+#define HMC7044_GPIO_0 (HMC7044_GPIO_OFFSET + 2)
-#define HMC7044_GPIO_1				(HMC7044_GPIO_OFFSET+3)
+#define HMC7044_GPIO_1 (HMC7044_GPIO_OFFSET + 3)
-#define HMC7044_GPIO_2				(HMC7044_GPIO_OFFSET+4)
+#define HMC7044_GPIO_2 (HMC7044_GPIO_OFFSET + 4)
-#define HMC7044_GPIO_3				(HMC7044_GPIO_OFFSET+5)
+#define HMC7044_GPIO_3 (HMC7044_GPIO_OFFSET + 5)
 // -- HMC7044 SPI Engine Configuration
 #define HMC7044_SPI_DEVICE_ID 0
 #define HMC7044_SPI_ENGINE_REF_CLK FCLK_CLK0_HZ
@@ -177,8 +160,23 @@ typedef enum
 #define HMC7044_SPI_ENGINE_BASEADDR XPAR_AXI_SPI_ENGINE_AXI_SPI_ENGINE_BASEADDR
 #define HMC7044_SPI_ENGINE_DATA_WIDTH 8
 #define HMC7044_SPI_ENGINE_CS_DELAY 3
-#define HMC7044_SPI_CS_HMC7044          0x00
+#define HMC7044_SPI_CS 0x00
 
+// AD9528 Configurations
+#define AD9528_GPIO_DEVICE_ID 0
+#define AD9528_GPIO_OFFSET 54
+#define AD9528_RESETB (AD9528_GPIO_OFFSET+0)
+#define AD9528_SYSREF_REQ (AD9528_GPIO_OFFSET+1)
+#define AD9528_STATUS_0 (AD9528_GPIO_OFFSET+2)
+#define AD9528_STATUS_1 (AD9528_GPIO_OFFSET+3)
+// -- AD9528 SPI Engine Configuration
+#define AD9528_SPI_DEVICE_ID 0
+#define AD9528_SPI_ENGINE_REF_CLK FCLK_CLK0_HZ
+#define AD9528_SPI_ENGINE_MAX_SPEED 5000000
+#define AD9528_SPI_ENGINE_BASEADDR XPAR_AXI_SPI_ENGINE_AXI_SPI_ENGINE_BASEADDR
+#define AD9528_SPI_ENGINE_DATA_WIDTH 8
+#define AD9528_SPI_ENGINE_CS_DELAY 3
+#define AD9528_SPI_CS 0x00
 
 // Configuration Check
 #if defined(PHY_BEAM_SET_PRESET) && !defined(PHY_BEAM_FORMING_ENABLE)
@@ -188,7 +186,7 @@ typedef enum
 
 #if defined(DATALINK_ENABLE_BERTEST)
 #if !defined(DATALINK_ENABLE_AUTOTIMESYNC)
-	#warning To enbale bit error rate test, auto time-sync should be enabled...
+#warning To enbale bit error rate test, auto time-sync should be enabled...
 #endif
 #endif
 

df_datalink_sp/src/dev_profile/ad9361_profile.c

@@ -273,7 +273,7 @@ AD9361_InitParam ad9361_default_init_param = {
 	{
 		.device_id = AD9361_SPI_DEVICE_ID,
 		.mode = SPI_MODE_1,
-		.chip_select = AD9361_SPI_CS_AD9361_1,
+		.chip_select = AD9361_1_SPI_CS,
 		.platform_ops = &spi_eng_platform_ops,
 		.extra = &spi_engine_param
 	},

df_datalink_sp/src/dev_profile/ad9361_reg_profile.c

@@ -25,7 +25,7 @@ static struct spi_init_param ad9361_1_reg_spi_init = {
 	.device_id = AD9361_SPI_DEVICE_ID,
     .max_speed_hz = AD9361_SPI_ENGINE_MAX_SPEED,
 	.mode = SPI_MODE_1,
-	.chip_select = AD9361_SPI_CS_AD9361_1,
+	.chip_select = AD9361_1_SPI_CS,
 	.platform_ops = &spi_eng_platform_ops,
 	.extra = &spi_engine_param
 };
@@ -35,6 +35,7 @@ static struct gpio_init_param ad9361_1_reg_gpio_resetb_init = {
 	.platform_ops = &xil_gpio_ops,
 	.extra = &xil_gpio_param
 };
+
 struct ad9361_reg_init_param ad9361_1_reg_default_init_param = {
 	/* SPI */
 	.spi_init = &ad9361_1_reg_spi_init,
@@ -46,7 +47,7 @@ static struct spi_init_param ad9361_2_reg_spi_init = {
 	.device_id = AD9361_SPI_DEVICE_ID,
     .max_speed_hz = AD9361_SPI_ENGINE_MAX_SPEED,
 	.mode = SPI_MODE_1,
-	.chip_select = AD9361_SPI_CS_AD9361_2,
+	.chip_select = AD9361_2_SPI_CS,
 	.platform_ops = &spi_eng_platform_ops,
 	.extra = &spi_engine_param
 };
@@ -56,6 +57,7 @@ static struct gpio_init_param ad9361_2_reg_gpio_resetb_init = {
 	.platform_ops = &xil_gpio_ops,
 	.extra = &xil_gpio_param
 };
+
 struct ad9361_reg_init_param ad9361_2_reg_default_init_param = {
 	/* SPI */
 	.spi_init = &ad9361_2_reg_spi_init,
@@ -72,7 +74,7 @@ uint32_t ad9361_reg_config(struct ad9361_reg_dev *dev){
 // generated using the AD9361 Customer software Version 2.1.3
 //************************************************************
 // Profile: Custom
-// REFCLK_IN: 25.000 MHz
+// REFCLK_IN: 40.000 MHz
 
 
     status = ad9361_reg_write(dev, 0x03DF, 0x01);	// Required for proper operation
@@ -87,527 +89,40 @@ uint32_t ad9361_reg_config(struct ad9361_reg_dev *dev){
 // Set BBPLL Frequency: 1152.000000
 //************************************************************
     status = ad9361_reg_write(dev, 0x0045, 0x03);	// Set BBPLL reflclk scale to REFCLK * 2
-    status = ad9361_reg_write(dev, 0x0046, 0x03);	// Set BBPLL Loop Filter Charge Pump current
+    status = ad9361_reg_write(dev, 0x0046, 0x02);	// Set BBPLL Loop Filter Charge Pump current
     status = ad9361_reg_write(dev, 0x0048, 0xE8);	// Set BBPLL Loop Filter C1, R1
     status = ad9361_reg_write(dev, 0x0049, 0x5B);	// Set BBPLL Loop Filter R2, C2, C1
     status = ad9361_reg_write(dev, 0x004A, 0x35);	// Set BBPLL Loop Filter C3,R2
     status = ad9361_reg_write(dev, 0x004B, 0xE0);	// Allow calibration to occur and set cal count to 1024 for max accuracy
     status = ad9361_reg_write(dev, 0x004E, 0x10);	// Set calibration clock to REFCLK/4 for more accuracy
-    status = ad9361_reg_write(dev, 0x0043, 0x66);	// BBPLL Freq Word (Fractional[7:0])
+    status = ad9361_reg_write(dev, 0x0043, 0x00);	// BBPLL Freq Word (Fractional[7:0])
-    status = ad9361_reg_write(dev, 0x0042, 0x46);	// BBPLL Freq Word (Fractional[15:8])
+    status = ad9361_reg_write(dev, 0x0042, 0xC0);	// BBPLL Freq Word (Fractional[15:8])
-    status = ad9361_reg_write(dev, 0x0041, 0x01);	// BBPLL Freq Word (Fractional[23:16])
+    status = ad9361_reg_write(dev, 0x0041, 0x0C);	// BBPLL Freq Word (Fractional[23:16])
-    status = ad9361_reg_write(dev, 0x0044, 0x17);	// BBPLL Freq Word (Integer[7:0])
+    status = ad9361_reg_write(dev, 0x0044, 0x0E);	// BBPLL Freq Word (Integer[7:0])
     status = ad9361_reg_write(dev, 0x003F, 0x05);	// Start BBPLL Calibration
     status = ad9361_reg_write(dev, 0x003F, 0x01);	// Clear BBPLL start calibration bit
     status = ad9361_reg_write(dev, 0x004C, 0x86);	// Increase BBPLL KV and phase margin
     status = ad9361_reg_write(dev, 0x004D, 0x01);	// Increase BBPLL KV and phase margin
     status = ad9361_reg_write(dev, 0x004D, 0x05);	// Increase BBPLL KV and phase margin
 
-    // Wait for BBPLL to lock, Timeout 2sec, Max BBPLL VCO Cal Time: 276.480 us (Done when 0x05E[7]==1)
+    // Wait for BBPLL to lock, Timeout 2sec, Max BBPLL VCO Cal Time: 172.800 us (Done when 0x05E[7]==1)
     time_out_cnt = 0;
     do{
         status |= ad9361_reg_read(dev, 0x005E, &value);
         mdelay(1);// Wait 1ms
         time_out_cnt++;
-    } while((value & 0x80) != 0x80 && time_out_cnt <= AD9361_TIMEOUT_TH);
+    } while((value & 0x80) != 0x80 && time_out_cnt <= TIMEOUT_TH);
 
 
     status = ad9361_reg_write(dev, 0x0002, 0xA4);	// Setup Tx Digital Filters/ Channels
-    status = ad9361_reg_write(dev, 0x0003, 0xE5);	// Setup Rx Digital Filters/ Channels
+    status = ad9361_reg_write(dev, 0x0003, 0xE4);	// Setup Rx Digital Filters/ Channels
     status = ad9361_reg_write(dev, 0x0004, 0x03);	// Select Rx input pin(A,B,C)/ Tx out pin (A,B)
     status = ad9361_reg_write(dev, 0x000A, 0x12);	// Set BBPLL post divide rate
 
-//************************************************************
-// Program Rx FIR: C:\Users\josh\Desktop\Config\rx64.txt
-//************************************************************
-    status = ad9361_reg_write(dev, 0x00F5, 0x9A);	// Enable clock to Rx FIR Filter
-    status = ad9361_reg_write(dev, 0x00F6, 0x02);	// Write Filter Gain setting
-    status = ad9361_reg_write(dev, 0x00F0, 0x00);	// Write FIR coefficient address
-    status = ad9361_reg_write(dev, 0x00F1, 0x00);	// Write FIR coefficient data[7:0]
-    status = ad9361_reg_write(dev, 0x00F2, 0x00);	// Write FIR coefficient data[15:8]
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);	// Set Write EN to push data into FIR filter register map
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);	// Dummy Write to Read only register to delay ~1us
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);	// Dummy Write to Read only register to delay ~1us
-    status = ad9361_reg_write(dev, 0x00F0, 0x01);
-    status = ad9361_reg_write(dev, 0x00F1, 0xB6);
-    status = ad9361_reg_write(dev, 0x00F2, 0xFF);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x02);
-    status = ad9361_reg_write(dev, 0x00F1, 0xA5);
-    status = ad9361_reg_write(dev, 0x00F2, 0xFF);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x03);
-    status = ad9361_reg_write(dev, 0x00F1, 0xEA);
-    status = ad9361_reg_write(dev, 0x00F2, 0xFF);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x04);
-    status = ad9361_reg_write(dev, 0x00F1, 0x61);
-    status = ad9361_reg_write(dev, 0x00F2, 0x00);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x05);
-    status = ad9361_reg_write(dev, 0x00F1, 0xA3);
-    status = ad9361_reg_write(dev, 0x00F2, 0x00);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x06);
-    status = ad9361_reg_write(dev, 0x00F1, 0x4D);
-    status = ad9361_reg_write(dev, 0x00F2, 0x00);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x07);
-    status = ad9361_reg_write(dev, 0x00F1, 0x77);
-    status = ad9361_reg_write(dev, 0x00F2, 0xFF);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x08);
-    status = ad9361_reg_write(dev, 0x00F1, 0xD5);
-    status = ad9361_reg_write(dev, 0x00F2, 0xFE);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x09);
-    status = ad9361_reg_write(dev, 0x00F1, 0x38);
-    status = ad9361_reg_write(dev, 0x00F2, 0xFF);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x0A);
-    status = ad9361_reg_write(dev, 0x00F1, 0xA5);
-    status = ad9361_reg_write(dev, 0x00F2, 0x00);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x0B);
-    status = ad9361_reg_write(dev, 0x00F1, 0xF8);
-    status = ad9361_reg_write(dev, 0x00F2, 0x01);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x0C);
-    status = ad9361_reg_write(dev, 0x00F1, 0xAD);
-    status = ad9361_reg_write(dev, 0x00F2, 0x01);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x0D);
-    status = ad9361_reg_write(dev, 0x00F1, 0x75);
-    status = ad9361_reg_write(dev, 0x00F2, 0xFF);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x0E);
-    status = ad9361_reg_write(dev, 0x00F1, 0xFD);
-    status = ad9361_reg_write(dev, 0x00F2, 0xFC);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x0F);
-    status = ad9361_reg_write(dev, 0x00F1, 0xD8);
-    status = ad9361_reg_write(dev, 0x00F2, 0xFC);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x10);
-    status = ad9361_reg_write(dev, 0x00F1, 0x00);
-    status = ad9361_reg_write(dev, 0x00F2, 0x00);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x11);
-    status = ad9361_reg_write(dev, 0x00F1, 0x3A);
-    status = ad9361_reg_write(dev, 0x00F2, 0x04);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x12);
-    status = ad9361_reg_write(dev, 0x00F1, 0x6B);
-    status = ad9361_reg_write(dev, 0x00F2, 0x05);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x13);
-    status = ad9361_reg_write(dev, 0x00F1, 0x51);
-    status = ad9361_reg_write(dev, 0x00F2, 0x01);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x14);
-    status = ad9361_reg_write(dev, 0x00F1, 0x80);
-    status = ad9361_reg_write(dev, 0x00F2, 0xFA);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x15);
-    status = ad9361_reg_write(dev, 0x00F1, 0x34);
-    status = ad9361_reg_write(dev, 0x00F2, 0xF7);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x16);
-    status = ad9361_reg_write(dev, 0x00F1, 0x08);
-    status = ad9361_reg_write(dev, 0x00F2, 0xFC);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x17);
-    status = ad9361_reg_write(dev, 0x00F1, 0xB2);
-    status = ad9361_reg_write(dev, 0x00F2, 0x06);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x18);
-    status = ad9361_reg_write(dev, 0x00F1, 0x1A);
-    status = ad9361_reg_write(dev, 0x00F2, 0x0E);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x19);
-    status = ad9361_reg_write(dev, 0x00F1, 0x44);
-    status = ad9361_reg_write(dev, 0x00F2, 0x09);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x1A);
-    status = ad9361_reg_write(dev, 0x00F1, 0x54);
-    status = ad9361_reg_write(dev, 0x00F2, 0xF8);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x1B);
-    status = ad9361_reg_write(dev, 0x00F1, 0xD1);
-    status = ad9361_reg_write(dev, 0x00F2, 0xE7);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x1C);
-    status = ad9361_reg_write(dev, 0x00F1, 0xC2);
-    status = ad9361_reg_write(dev, 0x00F2, 0xE9);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x1D);
-    status = ad9361_reg_write(dev, 0x00F1, 0x4F);
-    status = ad9361_reg_write(dev, 0x00F2, 0x08);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x1E);
-    status = ad9361_reg_write(dev, 0x00F1, 0xB2);
-    status = ad9361_reg_write(dev, 0x00F2, 0x3B);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x1F);
-    status = ad9361_reg_write(dev, 0x00F1, 0x2A);
-    status = ad9361_reg_write(dev, 0x00F2, 0x6C);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x20);
-    status = ad9361_reg_write(dev, 0x00F1, 0xFF);
-    status = ad9361_reg_write(dev, 0x00F2, 0x7F);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x21);
-    status = ad9361_reg_write(dev, 0x00F1, 0x2A);
-    status = ad9361_reg_write(dev, 0x00F2, 0x6C);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x22);
-    status = ad9361_reg_write(dev, 0x00F1, 0xB2);
-    status = ad9361_reg_write(dev, 0x00F2, 0x3B);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x23);
-    status = ad9361_reg_write(dev, 0x00F1, 0x4F);
-    status = ad9361_reg_write(dev, 0x00F2, 0x08);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x24);
-    status = ad9361_reg_write(dev, 0x00F1, 0xC2);
-    status = ad9361_reg_write(dev, 0x00F2, 0xE9);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x25);
-    status = ad9361_reg_write(dev, 0x00F1, 0xD1);
-    status = ad9361_reg_write(dev, 0x00F2, 0xE7);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x26);
-    status = ad9361_reg_write(dev, 0x00F1, 0x54);
-    status = ad9361_reg_write(dev, 0x00F2, 0xF8);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x27);
-    status = ad9361_reg_write(dev, 0x00F1, 0x44);
-    status = ad9361_reg_write(dev, 0x00F2, 0x09);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x28);
-    status = ad9361_reg_write(dev, 0x00F1, 0x1A);
-    status = ad9361_reg_write(dev, 0x00F2, 0x0E);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x29);
-    status = ad9361_reg_write(dev, 0x00F1, 0xB2);
-    status = ad9361_reg_write(dev, 0x00F2, 0x06);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x2A);
-    status = ad9361_reg_write(dev, 0x00F1, 0x08);
-    status = ad9361_reg_write(dev, 0x00F2, 0xFC);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x2B);
-    status = ad9361_reg_write(dev, 0x00F1, 0x34);
-    status = ad9361_reg_write(dev, 0x00F2, 0xF7);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x2C);
-    status = ad9361_reg_write(dev, 0x00F1, 0x80);
-    status = ad9361_reg_write(dev, 0x00F2, 0xFA);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x2D);
-    status = ad9361_reg_write(dev, 0x00F1, 0x51);
-    status = ad9361_reg_write(dev, 0x00F2, 0x01);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x2E);
-    status = ad9361_reg_write(dev, 0x00F1, 0x6B);
-    status = ad9361_reg_write(dev, 0x00F2, 0x05);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x2F);
-    status = ad9361_reg_write(dev, 0x00F1, 0x3A);
-    status = ad9361_reg_write(dev, 0x00F2, 0x04);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x30);
-    status = ad9361_reg_write(dev, 0x00F1, 0x00);
-    status = ad9361_reg_write(dev, 0x00F2, 0x00);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x31);
-    status = ad9361_reg_write(dev, 0x00F1, 0xD8);
-    status = ad9361_reg_write(dev, 0x00F2, 0xFC);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x32);
-    status = ad9361_reg_write(dev, 0x00F1, 0xFD);
-    status = ad9361_reg_write(dev, 0x00F2, 0xFC);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x33);
-    status = ad9361_reg_write(dev, 0x00F1, 0x75);
-    status = ad9361_reg_write(dev, 0x00F2, 0xFF);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x34);
-    status = ad9361_reg_write(dev, 0x00F1, 0xAD);
-    status = ad9361_reg_write(dev, 0x00F2, 0x01);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x35);
-    status = ad9361_reg_write(dev, 0x00F1, 0xF8);
-    status = ad9361_reg_write(dev, 0x00F2, 0x01);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x36);
-    status = ad9361_reg_write(dev, 0x00F1, 0xA5);
-    status = ad9361_reg_write(dev, 0x00F2, 0x00);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x37);
-    status = ad9361_reg_write(dev, 0x00F1, 0x38);
-    status = ad9361_reg_write(dev, 0x00F2, 0xFF);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x38);
-    status = ad9361_reg_write(dev, 0x00F1, 0xD5);
-    status = ad9361_reg_write(dev, 0x00F2, 0xFE);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x39);
-    status = ad9361_reg_write(dev, 0x00F1, 0x77);
-    status = ad9361_reg_write(dev, 0x00F2, 0xFF);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x3A);
-    status = ad9361_reg_write(dev, 0x00F1, 0x4D);
-    status = ad9361_reg_write(dev, 0x00F2, 0x00);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x3B);
-    status = ad9361_reg_write(dev, 0x00F1, 0xA3);
-    status = ad9361_reg_write(dev, 0x00F2, 0x00);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x3C);
-    status = ad9361_reg_write(dev, 0x00F1, 0x61);
-    status = ad9361_reg_write(dev, 0x00F2, 0x00);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x3D);
-    status = ad9361_reg_write(dev, 0x00F1, 0xEA);
-    status = ad9361_reg_write(dev, 0x00F2, 0xFF);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x3E);
-    status = ad9361_reg_write(dev, 0x00F1, 0xA5);
-    status = ad9361_reg_write(dev, 0x00F2, 0xFF);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x3F);
-    status = ad9361_reg_write(dev, 0x00F1, 0xB6);
-    status = ad9361_reg_write(dev, 0x00F2, 0xFF);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x40);
-    status = ad9361_reg_write(dev, 0x00F1, 0x00);
-    status = ad9361_reg_write(dev, 0x00F2, 0x00);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x41);
-    status = ad9361_reg_write(dev, 0x00F1, 0x00);
-    status = ad9361_reg_write(dev, 0x00F2, 0x00);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x42);
-    status = ad9361_reg_write(dev, 0x00F1, 0x00);
-    status = ad9361_reg_write(dev, 0x00F2, 0x00);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x43);
-    status = ad9361_reg_write(dev, 0x00F1, 0x00);
-    status = ad9361_reg_write(dev, 0x00F2, 0x00);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x44);
-    status = ad9361_reg_write(dev, 0x00F1, 0x00);
-    status = ad9361_reg_write(dev, 0x00F2, 0x00);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x45);
-    status = ad9361_reg_write(dev, 0x00F1, 0x00);
-    status = ad9361_reg_write(dev, 0x00F2, 0x00);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x46);
-    status = ad9361_reg_write(dev, 0x00F1, 0x00);
-    status = ad9361_reg_write(dev, 0x00F2, 0x00);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x47);
-    status = ad9361_reg_write(dev, 0x00F1, 0x00);
-    status = ad9361_reg_write(dev, 0x00F2, 0x00);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x48);
-    status = ad9361_reg_write(dev, 0x00F1, 0x00);
-    status = ad9361_reg_write(dev, 0x00F2, 0x00);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x49);
-    status = ad9361_reg_write(dev, 0x00F1, 0x00);
-    status = ad9361_reg_write(dev, 0x00F2, 0x00);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x4A);
-    status = ad9361_reg_write(dev, 0x00F1, 0x00);
-    status = ad9361_reg_write(dev, 0x00F2, 0x00);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x4B);
-    status = ad9361_reg_write(dev, 0x00F1, 0x00);
-    status = ad9361_reg_write(dev, 0x00F2, 0x00);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x4C);
-    status = ad9361_reg_write(dev, 0x00F1, 0x00);
-    status = ad9361_reg_write(dev, 0x00F2, 0x00);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x4D);
-    status = ad9361_reg_write(dev, 0x00F1, 0x00);
-    status = ad9361_reg_write(dev, 0x00F2, 0x00);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x4E);
-    status = ad9361_reg_write(dev, 0x00F1, 0x00);
-    status = ad9361_reg_write(dev, 0x00F2, 0x00);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F0, 0x4F);
-    status = ad9361_reg_write(dev, 0x00F1, 0x00);
-    status = ad9361_reg_write(dev, 0x00F2, 0x00);
-    status = ad9361_reg_write(dev, 0x00F5, 0x9E);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F4, 0x00);
-    status = ad9361_reg_write(dev, 0x00F5, 0x98);	// Disable clock to Rx Filter
-
 //************************************************************
 // Setup the Parallel Port (Digital Data Interface)
 //************************************************************
-    status = ad9361_reg_write(dev, 0x0010, 0xC8);	// I/O Config.  Tx Swap IQ; Rx Swap IQ; Tx CH Swap, Rx CH Swap; Rx Frame Mode; 2R2T bit; Invert data bus; Invert DATA_CLK
+    status = ad9361_reg_write(dev, 0x0010, 0xCC);	// I/O Config.  Tx Swap IQ; Rx Swap IQ; Tx CH Swap, Rx CH Swap; Rx Frame Mode; 2R2T bit; Invert data bus; Invert DATA_CLK
     status = ad9361_reg_write(dev, 0x0011, 0x00);	// I/O Config.  Alt Word Order; -Rx1; -Rx2; -Tx1; -Tx2; Invert Rx Frame; Delay Rx Data
     status = ad9361_reg_write(dev, 0x0012, 0x02);	// I/O Config.  Rx=2*Tx; Swap Ports; SDR; LVDS; Half Duplex; Single Port; Full Port; Swap Bits
     status = ad9361_reg_write(dev, 0x0006, 0x00);	// PPORT Rx Delay (adjusts Tco Dataclk->Data)
@@ -646,7 +161,7 @@ uint32_t ad9361_reg_config(struct ad9361_reg_dev *dev){
 //************************************************************
 // Setup GPO
 //************************************************************
-    status = ad9361_reg_write(dev, 0x003A, 0x18);	// Set number of REFCLK cycles for 1us delay timer
+    status = ad9361_reg_write(dev, 0x003A, 0x27);	// Set number of REFCLK cycles for 1us delay timer
     status = ad9361_reg_write(dev, 0x0020, 0x00);	// GPO Auto Enable Setup in RX and TX
     status = ad9361_reg_write(dev, 0x0027, 0x00);	// GPO Manual and GPO auto value in ALERT
     status = ad9361_reg_write(dev, 0x0028, 0x00);	// GPO_0 RX Delay
@@ -683,74 +198,74 @@ uint32_t ad9361_reg_config(struct ad9361_reg_dev *dev){
 
     status = ad9361_reg_write(dev, 0x023D, 0x04);	// Start RX CP cal
 
-    // Wait for CP cal to complete, Max RXCP Cal time: 737.280 (us)(Done when 0x244[7]==1)
+    // Wait for CP cal to complete, Max RXCP Cal time: 460.800 (us)(Done when 0x244[7]==1)
     time_out_cnt = 0;
     do{
         status |= ad9361_reg_read(dev, 0x0244, &value);
         mdelay(1);// Wait 1ms
         time_out_cnt++;
-    } while((value & 0x80) != 0x80 && time_out_cnt <= AD9361_TIMEOUT_TH);
+    } while((value & 0x80) != 0x80 && time_out_cnt <= TIMEOUT_TH);
 
     status = ad9361_reg_write(dev, 0x027D, 0x04);	// Start TX CP cal
 
-    // Wait for CP cal to complete, Max TXCP Cal time: 737.280 (us)(Done when 0x284[7]==1)
+    // Wait for CP cal to complete, Max TXCP Cal time: 460.800 (us)(Done when 0x284[7]==1)
 	time_out_cnt = 0;
 	do{
 		status |= ad9361_reg_read(dev, 0x0284, &value);
 		mdelay(1);// Wait 1ms
 		time_out_cnt++;
-	} while((value & 0x80) != 0x80 && time_out_cnt <= AD9361_TIMEOUT_TH);
+	} while((value & 0x80) != 0x80 && time_out_cnt <= TIMEOUT_TH);
 
     status = ad9361_reg_write(dev, 0x023D, 0x00);	// Disable RX CP Calibration since the CP Cal start bit is not self-clearing.  Only important if the script is run again without restting the DUT
     status = ad9361_reg_write(dev, 0x027D, 0x00);	// Disable TX CP Calibration since the CP Cal start bit is not self-clearing.  Only important if the script is run again without restting the DUT
 //************************************************************
-// FDD RX,TX Synth Frequency: 125.000000,4125.000000 MHz
+// FDD RX,TX Synth Frequency: 1268.250000,1268.250000 MHz
 //************************************************************
 //************************************************************
 // Setup Rx Frequency-Dependent Syntheisizer Registers
 //************************************************************
     status = ad9361_reg_write(dev, 0x023A, 0x4A);	// Set VCO Output level[3:0]
-    status = ad9361_reg_write(dev, 0x0239, 0xC1);	// Set Init ALC Value[3:0] and VCO Varactor[3:0]
+    status = ad9361_reg_write(dev, 0x0239, 0xC0);	// Set Init ALC Value[3:0] and VCO Varactor[3:0]
-    status = ad9361_reg_write(dev, 0x0242, 0x0E);	// Set VCO Bias Tcf[1:0] and VCO Bias Ref[2:0]
+    status = ad9361_reg_write(dev, 0x0242, 0x0D);	// Set VCO Bias Tcf[1:0] and VCO Bias Ref[2:0]
-    status = ad9361_reg_write(dev, 0x0238, 0x78);	// Set VCO Cal Offset[3:0]
+    status = ad9361_reg_write(dev, 0x0238, 0x70);	// Set VCO Cal Offset[3:0]
     status = ad9361_reg_write(dev, 0x0245, 0x00);	// Set VCO Cal Ref Tcf[2:0]
-    status = ad9361_reg_write(dev, 0x0251, 0x0B);	// Set VCO Varactor Reference[3:0]
+    status = ad9361_reg_write(dev, 0x0251, 0x09);	// Set VCO Varactor Reference[3:0]
     status = ad9361_reg_write(dev, 0x0250, 0x70);	// Set VCO Varactor Ref Tcf[2:0] and VCO Varactor Offset[3:0]
-    status = ad9361_reg_write(dev, 0x023B, 0x94);	// Set Synth Loop Filter charge pump current (Icp)
+    status = ad9361_reg_write(dev, 0x023B, 0x8F);	// Set Synth Loop Filter charge pump current (Icp)
-    status = ad9361_reg_write(dev, 0x023E, 0xF4);	// Set Synth Loop Filter C2 and C1
+    status = ad9361_reg_write(dev, 0x023E, 0xD4);	// Set Synth Loop Filter C2 and C1
     status = ad9361_reg_write(dev, 0x023F, 0xDF);	// Set Synth Loop Filter  R1 and C3
-    status = ad9361_reg_write(dev, 0x0240, 0x0A);	// Set Synth Loop Filter R3
+    status = ad9361_reg_write(dev, 0x0240, 0x09);	// Set Synth Loop Filter R3
 
 //************************************************************
 // Setup Tx Frequency-Dependent Syntheisizer Registers
 //************************************************************
     status = ad9361_reg_write(dev, 0x027A, 0x4A);	// Set VCO Output level[3:0]
-    status = ad9361_reg_write(dev, 0x0279, 0xC1);	// Set Init ALC Value[3:0] and VCO Varactor[3:0]
+    status = ad9361_reg_write(dev, 0x0279, 0xC0);	// Set Init ALC Value[3:0] and VCO Varactor[3:0]
-    status = ad9361_reg_write(dev, 0x0282, 0x0E);	// Set VCO Bias Tcf[1:0] and VCO Bias Ref[2:0]
+    status = ad9361_reg_write(dev, 0x0282, 0x0D);	// Set VCO Bias Tcf[1:0] and VCO Bias Ref[2:0]
-    status = ad9361_reg_write(dev, 0x0278, 0x78);	// Set VCO Cal Offset[3:0]
+    status = ad9361_reg_write(dev, 0x0278, 0x70);	// Set VCO Cal Offset[3:0]
     status = ad9361_reg_write(dev, 0x0285, 0x00);	// Set VCO Cal Ref Tcf[2:0]
-    status = ad9361_reg_write(dev, 0x0291, 0x0B);	// Set VCO Varactor Reference[3:0]
+    status = ad9361_reg_write(dev, 0x0291, 0x09);	// Set VCO Varactor Reference[3:0]
     status = ad9361_reg_write(dev, 0x0290, 0x70);	// Set VCO Varactor Ref Tcf[2:0] and VCO Varactor Offset[3:0]
-    status = ad9361_reg_write(dev, 0x027B, 0x93);	// Set Synth Loop Filter charge pump current (Icp)
+    status = ad9361_reg_write(dev, 0x027B, 0x8F);	// Set Synth Loop Filter charge pump current (Icp)
-    status = ad9361_reg_write(dev, 0x027E, 0xF4);	// Set Synth Loop Filter C2 and C1
+    status = ad9361_reg_write(dev, 0x027E, 0xD4);	// Set Synth Loop Filter C2 and C1
     status = ad9361_reg_write(dev, 0x027F, 0xDF);	// Set Synth Loop Filter  R1 and C3
-    status = ad9361_reg_write(dev, 0x0280, 0x0A);	// Set Synth Loop Filter R3
+    status = ad9361_reg_write(dev, 0x0280, 0x09);	// Set Synth Loop Filter R3
 
 //************************************************************
 // Write Rx and Tx Frequency Words
 //************************************************************
-    status = ad9361_reg_write(dev, 0x0233, 0x00);	// Write Rx Synth Fractional Freq Word[7:0]
+    status = ad9361_reg_write(dev, 0x0233, 0x8D);	// Write Rx Synth Fractional Freq Word[7:0]
-    status = ad9361_reg_write(dev, 0x0234, 0x00);	// Write Rx Synth Fractional Freq Word[15:8]
+    status = ad9361_reg_write(dev, 0x0234, 0x99);	// Write Rx Synth Fractional Freq Word[15:8]
-    status = ad9361_reg_write(dev, 0x0235, 0x00);	// Write Rx Synth Fractional Freq Word[22:16]
+    status = ad9361_reg_write(dev, 0x0235, 0x69);	// Write Rx Synth Fractional Freq Word[22:16]
     status = ad9361_reg_write(dev, 0x0232, 0x00);	// Write Rx Synth Integer Freq Word[10:8]
-    status = ad9361_reg_write(dev, 0x0231, 0xA0);	// Write Rx Synth Integer Freq Word[7:0]
+    status = ad9361_reg_write(dev, 0x0231, 0x7E);	// Write Rx Synth Integer Freq Word[7:0]
-    status = ad9361_reg_write(dev, 0x0005, 0x05);	// Set LO divider setting
+    status = ad9361_reg_write(dev, 0x0005, 0x22);	// Set LO divider setting
-    status = ad9361_reg_write(dev, 0x0273, 0x00);	// Write Tx Synth Fractional Freq Word[7:0]
+    status = ad9361_reg_write(dev, 0x0273, 0x8D);	// Write Tx Synth Fractional Freq Word[7:0]
-    status = ad9361_reg_write(dev, 0x0274, 0x00);	// Write Tx Synth Fractional Freq Word[15:8]
+    status = ad9361_reg_write(dev, 0x0274, 0x99);	// Write Tx Synth Fractional Freq Word[15:8]
-    status = ad9361_reg_write(dev, 0x0275, 0x00);	// Write Tx Synth Fractional Freq Word[22:16]
+    status = ad9361_reg_write(dev, 0x0275, 0x69);	// Write Tx Synth Fractional Freq Word[22:16]
     status = ad9361_reg_write(dev, 0x0272, 0x00);	// Write Tx Synth Integer Freq Word[10:8]
-    status = ad9361_reg_write(dev, 0x0271, 0xA5);	// Write Tx Synth Integer Freq Word[7:0] (starts VCO cal)
+    status = ad9361_reg_write(dev, 0x0271, 0x7E);	// Write Tx Synth Integer Freq Word[7:0] (starts VCO cal)
-    status = ad9361_reg_write(dev, 0x0005, 0x05);	// Set LO divider setting
+    status = ad9361_reg_write(dev, 0x0005, 0x22);	// Set LO divider setting
 
 //************************************************************
 // Program Mixer GM Sub-table
@@ -1542,12 +1057,12 @@ uint32_t ad9361_reg_config(struct ad9361_reg_dev *dev){
     status = ad9361_reg_write(dev, 0x011A, 0x27);	// Initial LMT Gain Limit
     status = ad9361_reg_write(dev, 0x0081, 0x00);	// Tx Symbol Gain Control
 //************************************************************
-// RX Baseband Filter Tuning (Real BW: 7.500000 MHz) 3dB Filter
+// RX Baseband Filter Tuning (Real BW: 20.000000 MHz) 3dB Filter
-// Corner @ 10.500000 MHz)
+// Corner @ 28.000000 MHz)
 //************************************************************
-    status = ad9361_reg_write(dev, 0x01FB, 0x07);	// RX Freq Corner (MHz)
+    status = ad9361_reg_write(dev, 0x01FB, 0x14);	// RX Freq Corner (MHz)
-    status = ad9361_reg_write(dev, 0x01FC, 0x40);	// RX Freq Corner (Khz)
+    status = ad9361_reg_write(dev, 0x01FC, 0x00);	// RX Freq Corner (Khz)
-    status = ad9361_reg_write(dev, 0x01F8, 0x0D);	// Rx BBF Tune Divider[7:0]
+    status = ad9361_reg_write(dev, 0x01F8, 0x05);	// Rx BBF Tune Divider[7:0]
     status = ad9361_reg_write(dev, 0x01F9, 0x1E);	// RX BBF Tune Divider[8]
 
     status = ad9361_reg_write(dev, 0x01D5, 0x3F);	// Set Rx Mix LO CM
@@ -1556,56 +1071,56 @@ uint32_t ad9361_reg_config(struct ad9361_reg_dev *dev){
     status = ad9361_reg_write(dev, 0x01E3, 0x02);	// Enable Rx2 Filter Tuner
     status = ad9361_reg_write(dev, 0x0016, 0x80);	// Start RX Filter Tune
 
-    // Wait for RX filter to tune, Max Cal Time: 6.884 us (Done when 0x016[7]==0)
+    // Wait for RX filter to tune, Max Cal Time: 2.648 us (Done when 0x016[7]==0)
 	time_out_cnt = 0;
 	do{
 		status |= ad9361_reg_read(dev, 0x0016, &value);
 		mdelay(1);// Wait 1ms
 		time_out_cnt++;
-	} while((value & 0x80) != 0x00 && time_out_cnt <= AD9361_TIMEOUT_TH);
+	} while((value & 0x80) != 0x00 && time_out_cnt <= TIMEOUT_TH);
 
     status = ad9361_reg_write(dev, 0x01E2, 0x03);	// Disable Rx Filter Tuner (Rx1)
     status = ad9361_reg_write(dev, 0x01E3, 0x03);	// Disable Rx Filter Tuner (Rx2)
 //************************************************************
-// TX Baseband Filter Tuning (Real BW: 7.500000 MHz) 3dB Filter
+// TX Baseband Filter Tuning (Real BW: 20.000000 MHz) 3dB Filter
-// Corner @ 12.000000 MHz)
+// Corner @ 32.000000 MHz)
 //************************************************************
-    status = ad9361_reg_write(dev, 0x00D6, 0x0B);	// TX BBF Tune Divider[7:0]
+    status = ad9361_reg_write(dev, 0x00D6, 0x04);	// TX BBF Tune Divider[7:0]
     status = ad9361_reg_write(dev, 0x00D7, 0x1E);	// TX BBF Tune Divider[8]
 
     status = ad9361_reg_write(dev, 0x00CA, 0x22);	// Enable Tx Filter Tuner
     status = ad9361_reg_write(dev, 0x0016, 0x40);	// Start Tx Filter Tune
 
-    // Wait for TX filter to tune, Max Cal Time: 3.390 us (Done when 0x016[6]==0)
+    // Wait for TX filter to tune, Max Cal Time: 1.233 us (Done when 0x016[6]==0)
 	time_out_cnt = 0;
 	do{
 		status |= ad9361_reg_read(dev, 0x0016, &value);
 		mdelay(1);// Wait 1ms
 		time_out_cnt++;
-	} while((value & 0x40) != 0x00 && time_out_cnt <= AD9361_TIMEOUT_TH);
+	} while((value & 0x40) != 0x00 && time_out_cnt <= TIMEOUT_TH);
 
     status = ad9361_reg_write(dev, 0x00CA, 0x26);	// Disable Tx Filter Tuner (Both Channels)
 //************************************************************
 // RX TIA Setup:  Setup values scale based on RxBBF calibration
 // results.  See information in Calibration Guide.
 //************************************************************
-    status = ad9361_reg_write(dev, 0x01DB, 0x60);	// Set TIA selcc[2:0]
+    status = ad9361_reg_write(dev, 0x01DB, 0x20);	// Set TIA selcc[2:0]
     status = ad9361_reg_write(dev, 0x01DD, 0x00);	// Set RX TIA1 C MSB[6:0]
     status = ad9361_reg_write(dev, 0x01DF, 0x00);	// Set RX TIA2 C MSB[6:0]
-    status = ad9361_reg_write(dev, 0x01DC, 0x72);	// Set RX TIA1 C LSB[5:0]
+    status = ad9361_reg_write(dev, 0x01DC, 0x47);	// Set RX TIA1 C LSB[5:0]
-    status = ad9361_reg_write(dev, 0x01DE, 0x72);	// Set RX TIA2 C LSB[5:0]
+    status = ad9361_reg_write(dev, 0x01DE, 0x47);	// Set RX TIA2 C LSB[5:0]
 
 //************************************************************
 // TX Secondary Filter Calibration Setup:  Real Bandwidth
-// 7.500000MHz, 3dB Corner @ 37.500000MHz
+// 20.000000MHz, 3dB Corner @ 100.000000MHz
 //************************************************************
-    status = ad9361_reg_write(dev, 0x00D2, 0x1E);	// TX Secondary Filter PDF Cap cal[5:0]
+    status = ad9361_reg_write(dev, 0x00D2, 0x04);	// TX Secondary Filter PDF Cap cal[5:0]
     status = ad9361_reg_write(dev, 0x00D1, 0x0C);	// TX Secondary Filter PDF Res cal[3:0]
-    status = ad9361_reg_write(dev, 0x00D0, 0x56);	// Pdampbias
+    status = ad9361_reg_write(dev, 0x00D0, 0x57);	// Pdampbias
 
 //************************************************************
 // ADC Setup:  Tune ADC Performance based on RX analog filter tune
-// corner.  Real Bandwidth: 6.982753 MHz, ADC Clock Frequency:
+// corner.  Real Bandwidth: 18.155158 MHz, ADC Clock Frequency:
 // 288.000000 MHz.  The values in registers 0x200 - 0x227 need to be
 // calculated using the equations in the Calibration Guide.
 //************************************************************
@@ -1617,23 +1132,23 @@ uint32_t ad9361_reg_config(struct ad9361_reg_dev *dev){
     status = ad9361_reg_write(dev, 0x0204, 0x24);
     status = ad9361_reg_write(dev, 0x0205, 0x00);
     status = ad9361_reg_write(dev, 0x0206, 0x00);
-    status = ad9361_reg_write(dev, 0x0207, 0x7C);
+    status = ad9361_reg_write(dev, 0x0207, 0x67);
-    status = ad9361_reg_write(dev, 0x0208, 0x46);
+    status = ad9361_reg_write(dev, 0x0208, 0x55);
-    status = ad9361_reg_write(dev, 0x0209, 0x3C);
+    status = ad9361_reg_write(dev, 0x0209, 0x31);
-    status = ad9361_reg_write(dev, 0x020A, 0x4C);
+    status = ad9361_reg_write(dev, 0x020A, 0x3E);
-    status = ad9361_reg_write(dev, 0x020B, 0x2C);
+    status = ad9361_reg_write(dev, 0x020B, 0x35);
-    status = ad9361_reg_write(dev, 0x020C, 0x4F);
+    status = ad9361_reg_write(dev, 0x020C, 0x41);
-    status = ad9361_reg_write(dev, 0x020D, 0x2A);
+    status = ad9361_reg_write(dev, 0x020D, 0x34);
     status = ad9361_reg_write(dev, 0x020E, 0x00);
-    status = ad9361_reg_write(dev, 0x020F, 0x7F);
+    status = ad9361_reg_write(dev, 0x020F, 0x6A);
-    status = ad9361_reg_write(dev, 0x0210, 0x7F);
+    status = ad9361_reg_write(dev, 0x0210, 0x6A);
-    status = ad9361_reg_write(dev, 0x0211, 0x7F);
+    status = ad9361_reg_write(dev, 0x0211, 0x6A);
-    status = ad9361_reg_write(dev, 0x0212, 0x4A);
+    status = ad9361_reg_write(dev, 0x0212, 0x3C);
-    status = ad9361_reg_write(dev, 0x0213, 0x4A);
+    status = ad9361_reg_write(dev, 0x0213, 0x3C);
-    status = ad9361_reg_write(dev, 0x0214, 0x4A);
+    status = ad9361_reg_write(dev, 0x0214, 0x3C);
-    status = ad9361_reg_write(dev, 0x0215, 0x4D);
+    status = ad9361_reg_write(dev, 0x0215, 0x3F);
-    status = ad9361_reg_write(dev, 0x0216, 0x4D);
+    status = ad9361_reg_write(dev, 0x0216, 0x3F);
-    status = ad9361_reg_write(dev, 0x0217, 0x4D);
+    status = ad9361_reg_write(dev, 0x0217, 0x3F);
     status = ad9361_reg_write(dev, 0x0218, 0x2E);
     status = ad9361_reg_write(dev, 0x0219, 0x9C);
     status = ad9361_reg_write(dev, 0x021A, 0x1F);
@@ -1664,7 +1179,7 @@ uint32_t ad9361_reg_config(struct ad9361_reg_dev *dev){
 		status |= ad9361_reg_read(dev, 0x0016, &value);
 		mdelay(1);// Wait 1ms
 		time_out_cnt++;
-	} while((value & 0x01) != 0x00 && time_out_cnt <= AD9361_TIMEOUT_TH);
+	} while((value & 0x01) != 0x00 && time_out_cnt <= TIMEOUT_TH);
 
     status = ad9361_reg_write(dev, 0x0185, 0x20);	// Set RF DC offset Wait Count
     status = ad9361_reg_write(dev, 0x0186, 0x32);	// Set RF DC Offset Count[7:0]
@@ -1680,21 +1195,21 @@ uint32_t ad9361_reg_config(struct ad9361_reg_dev *dev){
 		status |= ad9361_reg_read(dev, 0x0016, &value);
 		mdelay(1);// Wait 1ms
 		time_out_cnt++;
-	} while((value & 0x01) != 0x00 && time_out_cnt <= AD9361_TIMEOUT_TH);
+	} while((value & 0x01) != 0x00 && time_out_cnt <= TIMEOUT_TH);
 
 //************************************************************
 // Tx Quadrature Calibration Settings
 //************************************************************
-    status = ad9361_reg_write(dev, 0x00A0, 0x15);	// Set TxQuadcal NCO frequency
+    status = ad9361_reg_write(dev, 0x00A0, 0x5F);	// Set TxQuadcal NCO frequency
-    status = ad9361_reg_write(dev, 0x00A3, 0x00);	// Set TxQuadcal NCO frequency (Only update bits [7:6])
+    status = ad9361_reg_write(dev, 0x00A3, 0x80);	// Set TxQuadcal NCO frequency (Only update bits [7:6])
     status = ad9361_reg_write(dev, 0x00A1, 0x7B);	// Tx Quad Cal Configuration, Phase and Gain Cal Enable
     status = ad9361_reg_write(dev, 0x00A9, 0xFF);	// Set Tx Quad Cal Count
     status = ad9361_reg_write(dev, 0x00A2, 0x7F);	// Set Tx Quad Cal Kexp
     status = ad9361_reg_write(dev, 0x00A5, 0x01);	// Set Tx Quad Cal Magnitude Threshhold
     status = ad9361_reg_write(dev, 0x00A6, 0x01);	// Set Tx Quad Cal Magnitude Threshhold
-    status = ad9361_reg_write(dev, 0x00AA, 0x28);	// Set Tx Quad Cal Gain Table index
+    status = ad9361_reg_write(dev, 0x00AA, 0x22);	// Set Tx Quad Cal Gain Table index
     status = ad9361_reg_write(dev, 0x00A4, 0xF0);	// Set Tx Quad Cal Settle Count
-    status = ad9361_reg_write(dev, 0x00AE, 0x04);	// Set Tx Quad Cal LPF Gain index incase Split table mode used
+    status = ad9361_reg_write(dev, 0x00AE, 0x00);	// Set Tx Quad Cal LPF Gain index incase Split table mode used
 
     status = ad9361_reg_write(dev, 0x0169, 0xC0);	// Disable Rx Quadrature Calibration before Running Tx Quadrature Calibration
     status = ad9361_reg_write(dev, 0x0016, 0x10);	// Start Tx Quad cal
@@ -1705,7 +1220,7 @@ uint32_t ad9361_reg_config(struct ad9361_reg_dev *dev){
 		status |= ad9361_reg_read(dev, 0x0016, &value);
 		mdelay(1);// Wait 1ms
 		time_out_cnt++;
-	} while((value & 0x10) != 0x00 && time_out_cnt <= AD9361_TIMEOUT_TH);
+	} while((value & 0x10) != 0x00 && time_out_cnt <= TIMEOUT_TH);
 
     status = ad9361_reg_write(dev, 0x016A, 0x75);	// Set Kexp Phase
     status = ad9361_reg_write(dev, 0x016B, 0x95);	// Set Kexp Amplitude & Prevent Positive Gain Bit
@@ -1736,11 +1251,5 @@ uint32_t ad9361_reg_config(struct ad9361_reg_dev *dev){
     status = ad9361_reg_write(dev, 0x0158, 0x0D);	// RSSI Mode Select
     status = ad9361_reg_write(dev, 0x015C, 0x67);	// Power Measurement Duration
 
-//************************************************************
-// Enable External LO & External VCO Buffer
-//************************************************************
-    status |= ad9361_reg_write(dev, 0x0005, 0x07);
-    status |= ad9361_reg_write(dev, 0x0057, 0x1C);
-
     return status;
 }

df_datalink_sp/src/dev_profile/ad9528_profile.c

@@ -0,0 +1,134 @@
+#include "dev_profile.h"
+#include "../config/app_config.h"
+#include "../drivers/platform/xilinx_gpio.h"
+#include "../drivers/axi_core/spi_engine/spi_engine.h"
+#include "../drivers/frequency/ad9528/ad9528.h"
+
+static struct spi_engine_init_param spi_engine_param = {
+	.ref_clk_hz = AD9528_SPI_ENGINE_REF_CLK,
+	.type = SPI_ENGINE,
+	.spi_engine_baseaddr = AD9528_SPI_ENGINE_BASEADDR,
+	.cs_delay = AD9528_SPI_ENGINE_CS_DELAY,
+	.data_width = AD9528_SPI_ENGINE_DATA_WIDTH
+};
+
+static struct xil_gpio_init_param xil_gpio_param = {
+	.type = GPIO_PS,
+	.device_id = AD9528_GPIO_DEVICE_ID
+};
+
+static struct spi_init_param ad9528_spi_init = {
+	.device_id = AD9528_SPI_DEVICE_ID,
+    .max_speed_hz = AD9528_SPI_ENGINE_MAX_SPEED,
+	.mode = SPI_MODE_0,
+	.chip_select = AD9528_SPI_CS,
+	.platform_ops = &spi_eng_platform_ops,
+	.extra = &spi_engine_param
+};
+
+static struct gpio_init_param ad9528_gpio_resetb_init = {
+	.number = AD9528_RESETB,
+	.platform_ops = &xil_gpio_ops,
+	.extra = &xil_gpio_param
+};
+
+static struct gpio_init_param ad9528_gpio_sysref_req_init = {
+	.number = AD9528_SYSREF_REQ,
+	.platform_ops = &xil_gpio_ops,
+	.extra = &xil_gpio_param
+};
+
+static ad9528pll1Settings_t clockPll1Settings = {
+    .refA_Frequency_Hz  = 50000000,
+    .refA_Divider       = 1,
+    .refA_bufferCtrl    = SINGLE_ENDED,
+    .refB_Frequency_Hz  = 0,
+    .refB_Divider       = 1,
+    .refB_bufferCtrl    = DISABLED,
+    .vcxo_Frequency_Hz  = 50000000,
+    .vcxoBufferCtrl     = SINGLE_ENDED,
+    .nDivider           = 1
+};
+
+static ad9528pll2Settings_t clockPll2Settings = {
+    .rfDivider = 4,
+    .n2Divider = 20,
+    .totalNdiv = 80
+};
+
+/*******************************************************************
+ * Output Distribution Settings
+ * 9369CE02A uses the following clock outputs
+ * OUT 1: FPGA REFCLK
+ * OUT 3: FPGA SYSREF
+ * OUT 12: DUT SYSREF
+ * OUT 13: DUT REFCLK
+ *******************************************************************
+ */
+static ad9528outputSettings_t clockOutputSettings = {
+    .outPowerDown = 0xE001,
+    .outSource = {
+            AD9528_CHANNEL_DIV, AD9528_CHANNEL_DIV, AD9528_CHANNEL_DIV, AD9528_CHANNEL_DIV, AD9528_CHANNEL_DIV,
+			AD9528_CHANNEL_DIV, AD9528_CHANNEL_DIV, AD9528_CHANNEL_DIV, AD9528_CHANNEL_DIV, AD9528_CHANNEL_DIV,
+			AD9528_CHANNEL_DIV, AD9528_CHANNEL_DIV, AD9528_CHANNEL_DIV, AD9528_CHANNEL_DIV
+    },
+    .outBufferCtrl = {
+    		0,0,0,0,0,
+    		0,0,0,0,0,
+			0,0,0,0
+    },
+    .outAnalogDelay = {
+    		0,0,0,0,0,
+    		0,0,0,0,0,
+			0,0,0,0
+    },
+    .outDigitalDelay = {
+    		0,0,0,0,0,
+    		0,0,0,0,0,
+			0,0,0,0
+    },
+    .outChannelDiv = {
+    		5,25,25,5,5,
+			5,5,8,5,5,
+			5,5,10,5
+    },
+    .outFrequency_Hz    = {
+            200e6, 40e6, 40e6, 200e6, 200e6,
+			200e6, 200e6, 125e6, 200e6, 200e6,
+			200e6, 200e6, 100e6, 200e6
+    }
+};
+
+static ad9528sysrefSettings_t clockSysrefSettings = {
+    .sysrefRequestMethod    = PIN,
+    .sysrefSource           = INTERNAL,
+    .sysrefPinEdgeMode      = LEVEL_ACTIVE_HIGH,
+    .sysrefPinBufferMode    = DISABLED,
+    .sysrefPatternMode      = CONTINUOUS,
+    .sysrefNshotMode        = FOUR_PULSES,
+    .sysrefDivide           = 256
+};
+
+static ad9528spiSettings_t clockSpiSettings = {
+    .chipSelectIndex        = AD9528_SPI_CS, //chip select Index, not used
+    .writeBitPolarity       = 0, //Write bit polarity
+    .longInstructionWord    = 1, //16bit instruction word
+    .MSBFirst               = 1, //MSB first
+    .CPHA                   = 0, //Clock phase
+    .CPOL                   = 0, //Clock polarity
+    .enSpiStreaming         = 0, //uint8_t enSpiStreaming;
+    .autoIncAddrUp          = 1, //uint8_t autoIncAddrUp;
+    .fourWireMode           = 1  //uint8_t fourWireMode;
+};
+
+ad9528Init_t ad9528_default_init_param = {
+	/* SPI */
+	.spi_init = &ad9528_spi_init,
+	.gpio_init_resetb = &ad9528_gpio_resetb_init,
+	.gpio_init_sysref_req = &ad9528_gpio_sysref_req_init,
+    .spiSettings = &clockSpiSettings,
+    .pll1Settings = &clockPll1Settings,
+    .pll2Settings = &clockPll2Settings,
+    .outputSettings = &clockOutputSettings,
+    .sysrefSettings = &clockSysrefSettings
+};

df_datalink_sp/src/dev_profile/dev_profile.h

@@ -6,6 +6,7 @@
 #include "../drivers/rf-transceiver/ad9361/ad9361_api.h"
 #include "../drivers/rf-transceiver/ad9361_reg/ad9361_reg.h"
 #include "../drivers/frequency/hmc7044/hmc7044.h"
+#include "../drivers/frequency/ad9528/ad9528.h"
 #include "../drivers/adc/ad9694/ad9694.h"
 #include "../config/app_config.h"
 
@@ -17,6 +18,9 @@ extern struct global_timer_init_param globaltimer_init_param;
 // HMC7044
 extern struct hmc7044_init_param hmc7044_default_init_param;
 
+// AD9528
+extern ad9528Init_t ad9528_default_init_param;
+
 // AD9361
 extern AD9361_InitParam ad9361_default_init_param;
 extern AD9361_RXFIRConfig rx_fir_config;

df_datalink_sp/src/dev_profile/hmc7044_profile.c

@@ -23,7 +23,7 @@ static struct spi_init_param hmc7044_spi_init_param = {
 	.device_id = HMC7044_SPI_DEVICE_ID,
     .max_speed_hz = HMC7044_SPI_ENGINE_MAX_SPEED,
 	.mode = SPI_MODE_4,
-	.chip_select = HMC7044_SPI_CS_HMC7044,
+	.chip_select = HMC7044_SPI_CS,
 	.platform_ops = &spi_eng_platform_ops,
 	.extra = &spi_engine_param
 };
@@ -42,9 +42,9 @@ struct hmc7044_chan_spec hmc7044_chan_spec[4] = {
 		.dynamic_driver_enable = false,
 		.output_control0_rb4_enable = true,
 		.force_mute_enable = false,
-		.driver_mode = CML,
+		.driver_mode = HMC7044_CML,
 		.driver_impedance = INTERNAL_100OHM_PER_PIN,
-		.out_mux_mode = CHANNEL_DIV
+		.out_mux_mode = HMC7044_CHANNEL_DIV
 	},
 	/* FPGA_DAC_LOGIC_CLK */
 	{
@@ -58,9 +58,9 @@ struct hmc7044_chan_spec hmc7044_chan_spec[4] = {
 		.dynamic_driver_enable = false,
 		.output_control0_rb4_enable = true,
 		.force_mute_enable = false,
-		.driver_mode = CML,
+		.driver_mode = HMC7044_CML,
 		.driver_impedance = INTERNAL_100OHM_PER_PIN,
-		.out_mux_mode = CHANNEL_DIV
+		.out_mux_mode = HMC7044_CHANNEL_DIV
 	},
 	/* B_AD9361_XTAL */
 	{
@@ -74,9 +74,9 @@ struct hmc7044_chan_spec hmc7044_chan_spec[4] = {
 		.dynamic_driver_enable = false,
 		.output_control0_rb4_enable = true,
 		.force_mute_enable = false,
-		.driver_mode = CML,
+		.driver_mode = HMC7044_CML,
 		.driver_impedance = INTERNAL_100OHM_PER_PIN,
-		.out_mux_mode = CHANNEL_DIV
+		.out_mux_mode = HMC7044_CHANNEL_DIV
 	},
 	/* AD9361_RX_EXT_LO */
 	{
@@ -90,9 +90,9 @@ struct hmc7044_chan_spec hmc7044_chan_spec[4] = {
 		.dynamic_driver_enable = false,
 		.output_control0_rb4_enable = true,
 		.force_mute_enable = false,
-		.driver_mode = CML,
+		.driver_mode = HMC7044_CML,
 		.driver_impedance = INTERNAL_100OHM_PER_PIN,
-		.out_mux_mode = CHANNEL_DIV
+		.out_mux_mode = HMC7044_CHANNEL_DIV
 	},
 };
 

df_datalink_sp/src/drivers/axi_core/spi_engine/spi_engine.c

@@ -697,7 +697,6 @@ int32_t spi_engine_write_and_read(struct spi_desc *desc,
 				  uint8_t *data,
 				  uint16_t bytes_number)
 {
-	uint8_t 		i;
 	uint8_t 		word_len;
 	uint8_t 		words_number;
 	int32_t 		ret;

df_datalink_sp/src/drivers/frequency/ad9528/ad9528.c

@@ -0,0 +1,783 @@
+/**
+ * \file ad9528.c
+ * \brief Contains source code for configuring and initializing AD9528 clock device
+ */
+
+/**
+* \page Disclaimer Legal Disclaimer
+* Copyright 2015-2017 Analog Devices Inc.
+* Released under the AD9371 API license.
+*
+*/
+
+#include <stdlib.h>
+#include <stdio.h>
+#include "ad9528.h"
+#include "../../../include/error.h"
+
+static uint32_t _desired_time_to_elapse_ms = 0;
+
+/**
+ * \brief Write data to a register
+ */
+int32_t AD9528_spiWriteByte(ad9528Device_t *device, uint16_t addr,
+				 uint8_t data)
+{
+	uint8_t buf[3];
+	int32_t status;
+
+	buf[0] = (addr >> 8) & 0x7F;
+	buf[1] = addr & 0xFF;
+	buf[2] = data;
+	status = spi_write_and_read_3wire(device->spi_desc,
+			buf, NULL, 3, 0);
+
+	return status;
+}
+
+/**
+ * \brief Read data from a register
+ */
+int32_t AD9528_spiReadByte(ad9528Device_t *device, uint16_t addr,
+				uint8_t *readdata)
+{
+	uint8_t tx_buf[2];
+	uint8_t rx_buf[1];
+	int32_t status;
+
+	tx_buf[0] = 0x80 | addr >> 8;
+	tx_buf[1] = addr & 0xFF;
+
+	status = spi_write_and_read_3wire(device->spi_desc,
+			tx_buf, rx_buf, 2, 1);
+
+	*readdata = rx_buf[0];
+
+	return status;
+}
+
+/**
+ * \brief Modify a field of bits from a register
+ */
+int32_t AD9528_spiWriteField(ad9528Device_t *device,
+				  uint16_t addr, uint8_t fieldVal, uint8_t mask, uint8_t startBit)
+{
+	int32_t errVal;
+	uint8_t readVal;
+
+	errVal = AD9528_spiReadByte(device, addr, &readVal);
+	if (errVal < 0)
+		return errVal;
+
+	readVal = (readVal & ~mask) | ((fieldVal << startBit) & mask);
+
+	return AD9528_spiWriteByte(device, addr, readVal);
+}
+
+/**
+ * \brief Set the desired timeout value
+ */
+int32_t AD9528_setTimeout_ms(uint32_t timeOut_ms)
+{
+	_desired_time_to_elapse_ms = timeOut_ms;
+
+	return SUCCESS;
+}
+
+/**
+ * \brief Verify if the desired time has elapsed
+ */
+int32_t AD9528_hasTimeoutExpired()
+{
+	udelay(1000);
+
+	_desired_time_to_elapse_ms--;
+	if (_desired_time_to_elapse_ms > 0)
+		return SUCCESS;
+
+	return FAILURE;
+}
+
+/**
+ * \brief Performs a hard reset on the AD9528 DUT
+ *
+ * <B>Dependencies</B>
+ * - device->spiSettings->chipSelectIndex
+ *
+ * \param device is structure pointer to the AD9528 data structure containing settings
+ * \return Returns enum ADI_ERR, ADIERR_OK=pass, !ADIERR_OK=fail
+ */
+int32_t AD9528_resetDevice(ad9528Device_t *device)
+{
+	gpio_direction_output(device->gpio_resetb, 0);
+	mdelay(100);
+	gpio_direction_output(device->gpio_resetb, 1);
+	mdelay(100);
+
+	AD9528_spiWriteByte(device, AD9528_ADDR_ADI_SPI_CONFIG_A, 0x81);
+	mdelay(100);
+	AD9528_spiWriteByte(device, AD9528_ADDR_ADI_SPI_CONFIG_A, 0x00);
+	mdelay(100);
+
+	return SUCCESS;
+}
+
+/**
+ * \brief Sets the AD9528 device SPI settings (3wire/4wire, MSBFirst, etc).
+ *
+ * This function will use the settings in the device->spiSettings structure
+ * to set SPI stream mode, address auto increment direction, MSBFirst/LSBfirst,
+ * and 3wire/4wire mode.  The AD9528 device always uses SPI MODE 0 (CPHA=0, CPOL=0).
+ * This function will update your device->spiSettings to set CHPA=0 and CPOL=0 and
+ * longInstructionWord =1 to use a 16bit instruction word.
+ *
+ * <B>Dependencies</B>
+ * - writes device->spiSettings->CPHA = 0
+ * - writes device->spiSettings->CPOL = 0
+ * - writes device->spiSettings->longInstructionWord = 1
+ *
+ * - device->spiSettings->MSBFirst
+ * - device->spiSettings->enSpiStreaming
+ * - device->spiSettings->autoIncAddrUp
+ * - device->spiSettings->fourWireMode
+ *
+ * \param device is structure pointer to the AD9528 data structure containing settings
+ *
+ * \return Returns enum ADI_ERR, ADIERR_OK=pass, !ADIERR_OK=fail
+ */
+int32_t AD9528_setSpiSettings(ad9528Device_t *device)
+{
+	uint8_t spiReg = 0;
+
+	device->spiSettings->CPHA = 0;
+	device->spiSettings->CPOL = 0;
+	device->spiSettings->longInstructionWord = 1;
+
+	if (device->spiSettings->MSBFirst == 0) {
+		spiReg |= 0x42; /* SPI bit is 1=LSB first */
+	}
+
+	if (device->spiSettings->autoIncAddrUp > 0) {
+		spiReg |= 0x24;
+	}
+
+	if (device->spiSettings->fourWireMode > 0) {
+		spiReg |= 0x18;
+	}
+
+	AD9528_spiWriteByte(device, AD9528_ADDR_ADI_SPI_CONFIG_A, spiReg);
+
+	if (device->spiSettings->enSpiStreaming > 0) {
+		/* Allow SPI streaming mode: SPI message ends when chip select deasserts */
+		AD9528_spiWriteByte(device, AD9528_ADDR_ADI_SPI_CONFIG_B, 0x00);
+	} else {
+		/* Force single instruction mode */
+		AD9528_spiWriteByte(device, AD9528_ADDR_ADI_SPI_CONFIG_B, 0x80);
+	}
+
+	return SUCCESS;
+}
+
+/**
+ * \brief Helper function for ADI transceiver eval boards to init the AD9528 data structure
+ *
+ * This function inits the AD9528 device data structure with defaults that
+ * are known to work with the ADI AD9369 and AD9371 evaluation boards.  NOTE: This function will
+ * modify the contents of the AD9528 device data structure.
+ *
+ * <B>Dependencies</B>
+ * - spi->chipSelectIndex
+ * - spi
+ *
+ * \param device Pointer to the AD9528 device data structure to initialize
+ * \param vcxoFrequency_Hz The VCXO frequency that is connected to the AD9528
+ * \param refAFrequency_Hz The reference clock frequency being input into the AD9528 REFCLK A input
+ * \param outputDeviceClock_Hz Desired output clock frequency to the FPGA and transceiver device
+ *
+ * \return Returns enum ADI_ERR, 0=pass, >0 = fail
+*/
+int32_t AD9528_initDeviceDataStruct(ad9528Device_t *device,
+					uint32_t vcxoFrequency_Hz, uint32_t refAFrequency_Hz,
+					uint32_t outputDeviceClock_Hz)
+{
+//	uint16_t chDiv;
+//	uint8_t i = 0;
+//
+//	uint32_t pll1PfdFreq_Hz = 0;
+//	uint8_t pll1Ndiv = 0;
+//	uint8_t validPll1DivSetting = 0;
+//	uint8_t refAdiv = 1;
+//
+//
+//	uint8_t pll2RfDiv = 3; /* Valid values 3,4,5 */
+//	uint16_t pll2Ndiv = 1; /* Valid values 1-256 */
+//	uint32_t pll2InputFreq_Hz = 0;
+//	uint64_t pll2VcoFreq_Hz = 0;
+//	uint16_t pll2NdivStart = 0;
+//	uint8_t validPll2DivSetting = 0;
+//	uint64_t chDivU64 = 0;
+//
+//	static const uint64_t PLL2_MIN_VCO_FREQ_HZ = 3450000000ULL;
+//	static const uint64_t PLL2_MAX_VCO_FREQ_HZ = 4025000000ULL;
+
+//	struct spi_init_param spi_param;
+//	int32_t status;
+//
+//	status = gpio_get(&device->gpio_resetb, CLK_RESETB);
+//	status |= gpio_get(&device->gpio_sysref_req, ADRV_SYSREF_REQ);
+//
+//	spi_param.id = 0;
+//	spi_param.mode = SPI_MODE_0;
+//	spi_param.chip_select = CLK_CS;
+//	status |= spi_init(&device->spi_desc, &spi_param);
+//
+//	if (status != SUCCESS)
+//		return FAILURE;
+
+	/*******************************************************************
+	 * PLL1 Settings
+	 *******************************************************************
+	 */
+
+	/* find valid PLL1 Ndiv and REFA div */
+//	for (pll1Ndiv = 1; pll1Ndiv < 20; pll1Ndiv++) {
+//		pll1PfdFreq_Hz = vcxoFrequency_Hz / pll1Ndiv;
+//
+//		if ((pll1PfdFreq_Hz <= 110000000) && (pll1PfdFreq_Hz >= 1000000) &&
+//		    (pll1PfdFreq_Hz <= refAFrequency_Hz) &&
+//		    (refAFrequency_Hz % pll1PfdFreq_Hz == 0)
+//		   ) {
+//			validPll1DivSetting = 1;
+//			refAdiv = refAFrequency_Hz / pll1PfdFreq_Hz ;
+//			break;
+//		}
+//	}
+//
+//	if (validPll1DivSetting == 0) {
+//		return FAILURE;
+//	}
+
+//	device->pll1Settings->nDivider =
+//		pll1Ndiv; //This init function always runs PLL1 at 30.72MHz Pfd rate
+//	device->pll1Settings->refA_bufferCtrl =
+//		DIFFERENTIAL;	   //DISABLED = 0, SINGLE_ENDED, NEG_SINGLE_ENDED, DIFFERENTIAL
+//	device->pll1Settings->refA_Divider = refAdiv;
+//	device->pll1Settings->refA_Frequency_Hz = refAFrequency_Hz;
+//	device->pll1Settings->refB_bufferCtrl =
+//		DISABLED;		   //DISABLED = 0, SINGLE_ENDED, NEG_SINGLE_ENDED, DIFFERENTIAL
+//	device->pll1Settings->refB_Divider = 1;
+//	device->pll1Settings->refB_Frequency_Hz = 0;
+//	device->pll1Settings->vcxoBufferCtrl  =
+//		NEG_SINGLE_ENDED;   //DISABLED = 0, SINGLE_ENDED, NEG_SINGLE_ENDED, DIFFERENTIAL
+//	device->pll1Settings->vcxo_Frequency_Hz = vcxoFrequency_Hz;
+
+	/*******************************************************************
+	 * PLL2 Settings
+	 *******************************************************************
+	 */
+
+	/*******************************************************************
+	 * Output Distribution Settings
+	 * 9369CE02A uses the following clock outputs
+	 * OUT 1: FPGA REFCLK
+	 * OUT 3: FPGA SYSREF
+	 * OUT 12: DUT SYSREF
+	 * OUT 13: DUT REFCLK
+	 *******************************************************************
+	 */
+
+	/* PLL 2 input clock can be several different things.  Currently hard coded by this init funciton to use
+	 * PLL 1 output (VCXO Frequency) with no scaling
+	 */
+//	pll2InputFreq_Hz = device->pll1Settings->vcxo_Frequency_Hz;
+//	validPll2DivSetting = 0;
+
+	/* Sweep PLL2 Divider settings to find something that has a valid integer divide (3,4,5)*/
+//	for (pll2RfDiv = 3; pll2RfDiv <= 5; pll2RfDiv++) {
+//
+//		pll2NdivStart = (PLL2_MIN_VCO_FREQ_HZ / pll2RfDiv / pll2InputFreq_Hz);
+//		/* find valid PLL2 Ndiv (1-256) */
+//		for (pll2Ndiv = pll2NdivStart; pll2Ndiv <= 256; pll2Ndiv++) {
+//			pll2VcoFreq_Hz = (pll2InputFreq_Hz * pll2RfDiv * pll2Ndiv);
+//
+//			if (pll2VcoFreq_Hz < PLL2_MIN_VCO_FREQ_HZ) {
+//				/* Continue to next PLL2 N div */
+//				continue;
+//			} else if (pll2VcoFreq_Hz > PLL2_MAX_VCO_FREQ_HZ) {
+//				/* Break to next PLL2 RF div */
+//				break;
+//			}
+//
+//			if (((pll2VcoFreq_Hz / pll2RfDiv) % outputDeviceClock_Hz) == 0) {
+//
+//				device->pll2Settings->rfDivider = pll2RfDiv;
+//				device->pll2Settings->n2Divider = pll2Ndiv;
+//				device->pll2Settings->totalNdiv = pll2RfDiv * pll2Ndiv;
+//				chDivU64 = ((pll2VcoFreq_Hz / pll2RfDiv) / outputDeviceClock_Hz);
+//
+//				if ((chDivU64 < 1) || (chDivU64 > 256)) {
+//					return FAILURE;
+//				} else {
+//					chDiv = (uint16_t)(chDivU64);
+//				}
+//
+//				validPll2DivSetting = 1;
+//				break;
+//			}
+//		}
+//
+//		if (validPll2DivSetting == 1) {
+//			break;
+//		}
+//	}
+//
+//	if (validPll2DivSetting == 0) {
+//		return FAILURE;
+//	}
+//
+//	device->outputSettings->outPowerDown = (uint16_t)(
+//			~0x318A);	 //enable outputs 13,12,8,7,3 and 1
+//
+//	for (i=0; i<14; i++) {
+//		device->outputSettings->outSource[i] =
+//			CHANNEL_DIV; //CHANNEL_DIV , PLL1_OUTPUT, SYSREF, INV_PLL1_OUTPUT
+//		device->outputSettings->outBufferCtrl[i] = LVDS;		//LVDS, LVDS_BOOST, HSTL
+//		device->outputSettings->outChannelDiv[i] = chDiv;
+//		device->outputSettings->outFrequency_Hz[i] = outputDeviceClock_Hz;
+//		device->outputSettings->outAnalogDelay[i] = 0;
+//		device->outputSettings->outDigitalDelay[i] = 0;
+//	}
+//
+//
+//	device->outputSettings->outSource[3] = SYSREF;
+//	device->outputSettings->outSource[7] = SYSREF;
+//	device->outputSettings->outSource[12] = SYSREF;
+//
+//
+//	device->sysrefSettings->sysrefDivide =
+//		512; //SYSREF frequency = VCXO / 2 / sysrefDivde
+//	device->sysrefSettings->sysrefNshotMode =
+//		ONE_PULSE;		//ONE_PULSE=0, TWO_PULSES=2, FOUR_PULSES=3, SIX_PULSES=4, EIGHT_PULSES=5
+//	device->sysrefSettings->sysrefPatternMode =
+//		CONTINUOUS;		  //NSHOT=0, CONTINUOUS=1, PRBS=2, STOP=3
+//	device->sysrefSettings->sysrefPinBufferMode =
+//		DISABLED;	 //DISABLED = 0, SINGLE_ENDED, NEG_SINGLE_ENDED, DIFFERENTIAL
+//	device->sysrefSettings->sysrefPinEdgeMode =
+//		LEVEL_ACTIVE_HIGH;  //LEVEL_ACTIVE_HIGH=0, LEVEL_ACTIVE_LOW=1, RISING_EDGE=2, FALLING_EDGE=3
+//	device->sysrefSettings->sysrefRequestMethod = PIN;		  //SPI=0,PIN=1
+//	device->sysrefSettings->sysrefSource =
+//		INTERNAL;			//EXTERNAL=0, EXT_RESAMPLED=1, INTERNAL=2
+
+	return SUCCESS;
+}
+
+int32_t AD9528_init(ad9528Device_t **device, const ad9528Init_t *init_device)
+{
+	int ret = SUCCESS;
+	ad9528Device_t *dev;
+
+	dev = (ad9528Device_t *)malloc(sizeof(*dev));
+	if (!dev)
+		return FAILURE;
+
+	/* SPI */
+	ret = spi_init(&dev->spi_desc, init_device->spi_init);
+	ret |= gpio_get(&dev->gpio_resetb, init_device->gpio_init_resetb);
+	ret |= gpio_get(&dev->gpio_sysref_req, init_device->gpio_init_sysref_req);
+
+	gpio_direction_output(dev->gpio_resetb, 0);
+	gpio_direction_output(dev->gpio_sysref_req, 0);
+
+	AD9528_resetDevice(dev);
+
+	dev->spiSettings = init_device->spiSettings;
+	dev->pll1Settings = init_device->pll1Settings;
+	dev->pll2Settings = init_device->pll2Settings;
+	dev->outputSettings = init_device->outputSettings;
+	dev->sysrefSettings = init_device->sysrefSettings;
+
+	*device = dev;
+
+	return ret;
+}
+
+/**
+ * \brief Initializes the AD9528 by writing all SPI registers
+ *
+ * Initializes the AD9528 for use with the AD9369 transceiver.  Designed to work with
+ * a reference clock of 122.88MHz.  Reference clock is expected to be 30.72MHz.
+ * The output clocks from the AD9528 can run at 122.88M, 153.6M, 184.32M, 245.76M, or 307.2M.
+ * Typical setup: REFA frequency = 30.72, VCXO = 122.88MHz
+ * SYNC(SYSREF) pulses output at rate of 120kHz
+ *
+ * <B>Dependencies</B>
+ * - All parameters in device structure
+ *
+ * \param device is structure pointer to AD9528 clock device structure
+ *
+ * \return Returns enum ADI_ERR, 0=pass, >0 = fail
+ */
+int32_t AD9528_config(ad9528Device_t
+			      *device)   //writes all registers to desired values, leaves clock outputs off, SYSREF output disabled.
+{
+	uint8_t pll2_Adiv=0;
+	uint8_t pll2_Bdiv=0;
+	uint8_t reg108=0;
+	uint8_t reg109=0x4;
+	uint8_t i = 0;
+	uint8_t j = 0;
+	uint8_t reg508;
+	int32_t retval = SUCCESS;
+
+	retval = AD9528_setSpiSettings(device);
+	if (retval != SUCCESS) {
+		return retval;
+	}
+
+	/**********************************************************************
+	 * Configure PLL1
+	 **********************************************************************
+	 */
+
+	AD9528_spiWriteByte(device, AD9528_ADDR_REF_A_DIVIDER_LSB,
+			    device->pll1Settings->refA_Divider & 0xFF);		//REF A div[7:0]
+	AD9528_spiWriteByte(device, AD9528_ADDR_REF_A_DIVIDER_MSB,
+			    (device->pll1Settings->refA_Divider >> 8) & 0x03); //REF A div[9:8]
+	AD9528_spiWriteByte(device, AD9528_ADDR_REF_B_DIVIDER_LSB,
+			    device->pll1Settings->refB_Divider & 0xFF);		//REF B div[7:0]
+	AD9528_spiWriteByte(device, AD9528_ADDR_REF_B_DIVIDER_MSB,
+			    (device->pll1Settings->refB_Divider >> 8) & 0x03); //REF B div[9:8]
+	AD9528_spiWriteByte(device, AD9528_ADDR_PLL1_N_DIV_LSB,
+			    device->pll1Settings->nDivider & 0xFF); //PLL1 N div[7:0]
+	AD9528_spiWriteByte(device, AD9528_ADDR_PLL1_N_DIV_MSB,
+			    (device->pll1Settings->nDivider >> 8) & 0x03); //PLL1 N div[9:8]
+	AD9528_spiWriteByte(device, AD9528_ADDR_PLL1_CHARGEPUMP,
+			    0x0A); //PLL1 Charge Pump control 1
+	AD9528_spiWriteByte(device, AD9528_ADDR_PLL1_CP_CTRL2,
+			    0x03); //PLL1 Charge Pump control 2
+
+	switch (device->pll1Settings->refA_bufferCtrl) {
+	case DISABLED:
+		reg108 &= ~0x28;
+		reg109 &= ~0x01;
+		break; //clear all REFA enable bits
+	case SINGLE_ENDED:
+		reg108 |=  0x08;
+		reg109 &= ~0x01;
+		break; //Set REFA receiver enable, clear REFA SE negative input enable
+	case NEG_SINGLE_ENDED:
+		reg108 |=  0x08;
+		reg108 &= ~0x10;
+		reg109 |= 0x01;
+		break; //Disable REFA diff receiver, enable REFA receiver and use negative REFA input
+	case DIFFERENTIAL:
+		reg108 |=  0x28;
+		reg109 &= ~0x01;
+		break;
+	default:
+		reg108 |=  0x08;
+		reg109 &= ~0x01;
+		break; //default to single ended case
+	}
+	switch (device->pll1Settings->refB_bufferCtrl) {
+	case DISABLED:
+		reg108 &= ~0x50;
+		reg109 &= ~0x02;
+		break; //clear all REFB enable bits
+	case SINGLE_ENDED:
+		reg108 |=  0x10;
+		reg109 &= ~0x02;
+		break; //Set REFB receiver enable, clear REFB SE negative input enable
+	case NEG_SINGLE_ENDED:
+		reg108 |=  0x10;
+		reg108 &= ~0x40;
+		reg109 |= 0x02;
+		break; //Disable REFB diff receiver, enable REFB receiver and use negative REFB input
+	case DIFFERENTIAL:
+		reg108 |=  0x50;
+		reg109 &= ~0x02;
+		break;
+	default:
+		reg108 |=  0x10;
+		reg109 &= ~0x02;
+		break; //default to single ended case
+	}
+	switch (device->pll1Settings->vcxoBufferCtrl) {
+	case DISABLED:
+		reg108 &= ~0x03;
+		reg108 |=  0x04;
+		break; //power down VCXO input
+	case SINGLE_ENDED:
+		reg108 &= ~0x07;
+		break; //Clear VCXO receiver power down, defaults to Single ended mode
+	case NEG_SINGLE_ENDED:
+		reg108 &= ~0x07;
+		reg108 |=  0x02;
+		break; //Clear VCXO power down, enable Negative single ended mode[1]
+	case DIFFERENTIAL:
+		reg108 &= ~0x07;
+		reg108 |=  0x01;
+		break; //Clear VCXO power down, enable differential input buffer[0]
+	default:
+		reg108 &= ~0x07;
+		break; //default to positive single ended case
+	}
+
+
+	AD9528_spiWriteByte(device, AD9528_ADDR_INPUT_RECEIVERS1,
+			    reg108); //Input receiver settings (single ended or differential clock inputs)
+	AD9528_spiWriteByte(device, AD9528_ADDR_INPUT_RECEIVERS2,
+			    reg109); //Input receiver settings
+	AD9528_spiWriteByte(device, AD9528_ADDR_INPUT_RECEIVERS3,
+			    0x0A); //Reference selection mode
+	AD9528_spiWriteByte(device, AD9528_ADDR_PLL1_FASTLOCK,
+			    0x00); //Disable Fast lock
+
+	/**********************************************************************
+	 * Configure PLL2
+	 **********************************************************************
+	 */
+	pll2_Bdiv = device->pll2Settings->totalNdiv / 4;
+	pll2_Adiv = device->pll2Settings->totalNdiv % 4;
+
+	if (pll2_Adiv > 3) {  //A div valid range (0 to 3)
+		return FAILURE;
+	}
+	if (pll2_Bdiv < 3 || pll2_Bdiv > 63) {
+		return FAILURE;
+	}
+	AD9528_spiWriteByte(device, AD9528_ADDR_PLL2_CHARGEPUMP,
+			    0xE6); //PLL2 Charge Pump[7:0]
+	AD9528_spiWriteByte(device, AD9528_ADDR_PLL2_N_DIV,
+			    ((pll2_Adiv & 0x3) << 6) | (pll2_Bdiv & 0x3F)); //PLL2 A and B divider
+	AD9528_spiWriteByte(device, AD9528_ADDR_PLL2_CTRL, 0x03); //PLL2 control
+	AD9528_spiWriteByte(device, AD9528_ADDR_PLL2_VCO_CTRL, 0x01); //Manual VCO CAL
+
+	if (device->pll2Settings->rfDivider < 3
+	    || device->pll2Settings->rfDivider > 5) {
+		return FAILURE;
+	}
+
+	AD9528_spiWriteByte(device, AD9528_ADDR_PLL2_VCO_DIV,
+			    device->pll2Settings->rfDivider); //VCO divider
+	AD9528_spiWriteByte(device, AD9528_ADDR_PLL2_LF_CTRL1,
+			    0x3A); //PLL2 Loop filter [7:0]
+	AD9528_spiWriteByte(device, AD9528_ADDR_PLL2_LF_CTRL2,
+			    0x00); //PLL2 Loop filter [8]
+	AD9528_spiWriteByte(device, AD9528_ADDR_PLL2_RDIV, 0x01); //R divider
+	AD9528_spiWriteByte(device, AD9528_ADDR_PLL2_REPLICA_CHDIV,
+			    (device->pll2Settings->totalNdiv / device->pll2Settings->rfDivider)
+			    -1 ); //Replica channel divider: Ndivider = rfDivider * R divider
+	AD9528_spiWriteByte(device, AD9528_ADDR_PLL2_REPLICA_DIV_PHASE,
+			    0x00); //Replica Channel Divider phase
+
+	/**********************************************************************
+	 * Configure Output Distribution
+	 **********************************************************************
+	 */
+	for (i=0; i<14; i=i+1) {
+		AD9528_spiWriteByte(device, AD9528_ADDR_CH_OUT0_CTRL1 + j,
+				    ((device->outputSettings->outSource[i] & 0x7) << 5) |
+				    (device->outputSettings->outAnalogDelay[i] & 0x1F));
+		AD9528_spiWriteByte(device, AD9528_ADDR_CH_OUT0_CTRL2 + j,
+				    ((device->outputSettings->outBufferCtrl[i] & 0x3) << 6) |
+				    (device->outputSettings->outDigitalDelay[i] & 0x3F));
+		AD9528_spiWriteByte(device, AD9528_ADDR_CH_OUT0_CHDIV + j,
+				    device->outputSettings->outChannelDiv[i]-1);
+		j = j+3;
+	}
+
+	AD9528_spiWriteByte(device, AD9528_ADDR_OUTPUT_SYNC, 0x00); //Sync outputs
+	AD9528_spiWriteByte(device, AD9528_ADDR_MASK_SYNC1, 0x00); //Mask SYNC[7:0]
+	AD9528_spiWriteByte(device, AD9528_ADDR_MASK_SYNC2, 0x00); //Mask SYNC[13:8]
+	AD9528_spiWriteByte(device, AD9528_ADDR_EN_OUTPUT_PATH_SEL1,
+			    0x00); //Bypass SYSREF resample [6:0], bit0:Enable VCXO to feed output distrubution
+	AD9528_spiWriteByte(device, AD9528_ADDR_EN_OUTPUT_PATH_SEL2,
+			    0x00); //Bypass SYSREF resample [13:7]
+
+	/**********************************************************************
+	 * Configure SYSREF operation
+	 **********************************************************************
+	 */
+	AD9528_spiWriteByte(device, AD9528_ADDR_SYSERF_DIV_LSB,
+			    device->sysrefSettings->sysrefDivide & 0xFF); //SYSREF divider [7:0]
+	AD9528_spiWriteByte(device, AD9528_ADDR_SYSERF_DIV_MSB,
+			    (device->sysrefSettings->sysrefDivide >> 8) & 0xFF); //SYSREF divider [7:0]
+
+	AD9528_spiWriteByte(device, AD9528_ADDR_SYSREF_CTRL3,
+			    ((device->sysrefSettings->sysrefRequestMethod & 0x1) << 7) |
+			    ((device->sysrefSettings->sysrefPinEdgeMode & 0x3) << 5) );
+
+	AD9528_spiWriteByte(device, AD9528_ADDR_SYSREF_CTRL4,
+			    ((device->sysrefSettings->sysrefSource & 0x03) << 6) |
+			    ((device->sysrefSettings->sysrefPatternMode & 0x3) << 4 ) |
+			    ((device->sysrefSettings->sysrefNshotMode & 0x7) << 1) );
+
+	if(device->sysrefSettings->sysrefPinBufferMode == DISABLED) {
+		AD9528_spiWriteByte(device, AD9528_ADDR_SYSREF_CTRL5,
+				    0x04); //power down input buffer for external SYSREF
+	} else if(device->sysrefSettings->sysrefPinBufferMode == SINGLE_ENDED) {
+		AD9528_spiWriteByte(device, AD9528_ADDR_SYSREF_CTRL5,
+				    0x00); //enable positive singled ended input
+	} else if(device->sysrefSettings->sysrefPinBufferMode == NEG_SINGLE_ENDED) {
+		AD9528_spiWriteByte(device, AD9528_ADDR_SYSREF_CTRL5,
+				    0x02); //enable negative singled ended input
+	} else if(device->sysrefSettings->sysrefPinBufferMode == DIFFERENTIAL) {
+		AD9528_spiWriteByte(device, AD9528_ADDR_SYSREF_CTRL5,
+				    0x01); //enable differential input buffer
+	} else {
+		AD9528_spiWriteByte(device, AD9528_ADDR_SYSREF_CTRL5,
+				    0x04); //power down input buffer for external SYSREF
+	}
+
+	/**********************************************************************
+	 * Power down control
+	 **********************************************************************
+	 */
+
+	if (device->pll1Settings->bypassPll1 > 0) {
+		AD9528_spiWriteByte(device, AD9528_ADDR_POWERDOWN_CTRL,
+				    0x14);// power up PLL2 and output distribution, power down PLL1
+	} else {
+		AD9528_spiWriteByte(device, AD9528_ADDR_POWERDOWN_CTRL,
+				    0x10);// power up PLL1, PLL2 and output distribution
+	}
+
+	AD9528_spiWriteByte(device, AD9528_ADDR_CH_POWERDOWN1,
+			    device->outputSettings->outPowerDown & 0xFF); //power down out[7:0]
+	AD9528_spiWriteByte(device, AD9528_ADDR_CH_POWERDOWN2,
+			    ((device->outputSettings->outPowerDown >> 8) & 0x3F)); //power down out[13:8]
+	AD9528_spiWriteByte(device, AD9528_ADDR_LDO_ENABLES1,
+			    0xFF); //LDO enable per output channel [7:0]
+	AD9528_spiWriteByte(device, AD9528_ADDR_LDO_ENABLES2,
+			    0xFF); //LDO enable per output channel [15:8]
+	AD9528_spiWriteByte(device, AD9528_ADDR_STATUS0_CTRL,
+			    0x07); //STATUS 0 outputs REFA present
+	AD9528_spiWriteByte(device, AD9528_ADDR_STATUS1_CTRL,
+			    0x01); //STATUS 1 outputs PLL1 and PLL2 locked
+	AD9528_spiWriteByte(device, AD9528_ADDR_STATUS_OE,
+			    0x0C);// Make Status0 and Status1 outputs after reset.
+
+	AD9528_spiWriteByte(device, AD9528_ADDR_IO_UPDATE,
+			    0x01); //IO update to make all these settings valid in the 9528
+
+	AD9528_setTimeout_ms(1000);
+
+	do {
+		AD9528_spiReadByte(device, AD9528_ADDR_STATUS_READBACK0, &reg508);
+		if(AD9528_hasTimeoutExpired() > 0) {
+			return FAILURE;
+		}
+	} while((reg508 & 0x26) != 0x26);
+
+	return SUCCESS;
+}
+
+
+/// Send a SPI message to request a SYSREF pulse or continuous SYSREF from the AD9528.
+/*******************************************************************************//**
+ * Requests a SYSREF from the AD9528.  It will use whatever settings for SYSREF
+ * that are current configured in the AD9528.  This could be a single pulse,
+ * multiple pulses, or continuous pulses.
+ * <B>Dependencies</B>
+ * - device->spiSettings
+ * - device->sysrefSettings->sysrefPatternMode
+ *
+ * \param device is structure pointer to AD9528 clock device structure
+ * \param enableSYSREF If NSHOT SYSREF mode, this parameter is ignored.  If PRBS/CONTINUOUS SYSREF mode, 1= enable SYSREF, 0= disable SYSREF.
+ *
+ * \return Returns enum ADI_ERR, 0=pass, >0 = fail
+ ***********************************************************************************/
+int32_t AD9528_requestSysref(ad9528Device_t *device, uint8_t enableSYSREF)
+{
+	uint8_t _enableSYSREF=0;
+
+	if (device->sysrefSettings->sysrefPatternMode == NSHOT || enableSYSREF > 0) {
+		_enableSYSREF = 1;
+	} else {
+		_enableSYSREF = 0;
+	}
+
+	AD9528_spiWriteField(device, AD9528_ADDR_SYSREF_CTRL4, _enableSYSREF, 0x01,
+			     0x00); //Set SPI SYSREF request bit
+	AD9528_spiWriteByte(device, AD9528_ADDR_IO_UPDATE,
+			    0x01); //IO update to make all these settings valid in the 9528
+
+	return SUCCESS;
+}
+
+/// Allow changing the 9528 SYSREF frequency and pattern mode(CONTINUOUS, PRBS vs NSHOT mode)
+/*******************************************************************************//**
+ * NOTE: this function will update the device structure with the parameter values passed
+ * into this function. The device->sysrefSettings->sysrefPatternMode, device->sysrefSettings->sysrefNshotMode,
+ * and device->sysrefSettings->sysrefDivide values will be updated in the device structure.
+ *
+ * <B>Dependencies</B>
+ * - device->spiSettings
+ *
+ * \param device is structure pointer to AD9528 clock device structure
+ * \param divideFromPll1Out Sets the SYSREF pulse frequency. SYSREF frequency = PLL1_VCXO frequency/divideFromPll1Out
+ * \param sysrefPatternMode Valid settings: NSHOT, CONTINUOUS, PRBS, STOP
+ * \param nShotPulses Valid settings: ONE_PULSE=0, TWO_PULSES=2, FOUR_PULSES=3, SIX_PULSES=4, EIGHT_PULSES=5
+ *
+ * \return Returns enum ADI_ERR, 0=pass, >0 = fail
+ ***********************************************************************************/
+int32_t AD9528_setupSYSREF(ad9528Device_t *device,
+			       uint16_t divideFromPll1Out,  sysrefPatternMode_t sysrefPatternMode,
+			       sysrefNshotMode_t nShotPulses)
+{
+	uint8_t reg403=0;
+
+	device->sysrefSettings->sysrefPatternMode = sysrefPatternMode;
+	device->sysrefSettings->sysrefNshotMode = nShotPulses;
+	device->sysrefSettings->sysrefDivide = divideFromPll1Out >>
+					       1;  //SYSREF frequency is (PLL1)VCXO frequency / 2 / device->sysrefSettings->sysrefDivide
+
+	AD9528_spiReadByte(device, AD9528_ADDR_SYSREF_CTRL4, &reg403);
+
+	reg403 = reg403 & ~0x01; //clear bit 0 to stop a continuous sysref if it is on.
+	AD9528_spiWriteByte(device, AD9528_ADDR_SYSREF_CTRL4, reg403);
+
+	reg403 = reg403 & ~0x3E; //clear bits for pattern mode and Nshot mode bitfields
+	reg403 = reg403 | ((sysrefPatternMode & 0x3) << 4) | ((nShotPulses & 0x7) << 1);
+	AD9528_spiWriteByte(device, AD9528_ADDR_SYSREF_CTRL4,
+			    reg403); //update internal sysref pattern mode and Nshot mode (number of pulses)
+
+	//SYSREF request bit x403[0] is left 0.  The next call to AD9528_requestSysref will start the SYSREF
+	AD9528_spiWriteByte(device, AD9528_ADDR_IO_UPDATE,
+			    0x01); //IO update to make all these settings valid in the 9528
+
+
+	return SUCCESS;
+}
+
+int32_t AD9528_sysrefReq(ad9528Device_t *device,
+			     ad9528SysrefReqMode_t mode)
+{
+	if (mode == SYSREF_CONT_ON)
+		gpio_direction_output(device->gpio_sysref_req, 1);
+	else if (mode == SYSREF_CONT_OFF)
+		gpio_direction_output(device->gpio_sysref_req, 0);
+	else if (mode == SYSREF_PULSE) {
+		gpio_direction_output(device->gpio_sysref_req, 1);
+		mdelay(1);
+		gpio_direction_output(device->gpio_sysref_req, 0);
+	} else
+		return FAILURE;
+
+	return SUCCESS;
+}
+
+/**
+ * \brief Free the allocated resources
+ */
+int32_t AD9528_remove(ad9528Device_t *device)
+{
+	int32_t status;
+
+	status = gpio_remove(device->gpio_resetb);
+	status |= gpio_remove(device->gpio_sysref_req);
+	status |= spi_remove(device->spi_desc);
+
+	return SUCCESS;
+}

df_datalink_sp/src/drivers/frequency/ad9528/ad9528.h

@@ -0,0 +1,245 @@
+/**
+ * \file ad9528.h
+ * \brief Contains function declarations and ad9528Device_t structure typedef for ad9528.c
+ */
+
+/**
+* \page Disclaimer Legal Disclaimer
+* Copyright 2015-2017 Analog Devices Inc.
+* Released under the AD9371 API license.
+*
+*/
+
+#ifndef _AD9528_H_
+#define _AD9528_H_
+
+/******************************************************************************/
+/***************************** Include Files **********************************/
+/******************************************************************************/
+#include <stdint.h>
+#include "delay.h"
+#include "spi.h"
+#include "gpio.h"
+
+/******************************************************************************/
+/********************** Macros and Constants Definitions **********************/
+/******************************************************************************/
+
+/* AD9528 SPI Address defines */
+#define AD9528_ADDR_ADI_SPI_CONFIG_A	0x000
+#define AD9528_ADDR_ADI_SPI_CONFIG_B	0x001
+#define AD9528_ADDR_IO_UPDATE		 	0x00F
+
+#define AD9528_ADDR_REF_A_DIVIDER_LSB	0x100
+#define AD9528_ADDR_REF_A_DIVIDER_MSB	0x101
+#define AD9528_ADDR_REF_B_DIVIDER_LSB	0x102
+#define AD9528_ADDR_REF_B_DIVIDER_MSB	0x103
+#define AD9528_ADDR_PLL1_N_DIV_LSB		0x104
+#define AD9528_ADDR_PLL1_N_DIV_MSB		0x105
+#define AD9528_ADDR_PLL1_CHARGEPUMP		0x106
+#define AD9528_ADDR_PLL1_CP_CTRL2		0x107
+#define AD9528_ADDR_INPUT_RECEIVERS1	0x108
+#define AD9528_ADDR_INPUT_RECEIVERS2	0x109
+#define AD9528_ADDR_INPUT_RECEIVERS3	0x10A
+#define AD9528_ADDR_PLL1_FASTLOCK		0x10B
+
+#define AD9528_ADDR_PLL2_CHARGEPUMP		0x200
+#define AD9528_ADDR_PLL2_N_DIV			0x201
+#define AD9528_ADDR_PLL2_CTRL			0x202
+#define AD9528_ADDR_PLL2_VCO_CTRL		0x203
+#define AD9528_ADDR_PLL2_VCO_DIV		0x204
+#define AD9528_ADDR_PLL2_LF_CTRL1		0x205
+#define AD9528_ADDR_PLL2_LF_CTRL2		0x206
+#define AD9528_ADDR_PLL2_RDIV			0x207
+#define AD9528_ADDR_PLL2_REPLICA_CHDIV	0x208
+#define AD9528_ADDR_PLL2_REPLICA_DIV_PHASE	0x209
+
+#define AD9528_ADDR_CH_OUT0_CTRL1		0x300
+#define AD9528_ADDR_CH_OUT0_CTRL2		0x301
+#define AD9528_ADDR_CH_OUT0_CHDIV		0x302
+#define AD9528_ADDR_OUTPUT_SYNC			0x32A
+#define AD9528_ADDR_MASK_SYNC1			0x32B
+#define AD9528_ADDR_MASK_SYNC2			0x32C
+#define AD9528_ADDR_EN_OUTPUT_PATH_SEL1	0x32D
+#define AD9528_ADDR_EN_OUTPUT_PATH_SEL2 0x32E
+
+#define AD9528_ADDR_SYSERF_DIV_LSB		0x400
+#define AD9528_ADDR_SYSERF_DIV_MSB		0x401
+#define AD9528_ADDR_SYSREF_CTRL3		0x402
+#define AD9528_ADDR_SYSREF_CTRL4		0x403
+#define AD9528_ADDR_SYSREF_CTRL5		0x404
+
+#define AD9528_ADDR_POWERDOWN_CTRL		0x500
+#define AD9528_ADDR_CH_POWERDOWN1		0x501
+#define AD9528_ADDR_CH_POWERDOWN2		0x502
+#define AD9528_ADDR_LDO_ENABLES1		0x503
+#define AD9528_ADDR_LDO_ENABLES2		0x504
+#define AD9528_ADDR_STATUS0_CTRL		0x505
+#define AD9528_ADDR_STATUS1_CTRL		0x506
+#define AD9528_ADDR_STATUS_OE			0x507
+#define AD9528_ADDR_STATUS_READBACK0	0x508
+#define AD9528_ADDR_STATUS_READBACK1	0x509
+
+/******************************************************************************/
+/*************************** Types Declarations *******************************/
+/******************************************************************************/
+
+///Enum to select what source outputs from each AD9528 output channel
+typedef enum {
+	AD9528_CHANNEL_DIV = 0, PLL1_OUTPUT = 1, //VCXO frequency
+	SYSREF = 2,
+	INV_PLL1_OUTPUT = 5 //VCXO inverted
+} ad9528outSourceSel_t;
+
+///Enum to select what output buffer standard is used for the clock outputs
+typedef enum {
+	AD9528_LVDS = 0, AD9528_LVDS_BOOST = 1, AD9528_HSTL = 2
+} ad9528outBufferControl_t;
+
+///Enum to select the clock input buffer mode.
+typedef enum {
+	DISABLED = 0, SINGLE_ENDED, NEG_SINGLE_ENDED, DIFFERENTIAL
+} ad9528RefBuffer_t;
+
+/// Structure to hold AD9528 PLL1 settings
+typedef struct {
+	uint32_t refA_Frequency_Hz;
+	uint16_t refA_Divider;
+	ad9528RefBuffer_t refA_bufferCtrl;
+
+	uint32_t refB_Frequency_Hz;
+	uint16_t refB_Divider;
+	ad9528RefBuffer_t refB_bufferCtrl;
+
+	uint32_t vcxo_Frequency_Hz;
+	ad9528RefBuffer_t vcxoBufferCtrl;
+
+	uint16_t nDivider;
+	uint8_t bypassPll1;
+} ad9528pll1Settings_t;
+
+/// Structure to hold AD9528 PLL2 settings
+typedef struct {
+	uint8_t rfDivider; //VCO divider: Valid range (3,4,5)
+	uint8_t n2Divider; //PLL2 N2 Divider
+	uint8_t totalNdiv; //NDiv = 4*Bdiv + Adiv //Bdiv valid range (3 to 63), Adiv valid range (0-3)
+} ad9528pll2Settings_t;
+
+/// Structure to hold AD9528 Output Clock settings
+typedef struct {
+	uint16_t outPowerDown; //bit per output, if 1 power down that output.
+	ad9528outSourceSel_t
+	outSource[14]; //CHANNEL_DIV, PLL1_OUTPUT, SYSREF, INV_PLL1_OUTPUT
+	ad9528outBufferControl_t outBufferCtrl[14]; //LVDS, LVDS_BOOST, HSTL
+	uint8_t outAnalogDelay[14]; //5 bits
+	uint8_t outDigitalDelay[14]; //6 bits, 1/2 clock resolution @ channel div input frequency
+	uint8_t outChannelDiv[14]; //8 bit channel divider
+	uint32_t outFrequency_Hz[14]; //output clock frequency per clock output
+} ad9528outputSettings_t;
+
+///Enum to select the SYSREF output source
+typedef enum {
+	EXTERNAL = 0, EXT_RESAMPLED = 1, INTERNAL = 2
+} sysrefSourceSelection_t;
+
+///Enum to choose the SYSREF pattern mode.
+typedef enum {
+	NSHOT = 0, CONTINUOUS = 1, PRBS = 2, STOP = 3
+} sysrefPatternMode_t;
+
+///Enum to select the SYSREF input pin mode.
+typedef enum {
+	LEVEL_ACTIVE_HIGH = 0, LEVEL_ACTIVE_LOW = 1, RISING_EDGE = 2, FALLING_EDGE = 3
+} sysrefPinEdgeMode_t;
+
+///Enum to select the SYSREF output # of pulses for NSHOT mode.
+typedef enum {
+	ONE_PULSE = 0, TWO_PULSES = 2, FOUR_PULSES = 3, SIX_PULSES = 4, EIGHT_PULSES = 5
+} sysrefNshotMode_t;
+
+//Enum to select how a SYSREF is requested.
+typedef enum {
+	SPI = 0, PIN = 1
+} sysrefRequestMethod_t;
+
+/// Structure to hold AD9528 SYSREF output settings
+typedef struct {
+	sysrefRequestMethod_t sysrefRequestMethod;
+	sysrefSourceSelection_t sysrefSource;
+	sysrefPinEdgeMode_t sysrefPinEdgeMode;
+	ad9528RefBuffer_t sysrefPinBufferMode;
+	sysrefPatternMode_t sysrefPatternMode;
+	sysrefNshotMode_t sysrefNshotMode;
+	uint16_t sysrefDivide;
+
+} ad9528sysrefSettings_t;
+
+/// Structure to hold AD9528 SPI settings
+typedef struct {
+	uint8_t chipSelectIndex;		///< valid 1~8
+	uint8_t writeBitPolarity;		///< the level of the write bit of a SPI write instruction word, value is inverted for SPI read operation
+	uint8_t longInstructionWord;	///< 1 = 16bit instruction word, 0 = 8bit instruction word
+	uint8_t MSBFirst;				///< 1 = MSBFirst, 0 = LSBFirst
+	uint8_t CPHA;					///< clock phase, sets which clock edge the data updates (valid 0 or 1)
+	uint8_t CPOL;					///< clock polarity 0 = clock starts low, 1 = clock starts high
+	uint8_t enSpiStreaming;			///< Not implemented. SW feature to improve SPI throughput.
+	uint8_t autoIncAddrUp;			///< Not implemented. For SPI Streaming, set address increment direction. 1= next addr = addr+1, 0:addr = addr-1
+	uint8_t fourWireMode;			///< 1: Use 4-wire SPI, 0: 3-wire SPI (SDIO pin is bidirectional). NOTE: ADI's FPGA platform always uses 4-wire mode.
+	uint32_t spiClkFreq_Hz;			///< SPI Clk frequency in Hz (default 25000000), platform will use next lowest frequency that it's baud rate generator can create */
+} ad9528spiSettings_t;
+
+/// Structure to hold AD9528 settings
+typedef struct {
+	struct gpio_desc *gpio_resetb;
+	struct gpio_desc *gpio_sysref_req;
+	struct spi_desc *spi_desc;
+	ad9528spiSettings_t *spiSettings;
+	ad9528pll1Settings_t *pll1Settings;
+	ad9528pll2Settings_t *pll2Settings;
+	ad9528outputSettings_t *outputSettings;
+	ad9528sysrefSettings_t *sysrefSettings;
+} ad9528Device_t;
+
+typedef struct {
+	struct gpio_init_param *gpio_init_resetb;
+	struct gpio_init_param *gpio_init_sysref_req;
+	struct spi_init_param *spi_init;
+	ad9528spiSettings_t *spiSettings;
+	ad9528pll1Settings_t *pll1Settings;
+	ad9528pll2Settings_t *pll2Settings;
+	ad9528outputSettings_t *outputSettings;
+	ad9528sysrefSettings_t *sysrefSettings;
+} ad9528Init_t;
+
+typedef enum {
+	SYSREF_CONT_ON,
+	SYSREF_CONT_OFF,
+	SYSREF_PULSE,
+} ad9528SysrefReqMode_t;
+
+/******************************************************************************/
+/************************ Functions Declarations ******************************/
+/******************************************************************************/
+
+//Helper function to setup the 9528 device data structure specifically for the ADI transceiver evaluation cards
+int32_t AD9528_initDeviceDataStruct(ad9528Device_t *device,
+					uint32_t vcxoFrequency_Hz, uint32_t refAFrequency_Hz,
+					uint32_t outputDeviceClock_Hz);
+int32_t AD9528_spiReadByte(ad9528Device_t *device, uint16_t addr,
+				uint8_t *readdata);
+
+//AD9528 API functions
+int32_t AD9528_hasTimeoutExpired();
+int32_t AD9528_resetDevice(ad9528Device_t *device);
+int32_t AD9528_init(ad9528Device_t **device, const ad9528Init_t *init_device);
+int32_t AD9528_config(ad9528Device_t
+			      *device); //writes all registers to desired values, leaves clock outputs off.
+int32_t AD9528_setupSYSREF(ad9528Device_t *device,
+			       uint16_t divideFromPll1Out,  sysrefPatternMode_t sysrefPatternMode,
+			       sysrefNshotMode_t nShotPulses);
+int32_t AD9528_requestSysref(ad9528Device_t *device, uint8_t enableSYSREF);
+int32_t AD9528_sysrefReq(ad9528Device_t *device,
+			     ad9528SysrefReqMode_t mode);
+int32_t AD9528_remove(ad9528Device_t *device);
+
+#endif

df_datalink_sp/src/drivers/frequency/hmc7044/hmc7044.h

@@ -75,10 +75,10 @@ typedef enum
 // 0x0148, 0x0152)
 typedef enum
 {
-    CML = 0,
+    HMC7044_CML = 0,
-	LVPECL = 1,
+	HMC7044_LVPECL = 1,
-	LVDS = 2,
+	HMC7044_LVDS = 2,
-	CMOS = 3
+	HMC7044_CMOS = 3
 } hmc7044DriverMode_t;
 
 // Enum to select the GPIx functionality. (0x0046, 0x0047, 0x0048, 0x0049)
@@ -154,7 +154,7 @@ typedef enum
 // 0x0101, 0x010B, 0x0115, 0x011F, 0x0129, 0x0133, 0x013D, 0x0147, 0x0151
 typedef enum
 {
-    CHANNEL_DIV = 0,
+    HMC7044_CHANNEL_DIV = 0,
 	ANALOG_DELAY = 1,
 	OTHER_CHANNEL = 2,
 	VCO_CLOCK = 3

df_datalink_sp/src/hwconfig.c

@@ -34,9 +34,9 @@
 
 /************************** Function Prototypes ******************************/
 /*********************** Driver Instance Definitions **************************/
-static struct hmc7044_dev *hmc7044_inst;
+ad9528Device_t *ad9528_inst = NULL;
-static struct ad9361_reg_dev *ad9361_1_reg_inst;
+static struct ad9361_reg_dev *ad9361_1_reg_inst = NULL;
-static struct ad9361_reg_dev *ad9361_2_reg_inst;
+static struct ad9361_reg_dev *ad9361_2_reg_inst = NULL;
 // static struct ad9361_rf_phy *ad9361_phy;
 // static struct ad9361_rf_phy *ad9361_2_phy;
 
@@ -62,12 +62,17 @@ int32_t Hardware_Init(void)
 	}
 
 	/**********************************************************/
-	/****************** HMC7044 Configuration *****************/
+	/****************** AD9528 Configuration ******************/
 	/**********************************************************/
-	Status = hmc7044_init(&hmc7044_inst, &hmc7044_default_init_param);
+	Status = AD9528_init(&ad9528_inst, &ad9528_default_init_param);
-	if (Status != SUCCESS)
+	if (Status != SUCCESS) {
-	{
+		DBG_ERROR("AD9528_init() error: %" PRId32 "\n", Status);
-		DBG_ERROR("hmc7044_init() error: %" PRId32 "\n", Status);
+		return FAILURE;
+	}
+
+	Status = AD9528_config(ad9528_inst);
+	if (Status != SUCCESS) {
+		DBG_ERROR("AD9528_config() error: %" PRId32 "\n", Status);
 		return FAILURE;
 	}
 
@@ -110,285 +115,16 @@ int32_t Hardware_Init(void)
 	//	Status = ad9361_reg_read(ad9361_1_reg_inst, 0x0002, &rd_back);
 	//	Status = ad9361_reg_read(ad9361_2_reg_inst, 0x0002, &rd_back);
 
-	/**********************************************************/
+	Status = ad9361_reg_write(ad9361_1_reg_inst, 0x0109, 0x00); // Rx Gain
-	/******* AD9361 Baseband Multichip Synchronization ********/
+	Status = ad9361_reg_write(ad9361_1_reg_inst, 0x010C, 0x00); // Rx Gain
-	/**********************************************************/
+	Status = ad9361_reg_write(ad9361_2_reg_inst, 0x0109, 0x00); // Rx Gain
-	XGpioPs_SetDirectionPin(&Gpio, AD9361_SYNC, AD9361_GPIO_OUTPUT);
+	Status = ad9361_reg_write(ad9361_2_reg_inst, 0x010C, 0x00); // Rx Gain
-	XGpioPs_SetDirectionPin(&Gpio, AD9361_RX_FIFO_RST, AD9361_GPIO_OUTPUT);
-
-	// SYNC BBPLL and DIGITAL SAMPLING CLOCKS
-	ad9361_reg_write(ad9361_1_reg_inst, 0x0001, 0x0D); // MCS RF Enable; MCS BBPLL Enable; MCS BB Enable
-	ad9361_reg_write(ad9361_2_reg_inst, 0x0001, 0x0D);
-	ad9361_reg_write(ad9361_1_reg_inst, 0x0047, 0x80); // MCS refclk Scale Enable
-	ad9361_reg_write(ad9361_2_reg_inst, 0x0047, 0x80);
-	XGpioPs_WritePin(&Gpio, AD9361_SYNC, 0);
-	mdelay(20);
-	XGpioPs_WritePin(&Gpio, AD9361_SYNC, 1); // Input a rising-edge pulse to the SYNC_IN pin
-	mdelay(500);
-	XGpioPs_WritePin(&Gpio, AD9361_SYNC, 0);
-	mdelay(2000);
-	ad9361_reg_write(ad9361_1_reg_inst, 0x0001, 0x0B); // MCS RF Enable; MCS Digital CLK Enable ; MCS BB Enable
-	ad9361_reg_write(ad9361_2_reg_inst, 0x0001, 0x0B);
-	XGpioPs_WritePin(&Gpio, AD9361_SYNC, 1); // Input another rising-edge pulse to the SYNC_IN pin
-	mdelay(500);
-	XGpioPs_WritePin(&Gpio, AD9361_SYNC, 0);
-	ad9361_reg_write(ad9361_1_reg_inst, 0x0001, 0x08); // clear MCS bits
-	ad9361_reg_write(ad9361_2_reg_inst, 0x0001, 0x08);
-
-	XGpioPs_WritePin(&Gpio, AD9361_RX_FIFO_RST, 0);
-	mdelay(20);
-	XGpioPs_WritePin(&Gpio, AD9361_RX_FIFO_RST, 1);
-	mdelay(20);
-	XGpioPs_WritePin(&Gpio, AD9361_RX_FIFO_RST, 0);
-
-	/**********************************************************/
-	/********* AD9361 Multichip Rx Phase Calibration **********/
-	/**********************************************************/
-	XGpioPs_SetDirectionPin(&Gpio, AD9361_TX_SWITCH, AD9361_GPIO_OUTPUT);
-	XGpioPs_SetDirectionPin(&Gpio, AD9361_1_CAL_START, AD9361_GPIO_OUTPUT);
-	XGpioPs_SetDirectionPin(&Gpio, AD9361_1_CAL_DONE, AD9361_GPIO_INPUT);
-	XGpioPs_SetDirectionPin(&Gpio, AD9361_2_CAL_START, AD9361_GPIO_OUTPUT);
-	XGpioPs_SetDirectionPin(&Gpio, AD9361_2_CAL_DONE, AD9361_GPIO_INPUT);
-
-	// switch to lower frequency
-	Status = Hardware_SwitchFreq(ad9361_1_reg_inst, TX_FREQ_126);
-	XGpioPs_WritePin(&Gpio, AD9361_TX_SWITCH, 1);
-	mdelay(20);
-
-	// switch rx channel
-	Status = ad9361_reg_write(ad9361_1_reg_inst, 0x0004, 0x30);
-	Status = ad9361_reg_write(ad9361_2_reg_inst, 0x0004, 0x30);
-
-	// enable dual ad9361 tx channels
-	Status = ad9361_reg_write(ad9361_1_reg_inst, 0x0002, 0xE4); // Setup Tx Digital Filters/ Channels
-
-	// switch ad9361 tx channel
-	Status = ad9361_reg_write(ad9361_1_reg_inst, 0x0004, 0x70); // Select Rx input pin(A,B,C)/ Tx out pin (A,B)
-	mdelay(20);
-
-	// begin to calibrate the 1st ad9361
-	XGpioPs_WritePin(&Gpio, AD9361_1_CAL_START, 0);
-	XGpioPs_WritePin(&Gpio, AD9361_1_CAL_START, 1);
-	mdelay(1);
-	XGpioPs_WritePin(&Gpio, AD9361_1_CAL_START, 0);
-
-	// read calibration status
-	int32_t time_out_cnt = 0;
-	do
-	{
-		mdelay(1); // Wait 1ms
-		time_out_cnt++;
-	} while (((XGpioPs_ReadPin(&Gpio, AD9361_1_CAL_DONE) == 0) && time_out_cnt <= AD9361_TIMEOUT_TH));
-
-	if (time_out_cnt == AD9361_TIMEOUT_TH)
-	{
-		return FAILURE;
-	}
-
-	// begin to calibrate the 2nd ad9361
-	XGpioPs_WritePin(&Gpio, AD9361_2_CAL_START, 1);
-	mdelay(1);
-	XGpioPs_WritePin(&Gpio, AD9361_2_CAL_START, 0);
-
-	// read calibration status
-	time_out_cnt = 0;
-	do
-	{
-		mdelay(1); // Wait 1ms
-		time_out_cnt++;
-	} while (((XGpioPs_ReadPin(&Gpio, AD9361_2_CAL_DONE) == 0) && time_out_cnt <= AD9361_TIMEOUT_TH));
-
-	if (time_out_cnt == AD9361_TIMEOUT_TH)
-	{
-		return FAILURE;
-	}
-
-	// enable single ad9361 tx channels
-	Status = ad9361_reg_write(ad9361_1_reg_inst, 0x0002, 0xA4); // Setup Tx Digital Filters/ Channels
-
-	// switch ad9361 tx & rx channel
-	Status = ad9361_reg_write(ad9361_1_reg_inst, 0x0004, 0x03);
-	Status = ad9361_reg_write(ad9361_2_reg_inst, 0x0004, 0x03);
-
-	// switch to higher frequency
-	Status = Hardware_SwitchFreq(ad9361_1_reg_inst, TX_FREQ_4125);
-	XGpioPs_WritePin(&Gpio, AD9361_TX_SWITCH, 0);
 
 	DBG_PRINT("Done.\n");
 
 	return SUCCESS;
 }
 
-/*****************************************************************************/
-/**
- * @brief   Hardware_SwitchFreq
- *
- * @param   devSysMonitor_UpdateHardwareStatus(newHwState);
- * @param   freq
- *
- * @return  None.
- *
- ******************************************************************************/
-int32_t Hardware_SwitchFreq(struct ad9361_reg_dev *dev, ad9361TxFreq freq)
-{
-	int32_t status = 0;
-	uint8_t value = 0;
-	int32_t time_out_cnt = 0;
-
-	switch (freq)
-	{
-	case TX_FREQ_125:
-	{
-		//************************************************************
-		// Setup Tx Frequency-Dependent Syntheisizer Registers
-		//************************************************************
-		status = ad9361_reg_write(dev, 0x027A, 0x4A); // Set VCO Output level[3:0]
-		status = ad9361_reg_write(dev, 0x0279, 0xC1); // Set Init ALC Value[3:0] and VCO Varactor[3:0]
-		status = ad9361_reg_write(dev, 0x0282, 0x0E); // Set VCO Bias Tcf[1:0] and VCO Bias Ref[2:0]
-		status = ad9361_reg_write(dev, 0x0278, 0x78); // Set VCO Cal Offset[3:0]
-		status = ad9361_reg_write(dev, 0x0285, 0x00); // Set VCO Cal Ref Tcf[2:0]
-		status = ad9361_reg_write(dev, 0x0291, 0x0B); // Set VCO Varactor Reference[3:0]
-		status = ad9361_reg_write(dev, 0x0290, 0x70); // Set VCO Varactor Ref Tcf[2:0] and VCO Varactor Offset[3:0]
-		status = ad9361_reg_write(dev, 0x027B, 0x94); // Set Synth Loop Filter charge pump current (Icp)
-		status = ad9361_reg_write(dev, 0x027E, 0xF4); // Set Synth Loop Filter C2 and C1
-		status = ad9361_reg_write(dev, 0x027F, 0xDF); // Set Synth Loop Filter  R1 and C3
-		status = ad9361_reg_write(dev, 0x0280, 0x0A); // Set Synth Loop Filter R3
-
-		//************************************************************
-		// Write Tx Frequency Words
-		//************************************************************
-		status = ad9361_reg_write(dev, 0x0273, 0x00); // Write Tx Synth Fractional Freq Word[7:0]
-		status = ad9361_reg_write(dev, 0x0274, 0x00); // Write Tx Synth Fractional Freq Word[15:8]
-		status = ad9361_reg_write(dev, 0x0275, 0x00); // Write Tx Synth Fractional Freq Word[22:16]
-		status = ad9361_reg_write(dev, 0x0272, 0x00); // Write Tx Synth Integer Freq Word[10:8]
-		status = ad9361_reg_write(dev, 0x0271, 0xA0); // Write Tx Synth Integer Freq Word[7:0] (starts VCO cal)
-		status = ad9361_reg_write(dev, 0x0005, 0x57); // Set LO divider setting
-
-		//************************************************************
-		// Tx Quadrature Calibration Settings
-		//************************************************************
-		status = ad9361_reg_write(dev, 0x00A0, 0x75); // Set TxQuadcal NCO frequency
-		status = ad9361_reg_write(dev, 0x00A3, 0xC0); // Set TxQuadcal NCO frequency (Only update bits [7:6])
-		status = ad9361_reg_write(dev, 0x00A1, 0x7B); // Tx Quad Cal Configuration, Phase and Gain Cal Enable
-		status = ad9361_reg_write(dev, 0x00A9, 0xFF); // Set Tx Quad Cal Count
-		status = ad9361_reg_write(dev, 0x00A2, 0x7F); // Set Tx Quad Cal Kexp
-		status = ad9361_reg_write(dev, 0x00A5, 0x01); // Set Tx Quad Cal Magnitude Threshhold
-		status = ad9361_reg_write(dev, 0x00A6, 0x01); // Set Tx Quad Cal Magnitude Threshhold
-		status = ad9361_reg_write(dev, 0x00AA, 0x22); // Set Tx Quad Cal Gain Table index
-		status = ad9361_reg_write(dev, 0x00A4, 0xF0); // Set Tx Quad Cal Settle Count
-		status = ad9361_reg_write(dev, 0x00AE, 0x00); // Set Tx Quad Cal LPF Gain index incase Split table mode used
-
-		status = ad9361_reg_write(dev, 0x0169, 0xC0); // Disable Rx Quadrature Calibration before Running Tx Quadrature Calibration
-		status = ad9361_reg_write(dev, 0x0016, 0x10); // Start Tx Quad cal
-
-		break;
-	}
-	case TX_FREQ_126:
-	{
-		//************************************************************
-		// Setup Tx Frequency-Dependent Syntheisizer Registers
-		//************************************************************
-		status = ad9361_reg_write(dev, 0x027A, 0x4A); // Set VCO Output level[3:0]
-		status = ad9361_reg_write(dev, 0x0279, 0xC1); // Set Init ALC Value[3:0] and VCO Varactor[3:0]
-		status = ad9361_reg_write(dev, 0x0282, 0x0E); // Set VCO Bias Tcf[1:0] and VCO Bias Ref[2:0]
-		status = ad9361_reg_write(dev, 0x0278, 0x78); // Set VCO Cal Offset[3:0]
-		status = ad9361_reg_write(dev, 0x0285, 0x00); // Set VCO Cal Ref Tcf[2:0]
-		status = ad9361_reg_write(dev, 0x0291, 0x0B); // Set VCO Varactor Reference[3:0]
-		status = ad9361_reg_write(dev, 0x0290, 0x70); // Set VCO Varactor Ref Tcf[2:0] and VCO Varactor Offset[3:0]
-		status = ad9361_reg_write(dev, 0x027B, 0x93); // Set Synth Loop Filter charge pump current (Icp)
-		status = ad9361_reg_write(dev, 0x027E, 0xF4); // Set Synth Loop Filter C2 and C1
-		status = ad9361_reg_write(dev, 0x027F, 0xDF); // Set Synth Loop Filter  R1 and C3
-		status = ad9361_reg_write(dev, 0x0280, 0x0A); // Set Synth Loop Filter R3
-
-		//************************************************************
-		// Write Tx Frequency Words
-		//************************************************************
-		status = ad9361_reg_write(dev, 0x0273, 0x06); // Write Tx Synth Fractional Freq Word[7:0]
-		status = ad9361_reg_write(dev, 0x0274, 0xD7); // Write Tx Synth Fractional Freq Word[15:8]
-		status = ad9361_reg_write(dev, 0x0275, 0x23); // Write Tx Synth Fractional Freq Word[22:16]
-		status = ad9361_reg_write(dev, 0x0272, 0x00); // Write Tx Synth Integer Freq Word[10:8]
-		status = ad9361_reg_write(dev, 0x0271, 0xA1); // Write Tx Synth Integer Freq Word[7:0] (starts VCO cal)
-		status = ad9361_reg_write(dev, 0x0005, 0x57); // Set LO divider setting
-
-		//************************************************************
-		// Tx Quadrature Calibration Settings
-		//************************************************************
-		status = ad9361_reg_write(dev, 0x00A0, 0x75); // Set TxQuadcal NCO frequency
-		status = ad9361_reg_write(dev, 0x00A3, 0xC0); // Set TxQuadcal NCO frequency (Only update bits [7:6])
-		status = ad9361_reg_write(dev, 0x00A1, 0x7B); // Tx Quad Cal Configuration, Phase and Gain Cal Enable
-		status = ad9361_reg_write(dev, 0x00A9, 0xFF); // Set Tx Quad Cal Count
-		status = ad9361_reg_write(dev, 0x00A2, 0x7F); // Set Tx Quad Cal Kexp
-		status = ad9361_reg_write(dev, 0x00A5, 0x01); // Set Tx Quad Cal Magnitude Threshhold
-		status = ad9361_reg_write(dev, 0x00A6, 0x01); // Set Tx Quad Cal Magnitude Threshhold
-		status = ad9361_reg_write(dev, 0x00AA, 0x22); // Set Tx Quad Cal Gain Table index
-		status = ad9361_reg_write(dev, 0x00A4, 0xF0); // Set Tx Quad Cal Settle Count
-		status = ad9361_reg_write(dev, 0x00AE, 0x00); // Set Tx Quad Cal LPF Gain index incase Split table mode used
-
-		status = ad9361_reg_write(dev, 0x0169, 0xC0); // Disable Rx Quadrature Calibration before Running Tx Quadrature Calibration
-		status = ad9361_reg_write(dev, 0x0016, 0x10); // Start Tx Quad cal
-
-		break;
-	}
-	case TX_FREQ_4125:
-	{
-		//************************************************************
-		// Setup Tx Frequency-Dependent Syntheisizer Registers
-		//************************************************************
-		status = ad9361_reg_write(dev, 0x027A, 0x4A); // Set VCO Output level[3:0]
-		status = ad9361_reg_write(dev, 0x0279, 0xC1); // Set Init ALC Value[3:0] and VCO Varactor[3:0]
-		status = ad9361_reg_write(dev, 0x0282, 0x0E); // Set VCO Bias Tcf[1:0] and VCO Bias Ref[2:0]
-		status = ad9361_reg_write(dev, 0x0278, 0x78); // Set VCO Cal Offset[3:0]
-		status = ad9361_reg_write(dev, 0x0285, 0x00); // Set VCO Cal Ref Tcf[2:0]
-		status = ad9361_reg_write(dev, 0x0291, 0x0B); // Set VCO Varactor Reference[3:0]
-		status = ad9361_reg_write(dev, 0x0290, 0x70); // Set VCO Varactor Ref Tcf[2:0] and VCO Varactor Offset[3:0]
-		status = ad9361_reg_write(dev, 0x027B, 0x93); // Set Synth Loop Filter charge pump current (Icp)
-		status = ad9361_reg_write(dev, 0x027E, 0xF4); // Set Synth Loop Filter C2 and C1
-		status = ad9361_reg_write(dev, 0x027F, 0xDF); // Set Synth Loop Filter  R1 and C3
-		status = ad9361_reg_write(dev, 0x0280, 0x0A); // Set Synth Loop Filter R3
-
-		//************************************************************
-		// Write Rx Frequency Words
-		//************************************************************
-		status = ad9361_reg_write(dev, 0x0273, 0x00); // Write Tx Synth Fractional Freq Word[7:0]
-		status = ad9361_reg_write(dev, 0x0274, 0x00); // Write Tx Synth Fractional Freq Word[15:8]
-		status = ad9361_reg_write(dev, 0x0275, 0x00); // Write Tx Synth Fractional Freq Word[22:16]
-		status = ad9361_reg_write(dev, 0x0272, 0x00); // Write Tx Synth Integer Freq Word[10:8]
-		status = ad9361_reg_write(dev, 0x0271, 0xA5); // Write Tx Synth Integer Freq Word[7:0] (starts VCO cal)
-		status = ad9361_reg_write(dev, 0x0005, 0x07); // Set LO divider setting
-
-		//************************************************************
-		// Tx Quadrature Calibration Settings
-		//************************************************************
-		status = ad9361_reg_write(dev, 0x00A0, 0x75); // Set TxQuadcal NCO frequency
-		status = ad9361_reg_write(dev, 0x00A3, 0xC0); // Set TxQuadcal NCO frequency (Only update bits [7:6])
-		status = ad9361_reg_write(dev, 0x00A1, 0x7B); // Tx Quad Cal Configuration, Phase and Gain Cal Enable
-		status = ad9361_reg_write(dev, 0x00A9, 0xFF); // Set Tx Quad Cal Count
-		status = ad9361_reg_write(dev, 0x00A2, 0x7F); // Set Tx Quad Cal Kexp
-		status = ad9361_reg_write(dev, 0x00A5, 0x01); // Set Tx Quad Cal Magnitude Threshhold
-		status = ad9361_reg_write(dev, 0x00A6, 0x01); // Set Tx Quad Cal Magnitude Threshhold
-		status = ad9361_reg_write(dev, 0x00AA, 0x28); // Set Tx Quad Cal Gain Table index
-		status = ad9361_reg_write(dev, 0x00A4, 0xF0); // Set Tx Quad Cal Settle Count
-		status = ad9361_reg_write(dev, 0x00AE, 0x04); // Set Tx Quad Cal LPF Gain index incase Split table mode used
-
-		status = ad9361_reg_write(dev, 0x0169, 0xC0); // Disable Rx Quadrature Calibration before Running Tx Quadrature Calibration
-		status = ad9361_reg_write(dev, 0x0016, 0x10); // Start Tx Quad cal
-
-		break;
-	}
-
-		// Wait for cal to complete (Done when 0x016[4]==0)
-		time_out_cnt = 0;
-		do
-		{
-			status |= ad9361_reg_read(dev, 0x0016, &value);
-			mdelay(1); // Wait 1ms
-			time_out_cnt++;
-		} while ((value & 0x10) != 0x00 && time_out_cnt <= AD9361_TIMEOUT_TH);
-	}
-
-	return status;
-}
-
 // @ Get AD9361 - 1 temperature (Celsius Degree)
 /**
  * Read corresponding register to get AD9361 - 1 current temperature.
@@ -396,12 +132,15 @@ int32_t Hardware_SwitchFreq(struct ad9361_reg_dev *dev, ad9361TxFreq freq)
 int8_t Hardware_GetAD9361Temp_1(void)
 {
 	int8_t scaleTemp;
+	double temp;
 
+	ad9361_reg_write(ad9361_1_reg_inst, 0x000B, -64);
 	ad9361_reg_write(ad9361_1_reg_inst, 0x001D, 0x01); // disable aux adc
 	ad9361_reg_read(ad9361_1_reg_inst, 0x000E, (uint8_t*)&scaleTemp);
 	ad9361_reg_write(ad9361_1_reg_inst, 0x001D, 0x00); // enable aux adc
 
-	return (int8_t) scaleTemp/1.16;
+	temp = ((double)scaleTemp + 64)/1.16;
+	return ((temp > INT8_MAX) ? INT8_MAX : (int8_t)temp);
 }
 
 // @ Get AD9361 - 2 temperature (Celsius Degree)
@@ -411,12 +150,14 @@ int8_t Hardware_GetAD9361Temp_1(void)
 int8_t Hardware_GetAD9361Temp_2(void)
 {
 	int8_t scaleTemp;
+	double temp;
 
+	ad9361_reg_write(ad9361_2_reg_inst, 0x000B, -64);
 	ad9361_reg_write(ad9361_2_reg_inst, 0x001D, 0x01); // disable aux adc
 	ad9361_reg_read(ad9361_2_reg_inst, 0x000E, (uint8_t*)&scaleTemp);
 	ad9361_reg_write(ad9361_2_reg_inst, 0x001D, 0x00); // enable aux adc
-
+	temp = ((double)scaleTemp + 64)/1.16;
-	return (int8_t) scaleTemp/1.16;
+	return ((temp > INT8_MAX) ? INT8_MAX : (int8_t)temp);
 }
 
 // @ Determine AD9361 lock state
@@ -443,22 +184,22 @@ uint8_t Hardware_GetAD9361LockStatus(void)
 	return ret;
 }
 
-// @ Determine HMC7044 lock state
+// @ Determine AD9528 lock state
 /**
  * Read corresponding register to determine clock lock state.
  */
-uint8_t Hardware_GetHMC7044LockStatus(void)
+uint8_t Hardware_GetAD9528LockStatus(void)
 {
 	uint8_t ret = 0;
 	uint8_t regVal;
 
 	// pll1
-	hmc7044_read(hmc7044_inst, 0x007C, &regVal); // [D5] is lock indicator
+	AD9528_spiReadByte(ad9528_inst, AD9528_ADDR_STATUS_READBACK0, &regVal); // [D0] is lock indicator
-	ret |= ((regVal & 0xE0) != 0x00) ? CLK_SP_PLL0_LOCK : 0;
+	ret |= ((regVal & 0x01) == 0x01) ? CLK_SP_PLL1_LOCK : 0;
 
 	// pll2
-	hmc7044_read(hmc7044_inst, 0x007D, &regVal); // [D0] is lock indicator
+	AD9528_spiReadByte(ad9528_inst, AD9528_ADDR_STATUS_READBACK0, &regVal); // [D1] is lock indicator
-	ret |= ((regVal & 0x01) == 0x01) ? CLK_SP_PLL1_LOCK : 0;
+	ret |= ((regVal & 0x02) == 0x02) ? CLK_SP_PLL2_LOCK : 0;
 
 	return ret;
 }

df_datalink_sp/src/hwconfig.h

@@ -13,7 +13,8 @@
  * Copyright(c) 2024 Beijing Institute of Technology.
  *
  ******************************************************************************/
-
+#ifndef HWCONFIG_H_
+#define HWCONFIG_H_
 /***************************** Include Files *********************************/
 // Standard
 #include <stdint.h>
@@ -23,10 +24,9 @@
 
 /************************** Function Prototypes ******************************/
 int32_t Hardware_Init(void);
-int32_t Hardware_SwitchFreq(struct ad9361_reg_dev *dev, ad9361TxFreq freq);
 int8_t Hardware_GetAD9361Temp_1(void);
 int8_t Hardware_GetAD9361Temp_2(void);
 uint8_t Hardware_GetAD9361LockStatus(void);
-uint8_t Hardware_GetHMC7044LockStatus(void);
+uint8_t Hardware_GetAD9528LockStatus(void);
-
 
+#endif // HWCONFIG_H_

df_datalink_sp/src/include/circ_queue.h

@@ -1,33 +1,25 @@
 /*****************************************************************************/
 /**
- * Description: A simple circular FIFO bounded queue
+ * @file circ_queue.h
+ * @author FanHao (hao_fan_bit_ee@163.com)
+ * @brief A simple circular FIFO bounded queue
+ * @version 0.1
+ * @date 2023-02-23
+ * @note Forked from https://github.com/chrismerck/rpa_queue.git
+ * @copyright Copyright(c) 2024 Beijing Institute of Technology.\n
+ * Lab of Communication and Network
  *
- * Author: Fan Hao
+ ******************************************************************************/
- * Date: 2023-02-23 10:29
+
- * LastEditors: Fan Hao
+/**
- * LastEditTime: 2023-02-23 12:53
+ * @addtogroup Utility
- * Revisions: Rev 0.0
+ * @{
- * History: 
+ */
- * [2023-02-23]: Initial Version.
+
- * 
+/**
- * Copyright(c) 2023 Beijing Institute of Technology.
+ * @defgroup CircularQueue
- * Lab of Communication and Networking
+ * @{
- * NOTE: Forked from https://github.com/chrismerck/rpa_queue.git
+ */
- * Licensed to the Apache Software Foundation (ASF) under one or more
- * contributor license agreements.  See the NOTICE file distributed with
- * this work for additional information regarding copyright ownership.
- * The ASF licenses this file to You under the Apache License, Version 2.0
- * (the "License"); you may not use this file except in compliance with
- * the License.  You may obtain a copy of the License at
- *
- *   http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
-******************************************************************************/
 
 #ifndef CIRC_QUEUE_H
 #define CIRC_QUEUE_H
@@ -36,76 +28,73 @@
 #include <stdint.h>
 #include <stddef.h>
 
-
 /**
- * opaque structure
+ * @struct CIRC_QUEUE
+ * @brief Circular queue Instance
  */
-typedef struct {
+typedef struct
+{
     void **data;
-  volatile uint32_t nelts; /**< # elements */
+    volatile uint32_t nelts; ///< number of elements
-  uint32_t in;  /**< next empty location */
+    uint32_t in;             ///< next empty location
-  uint32_t out;   /**< next filled location */
+    uint32_t out;            ///< next filled location
-  uint32_t bounds;/**< max size of queue */
+    uint32_t bounds;         ///< max size of queue
 } CIRC_QUEUE;
 
-
-
 /**
- * create a FIFO queue
+ * @brief create a FIFO queue
  * @param queue The new queue
  * @param queue_capacity maximum size of the queue
- * @param a pool to allocate queue from
  */
 bool CircQueueCreate(CIRC_QUEUE **queue, uint32_t queue_capacity);
 
-/** free queue memory -- call after destroy 
+/**
- * @note we do not free in destroy() to follow pthreads convention
+ * @brief free queue memory -- call after destroy
-*/
+ */
-void CircQueueFree(CIRC_QUEUE * queue);
+void CircQueueFree(CIRC_QUEUE *queue);
 
 /**
- * Detects when the CIRC_QUEUE is full. This utility function is expected
+ * @brief Detects when the CIRC_QUEUE is full. This utility function is expected
  * to be called from within critical sections, and is not threadsafe.
  */
 bool isCircQueueFull(CIRC_QUEUE *queue);
 
 /**
- * Detects when the CIRC_QUEUE is empty. This utility function is expected
+ * @brief Detects when the CIRC_QUEUE is empty. This utility function is expected
  * to be called from within critical sections, and is not threadsafe.
  */
 bool isCircQueueEmpty(CIRC_QUEUE *queue);
 
 /**
- * push/add an object to the queue, blocking if the queue is already full
+ * @brief push/add an object to the queue, blocking if the queue is already full
  *
  * @param queue the queue
  * @param data the data
- * @returns RPA_EINTR the blocking was interrupted (try again)
+ * @return True on a successful push
- * @returns RPA_EOF the queue has been terminated
+ * @return False push failed
- * @returns RPA_SUCCESS on a successful push
  */
 bool CircQueuePush(CIRC_QUEUE *queue, void *data);
 
-
 /**
- * pop/get an object from the queue, blocking if the queue is already empty
+ * @brief pop/get an object from the queue, blocking if the queue is already empty
  *
  * @param queue the queue
  * @param data the data
- * @returns RPA_EINTR the blocking was interrupted (try again)
+ * @return false pop failed
- * @returns RPA_EOF if the queue has been terminated
+ * @return true on a successful pop
- * @returns RPA_SUCCESS on a successful pop
  */
 bool CircQueuePop(CIRC_QUEUE *queue, void **data);
 
 /**
- * returns the size of the queue.
+ * @brief returns the size of the queue.
  *
- * @warning this is not threadsafe, and is intended for reporting/monitoring
- * of the queue.
  * @param queue the queue
- * @returns the size of the queue
+ * @return the size of the queue
  */
 uint32_t CircQueueSize(CIRC_QUEUE *queue);
 
 #endif /* CIRC_QUEUE_H */
+
+/** @} CircularQueue*/
+
+/** @} Utility*/

df_datalink_sp/src/include/clist.h

@@ -1,9 +1,25 @@
+/*****************************************************************************/
+/**
+ * @file clist.h
+ * @author FanHao (hao_fan_bit_ee@163.com)
+ * @brief A basic list data structure
+ * @version 0.1
+ * @date 2023-02-23
+ * @note Forked from https://github.com/clibs/list
+ * @copyright Copyright(c) 2024 Beijing Institute of Technology.\n
+ * Lab of Communication and Network
+ *
+ ******************************************************************************/
 
-//
+/**
-// clist.h
+ * @addtogroup Utility
-//
+ * @{
-// Copyright (c) 2010 TJ Holowaychuk <[email protected]>
+ */
-//
+
+/**
+ * @defgroup cList
+ * @{
+ */
 
 #ifndef __CLIST_H__
 #define __CLIST_H__
@@ -16,48 +32,48 @@ extern "C"
 #include <stdlib.h>
 #include <stdint.h>
 
-  /*
+	/**
-   * clist_t iterator direction.
+	 * @enum clist_direction_t
+	 * @brief clist_t iterator direction.
 	 */
-
 	typedef enum
 	{
 		LIST_HEAD,
 		LIST_TAIL
 	} clist_direction_t;
 
-  /*
+	/**
-   * clist_t node struct.
+	 * @struct clist_node_t
+	 * @brief clist_t node struct.
 	 */
-
 	typedef struct clist_node
 	{
-    struct clist_node *prev;
+		struct clist_node *prev; ///< previous node
-    struct clist_node *next;
+		struct clist_node *next; ///< next node
 		void *val;
 	} clist_node_t;
 
-  /*
+	/**
-   * clist_t struct.
+	 * @struct clist_t
+	 * @brief clist_t struct.
 	 */
-
 	typedef struct
 	{
-    clist_node_t *head;
+		clist_node_t *head;					 ///< first node
-    clist_node_t *tail;
+		clist_node_t *tail;					 ///< last node
-    uint32_t len;
+		uint32_t len;						 ///< list length
-    void (*free)(void *val);
+		void (*free)(void *val);			 ///< node free function handle
-    int8_t (*compare)(void *a, void *b);
+		int8_t (*compare)(void *a, void *b); ///< node compare function handle
 	} clist_t;
 
-  /*
+	/**
-   * clist_t iterator struct.
+	 * @struct clist_iterator_t
+	 * @brief clist_t iterator struct.
 	 */
-
 	typedef struct
 	{
-    clist_node_t *next;
+		clist_node_t *next;			 ///< next element
-    clist_direction_t direction;
+		clist_direction_t direction; ///< iter direction
 	} clist_iterator_t;
 
 	// Node prototypes.
@@ -116,3 +132,7 @@ extern "C"
 #endif
 
 #endif /* __CLIBS_LIST_H__ */
+
+/** @} cList*/
+
+/** @} Utility*/

df_datalink_sp/src/include/common.h

@@ -1,20 +1,19 @@
 /*****************************************************************************/
 /**
- * Description: Common definitions
+ * @file common.h
- *
+ * @author FanHao (hao_fan_bit_ee@163.com)
- * Date: 2023-12-21 16:32
+ * @brief Common macros
- * LastEditors: Fan Hao
+ * @version 0.0
- * LastEditTime: 2022-07-16 17:13
+ * @date 2022-07-16
- * Revisions: Rev 0.1
+ * @copyright Copyright(c) 2024 Beijing Institute of Technology.\n
- * History:
+ * Lab of Communication and Network
- * [2023-12-21]: Ensure the code conform ISO C11 standard.
- * [2022-07-16]: New branch for Dijian.
- * [2021-11-16]: Initial version.
- *
- * Copyright(c) 2021 Beijing Institute of Technology.
- * Lab of Communication and Networking
  *
  ******************************************************************************/
+/**
+ * @defgroup COMMON_MACRO
+ * @{
+ */
+
 /***************************** Include Files *********************************/
 #ifndef __COMMON_H_
 #define __COMMON_H_
@@ -90,3 +89,5 @@
 /************************** Function Prototypes ******************************/
 void AppAssert(const char *file, int line);
 #endif /* __COMMON_H_ */
+
+/** @} */

df_datalink_sp/src/include/error.h

@@ -1,19 +1,19 @@
 /*****************************************************************************/
 /**
- * Description: Error code definitions.
+ * @file common.h
+ * @author FanHao (hao_fan_bit_ee@163.com)
+ * @brief Common error numbers
+ * @version 0.0
+ * @date 2022-06-18
+ * @copyright Copyright(c) 2024 Beijing Institute of Technology.\n
+ * Lab of Communication and Network
  *
- * Author: Fan Hao
+ ******************************************************************************/
- * Date: 2022-06-18 16:37
+
- * LastEditors: Fan Hao
+/**
- * LastEditTime: 2022-06-18 17:12
+ * @addtogroup COMMON_MACRO
- * Revisions: Rev 0.0
+ * @{
- * History:
+ */
- * [2022-06-18]: Initial version.
- *
- * Copyright(c) 2022 Beijing Institute of Technology.
- * Lab of Communication and Networking
- *
-******************************************************************************/
 
 #ifndef SRC_ERROR_H_
 #define SRC_ERROR_H_
@@ -24,6 +24,11 @@
 /********************** Macros and Constants Definitions **********************/
 /******************************************************************************/
 
+/**
+ * @name ERRORNO
+ * @{
+ */
+
 #ifdef SUCCESS
 #undef SUCCESS
 #endif
@@ -45,3 +50,7 @@
 #define IS_ERR_VALUE(x)	((x) != SUCCESS)
 
 #endif // ERROR_H_
+
+/** @} ERRORNO*/
+
+/** @} COMMON_MACRO*/

df_datalink_sp/src/include/util.h

@@ -1,41 +1,21 @@
-/*******************************************************************************
+/*****************************************************************************/
+/**
  * @file util.h
- *   @brief  Implementation of utility functions.
+ * @author FanHao (hao_fan_bit_ee@163.com)
- *   @author DBogdan (dragos.bogdan@analog.com)
+ * @brief Utility functions header file
-********************************************************************************
+ * @version 0.0
- * Copyright 2018(c) Analog Devices, Inc.
+ * @date 2023-05-06
  *
- * All rights reserved.
+ * @copyright Copyright(c) 2024 Beijing Institute of Technology.\n
+ * Lab of Communication and Network
  *
- * Redistribution and use in source and binary forms, with or without
+ ******************************************************************************/
- * modification, are permitted provided that the following conditions are met:
+
- *  - Redistributions of source code must retain the above copyright
+/**
- *    notice, this list of conditions and the following disclaimer.
+ * @defgroup Utility
- *  - Redistributions in binary form must reproduce the above copyright
+ * @{
- *    notice, this list of conditions and the following disclaimer in
+ */
- *    the documentation and/or other materials provided with the
+
- *    distribution.
- *  - Neither the name of Analog Devices, Inc. nor the names of its
- *    contributors may be used to endorse or promote products derived
- *    from this software without specific prior written permission.
- *  - The use of this software may or may not infringe the patent rights
- *    of one or more patent holders.  This license does not release you
- *    from the requirement that you obtain separate licenses from these
- *    patent holders to use this software.
- *  - Use of the software either in source or binary form, must be run
- *    on or directly connected to an Analog Devices Inc. component.
- *
- * THIS SOFTWARE IS PROVIDED BY ANALOG DEVICES "AS IS" AND ANY EXPRESS OR
- * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, NON-INFRINGEMENT,
- * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
- * IN NO EVENT SHALL ANALOG DEVICES BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, INTELLECTUAL PROPERTY RIGHTS, PROCUREMENT OF SUBSTITUTE GOODS OR
- * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
- * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
- * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
- * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-*******************************************************************************/
 #ifndef __UTIL_H_
 #define __UTIL_H_
 
@@ -193,3 +173,5 @@ bool crc16_check(uint8_t *buffPtr, uint32_t dataLen, uint32_t crcOffset, uint16_
 int crc8_gen(uint8_t *buffPtr, uint32_t dataLen, uint16_t poly, uint8_t *crcVal);
 bool crc8_check(uint8_t *buffPtr, uint32_t dataLen, uint32_t crcOffset, uint16_t poly);
 #endif // __UTIL_H_
+
+/** @} */

df_datalink_sp/src/lscript.ld

@@ -23,9 +23,9 @@ _UNDEF_STACK_SIZE = DEFINED(_UNDEF_STACK_SIZE) ? _UNDEF_STACK_SIZE : 1024;
 
 MEMORY
 {
-   phy_data_interface_rx_frame_bram_ctrl_Mem0 : ORIGIN = 0x40000000, LENGTH = 0x2000
+   phy_data_interface_rx_frame_bram_ctrl_Mem0 : ORIGIN = 0x40000000, LENGTH = 0x1000
-   phy_data_interface_tx_frame_bram_ctrl_Mem0 : ORIGIN = 0x40002000, LENGTH = 0x2000
+   phy_data_interface_tx_frame_bram_ctrl_Mem0 : ORIGIN = 0x40002000, LENGTH = 0x1000
-   phy_data_interface_ant_info_bram_ctrl_Mem0 : ORIGIN = 0x40004000, LENGTH = 0x2000
+   phy_data_interface_ant_config_bram_ctrl_Mem0 : ORIGIN = 0x40004000, LENGTH = 0x2000
    phy_data_interface_ant_beam_bram_ctrl_Mem0 : ORIGIN = 0x42000000, LENGTH = 0x1000
    ps7_ddr_0 : ORIGIN = 0x100000, LENGTH = 0x1FF00000
    ps7_qspi_linear_0 : ORIGIN = 0xFC000000, LENGTH = 0x1000000

df_datalink_sp/src/main.c

@@ -10,7 +10,7 @@
  * History:
  * [2023-05-07]: Initial edition.
  *
- * Copyright(c) 2021 Beijing Institute of Technology.
+ * Copyright(c) 2024 Beijing Institute of Technology.
  *
  ******************************************************************************/
 
@@ -72,35 +72,33 @@ struct callback_desc scutm_callback_desc = {
 
 L2_CONFIG linkConfig = {
 	.myType = L2_NODE_HEAD,
-	.clustId = 1,
+	.clustId = 1U,
-	.myId = 1,
+	.myId = 1U,
-	.headId = 1,
+	.headId = 1U,
-	.bkpHeadId = 0,
+	.netScale = 2U,
-	.netScale = 2,
 	.phyInstPtr = NULL, // physical layer reference
 	.tmcInstPtr = NULL
 };
 
 // L2_CONFIG linkConfig = {
 // 	.myType = L2_NODE_MEMBER,
-// 	.clustId = 1,
+// 	.clustId = 1U,
-// 	.myId = 2,
+// 	.myId = 2U,
-// 	.headId = 1,
+// 	.headId = 1U,
-// 	.bkpHeadId = 0,
+// 	.netScale = 2U,
-// 	.netScale = 2,
 // 	.phyInstPtr = NULL, // physical layer reference
 // 	.tmcInstPtr = NULL
 // };
 
 static PHY_CONFIG phyConfig = {
-	.devId = 0,
+	.devId = PHY_DEVICE_ID,
 	.baseAddr = PHY_BASEADDR,
 	.antBramId = PHY_ANTCONFIG_BRAM_DEVICE_ID,
 	.antInfoBramId = PHY_ANTINFO_BRAM_DEVICE_ID,
 	.txBramId = PHY_TXBUFF_BRAM_DEVICE_ID,
 	.rxBramId = PHY_RXBUFF_BRAM_DEVICE_ID,
 	.hwXadcId = PHY_HW_XADC_DEVICE_ID,
-	.get_clk_state = Hardware_GetHMC7044LockStatus,
+	.get_clk_state = Hardware_GetAD9528LockStatus,
 	.get_ad_lock_state = Hardware_GetAD9361LockStatus,
 	.get_ad0_temp = Hardware_GetAD9361Temp_1,
 	.get_ad1_temp = Hardware_GetAD9361Temp_2
@@ -108,21 +106,21 @@ static PHY_CONFIG phyConfig = {
 
 TMC_CONFIG tmcConfig = {
 	.baseAddr = TIME_CONTROLLER_BASEADDR,
-	.reset = 10
+	.reset = 10U
 };
 
 static SYSBUS_CONFIG sysbusConfig = {
 	.baseAddr = SYSBUS_BASE_ADDR,
-	.txQueueMax = 16,
+	.txQueueMax = 16U,
-	.rxQueueMax = 16
+	.rxQueueMax = 16U
 };
 /*********************** Driver Instance Definitions **************************/
-static struct irq_ctrl_desc *intcDescPtr; // General interrupt controller descriptor
+static struct irq_ctrl_desc *intcDescPtr = NULL; // General interrupt controller descriptor
-static struct timer_desc *logTmPtr;
+static struct timer_desc *logTmPtr = NULL;
-static SYSBUS *sysbusDescPtr;
+static SYSBUS *sysbusDescPtr = NULL;
-static PHY_INST *phyInstPtr;
+static PHY_INST *phyInstPtr = NULL;
 static TMC_INST *tmcInstPtr = NULL;
-L2_INST *linkInstPtr;
+L2_INST *linkInstPtr = NULL;
 
 
 /****************************************************************************/
@@ -360,6 +358,11 @@ void ScuTimer_IntrHandler(void *context)
 	{
 		// Refresh log
 		Phy_RefreshHwSate(phyInstPtr);
+		if (TimeCtrl_GetIntCnt(tmcInstPtr) - phyInstPtr->lastLogTime >= PHY_LOG_EXPIRE)
+		{
+			Phy_UpdateLogging(phyInstPtr);
+		}
+
 		XScuTimer_ClearInterruptStatus((XScuTimer *)xdesc->instance);
 	}
 	else
@@ -420,7 +423,7 @@ int main(void)
 	}
 
 	/* Physical Layer Initialize */
-	Status = Phy_InstInit(&phyInstPtr, &phyConfig);
+	Status = Phy_Init(&phyInstPtr, &phyConfig);
 	if (Status == SUCCESS)
 	{
 		DBG_PRINT("Physical layer Init SUCCESS! \n");

df_datalink_sp/src/networking/link_layer/framing.c

@@ -1,19 +1,25 @@
 /*****************************************************************************/
 /**
- * Description:  Functions for framing operations.
+ * @file framing.h
+ * @author FanHao (hao_fan_bit_ee@163.com)
+ * @brief DF Linklayer framing functions.
+ * @version 0.0
+ * @date 2023-05-06
  *
- * Date: 2022-07-16 14:17
+ * @copyright Copyright(c) 2024 Beijing Institute of Technology.\n
- * LastEditors: Fan Hao
+ * Lab of Communication and Network
- * LastEditTime: 2022-07-16 17:11
- * Revisions: Rev 0.0
- * History:
- * [2022-07-16]: Description of modification.
- *
- * Copyright(c) 2022 Beijing Institute of Technology.
- * Lab of Communication and Networking
  *
  ******************************************************************************/
 
+/**
+ * @addtogroup LinkLayer
+ * @{
+ */
+
+/**
+ * @addtogroup LinkLayer_Framing
+ * @{
+ */
 /***************************** Include Files *********************************/
 #include <stdint.h>
 #include <string.h>
@@ -159,7 +165,7 @@ bool L2_CrcCheck(uint8_t *dataBuff, uint32_t dataLen, L2_CRC_TYPE crcType)
 	ASSERT(dataBuff != NULL);
 	int32_t Status;
 	uint32_t crcVal;
-	crcVal = 0;
+	crcVal = 0U;
 	Status = L2_CrcGen(dataBuff, dataLen, crcType, &crcVal);
 	if (Status == SUCCESS)
 	{
@@ -177,3 +183,7 @@ bool L2_CrcCheck(uint8_t *dataBuff, uint32_t dataLen, L2_CRC_TYPE crcType)
 		return false;
 	}
 }
+
+/** @} LinkLayer_Framing*/
+
+/** @} LinkLayer*/

df_datalink_sp/src/networking/link_layer/geometry/coord.c

@@ -1,8 +1,28 @@
-//
+/*****************************************************************************/
-// Copyright (C) 2020 OpenSim Ltd.
+/**
-//
+ * @file coord.c
-// SPDX-License-Identifier: LGPL-3.0-or-later
+ * @author FanHao (hao_fan_bit_ee@163.com)
-//
+ * @version 0.0
+ * @date 2023-05-06
+ *
+ * @copyright Copyright(c) 2024 Beijing Institute of Technology.\n
+ * Lab of Communication and Network
+ *
+ ******************************************************************************/
+/**
+ * @addtogroup LinkLayer
+ * @{
+ */
+
+/**
+ * @addtogroup LinkLayerGeometry
+ * @{
+ */
+
+/**
+ * @addtogroup LinkLayerGeometry_Coord
+ * @{
+ */
 
 #include <math.h>
 #include "coord.h"
@@ -55,6 +75,10 @@ COORD Coord_GetScalarMult(COORD a, double t)
 /** @brief Divides a coordinate vector by a real number. */
 void Coord_ScalarDiv(COORD *a, double t)
 {
+	if (t == 0.0) {
+		*a = COORD_NIL;
+		return;
+	}
 	a->x /= t;
 	a->y /= t;
 	a->z /= t;
@@ -63,6 +87,9 @@ void Coord_ScalarDiv(COORD *a, double t)
 /** @brief Divides a coordinate vector by a real number. */
 COORD Coord_GetScalarDiv(COORD a, double t)
 {
+	if (t == 0.0) {
+		return COORD_NIL;
+	}
 	COORD ret;
 	ret.x = a.x / t;
 	ret.y = a.y / t;
@@ -209,3 +236,9 @@ COORD Coord_Launch2Inertia(COORD o, COORD p, double A, double B, double we, doub
 
 	return ret;
 }
+
+/** @} LinkLayerGeometry_Coord */
+
+/** @} LinkLayerGeometry */
+
+/** @} LinkLayer */

df_datalink_sp/src/networking/link_layer/geometry/coord.h

@@ -1,20 +1,36 @@
-//
+/*****************************************************************************/
-// Copyright (C) 2020 OpenSim Ltd.
+/**
-//
+ * @file coord.h
-// SPDX-License-Identifier: LGPL-3.0-or-later
+ * @author FanHao (hao_fan_bit_ee@163.com)
-//
+ * @version 0.0
+ * @date 2023-05-06
+ *
+ * @copyright Copyright(c) 2024 Beijing Institute of Technology.\n
+ * Lab of Communication and Network
+ *
+ ******************************************************************************/
 
 #ifndef _COORD_H
 #define _COORD_H
-
 /**
- * @brief Structure for storing 3D coordinates.
+ * @addtogroup LinkLayer
- *
+ * @{
- * Some comparison and basic arithmetic operators are implemented.
- *
- * @ingroup utils
  */
 
+/**
+ * @defgroup LinkLayerGeometry
+ * @{
+ */
+
+/**
+ * @defgroup LinkLayerGeometry_Coord
+ * @{
+ */
+
+/**
+ * @struct COORD
+ * @brief Structure for storing 3D coordinates.
+ */
 typedef struct
 {
 	double x;
@@ -78,3 +94,9 @@ COORD Coord_GetNormalized(COORD a);
 double Coord_Angle(COORD a, COORD b);
 
 #endif
+
+/** @} LinkLayerGeometry_Coord */
+
+/** @} LinkLayerGeometry */
+
+/** @} LinkLayer */

df_datalink_sp/src/networking/link_layer/geometry/eulerangles.c

@@ -1,8 +1,29 @@
-//
+/*****************************************************************************/
-// Copyright (C) 2020 OpenSim Ltd.
+/**
-//
+ * @file eulerangles.c
-// SPDX-License-Identifier: LGPL-3.0-or-later
+ * @author FanHao (hao_fan_bit_ee@163.com)
-//
+ * @version 0.0
+ * @date 2023-05-06
+ *
+ * @copyright Copyright(c) 2024 Beijing Institute of Technology.\n
+ * Lab of Communication and Network
+ *
+ ******************************************************************************/
+
+/**
+ * @addtogroup LinkLayer
+ * @{
+ */
+
+/**
+ * @addtogroup LinkLayerGeometry
+ * @{
+ */
+
+/**
+ * @addtogroup LinkLayerGeometry_EulerAngles
+ * @{
+ */
 
 #include <math.h>
 #include "eulerangles.h"
@@ -48,9 +69,9 @@ EULERANGLES EulerAngles_GetScalarMult(EULERANGLES e, double f)
 /** @brief Normalize EulerAngles. */
 void EulerAngles_Normalize(EULERANGLES *e)
 {
-    e->alpha = fmod(e->alpha, 2 * EUL_PI);
+	e->alpha = fmod(e->alpha, 2.0 * EUL_PI);
-    e->beta = fmod(e->beta, 2 * EUL_PI);
+	e->beta = fmod(e->beta, 2.0 * EUL_PI);
-    e->gamma = fmod(e->gamma, 2 * EUL_PI);
+	e->gamma = fmod(e->gamma, 2.0 * EUL_PI);
 }
 
 /** @brief Normalize EulerAngles. */
@@ -59,3 +80,9 @@ EULERANGLES EulerAngles_GetNormalize(EULERANGLES e)
 	EulerAngles_Normalize(&e);
 	return e;
 }
+
+/** @} LinkLayerGeometry_EulerAngles */
+
+/** @} LinkLayerGeometry */
+
+/** @} LinkLayer */

df_datalink_sp/src/networking/link_layer/geometry/eulerangles.h

@@ -1,10 +1,37 @@
+/*****************************************************************************/
+/**
+ * @file eulerangles.h
+ * @author FanHao (hao_fan_bit_ee@163.com)
+ * @version 0.0
+ * @date 2023-05-06
+ *
+ * @copyright Copyright(c) 2024 Beijing Institute of Technology.\n
+ * Lab of Communication and Network
+ *
+ ******************************************************************************/
+
+/**
+ * @addtogroup LinkLayer
+ * @{
+ */
+
+/**
+ * @addtogroup LinkLayerGeometry
+ * @{
+ */
+
+/**
+ * @defgroup LinkLayerGeometry_EulerAngles
+ * @{
+ */
+
 #ifndef __EULERANGLES_H
 #define __EULERANGLES_H
 
 #define EUL_PI 3.14159265358979323846
 
-#define DEG2RAD(d) ((EUL_PI / 180.0) * d)
+#define DEG2RAD(d) ((EUL_PI / 180.0) * (d))
-#define RAD2DEG(r) ((180.0 / EUL_PI) * r)
+#define RAD2DEG(r) ((180.0 / EUL_PI) * (r))
 
 /**
  * Orientations are represented by 3D double precision Tait-Bryan (Euler) tuples
@@ -16,6 +43,11 @@
  * rotation along the Y axis rotates Z into X (leans forward), positive rotation
  * along the X axis rotates Y into Z (leans right).
  */
+
+/**
+ * @struct EULERANGLES
+ * @brief Structure for standard quaternion
+ */
 typedef struct
 {
 	double alpha; // unit rad
@@ -53,3 +85,9 @@ void EulerAngles_Normalize(EULERANGLES *e);
 EULERANGLES EulerAngles_GetNormalize(EULERANGLES e);
 
 #endif
+
+/** @} LinkLayerGeometry_EulerAngles */
+
+/** @} LinkLayerGeometry */
+
+/** @} LinkLayer */

df_datalink_sp/src/networking/link_layer/geometry/quaternion.c

@@ -1,8 +1,29 @@
-//
+/*****************************************************************************/
-// Copyright (C) 2014 OpenSim Ltd.
+/**
-//
+ * @file quaternion.c
-// SPDX-License-Identifier: LGPL-3.0-or-later
+ * @author FanHao (hao_fan_bit_ee@163.com)
-//
+ * @version 0.0
+ * @date 2023-05-06
+ *
+ * @copyright Copyright(c) 2024 Beijing Institute of Technology.\n
+ * Lab of Communication and Network
+ *
+ ******************************************************************************/
+
+/**
+ * @addtogroup LinkLayer
+ * @{
+ */
+
+/**
+ * @addtogroup LinkLayerGeometry
+ * @{
+ */
+
+/**
+ * @addtogroup LinkLayerGeometry_Quaternion
+ * @{
+ */
 
 #include <math.h>
 #include <stdint.h>
@@ -28,6 +49,7 @@ const SOFT_DOUBLE EPS_DOUBLE = {.raw = 0x3CB0000000000000};
 
 const QUATERNION QUATERNION_IDENTITY = {1.0, 0.0, 0.0, 0.0};
 const QUATERNION QUATERNION_NIL = {NAN, NAN, NAN, NAN};
+
 /** @brief Subtracts two quaternions. */
 QUATERNION Quaternion_Sub(QUATERNION q1, QUATERNION q2)
 {
@@ -69,6 +91,10 @@ QUATERNION Quaternion_GetScalarMult(QUATERNION a, double t)
 /** @brief Divides a quaternion by a real number. */
 void Quaternion_ScalarDiv(QUATERNION *q, double t)
 {
+	if (t == 0.0) {
+		*q = QUATERNION_NIL;
+		return;
+	}
 	q->s /= t;
 	q->i /= t;
 	q->j /= t;
@@ -168,6 +194,9 @@ inline double Quaternion_GetRotationAngle(QUATERNION q)
 /** @brief Get axis of quaternion. */
 COORD Quaternion_GetRotationAxis(QUATERNION q)
 {
+	if ((q.s > 1.0) || (q.s < -1.0)) {
+		return COORD_NIL;
+	}
 	double sin_theta_inv;
 	COORD ret;
 	sin_theta_inv = 1.0 / sin(acos(q.s));
@@ -180,6 +209,12 @@ COORD Quaternion_GetRotationAxis(QUATERNION q)
 /** @brief Get the axis and rotate angle of a unit Quaternion */
 void Quaternion_GetRotationAxisAndAngle(QUATERNION q, COORD *axis, double *angle)
 {
+	if ((q.s > 1.0) || (q.s < -1.0)) {
+		*axis = COORD_NIL;
+		*angle = NAN;
+		return;
+	}
+
 	double sin_theta_inv;
 	*angle = acos(q.s);
 
@@ -196,6 +231,11 @@ void Quaternion_GetRotationAxisAndAngle(QUATERNION q, COORD *axis, double *angle
 /** @brief Decompose the rotation on to 2 parts. */
 void Quaternion_GetSwingAndTwist(QUATERNION q, COORD axis, QUATERNION *swing, QUATERNION *twist)
 {
+	if ((swing == NULL) || (twist == NULL))
+	{
+		return;
+	}
+
 	double p;
 	COORD v;
 	v.x = q.i;
@@ -304,7 +344,7 @@ EULERANGLES Quaternion_ToEulerAngles(QUATERNION q, EULERANGLES_TYPE type)
 		if (mask1 || mask2)
 		{
 			ret.alpha = 0;
-            ret.gamma = (asinValue > 0) ? (2.0 * atan2(q.i, q.s)) : (-2.0 * atan2(q.i, q.s));
+			ret.gamma = (asinValue > 0.0) ? (2.0 * atan2(q.i, q.s)) : (-2.0 * atan2(q.i, q.s));
 		}
 		else
 		{
@@ -317,6 +357,7 @@ EULERANGLES Quaternion_ToEulerAngles(QUATERNION q, EULERANGLES_TYPE type)
 
 	default:
 		ret = EULERANGLES_NIL;
+		break;
 	}
 	return ret;
 }
@@ -406,7 +447,7 @@ QUATERNION Quaternion_RotationFromTo(COORD from, COORD to)
 QUATERNION Quaternion_Lerp(QUATERNION q1, QUATERNION q2, double t)
 {
 	QUATERNION ret;
-    Quaternion_ScalarMult(&q1, 1 - t);
+	Quaternion_ScalarMult(&q1, 1.0 - t);
 	Quaternion_ScalarMult(&q1, t);
 	ret = Quaternion_Add(q1, q2);
 	Quaternion_Normalize(&ret);
@@ -450,3 +491,9 @@ QUATERNION Quaternion_Slerp(QUATERNION q1, QUATERNION q2, double t)
 		return Quaternion_Lerp(q1, q3, t);
 	}
 }
+
+/** @} LinkLayerGeometry_Quaternion */
+
+/** @} LinkLayerGeometry */
+
+/** @} LinkLayer */

df_datalink_sp/src/networking/link_layer/geometry/quaternion.h

@@ -1,3 +1,29 @@
+/*****************************************************************************/
+/**
+ * @file quaternion.h
+ * @author FanHao (hao_fan_bit_ee@163.com)
+ * @version 0.0
+ * @date 2023-05-06
+ *
+ * @copyright Copyright(c) 2024 Beijing Institute of Technology.\n
+ * Lab of Communication and Network
+ *
+ ******************************************************************************/
+
+/**
+ * @addtogroup LinkLayer
+ * @{
+ */
+
+/**
+ * @addtogroup LinkLayerGeometry
+ * @{
+ */
+
+/**
+ * @defgroup LinkLayerGeometry_Quaternion
+ * @{
+ */
 
 #ifndef __QUATERNION_H
 #define __QUATERNION_H
@@ -5,7 +31,10 @@
 #include "coord.h"
 #include "eulerangles.h"
 
-// borrowed and adapted from https://github.com/MegaManSE/willperone/blob/master/Math/quaternion.h
+/**
+ * @struct QUATERNION
+ * @brief Structure for standard quaternion
+ */
 typedef struct
 {
 	double s;
@@ -27,13 +56,13 @@ QUATERNION Quaternion_Add(QUATERNION q1, QUATERNION q2);
 void Quaternion_ScalarMult(QUATERNION *q, double t);
 
 /** @brief Multiplies a quaternion by a real number. */
-QUATERNION Quaternion_GetScalarMult(QUATERNION a, double t);
+QUATERNION Quaternion_GetScalarMult(QUATERNION q, double t);
 
 /** @brief Divides a quaternion by a real number. */
 void Quaternion_ScalarDiv(QUATERNION *q, double t);
 
 /** @brief Divides a quaternion by a real number. */
-QUATERNION Quaternion_GetScalarDiv(QUATERNION a, double t);
+QUATERNION Quaternion_GetScalarDiv(QUATERNION q, double t);
 
 /** @brief Multiplies two quaternions. */
 QUATERNION Quaternion_Mult(QUATERNION q1, QUATERNION q2);
@@ -107,3 +136,9 @@ QUATERNION Quaternion_Lerp(QUATERNION q1, QUATERNION q2, double t);
 QUATERNION Quaternion_Slerp(QUATERNION q1, QUATERNION q2, double t);
 
 #endif
+
+/** @} LinkLayerGeometry_Quaternion */
+
+/** @} LinkLayerGeometry */
+
+/** @} LinkLayer */

df_datalink_sp/src/networking/link_layer/link_layer.c

@@ -1,19 +1,21 @@
 /*****************************************************************************/
 /**
- * Description: A brief description of this file
+ * @file link_layer.c
+ * @author FanHao (hao_fan_bit_ee@163.com)
+ * @brief DF Linklayer implementation file.
+ * @version 0.1
+ * @date 2023-05-06
  *
- * Date: 2021-11-13 13:32
+ * @copyright Copyright(c) 2024 Beijing Institute of Technology.\n
- * LastEditTime: 2021-11-23 10:57
+ * Lab of Communication and Network
- * Revisions: Rev 0.0
- * History:
- * [2021-11-23]: Initial version.
- * [2022-03-28]: Add bre test mode.
- *
- * Copyright(c) 2021 Beijing Institute of Technology.
- * Lab of Communication and Networking
  *
  ******************************************************************************/
 
+/**
+ * @addtogroup LinkLayer
+ * @{
+ */
+
 /***************************** Include Files *********************************/
 #include <stdlib.h>
 #include <string.h>
@@ -31,18 +33,30 @@
 #endif
 /************************** Constant Definitions *****************************/
 #define NET_START_TIME_INFTY UINT32_MAX
-#define LINK_BROCK_THRESHOLD (3 * 200) // 3 secods
+#define LINK_BROCK_THRESHOLD L2_SLOTS_PER_FRAME // 0.5 secods
 
 /************************** Variable Definitions *****************************/
 /***************** Macros (Inline Functions) Definitions *********************/
 /**************************** Type Definitions *******************************/
 /************************** Function Prototypes ******************************/
-static void L2_RcdShift(L2_RCD *rcd, int32_t netxVal);
+static void L2_RcdShift(L2_RCD *rcd, uint32_t netxVal);
 static void UpdateMainSate(L2_INST *instPtr, L2_NODE_STATE newSate);
 static void L2_SetSlotNum(L2_INST *instPtr, uint32_t newSlotNum);
 static void L2_SetFrameNum(L2_INST *instPtr, uint32_t newFrameNum);
 static void L2_UpdateSlotNum(L2_INST *instPtr);
 static void L2_DataAvailUpdate(L2_INST *instPtr, bool status);
+static void L2_FrameStateUpdate(L2_INST *instPtr);
+
+/**
+ * @brief   Shift L2 status record.(newval->next->curr->last)
+ */
+inline void L2_RcdShift(L2_RCD *rcd, uint32_t netxVal)
+{
+	ASSERT(rcd != NULL);
+	rcd->last = rcd->curr;
+	rcd->curr = rcd->next;
+	rcd->next = netxVal;
+}
 
 /**
  * @brief	helper function to update linkelayer state
@@ -102,6 +116,80 @@ static inline void L2_DataAvailUpdate(L2_INST *instPtr, bool status)
 	instPtr->dataAvail = status;
 }
 
+/*****************************************************************************/
+/**
+ * @brief   Update L2 frame state, check if there is any valid L2 frame data in
+ * 			data buffer, update receive frame status.
+ *
+ * @param   instPtr		a pointer to linklayer instance
+ *
+ * @return	NONE.
+ *
+ ******************************************************************************/
+static void L2_FrameStateUpdate(L2_INST *instPtr)
+{
+	ASSERT(instPtr != NULL);
+	PHY_INST *phyRef = instPtr->config.phyInstPtr;
+	bool isValid;
+	L2_FRAME_TYPE recvType = L2_GetLastOptFrameType(instPtr);
+	isValid = false;
+	// Update frame state.
+	if (Phy_IsFrameValid(phyRef) == false)
+	{
+		L2_DataAvailUpdate(instPtr, false);
+	}
+	else
+	{
+		DBG_INFO("A frame received, checking data validation...\n");
+		DBG_INFO("Last frame type is: %" PRId32 ".\n", instPtr->frame.last);
+		Phy_RetrieveRecvData(phyRef, instPtr->recvPktData);
+		instPtr->log.frameRecv++;
+
+		// Update frame state.
+		switch (recvType)
+		{
+		case L2_SCAN_FRAME:
+		case L2_ADV_FRAME:
+			isValid = L2_CrcCheck(instPtr->recvPktData, L2_ADV_PACK_LEN, L2_CRC16_1021);
+			instPtr->log.advRecvCnt++;
+			instPtr->log.advCorrectCnt = isValid ? instPtr->log.advCorrectCnt + 1 : instPtr->log.advCorrectCnt;
+			break;
+		case L2_CFM_FRAME:
+			isValid = L2_CrcCheck(instPtr->recvPktData, L2_CMF_PACK_LEN, L2_CRC16_1021);
+			instPtr->log.cfmRecvCnt++;
+			instPtr->log.cfmCorrectCnt = isValid ? instPtr->log.cfmCorrectCnt + 1 : instPtr->log.cfmCorrectCnt;
+			break;
+		case L2_SVC_FRAME:
+#ifndef DATALINK_ENABLE_BERTEST
+			isValid = L2_CrcCheck(instPtr->recvPktData, L2_SVC_PACK_LEN, L2_CRC16_1021);
+#else
+			isValid = true;
+#endif
+			instPtr->log.svcRecvCnt++;
+			instPtr->log.svcCorrectCnt = isValid ? instPtr->log.svcCorrectCnt + 1 : instPtr->log.svcCorrectCnt;
+			break;
+
+		default:
+			isValid = false;
+			break;
+		}
+		if (isValid)
+		{
+			instPtr->log.frameCorrect++;
+			L2_DataAvailUpdate(instPtr, true);
+		}
+		else
+		{
+			L2_DataAvailUpdate(instPtr, false);
+		}
+	}
+}
+
+/**
+ * @addtogroup LinkLayer_Utility
+ * @{
+ */
+
 /**
  * @brief   Get the current node ID.
  */
@@ -147,6 +235,15 @@ inline L2_NODE_STATE L2_GetMainState(L2_INST *instPtr)
 	return instPtr->mainState;
 }
 
+/**
+ * @brief   Check if there is a valid l2 frame.
+ */
+inline bool L2_isStarted(L2_INST *instPtr)
+{
+	ASSERT(instPtr != NULL);
+	return instPtr->isEnable;
+}
+
 /**
  * @brief   Check if there is a valid l2 frame.
  */
@@ -165,6 +262,14 @@ inline bool L2_isCxn2Net(L2_INST *instPtr)
 	return instPtr->cxn2Net;
 }
 
+/**
+ * @brief   Get corresponding frame length in byte of L2 frame.
+ */
+inline uint32_t L2_GetFrameLen(L2_FRAME_TYPE l2FrameType)
+{
+	return Phy_GetFrameLen(L2_L2frame2L1frame(l2FrameType));
+}
+
 /**
  * @brief   Get last frame number.
  */
@@ -272,24 +377,6 @@ inline L2_TOR_TYPE L2_GetNextTor(L2_INST *instPtr)
 	return instPtr->tor.next;
 }
 
-/*****************************************************************************/
-/**
- * @brief   Shift L2 status record.(newval->next->curr->last)
- *
- * @param   instPtr  A pointer to physical layer control instance.
- *
- * @return  NONE.
- *
- ******************************************************************************/
-inline void L2_RcdShift(L2_RCD *rcd, int32_t netxVal)
-{
-	ASSERT(rcd != NULL);
-	rcd->last = rcd->curr;
-	rcd->curr = rcd->next;
-	rcd->next = netxVal;
-}
-
-// FIXME:
 /*****************************************************************************/
 /**
  * @brief   Infer last received frame type.
@@ -317,292 +404,6 @@ L2_FRAME_TYPE L2_GetLastOptFrameType(L2_INST *instPtr)
 		return L2_NONE_FRAME;
 	}
 }
-
-/*****************************************************************************/
-/**
- * @brief   Update L2 frame state, check if there is any valid L2 frame data in
- * 			data buffer, update receive frame status.
- *
- * @param   instPtr		a pointer to linklayer instance
- *
- * @return	NONE.
- *
- ******************************************************************************/
-void L2_FrameStateUpdate(L2_INST *instPtr)
-{
-	ASSERT(instPtr != NULL);
-	PHY_INST *phyRef = instPtr->config.phyInstPtr;
-	bool isValid;
-	L2_FRAME_TYPE recvType = L2_GetLastOptFrameType(instPtr);
-	// Update frame state.
-	if (Phy_IsFrameValid(phyRef) == false)
-	{
-		L2_DataAvailUpdate(instPtr, false);
-	}
-	else
-	{
-		DBG_INFO("A frame received, checking data validation...\n");
-		DBG_INFO("Last frame type is: %" PRId32 ".\n", instPtr->frame.last);
-		Phy_RetrieveRecvData(phyRef, instPtr->recvPktData);
-		instPtr->log.frameRecv++;
-
-		// Update frame state.
-		switch (recvType)
-		{
-		case L2_SCAN_FRAME:
-		case L2_ADV_FRAME:
-			isValid = L2_CrcCheck(instPtr->recvPktData, L2_ADV_PACK_LEN, L2_CRC16_1021);
-			instPtr->log.advRecvCnt++;
-			instPtr->log.advCorrectCnt = isValid ? instPtr->log.advCorrectCnt + 1 : instPtr->log.advCorrectCnt;
-			break;
-		case L2_CFM_FRAME:
-			isValid = L2_CrcCheck(instPtr->recvPktData, L2_CMF_PACK_LEN, L2_CRC16_1021);
-			instPtr->log.cfmRecvCnt++;
-			instPtr->log.cfmCorrectCnt = isValid ? instPtr->log.cfmCorrectCnt + 1 : instPtr->log.cfmCorrectCnt;
-			break;
-		case L2_SVC_FRAME:
-#ifndef DATALINK_ENABLE_BERTEST
-			isValid = L2_CrcCheck(instPtr->recvPktData, L2_SVC_PACK_LEN, L2_CRC16_1021);
-#else
-			isValid = true;
-#endif
-			instPtr->log.svcRecvCnt++;
-			instPtr->log.svcCorrectCnt = isValid ? instPtr->log.svcCorrectCnt + 1 : instPtr->log.svcCorrectCnt;
-			break;
-
-		default:
-			isValid = false;
-			break;
-		}
-		if (isValid)
-		{
-			instPtr->log.frameCorrect++;
-			L2_DataAvailUpdate(instPtr, true);
-		}
-		else
-		{
-			L2_DataAvailUpdate(instPtr, false);
-		}
-	}
-}
-
-/*****************************************************************************/
-/**
- * @brief   Steer antenna beam to specified node.
- *
- * @param   instPtr	a pointer to link layer descriptor instance
- * @param   nodeId		destination node
- *
- * @return Corresponding frame length
- *         L2_FRAME_NONE_LEN if the frame type code cannot be recognized.
- *
- ******************************************************************************/
-// FIXME: To Complete.
-int32_t L2_SteerBeam2Node(L2_INST *instPtr, uint8_t nodeId)
-{
-	ASSERT(instPtr != NULL);
-	ASSERT(instPtr->config.phyInstPtr != NULL);
-	int32_t Status;
-
-	COORD myPos, dstPos, beamDir;
-	Status = L2_GetNodePos(instPtr->nodeList, nodeId, &dstPos);
-	if (Status != SUCCESS)
-	{
-		DBG_ERROR("Failed to retrieve position info of node %" PRIu8 ", remain last configuration.\n", nodeId);
-		return EPARAM;
-	}
-	myPos.x = instPtr->sysInfo.posX;
-	myPos.y = instPtr->sysInfo.posY;
-	myPos.z = instPtr->sysInfo.posZ;
-
-	// TODO Check data format
-	EULERANGLES attitudeEuler, antAttitudeEuler;
-	attitudeEuler.alpha = DEG2RAD(instPtr->sysInfo.pitch);
-	attitudeEuler.beta = DEG2RAD(instPtr->sysInfo.yaw);
-	attitudeEuler.gamma = DEG2RAD(instPtr->sysInfo.roll);
-
-	// FIXME: confirm date source.
-	antAttitudeEuler.alpha = DEG2RAD(0);
-	antAttitudeEuler.beta = DEG2RAD(0);
-	antAttitudeEuler.gamma = DEG2RAD(0);
-
-	// TODO Check data format
-	QUATERNION attitude, antAttitude;
-	attitude = Quaternion_FromeEulerAngles(attitudeEuler, EULERANGLES_XYZ);
-	antAttitude = Quaternion_FromeEulerAngles(antAttitudeEuler, EULERANGLES_XYZ);
-
-	// --- --- Algorithm --- ---
-	// TODO Check result validation
-	// Compute beam direction vector
-	beamDir = Coord_Sub(dstPos, myPos);
-
-	// Compute antenna attitude respect to ECEF
-	antAttitude = Quaternion_Mult(attitude, antAttitude);
-
-	// Convert beam direction vector to antenna coordinate
-	beamDir = Quaternion_Rotate(Quaternion_GeInverse(antAttitude), beamDir);
-	// Normalize
-	Coord_Normalize(&beamDir);
-
-	double oAxis, rAxis;
-	oAxis = RAD2DEG(atan2(beamDir.z, beamDir.y));
-	rAxis = RAD2DEG(acos(Coord_Dot(beamDir, COORD_X_AXIS)));
-	Status = Phy_SetBeamAngle(instPtr->config.phyInstPtr, oAxis, rAxis);
-	return Status;
-}
-
-/*****************************************************************************/
-/**
- * @brief   Layer 2 setup next slot operation, update current operating frame.
- *
- * @param   instPtr		a pointer to linklayer instance
- * @param   txrxMode	tx/rx state for next slot
- * @param   frameType	frame type of next slot.
- *
- * @return Corresponding frame length
- *         L2_FRAME_NONE_LEN if the frame type code cannot be recognized.
- *
- ******************************************************************************/
-int32_t L2_SetupNextSlot(L2_INST *instPtr, L2_TOR_TYPE txrxMode, L2_FRAME_TYPE frameType)
-{
-	ASSERT(instPtr != NULL);
-	PHY_INST *phyRef = instPtr->config.phyInstPtr;
-	int32_t Status;
-	if (frameType < L2_SCAN_FRAME || frameType > L2_SVC_FRAME)
-	{
-		return FAILURE;
-	}
-
-	// logging
-	if (txrxMode == L2_TOR_TX)
-	{
-		instPtr->log.frameTx++;
-		switch (frameType)
-		{
-		case L2_ADV_FRAME:
-			instPtr->log.advTxCnt++;
-			break;
-		case L2_CFM_FRAME:
-			instPtr->log.cfmTxCnt++;
-			break;
-		case L2_SVC_FRAME:
-			instPtr->log.svcTxCnt++;
-			break;
-		default:
-			break;
-		}
-	}
-	else if (txrxMode == L2_TOR_RX)
-	{
-		instPtr->log.frameRx++;
-		switch (frameType)
-		{
-		case L2_ADV_FRAME:
-			instPtr->log.advRxCnt++;
-			break;
-		case L2_CFM_FRAME:
-			instPtr->log.cfmRxCnt++;
-			break;
-		case L2_SVC_FRAME:
-			instPtr->log.svcRxCnt++;
-			break;
-		default:
-			break;
-		}
-	}
-
-#if _DEBUG_LEVEL >= 3
-	char *torStr = NULL;
-	char *frameStr = NULL;
-	switch (txrxMode)
-	{
-	case L2_TOR_SUSPEND:
-		torStr = "SUSPEND";
-		break;
-	case L2_TOR_TX:
-		torStr = "TX";
-		break;
-	case L2_TOR_RX:
-		torStr = "RX";
-		break;
-	}
-	switch (frameType)
-	{
-	case L2_SCAN_FRAME:
-		frameStr = "Scan";
-		break;
-	case L2_ADV_FRAME:
-		frameStr = "Advertisement";
-		break;
-	case L2_CFM_FRAME:
-		frameStr = "Confirm";
-		break;
-	case L2_SVC_FRAME:
-		frameStr = "Service";
-		break;
-	default:
-		frameStr = "UNKNOWN Frame";
-		break;
-	}
-	DBG_INFO("# Setup Next Slot # [%" PRIu32 "-%" PRIu32 "], %s, %s.\n",
-			 instPtr->frameNum.next,
-			 instPtr->slotNum.next,
-			 torStr, frameStr);
-#endif
-
-	// Update frame and tx/rx mode record.
-	// Frame types shift (last <- curr <- next)
-	L2_RcdShift(&(instPtr->frame), frameType);
-	L2_RcdShift(&(instPtr->tor), txrxMode);
-
-	TIME_WORD pullTime = {0, 0};
-	pullTime.int_part = TimeCtrl_GetIntCnt(instPtr->config.tmcInstPtr) + 1;
-	Status = Phy_SetTimeWord(phyRef, &pullTime, PHY_TIME_WORD_POLL);
-	if (Status != SUCCESS)
-	{
-		DBG_ERROR("Physical set pull time failed, with error code: %" PRId32 "\n", Status);
-	}
-
-	PHY_TOR_TYPE tor;
-	switch (txrxMode)
-	{
-	case L2_TOR_SUSPEND:
-		tor = PHY_TOR_SUSPEND;
-		break;
-	case L2_TOR_TX:
-		tor = PHY_TOR_TX;
-		break;
-	case L2_TOR_RX:
-		tor = PHY_TOR_RX;
-		break;
-	default:
-		DBG_ERROR("Invalid txrx mode :%" PRId8 ".\n", txrxMode);
-		return EPARAM;
-	}
-
-	Status = Phy_SetupNextSlot(phyRef, tor, L2_L2frame2L1frame(frameType), instPtr->sendPktData);
-	if (Status != SUCCESS)
-	{
-		DBG_ERROR("Physical setup failed, with error code: %" PRId32 "\n", Status);
-	}
-	return Status;
-}
-
-/*****************************************************************************/
-/**
- * @brief   Get corresponding frame length in byte of L2 frame.
- *
- * @param   l2FrameType
- *
- * @return Corresponding frame length
- *         L2_FRAME_NONE_LEN if the frame type code cannot be recognized.
- *
- ******************************************************************************/
-uint32_t L2_GetFrameLen(L2_FRAME_TYPE l2FrameType)
-{
-	return Phy_GetFrameLen(L2_L2frame2L1frame(l2FrameType));
-}
-
 /*****************************************************************************/
 /**
  * @brief   Convert L2 frame type to L1 frame type
@@ -627,6 +428,12 @@ L1_FRAME_TYPE L2_L2frame2L1frame(L2_FRAME_TYPE l2Frame)
 		return L1_NONE_FRAME;
 	}
 }
+/** @} LinkLayer_Utility*/
+
+/**
+ * @defgroup LinkLayer_Main
+ * @{
+ */
 
 /*****************************************************************************/
 /**
@@ -664,6 +471,12 @@ int32_t Linklayer_Init(L2_INST **instPtr, const L2_CONFIG *config)
 
 	// Clear random content
 	memset(*instPtr, 0x00, sizeof(L2_INST));
+	(*instPtr)->sendPktData = NULL;
+	(*instPtr)->recvPktData = NULL;
+	(*instPtr)->schdEventPool = NULL;
+	(*instPtr)->nodeList = NULL;
+	(*instPtr)->scanFSM = NULL;
+	(*instPtr)->serviceFSM = NULL;
 	memcpy(&((*instPtr)->config), config, sizeof(L2_CONFIG));
 
 	// Packet buffer
@@ -671,15 +484,15 @@ int32_t Linklayer_Init(L2_INST **instPtr, const L2_CONFIG *config)
 	if ((*instPtr)->sendPktData == NULL)
 	{
 		DBG_ERROR("Allocate memory for sendPktData failed.\n");
-		Status = ENOMEM;
+		Linklayer_Destroy(*instPtr);
-		goto init_error;
+		return ENOMEM;
 	}
 	(*instPtr)->recvPktData = calloc(L2_PACK_LEN_MAX / sizeof(uint64_t), sizeof(uint64_t));
 	if ((*instPtr)->recvPktData == NULL)
 	{
 		DBG_ERROR("Allocate memory for recvPktData failed.\n");
-		Status = ENOMEM;
+		Linklayer_Destroy(*instPtr);
-		goto init_error;
+		return ENOMEM;
 	}
 	// Reset basic info
 	(*instPtr)->netStartTime = NET_START_TIME_INFTY;
@@ -722,32 +535,33 @@ int32_t Linklayer_Init(L2_INST **instPtr, const L2_CONFIG *config)
 	if (Status != SUCCESS)
 	{
 		DBG_ERROR("L2_CreateSchedEventPool runs failed, with error code: %" PRId32 ".\n", Status);
-		goto init_error;
+		Linklayer_Destroy(*instPtr);
+		return Status;
 	}
 
 	Status = L2_NodeList_Init(&((*instPtr)->nodeList));
 	if (Status != SUCCESS)
 	{
 		DBG_ERROR("NodeList_Init runs failed, with error code: %" PRId32 ".\n", Status);
-		goto init_error;
+		Linklayer_Destroy(*instPtr);
+		return Status;
 	}
 
 	Status = L2_Scan_Init(&((*instPtr)->scanFSM));
 	if (Status != SUCCESS)
 	{
-		goto init_error;
+		Linklayer_Destroy(*instPtr);
+		return Status;
 	}
 
 	Status = L2_Service_Init(&((*instPtr)->serviceFSM));
 	if (Status != SUCCESS)
 	{
-		goto init_error;
+		Linklayer_Destroy(*instPtr);
+		return Status;
 	}
 
 	return SUCCESS;
-init_error:
-	Linklayer_Destroy(*instPtr);
-	return Status;
 }
 
 /*****************************************************************************/
@@ -783,7 +597,7 @@ int32_t Linklayer_Reconfig(L2_INST *instPtr, const L2_CONFIG *config)
 	instPtr->rtneConfig.last = NULL;
 	instPtr->rtneConfig.curr = NULL;
 	instPtr->rtneConfig.next = NULL;
-	instPtr->cxn2Net = false;
+	instPtr->cxn2Net = (config->myType == L2_NODE_HEAD) ? true : false;
 	instPtr->dataAvail = false;
 	instPtr->frameNum.last = 0;
 	instPtr->frameNum.curr = 0;
@@ -831,7 +645,10 @@ int32_t Linklayer_Reconfig(L2_INST *instPtr, const L2_CONFIG *config)
  ******************************************************************************/
 void Linklayer_Destroy(L2_INST *instPtr)
 {
-	ASSERT(instPtr != NULL);
+	if (instPtr == NULL)
+	{
+		return;
+	}
 	free(instPtr->sendPktData);
 	free(instPtr->recvPktData);
 	// Destroy FSMs and nodeList
@@ -948,7 +765,7 @@ int32_t Linklayer_EventHandler(L2_INST *instPtr, const L2_EVENT *l2Event)
 	case L2_EV_LOST_CXN:
 	{
 		DBG_INFO("Event L2_EV_LOST_CXN asserted....\n");
-		if (instPtr->config.myType == L2_NODE_HEAD)
+		if (L2_GetNodeType(instPtr) == L2_NODE_HEAD)
 		{
 			DBG_ERROR("Illegal event, only None_Head node can assert L2_EV_LOST_CXN.\n");
 			break;
@@ -1171,6 +988,8 @@ int32_t Linklayer_Proc(L2_INST *instPtr)
 {
 	ASSERT(instPtr != NULL);
 	int32_t Status;
+	PHY_INST *phyRef = instPtr->config.phyInstPtr;
+	TMC_INST *tmcRef = instPtr->config.tmcInstPtr;
 
 	if (instPtr->isEnable == false)
 	{
@@ -1179,7 +998,7 @@ int32_t Linklayer_Proc(L2_INST *instPtr)
 	}
 
 	// FIXME: Consider time wrapping.
-	uint32_t nextTimeUnit = (TimeCtrl_GetIntCnt(instPtr->config.tmcInstPtr) + 1) / L2_SLOTS_PER_FRAME;
+	uint32_t nextTimeUnit = (TimeCtrl_GetIntCnt(tmcRef) + 1) / L2_SLOTS_PER_FRAME;
 	if (nextTimeUnit < instPtr->netStartTime)
 	{
 		DBG_WARNING("Linklayer not start yet, next time unit: %" PRIu32 ", start time unit: %" PRIu32 ".\n",
@@ -1211,19 +1030,19 @@ int32_t Linklayer_Proc(L2_INST *instPtr)
 	// Run Link layer routine, setup next slot procedure.
 	if (L2_GetNodeType(instPtr) == L2_NODE_HEAD)
 	{
-		Phy_SetMode(instPtr->config.phyInstPtr, PHY_MODE_PULL);
+		Phy_SetMode(phyRef, PHY_MODE_PULL);
 		Status = Linklayer_Routine(instPtr);
 	}
 	else
 	{ // L2_NODE_MEMBER
 		if (L2_isCxn2Net(instPtr))
 		{
-			Phy_SetMode(instPtr->config.phyInstPtr, PHY_MODE_PULL);
+			Phy_SetMode(phyRef, PHY_MODE_PULL);
 			Status = Linklayer_Routine(instPtr);
 		}
 		else
 		{
-			Phy_SetMode(instPtr->config.phyInstPtr, PHY_MODE_LISTEN);
+			Phy_SetMode(phyRef, PHY_MODE_LISTEN);
 			Status = L2_Scan_Proc(instPtr);
 		}
 	}
@@ -1241,14 +1060,14 @@ int32_t Linklayer_Proc(L2_INST *instPtr)
 	instPtr->mainState = instPtr->nextState;
 	instPtr->linkLog.tuNum = instPtr->frameNum.curr;
 	instPtr->linkLog.slotNum = (uint8_t)instPtr->slotNum.curr;
-	instPtr->linkLog.nodeType = (instPtr->config.myType == L2_NODE_HEAD) ? 0xAA : 0xCC;
+	instPtr->linkLog.nodeType = (L2_GetNodeType(instPtr) == L2_NODE_HEAD) ? 0xAA : 0xCC;
-	instPtr->linkLog.cxnStatus = (instPtr->cxn2Net) ? 0x11 : 0x00;
+	instPtr->linkLog.cxnStatus = (L2_isCxn2Net(instPtr)) ? 0x11 : 0x00;
 	instPtr->linkLog.linkStage = (instPtr->mainState == L2_INIT_STATE) ? 0x11 : 0x22;
 	instPtr->linkLog.recxnCnt = instPtr->log.reconnectCnt;
 	instPtr->linkLog.beamNo = instPtr->scanFSM->beamNo;
 	instPtr->linkLog.beamWidth = instPtr->log.lastBeamWidth;
-	instPtr->linkLog.beamAz = instPtr->config.phyInstPtr->antNrrwPattern[instPtr->scanFSM->beamNo].oaxis;
+	instPtr->linkLog.beamAz = phyRef->antNrrwPattern[instPtr->scanFSM->beamNo].oaxis;
-	instPtr->linkLog.beamEl = instPtr->config.phyInstPtr->antNrrwPattern[instPtr->scanFSM->beamNo].raxis;
+	instPtr->linkLog.beamEl = phyRef->antNrrwPattern[instPtr->scanFSM->beamNo].raxis;
 	instPtr->linkLog.advTxCnt = (uint16_t)instPtr->log.advTxCnt;
 	instPtr->linkLog.advRecvCnt = (uint16_t)instPtr->log.advRecvCnt;
 	instPtr->linkLog.advCorrectCnt = (uint16_t)instPtr->log.advCorrectCnt;
@@ -1260,9 +1079,210 @@ int32_t Linklayer_Proc(L2_INST *instPtr)
 	instPtr->linkLog.svcCorrectCnt = instPtr->log.svcCorrectCnt;
 	instPtr->linkLog.timeDev = (instPtr->log.timeDev > INT32_MAX)
 								? INT32_MAX : ((instPtr->log.timeDev < INT32_MIN) ? INT32_MIN : (int32_t)instPtr->log.timeDev);
-	instPtr->linkLog.sendId = instPtr->serviceFSM->txLog.dataId;
+	instPtr->linkLog.sendId = instPtr->log.txLog.dataId;
-	instPtr->linkLog.recvId = instPtr->serviceFSM->rxLog.dataId;
+	instPtr->linkLog.recvId = instPtr->log.rxLog.dataId;
 
 	SysMonitor_UpdateLinklayerLog(&(instPtr->linkLog));
 	return SUCCESS;
 }
+
+/*****************************************************************************/
+/**
+ * @brief   Steer antenna beam to specified node.
+ *
+ * @param   instPtr	a pointer to link layer descriptor instance
+ * @param   nodeId		destination node
+ *
+ * @return Corresponding frame length
+ *         L2_FRAME_NONE_LEN if the frame type code cannot be recognized.
+ *
+ ******************************************************************************/
+int32_t L2_SteerBeam2Node(L2_INST *instPtr, uint8_t nodeId)
+{
+	ASSERT(instPtr != NULL);
+	int32_t Status;
+
+	COORD myPos, dstPos, beamDir;
+	Status = L2_GetNodePos(instPtr->nodeList, nodeId, &dstPos);
+	if (Status != SUCCESS)
+	{
+		DBG_ERROR("Failed to retrieve position info of node %" PRIu8 ", remain last configuration.\n", nodeId);
+		return EPARAM;
+	}
+	myPos.x = instPtr->sysInfo.posX;
+	myPos.y = instPtr->sysInfo.posY;
+	myPos.z = instPtr->sysInfo.posZ;
+
+	// TODO Check data format
+	EULERANGLES attitudeEuler, antAttitudeEuler;
+	attitudeEuler.alpha = DEG2RAD(instPtr->sysInfo.pitch);
+	attitudeEuler.beta = DEG2RAD(instPtr->sysInfo.yaw);
+	attitudeEuler.gamma = DEG2RAD(instPtr->sysInfo.roll);
+
+	// FIXME: confirm date source.
+	antAttitudeEuler.alpha = DEG2RAD(0);
+	antAttitudeEuler.beta = DEG2RAD(0);
+	antAttitudeEuler.gamma = DEG2RAD(0);
+
+	// TODO Check data format
+	QUATERNION attitude, antAttitude;
+	attitude = Quaternion_FromeEulerAngles(attitudeEuler, EULERANGLES_XYZ);
+	antAttitude = Quaternion_FromeEulerAngles(antAttitudeEuler, EULERANGLES_XYZ);
+
+	// --- --- Algorithm --- ---
+	// TODO Check result validation
+	// Compute beam direction vector
+	beamDir = Coord_Sub(dstPos, myPos);
+
+	// Compute antenna attitude respect to ECEF
+	antAttitude = Quaternion_Mult(attitude, antAttitude);
+
+	// Convert beam direction vector to antenna coordinate
+	beamDir = Quaternion_Rotate(Quaternion_GeInverse(antAttitude), beamDir);
+	// Normalize
+	Coord_Normalize(&beamDir);
+
+	double oAxis, rAxis;
+	oAxis = RAD2DEG(atan2(beamDir.z, beamDir.y));
+	rAxis = RAD2DEG(acos(Coord_Dot(beamDir, COORD_X_AXIS)));
+	Status = Phy_SetBeamAngle(instPtr->config.phyInstPtr, oAxis, rAxis);
+	return Status;
+}
+
+/*****************************************************************************/
+/**
+ * @brief   Layer 2 setup next slot operation, update current operating frame.
+ *
+ * @param   instPtr		a pointer to linklayer instance
+ * @param   txrxMode	tx/rx state for next slot
+ * @param   frameType	frame type of next slot.
+ *
+ * @return SUCCESS/FAILURE
+ *
+ ******************************************************************************/
+int32_t L2_SetupNextSlot(L2_INST *instPtr, L2_TOR_TYPE txrxMode, L2_FRAME_TYPE frameType)
+{
+	ASSERT(instPtr != NULL);
+	PHY_INST *phyRef = instPtr->config.phyInstPtr;
+	int32_t Status;
+	if (frameType < L2_SCAN_FRAME || frameType > L2_SVC_FRAME)
+	{
+		return FAILURE;
+	}
+
+	// logging
+	if (txrxMode == L2_TOR_TX)
+	{
+		instPtr->log.frameTx++;
+		switch (frameType)
+		{
+		case L2_ADV_FRAME:
+			instPtr->log.advTxCnt++;
+			break;
+		case L2_CFM_FRAME:
+			instPtr->log.cfmTxCnt++;
+			break;
+		case L2_SVC_FRAME:
+			instPtr->log.svcTxCnt++;
+			break;
+		default:
+			break;
+		}
+	}
+	else if (txrxMode == L2_TOR_RX)
+	{
+		instPtr->log.frameRx++;
+		switch (frameType)
+		{
+		case L2_ADV_FRAME:
+			instPtr->log.advRxCnt++;
+			break;
+		case L2_CFM_FRAME:
+			instPtr->log.cfmRxCnt++;
+			break;
+		case L2_SVC_FRAME:
+			instPtr->log.svcRxCnt++;
+			break;
+		default:
+			break;
+		}
+	}
+
+#if _DEBUG_LEVEL >= 3
+	char *torStr = NULL;
+	char *frameStr = NULL;
+	switch (txrxMode)
+	{
+	case L2_TOR_SUSPEND:
+		torStr = "SUSPEND";
+		break;
+	case L2_TOR_TX:
+		torStr = "TX";
+		break;
+	case L2_TOR_RX:
+		torStr = "RX";
+		break;
+	}
+	switch (frameType)
+	{
+	case L2_SCAN_FRAME:
+		frameStr = "Scan";
+		break;
+	case L2_ADV_FRAME:
+		frameStr = "Advertisement";
+		break;
+	case L2_CFM_FRAME:
+		frameStr = "Confirm";
+		break;
+	case L2_SVC_FRAME:
+		frameStr = "Service";
+		break;
+	default:
+		frameStr = "UNKNOWN Frame";
+		break;
+	}
+	DBG_INFO("# Setup Next Slot # [%" PRIu32 "-%" PRIu32 "], %s, %s.\n",
+			 instPtr->frameNum.next,
+			 instPtr->slotNum.next,
+			 torStr, frameStr);
+#endif
+
+	// Update frame and tx/rx mode record.
+	// Frame types shift (last <- curr <- next)
+	L2_RcdShift(&(instPtr->frame), frameType);
+	L2_RcdShift(&(instPtr->tor), txrxMode);
+
+	TIME_WORD pullTime = {0, 0};
+	pullTime.int_part = TimeCtrl_GetIntCnt(instPtr->config.tmcInstPtr) + 1;
+	Status = Phy_SetTimeWord(phyRef, &pullTime, PHY_TIME_WORD_POLL);
+	if (Status != SUCCESS)
+	{
+		DBG_ERROR("Physical set pull time failed, with error code: %" PRId32 "\n", Status);
+	}
+
+	PHY_TOR_TYPE tor;
+	switch (txrxMode)
+	{
+	case L2_TOR_SUSPEND:
+		tor = PHY_TOR_SUSPEND;
+		break;
+	case L2_TOR_TX:
+		tor = PHY_TOR_TX;
+		break;
+	case L2_TOR_RX:
+		tor = PHY_TOR_RX;
+		break;
+	default:
+		DBG_ERROR("Invalid txrx mode :%" PRId8 ".\n", txrxMode);
+		return EPARAM;
+	}
+
+	Status = Phy_SetupNextSlot(phyRef, tor, L2_L2frame2L1frame(frameType), instPtr->sendPktData);
+	if (Status != SUCCESS)
+	{
+		DBG_ERROR("Physical setup failed, with error code: %" PRId32 "\n", Status);
+	}
+	return Status;
+}
+/** @} LinkLayer_Main*/
+/** @} LinkLayer*/

df_datalink_sp/src/networking/link_layer/link_layer.h

@@ -1,19 +1,21 @@
 /*****************************************************************************/
 /**
- * Description: Header file for df linklayer functions
+ * @file link_layer.h
+ * @author FanHao (hao_fan_bit_ee@163.com)
+ * @brief DF Linklayer header file.
+ * @version 0.1
+ * @date 2023-05-06
  *
- * Date: 2021-11-13 13:33
+ * @copyright Copyright(c) 2024 Beijing Institute of Technology.\n
- * LastEditTime: 2022-07-16 10:12
+ * Lab of Communication and Network
- * Revisions: Rev 0.1
- * History:
- * [2022-07-16]: New branch for DiJian.
- * [2021-11-23]: Initial version.
- *
- * Copyright(c) 2021 Beijing Institute of Technology.
- * Lab of Communication and Networking
  *
  ******************************************************************************/
 
+/**
+ * @defgroup LinkLayer
+ * @{
+ */
+
 #ifndef __LINK_LAYER_H_
 #define __LINK_LAYER_H_
 
@@ -27,81 +29,97 @@
 #include "../../system_monitor.h"
 /************************** Constant Definitions *****************************/
 /***************** Macros (Inline Functions) Definitions *********************/
-#define AssertL2Event(instPtr, event) Linklayer_EventHandler(instPtr, event)
+#define AssertL2Event(instPtr, event) (Linklayer_EventHandler((instPtr), (event)))
 /**************************** Type Definitions *******************************/
 
+/**
+ * @struct L2_CONFIG
+ * @brief A struct holds all linklayer initialization parameters
+ */
 typedef struct
 {
-	L2_NODE_TYPE myType;
+	L2_NODE_TYPE myType;  ///< node type
-	bool isInterHead;
+	uint8_t clustId;	  ///< node cluster id
-	uint8_t clustId;
+	uint8_t myId;		  ///< node id
-	uint8_t myId;
+	uint8_t headId;		  ///< head node id
-	uint8_t headId;
+	uint8_t netScale;	  ///< net scale
-	uint8_t bkpHeadId;
+	PHY_INST *phyInstPtr; ///< pointer to system physical layer instance
-	uint8_t netScale;
+	TMC_INST *tmcInstPtr; ///< pointer to system timer controller layer instance
-	PHY_INST *phyInstPtr;
-	TMC_INST *tmcInstPtr;
 } L2_CONFIG;
 
+/**
+ * @struct L2_LOG
+ *  @brief A struct holds linklayer operating log
+ */
 typedef struct
 {
-	uint32_t frameRx;
+	uint32_t frameRx;	   ///< total rx frame count
-	uint32_t frameTx;
+	uint32_t frameTx;	   ///< total tx frame count
-	uint32_t frameRecv;
+	uint32_t frameRecv;	   ///< total received frame count
-	uint32_t frameCorrect;
+	uint32_t frameCorrect; ///< total correctly received frame count
 
-	uint32_t advRxCnt;
+	uint32_t advRxCnt;		///< advertise rx frame count
-	uint32_t advTxCnt;
+	uint32_t advTxCnt;		///< advertise tx frame count
-	uint32_t advRecvCnt;
+	uint32_t advRecvCnt;	///< advertise received frame count
-	uint32_t advCorrectCnt;
+	uint32_t advCorrectCnt; ///< advertise correctly received frame count
 
-	uint32_t cfmRxCnt;
+	uint32_t cfmRxCnt;		///< confirm rx frame count
-	uint32_t cfmTxCnt;
+	uint32_t cfmTxCnt;		///< confirm tx frame count
-	uint32_t cfmRecvCnt;
+	uint32_t cfmRecvCnt;	///< confirm received frame count
-	uint32_t cfmCorrectCnt;
+	uint32_t cfmCorrectCnt; ///< confirm correctly received frame count
 
-	uint32_t svcRxCnt;
+	uint32_t svcRxCnt;		///< service rx frame count
-	uint32_t svcTxCnt;
+	uint32_t svcTxCnt;		///< service tx frame count
-	uint32_t svcRecvCnt;
+	uint32_t svcRecvCnt;	///< service received frame count
-	uint32_t svcCorrectCnt;
+	uint32_t svcCorrectCnt; ///< service correctly received frame count
 
-	int64_t timeDev;
+	int64_t timeDev;	   ///< last time deviation estimation result
-	uint8_t lastBeamWidth;
+	uint8_t lastBeamWidth; ///< last beam width
-	uint32_t reconnectCnt;
+	uint32_t reconnectCnt; ///< reconnect trial count
+
+	PAYLOAD rxLog;
+	PAYLOAD txLog;
 } L2_LOG;
 
+/**
+ * @struct L2_INST
+ * @brief A linklayer instance
+ */
 typedef struct
 {
-	L2_CONFIG config;
+	L2_CONFIG config;			 ///< linklayer configuration parameters
-	L2_NODE_INFO myInfo;
+	L2_NODE_INFO myInfo;		 ///< current node info
-	NODE_LIST *nodeList;
+	NODE_LIST *nodeList;		 ///< discovered node list
-	L2_SCHD_POOL *schdEventPool;
+	L2_SCHD_POOL *schdEventPool; ///< event schedule pool
-	uint32_t netStartTime;
+	uint32_t netStartTime;		 ///< network start time
-	bool isEnable;			   // if the node is connected to the network
+	bool isEnable;				 ///< indicates if the node is connected to the network
-	bool dataAvail;			   // if there is a valid received frame data in rx buffer
+	bool dataAvail;				 ///< indicates if there is a valid received frame data in rx buffer
-	bool cxn2Net;			   // if the node is connected to the network
+	bool cxn2Net;				 ///< indicates if the node is connected to the network
-	L2_RCD frameNum;		   // stores the last current and next frame number.
+	L2_RCD frameNum;			 ///< stores the last current and next frame number.
-	L2_RCD slotNum;			   // stores the last current and next slot number.
+	L2_RCD slotNum;				 ///< stores the last current and next slot number.
-	L2_RCD frame;			   // stores the last current and next link layer frame type.
+	L2_RCD frame;				 ///< stores the last current and next link layer frame type.
-	L2_RCD tor;				   // stores the last current and next link layer tx/rx state.
+	L2_RCD tor;					 ///< stores the last current and next link layer tx/rx state.
-	L2_NODE_STATE mainState;   // the main state of link layer state
+	L2_NODE_STATE mainState;	 ///< the main state of link layer state
-	L2_NODE_STATE nextState;   // next state of link layer state, which will be applied to mainState every second.
+	L2_NODE_STATE nextState;	 ///< next state of link layer state, which will be applied to mainState every second.
-	L2_RTNE_CONFIG rtneConfig; // current routine table configuration and status.
+	L2_RTNE_CONFIG rtneConfig;	 ///< current routine table configuration and status.
-	L2_SCAN_FSM *scanFSM;   // FSM of scan net (link set up)
+	L2_SCAN_FSM *scanFSM;		 ///< FSM of scan net (link set up)
-	L2_SVC_FSM *serviceFSM; // FSM of service net (data service)
+	L2_SVC_FSM *serviceFSM;		 ///< FSM of service net (data service)
-	uint8_t *sendPktData;
+	uint8_t *sendPktData;		 ///< send data buffer
-	uint8_t *recvPktData;
+	uint8_t *recvPktData;		 ///< received data buffer
-	L2_LOG log;
+	L2_LOG log;					 ///< Linklayer operating log
 	// for system log
-	SYSINFO sysInfo;
+	SYSINFO sysInfo; ///< system info
-	LINKLOG linkLog;
+	LINKLOG linkLog; ///< linklayer log for system monitor
 } L2_INST;
 
 /************************** Variable Definitions *****************************/
 extern L2_RTNE_TABLE_ENTRY *initTable[L2_INIT_RTNE_PERIOD];
 extern L2_RTNE_TABLE_ENTRY *normalTable[L2_NORMAL_RTNE_PERIOD];
 /************************** Function Prototypes ******************************/
-// Main
+/**
+ * @defgroup LinkLayer_Main
+ * @{
+ */
 int32_t Linklayer_Init(L2_INST **instPtr, const L2_CONFIG *config);
 int32_t Linklayer_Reconfig(L2_INST *instPtr, const L2_CONFIG *config);
 void Linklayer_Destroy(L2_INST *instPtr);
@@ -112,24 +130,33 @@ int32_t Linklayer_EventHandler(L2_INST *instPtr, const L2_EVENT *l2Event);
 int32_t Linklayer_PktHandler(L2_INST *instPtr, L2_FRAME_TYPE frameType);
 int32_t L2_SteerBeam2Node(L2_INST *instPtr, uint8_t nodeId);
 int32_t L2_SetupNextSlot(L2_INST *instPtr, L2_TOR_TYPE txrxMode, L2_FRAME_TYPE frameType);
-void L2_FrameStateUpdate(L2_INST *instPtr);
+/** @} LinkLayer_Main*/
-L2_FRAME_TYPE L2_GetLastOptFrameType(L2_INST *instPtr);
-L1_FRAME_TYPE L2_L2frame2L1frame(L2_FRAME_TYPE l2Frame);
 
-// Scheduling Event
+/**
+ * @defgroup LinkLayer_Framing
+ * @{
+ */
+void L2_FrameInsertChunk(uint8_t *frame, size_t offset, size_t bytes, const void *chunk);
+void L2_FrameGetChunk(uint8_t *frame, size_t offset, size_t bytes, void *chunk);
+int32_t L2_CrcAppend(uint8_t *dataBuff, uint32_t dataLen, uint32_t crcPos, L2_CRC_TYPE crcType);
+bool L2_CrcCheck(uint8_t *dataBuff, uint32_t dataLen, L2_CRC_TYPE crcType);
+/** @} LinkLayer_Framing*/
+
+/**
+ * @defgroup LinkLayer_Scheduler
+ * @{
+ */
 void L2_EventPoolHandler(L2_INST *instPtr);
 int32_t L2_ScheduleEventAt(L2_INST *instPtr, L2_SCHD_EVENT *schdEvent, uint32_t frameNo, uint32_t slotNo);
 int32_t L2_ScheduleEventAfter(L2_INST *instPtr, L2_SCHD_EVENT *schdEvent, uint32_t numSlots);
 int32_t L2_RescheduleEventAt(L2_INST *instPtr, L2_SCHD_EVENT *schdEvent, uint32_t frameNo, uint32_t slotNo);
 int32_t L2_RescheduleEventAfter(L2_INST *instPtr, L2_SCHD_EVENT *schdEvent, uint32_t numSlots);
+/** @} LinkLayer_Scheduler*/
 
-// Framing
+/**
-void L2_FrameInsertChunk(uint8_t *frame, size_t offset, size_t bytes, const void *chunk);
+ * @defgroup LinkLayer_Scan
-void L2_FrameGetChunk(uint8_t *frame, size_t offset, size_t bytes, void *chunk);
+ * @{
-int32_t L2_CrcAppend(uint8_t *dataBuff, uint32_t dataLen, uint32_t crcPos, L2_CRC_TYPE crcType);
+ */
-bool L2_CrcCheck(uint8_t *dataBuff, uint32_t dataLen, L2_CRC_TYPE crcType);
-
-// Scanning
 int32_t L2_Scan_Init(L2_SCAN_FSM **scanFSMPtr);
 void L2_Scan_RefreashScanTable(L2_INST *instPtr);
 void L2_Scan_Reset(L2_SCAN_FSM *scanFSMPtr);
@@ -137,21 +164,38 @@ void L2_Scan_Destroy(L2_SCAN_FSM *scanFSMPtr);
 int32_t L2_Scan_Proc(L2_INST *instPtr);
 int32_t L2_Scan_PktHandler(L2_INST *instPtr, uint8_t *msg);
 int32_t L2_Scan_Routine(L2_INST *instPtr, const L2_RTNE_TABLE_ENTRY *schedEntry);
+/** @} LinkLayer_Scan*/
 
-// Service
+/**
+ * @defgroup LinkLayer_Service
+ * @{
+ */
 int32_t L2_Service_Init(L2_SVC_FSM **svcFSMPtr);
 void L2_Service_Reset(L2_SVC_FSM *svcFSMPtr);
 void L2_Service_Destroy(L2_SVC_FSM *svcFSMPtr);
 int32_t L2_Service_PktHandler(L2_INST *instPtr, uint8_t *msg);
 int32_t L2_Service_Proc(L2_INST *instPtr);
 int32_t L2_Service_Routine(L2_INST *instPtr, const L2_RTNE_TABLE_ENTRY *schedEntry);
+/** @} LinkLayer_Service*/
 
-// Miscellaneous
+/**
+ * @defgroup LinkLayer_TimeSync
+ * @{
+ */
+int32_t L2_GetTimeDeviation(L2_INST *instPtr, uint32_t frameNum, uint32_t slotNum, bool relative, int64_t *timeDev);
+void L2_TimeAdjust(L2_INST *instPtr, const int64_t *timeDev);
+/** @} LinkLayer_TimeSync*/
+
+/**
+ * @defgroup LinkLayer_Utility
+ * @{
+ */
 uint8_t L2_GetNodeId(L2_INST *instPtr);
 uint8_t L2_GetClusterId(L2_INST *instPtr);
 uint8_t L2_GetHeadId(L2_INST *instPtr);
 L2_NODE_TYPE L2_GetNodeType(L2_INST *instPtr);
 L2_NODE_STATE L2_GetMainState(L2_INST *instPtr);
+bool L2_isStarted(L2_INST *instPtr);
 bool L2_isDataAvail(L2_INST *instPtr);
 bool L2_isCxn2Net(L2_INST *instPtr);
 uint32_t L2_GetFrameLen(L2_FRAME_TYPE l2FrameType);
@@ -167,10 +211,10 @@ uint32_t L2_GetNextFrameNum(L2_INST *instPtr);
 uint32_t L2_GetNextSlotNum(L2_INST *instPtr);
 L2_FRAME_TYPE L2_GetNextFrameType(L2_INST *instPtr);
 L2_TOR_TYPE L2_GetNextTor(L2_INST *instPtr);
-
+L2_FRAME_TYPE L2_GetLastOptFrameType(L2_INST *instPtr);
-// Time syncronization
+L1_FRAME_TYPE L2_L2frame2L1frame(L2_FRAME_TYPE l2Frame);
-int32_t L2_GetTimeDeviation(L2_INST *instPtr, uint32_t frameNum, uint32_t slotNum, bool relative, int64_t* timeDev);
+/** @} LinkLayer_Utility*/
-void L2_TimeAdjust(L2_INST *instPtr, const int64_t *timeDev);
-
 
 #endif /* __LINK_LAYER_H_ */
+
+/** @} LinkLayer*/

df_datalink_sp/src/networking/link_layer/link_layer_types.h

@@ -1,17 +1,19 @@
 /*****************************************************************************/
 /**
- * Description: A brief description of this file
+ * @file link_layer_types.h
+ * @author FanHao (hao_fan_bit_ee@163.com)
+ * @brief DF Linklayer types definition.
+ * @version 0.1
+ * @date 2023-05-06
  *
- * Date: 2022-08-28 22:53
+ * @copyright Copyright(c) 2024 Beijing Institute of Technology.\n
- * LastEditTime: 2022-08-29 00:45
+ * Lab of Communication and Network
- * Revisions: Rev 0.0
- * History:
- * [2022-08-29]: Initial version.
- *
- * Copyright(c) 2022 Beijing Institute of Technology.
- * Lab of Communication and Networking
  *
  ******************************************************************************/
+/**
+ * @defgroup LinkLayer
+ * @{
+ */
 
 #ifndef __LINK_LAYER_DEF_H_
 #define __LINK_LAYER_DEF_H_
@@ -26,6 +28,10 @@
 #include "../config/app_config.h"
 #endif
 /************************** Constant Definitions *****************************/
+/**
+ * @name Linklayer_Common_Constants
+ * @{
+ */
 // Common node ID definition
 #define L2_BROADCAST_ID 0xFF
 #define L2_NONE_ID 0
@@ -39,7 +45,7 @@
 #define L2_FRAMENO_NONE 0
 
 // Common number of slots definition
-#define L2_SLOTS_PER_FRAME 200
+#define L2_SLOTS_PER_FRAME 100
 #define L2_SLOTS_PER_SUBFRAME 20
 
 #define L2_NUM_SLOTS_NONE UINT32_MAX
@@ -48,9 +54,14 @@
 #define L2_NUM_SLOTS_10MS 2
 #define L2_NUM_SLOTS_5MS 1
 #define L2_NUM_SLOTS_SKIP 0
+/** @} Linklayer_Common_Constants*/
 
 /**************************** Type Definitions *******************************/
 
+/**
+ * @struct L2_RCD
+ * @brief Linklayer recode buffer
+ */
 typedef struct
 {
 	uint32_t last;
@@ -58,7 +69,8 @@ typedef struct
 	uint32_t next;
 } L2_RCD;
 
-/** @name Tx/Rx mode code
+/**
+ * @enum L2_TOR_TYPE
  */
 typedef enum
 {
@@ -67,7 +79,8 @@ typedef enum
 	L2_TOR_RX = 2
 } L2_TOR_TYPE;
 
-/** @name Prior information type definition
+/**
+ * @enum L2_NODE_TYPE
  */
 typedef enum
 {
@@ -77,7 +90,8 @@ typedef enum
 	L2_NODE_BACKUP = 3
 } L2_NODE_TYPE;
 
-/** @name Node state type definition
+/**
+ * @enum L2_NODE_STATE
  */
 typedef enum
 {
@@ -89,23 +103,24 @@ typedef enum
 	L2_SEEK_STATE = 5
 } L2_NODE_STATE;
 
-/** @name Node information type definition
+/**
- * The following types define the detail node info which needed by the link layer.
+ * @struct L2_NODE_INFO
+ * @brief Node information struct contains the detail node info which needed by the link layer.
  */
 typedef struct
 {
-	uint8_t nodeId;
+	uint8_t nodeId;		   ///< node ID
-	uint8_t clustId;
+	uint8_t clustId;	   ///< node cluster ID
-	uint8_t headId;
+	uint8_t headId;		   ///< cluster head ID
-	L2_NODE_TYPE nodeType;
+	L2_NODE_TYPE nodeType; ///< node type
-	uint8_t beamNo;
+	uint8_t beamNo;		   ///< beam number to this node
-	COORD pos;
+	COORD pos;			   ///< node position
-	COORD speed;
+	COORD speed;		   ///< node speed
-	QUATERNION attitude;
+	QUATERNION attitude;   ///< node attitude
 } L2_NODE_INFO;
 
-/** @name L2 event enum
+/**
- * A enum of L2 event types.
+ * @enum L2_EVENT_TYPE
  */
 typedef enum
 {
@@ -123,17 +138,18 @@ typedef enum
 	L2_ROUTINE_UPDATE = 11
 } L2_EVENT_TYPE;
 
-/** @name L2 event
+/**
- * A definition of L2 event instance.
+ * @struct L2_EVENT
+ * @brief Linklayer event instance
  */
 typedef struct
 {
-	L2_EVENT_TYPE event;
+	L2_EVENT_TYPE event; ///< event type
-	void *msg;
+	void *msg;			 ///< event message (MUST be a heap item)
 } L2_EVENT;
 
-/** @name Slot types
+/**
- * A definition of different slots.
+ * @enum L2_SLOT_TYPE
  */
 typedef enum
 {
@@ -145,8 +161,8 @@ typedef enum
 	L2_SLOT_SERVICE = 5,
 } L2_SLOT_TYPE;
 
-/** @name Frame types
+/**
- * A definition of different frame types.
+ * @enum L2_FRAME_TYPE
  */
 typedef enum
 {
@@ -157,8 +173,8 @@ typedef enum
 	L2_SVC_FRAME = 4
 } L2_FRAME_TYPE;
 
-/** @name Frame types
+/**
- * A definition of different frame types.
+ * @enum L2_CRC_TYPE
  */
 typedef enum
 {
@@ -168,17 +184,21 @@ typedef enum
 	L2_CRC8_31 = 3
 } L2_CRC_TYPE;
 
-/** @name Schedule subtable entry
+/**
- * A definition of Schedule subtable entry.
+ * @struct L2_RTNE_TABLE_ENTRY
+ * @brief Linklayer routine table entry
  */
 typedef struct
 {
-	L2_SLOT_TYPE slotType : 8;
+	L2_SLOT_TYPE slotType : 8; ///< slot type
-	uint8_t slotSeq;
+	uint8_t slotSeq;		   ///< slot sequence number
-	uint8_t src;
+	uint8_t src;			   ///< source node ID
-	uint8_t dst;
+	uint8_t dst;			   ///< destination node ID
 } L2_RTNE_TABLE_ENTRY;
 
+/**
+ * @enum SCAN_STAGE
+ */
 typedef enum
 {
 	L2_SCAN_NONE_STAGE = 0,
@@ -187,47 +207,56 @@ typedef enum
 	L2_SCAN_CFM_STAGE = 3
 } SCAN_STAGE;
 
-/** @name Scan procedure FSM
+/**
+ * @struct L2_SCAN_FSM
+ * @brief Linklayer scan process FSM instance
  */
 typedef struct
 {
-	bool isLocked;	// init acq done.
+	bool isLocked;		  ///< indicates if init acq done(beam locked).
-	bool isAdvRecvd; // bm received.
+	bool isAdvRecvd;	  ///< indicates if advertisement frame done(beam locked).
-	bool isAckPending;	// 2way acq done.
+	bool isAckPending;	  ///< indicates if confirm message acked
-	uint8_t scanCnt;
+	uint8_t scanCnt;	  ///< scan count
-	uint8_t advTimeout;
+	uint8_t advTimeout;	  ///< adv receive try count
-	uint8_t cfmTimeout;
+	uint8_t cfmTimeout;	  ///< cmf receive try count
-	SCAN_STAGE scanStage;  // only for member node
+	SCAN_STAGE scanStage; ///< scan stage \n
-	uint8_t beamNo;
+						  /// only for member node
-	uint8_t tableNo;
+	uint8_t beamNo;		  ///< locked beam number
+	uint8_t tableNo;	  ///< scan table index
 } L2_SCAN_FSM;
 
-
+/**
-/** @name Service procedure FSM
+ * @struct L2_SVC_FSM
+ * @brief Linklayer service process FSM
  */
 typedef struct
 {
-	PAYLOAD rxLog;
+	uint32_t txCnt;	 ///< tx frame count
-	PAYLOAD txLog;
+	uint32_t rxCnt;	 ///< rx frame count
-	uint32_t pktRecv;
+	uint32_t rxdCnt; ///< received frame count
-	uint32_t pktCorrect;
 #ifdef DATALINK_ENABLE_BERTEST
-	uint32_t bitTotal;
+	uint32_t bitTotal; ///< received bits count
-	uint32_t bitError;
+	uint32_t bitError; ///< error bits count
-	double lossRate;
+	double lossRate;   ///< packet loss rate
-	double errorRate;
+	double errorRate;  ///< bit error rate
 #endif
 } L2_SVC_FSM;
 
+/**
+ * @struct L2_RTNE_CONFIG
+ * @brief Linklayer routine table configuration
+ */
 typedef struct
 {
-	L2_RTNE_TABLE_ENTRY **rtneTable;
+	L2_RTNE_TABLE_ENTRY **rtneTable; ///< routine table
-	uint32_t rtnePrd;
+	uint32_t rtnePrd;				 ///< period of routine table
-	L2_RTNE_TABLE_ENTRY *last;
+	L2_RTNE_TABLE_ENTRY *last;		 ///< last routine entry
-	L2_RTNE_TABLE_ENTRY *curr;
+	L2_RTNE_TABLE_ENTRY *curr;		 ///< curent routine entry
-	L2_RTNE_TABLE_ENTRY *next;
+	L2_RTNE_TABLE_ENTRY *next;		 ///< next routine entry
 } L2_RTNE_CONFIG;
 
 /************************** Variable Definitions *****************************/
 
 #endif /* __LINK_LAYER_DEF_H_ */
+
+/** @} LinkLayer*/

df_datalink_sp/src/networking/link_layer/msg_def.h

@@ -1,17 +1,25 @@
 /*****************************************************************************/
 /**
- * Description: Header of 814 linklayer messages
+ * @file msg_def.c
+ * @author FanHao (hao_fan_bit_ee@163.com)
+ * @brief DF Linklayer message definition constants.
+ * @version 0.0
+ * @date 2023-05-06
  *
- * Date: 2022-07-14 00:08
+ * @copyright Copyright(c) 2024 Beijing Institute of Technology.\n
- * LastEditTime: 2022-07-14 22:52
+ * Lab of Communication and Network
- * Revisions: Rev 0.0
- * History:
- * [2022-07-14]: Initial version.
- *
- * Copyright(c) 2021 Beijing Institute of Technology.
- * Lab of Communication and Networking
  *
  ******************************************************************************/
+
+/**
+ * @addtogroup LinkLayer
+ * @{
+ */
+
+/**
+ * @name LinkLayer_MSG_Constants
+ * @{
+ */
 #ifndef __L2_MSG_DEF_H_
 #define __L2_MSG_DEF_H_
 
@@ -115,5 +123,8 @@
 #define L2_MSG_SVC_CRC 266
 #define L2_MSG_SVC_CRC_LEN 2
 
-
 #endif //__L2_MSG_DEF_H_
+
+/** @} LinkLayer_MSG_Constants*/
+
+/** @} LinkLayer*/

df_datalink_sp/src/networking/link_layer/node_list.c

@@ -1,19 +1,25 @@
 /*****************************************************************************/
 /**
- * Description: Implementations of 814 linklayer local record.
+ * @file node_list.c
+ * @author FanHao (hao_fan_bit_ee@163.com)
+ * @brief DF Linklayer node list implementation file
+ * @version 0.0
+ * @date 2023-05-06
  *
- * Date: 2022-07-14 00:08
+ * @copyright Copyright(c) 2024 Beijing Institute of Technology.\n
- * LastEditors: Fan Hao
+ * Lab of Communication and Network
- * LastEditTime: 2022-07-14 22:52
- * Revisions: Rev 0.0
- * History:
- * [2022-07-14]: Initial version.
- *
- * Copyright(c) 2021 Beijing Institute of Technology.
- * Lab of Communication and Networking
  *
  ******************************************************************************/
 
+/**
+ * @addtogroup LinkLayer
+ * @{
+ */
+
+/**
+ * @addtogroup LinkLayer_NodeList
+ * @{
+ */
 /***************************** Include Files *********************************/
 #include <stdlib.h>
 #include <string.h>
@@ -26,6 +32,10 @@
 #include "error.h"
 
 /***************** Macros (Inline Functions) Definitions *********************/
+/**
+ * @brief Get the node list length
+ * @param list pointer to node list
+ */
 inline uint32_t L2_GetNodeListLen(NODE_LIST *list)
 {
 	ASSERT(list != NULL);
@@ -34,7 +44,7 @@ inline uint32_t L2_GetNodeListLen(NODE_LIST *list)
 /**************************** Type Definitions *******************************/
 
 /************************** Variable Definitions *****************************/
-static NODE_ENTRY util_entry;
+static NODE_ENTRY util_entry = { 0 };
 /************************** Function Prototypes ******************************/
 /**
  * @brief	helper function to free node entry.
@@ -94,7 +104,7 @@ int32_t L2_NodeList_Init(NODE_LIST **list)
  * @brief   Clear all nodes in the node list, free allocated memory.
  *
  * @param   list
- *NONE
+ * @return NONE
  *
  ******************************************************************************/
 void L2_NodeList_Clear(NODE_LIST *list)
@@ -123,7 +133,7 @@ void L2_NodeList_Destroy(NODE_LIST *list)
  * @param   list
  * @param   nodeId
  *
- * @return  Node entry
+ * @return  Node entry \n
  *          NULL if node dose not exist.
  *
  ******************************************************************************/
@@ -154,7 +164,7 @@ NODE_ENTRY *L2_GetNodeById(NODE_LIST *list, uint8_t nodeId)
  * @param   nodeId
  * @param   nodeType
  *
- * @return  SUCCESS Node was added successfully.
+ * @return  SUCCESS Node was added successfully.\n
  *          Other       Error occurred.(Node already exist, memory alloc error ect.)
  *
  ******************************************************************************/
@@ -201,7 +211,7 @@ NODE_ENTRY *L2_AppendNode(NODE_LIST *list, uint8_t nodeId, L2_NODE_TYPE nodeType
  * @param   list
  * @param   nodeId
  *
- * @return  SUCCESS Node has been successfully deleted.
+ * @return  SUCCESS Node has been successfully deleted.\n
  *          Other       Node not exist.
  *
  ******************************************************************************/
@@ -227,7 +237,7 @@ int32_t L2_DeleteNodeById(NODE_LIST *list, uint8_t nodeId)
  * @param   list
  * @param   nodeId
  *
- * @return  true node in the list
+ * @return  true node in the list\n
  *          false node not in the list
  *
  ******************************************************************************/
@@ -245,7 +255,7 @@ bool L2_isNodeInList(NODE_LIST *list, uint8_t nodeId)
  * @param   nodeId
  * @param	dst     A pointer to store distance.
  *
- * @return  SUCCESS distance has been successfully store in dst
+ * @return  SUCCESS distance has been successfully store in dst\n
  *          FAILURE Node dose not exit.
  *
  ******************************************************************************/
@@ -273,7 +283,7 @@ int32_t L2_GetDistance(NODE_LIST *list, COORD myCoord, uint8_t nodeId, double *d
  * @param   nodeId
  * @param   newPos A structure stores the corresponding node position info.
  *
- * @return  SUCCESS update successfully.
+ * @return  SUCCESS update successfully.\n
  *          FAILURE node not exist.
  *
  ******************************************************************************/
@@ -300,7 +310,7 @@ int32_t L2_UpdateNodePos(NODE_LIST *list, uint8_t nodeId, const COORD *newPos)
  * @param   nodeId
  * @param   newPos A structure stores the corresponding node position info.
  *
- * @return  SUCCESS update successfully.
+ * @return  SUCCESS update successfully.\n
  *          FAILURE node not exist.
  *
  ******************************************************************************/
@@ -327,7 +337,7 @@ int32_t L2_GetNodePos(NODE_LIST *list, uint8_t nodeId, COORD *pos)
  * @param   nodeId
  * @param   newSpeed A structure stores the corresponding node speed info.
  *
- * @return  SUCCESS update successfully.
+ * @return  SUCCESS update successfully.\n
  *          FAILURE node not exist.
  *
  ******************************************************************************/
@@ -354,7 +364,7 @@ int32_t L2_UpdateNodeSpeed(NODE_LIST *list, uint8_t nodeId, const COORD *newSpee
  * @param   nodeId
  * @param   newSpeed A structure stores the corresponding node speed info.
  *
- * @return  SUCCESS update successfully.
+ * @return  SUCCESS update successfully.\n
  *          FAILURE node not exist.
  *
  ******************************************************************************/
@@ -380,7 +390,7 @@ int32_t L2_GetNodeSpeed(NODE_LIST *list, uint8_t nodeId, COORD *speed)
  * @param   nodeId
  * @param   devi
  *
- * @return  SUCCESS update successfully.
+ * @return  SUCCESS update successfully.\n
  *          FAILURE Node not exist.
  *
  ******************************************************************************/
@@ -432,7 +442,7 @@ int32_t L2_IncNodeTTL(NODE_LIST *list, uint8_t nodeId, uint32_t inc)
  * @param   list
  * @param   nodeId
  *
- * @return  SUCCESS TTL has been successfully cleared.
+ * @return  SUCCESS TTL has been successfully cleared.\n
  *          FAILURE Node not exist.
  *
  ******************************************************************************/
@@ -486,7 +496,7 @@ int32_t L2_GetNodeTTL(NODE_LIST *list, uint8_t nodeId, uint32_t *ttl)
  * @param   operation  A pointer to a function handled "NODE_ENTRY*" as input
  *                  which defines the operations need to be apply.
  *
- * @return SUCCESS Operations has been applied successfully to all nodes.
+ * @return SUCCESS Operations has been applied successfully to all nodes.\n
  *         Other       Error occurred.
  *
  ******************************************************************************/
@@ -545,3 +555,7 @@ int32_t L2_IterDeleteNode(NODE_LIST *list, bool (*condition)(NODE_ENTRY *))
 	clist_iterator_destroy(iter);
 	return SUCCESS;
 }
+
+/** @} LinkLayer_NodeList*/
+
+/** @} LinkLayer*/

df_datalink_sp/src/networking/link_layer/node_list.h

@@ -1,19 +1,27 @@
 /*****************************************************************************/
 /**
- * Description: Header of 814 linklayer local record.
+ * @file node_list.h
+ * @author FanHao (hao_fan_bit_ee@163.com)
+ * @brief DF Linklayer node list header file
+ * @version 0.0
+ * @date 2023-05-06
  *
- * Date: 2022-07-14 00:08
+ * @copyright Copyright(c) 2024 Beijing Institute of Technology.\n
- * LastEditors: Fan Hao
+ * Lab of Communication and Network
- * LastEditTime: 2022-07-14 22:52
- * Revisions: Rev 0.0
- * History:
- * [2022-07-14]: Initial version.
- *
- * Copyright(c) 2021 Beijing Institute of Technology.
- * Lab of Communication and Networking
  *
  ******************************************************************************/
 
+/**
+ * @addtogroup LinkLayer
+ * @{
+ */
+
+/**
+ * @defgroup LinkLayer_NodeList
+ * @{
+ */
+
+
 /***************************** Include Files *********************************/
 #ifndef NODE_LIST_H_
 #define NODE_LIST_H_
@@ -29,7 +37,11 @@
 /************************** Constant Definitions *****************************/
 /***************** Macros (Inline Functions) Definitions *********************/
 /**************************** Type Definitions *******************************/
-typedef struct NODE_LIST_ENTRY
+/**
+ * @struct NODE_ENTRY
+ * @brief Linklayer discovered node list node entry
+ */
+typedef struct
 {
 	L2_NODE_INFO nodeInfo;
 	uint32_t ttlCnt;
@@ -62,3 +74,6 @@ int32_t L2_IterEditNode(NODE_LIST *list, const void *param, int32_t (*operation)
 int32_t L2_IterDeleteNode(NODE_LIST *list, bool (*condition)(NODE_ENTRY *));
 
 #endif /* NODE_LIST_H_ */
+
+/** @} LinkLayer_NodeList*/
+/** @} LinkLayer*/

df_datalink_sp/src/networking/link_layer/routine_table.c

@@ -1,467 +1,30 @@
 /*****************************************************************************/
 /**
- * Description: Time allocations for df datalink,
+ * @file routine_table.c
- * Date: 2022-07-16 17:05
+ * @author FanHao (hao_fan_bit_ee@163.com)
- * LastEditTime: 2022-07-16 17:05
+ * @brief DF Linklayer node list implementation file
- * Revisions: Rev 0.1
+ * @version 0.0
- * History:
+ * @date 2023-05-06
- * [2021-11-13]: Initial version.
  *
- * Copyright(c) 2021 Beijing Institute of Technology.
+ * @copyright Copyright(c) 2024 Beijing Institute of Technology.\n
- * Lab of Communication and Networking
+ * Lab of Communication and Network
  *
  ******************************************************************************/
 
+/**
+ * @addtogroup LinkLayer
+ * @{
+ */
+
+/**
+ * @name RoutineTable
+ * @{
+ */
+
 #include <inttypes.h>
 #include "link_layer.h"
 #include "link_layer_types.h"
 
-#define LINKLAYER_INSERT_EXTRGAP
-
-#ifndef LINKLAYER_INSERT_EXTRGAP
-L2_RTNE_TABLE_ENTRY intraScanSubT[L2_SLOTS_PER_FRAME] = {
-// SubFrame 0
-	{L2_SLOT_SCAN, 0x00, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x01, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x00, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x01, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x00, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x01, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x00, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x01, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x00, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x01, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x00, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x01, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x00, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x01, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x00, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x01, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x00, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x01, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x00, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x01, 0x01, 0xFF},
-
-// SubFrame 1
-	{L2_SLOT_SCAN, 0x00, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x01, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x00, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x01, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x00, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x01, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x00, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x01, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x00, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x01, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x00, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x01, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x00, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x01, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x00, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x01, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x00, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x01, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x00, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x01, 0x01, 0xFF},
-
-// SubFrame 2
-	{L2_SLOT_SCAN, 0x00, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x01, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x00, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x01, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x00, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x01, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x00, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x01, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x00, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x01, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x00, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x01, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x00, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x01, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x00, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x01, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x00, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x01, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x00, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x01, 0x01, 0xFF},
-
-// SubFrame 3
-	{L2_SLOT_SCAN, 0x00, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x01, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x00, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x01, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x00, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x01, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x00, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x01, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x00, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x01, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x00, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x01, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x00, 0x01, 0xFF},
-	{L2_SLOT_SCAN, 0x01, 0x01, 0xFF},
-	{L2_SLOT_ADVERTISE, 0x00, 0x01, 0xFF},
-	{L2_SLOT_ADVERTISE, 0x01, 0x01, 0xFF},
-	{L2_SLOT_ADVERTISE, 0x02, 0x01, 0xFF},
-	{L2_SLOT_ADVERTISE, 0x03, 0x01, 0xFF},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-// SubFrame 4
-	{L2_SLOT_CONFIRM, 0x00, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x01, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x02, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x03, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x00, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x01, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x02, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x03, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x00, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x01, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x02, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x03, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x00, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x01, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x02, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x03, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x00, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x01, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x02, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x03, 0x01, 0xFF},
-
-// SubFrame 5
-	{L2_SLOT_CONFIRM, 0x00, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x01, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x02, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x03, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x00, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x01, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x02, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x03, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x00, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x01, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x02, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x03, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x00, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x01, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x02, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x03, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x00, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x01, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x02, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x03, 0x01, 0xFF},
-
-// SubFrame 6
-	{L2_SLOT_CONFIRM, 0x00, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x01, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x02, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x03, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x00, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x01, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x02, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x03, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x00, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x01, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x02, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x03, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x00, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x01, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x02, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x03, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x00, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x01, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x02, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x03, 0xFF, 0x01},
-
-// SubFrame 7
-	{L2_SLOT_CONFIRM, 0x00, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x01, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x02, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x03, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x00, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x01, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x02, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x03, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x00, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x01, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x02, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x03, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x00, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x01, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x02, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x03, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x00, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x01, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x02, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x03, 0xFF, 0x01},
-
-// SubFrame 8
-	{L2_SLOT_CONFIRM, 0x00, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x01, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x02, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x03, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x00, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x01, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x02, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x03, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x00, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x01, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x02, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x03, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x00, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x01, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x02, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x03, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x00, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x01, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x02, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x03, 0x01, 0xFF},
-
-// SubFrame 9
-	{L2_SLOT_CONFIRM, 0x00, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x01, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x02, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x03, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x00, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x01, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x02, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x03, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x00, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x01, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x02, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x03, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x00, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x01, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x02, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x03, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x00, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x01, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x02, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x03, 0x01, 0xFF},
-};
-
-L2_RTNE_TABLE_ENTRY normalSub[L2_SLOTS_PER_FRAME] = {
-// SubFrame 0
-	{L2_SLOT_SERVICE, 0x00, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x01, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x02, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x03, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x00, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x01, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x02, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x03, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x00, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x01, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x02, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x03, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x00, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x01, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x02, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x03, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x00, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x01, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x02, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x03, 0x01, 0x02},
-
-// SubFrame 1
-	{L2_SLOT_SERVICE, 0x00, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x01, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x02, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x03, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x00, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x01, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x02, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x03, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x00, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x01, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x02, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x03, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x00, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x01, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x02, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x03, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x00, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x01, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x02, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x03, 0x02, 0x01},
-
-// SubFrame 2
-	{L2_SLOT_SERVICE, 0x00, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x01, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x02, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x03, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x00, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x01, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x02, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x03, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x00, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x01, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x02, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x03, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x00, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x01, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x02, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x03, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x00, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x01, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x02, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x03, 0x01, 0x02},
-
-// SubFrame 3
-	{L2_SLOT_SERVICE, 0x00, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x01, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x02, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x03, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x00, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x01, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x02, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x03, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x00, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x01, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x02, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x03, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x00, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x01, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x02, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x03, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x00, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x01, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x02, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x03, 0x02, 0x01},
-
-// SubFrame 4
-	{L2_SLOT_SERVICE, 0x00, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x01, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x02, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x03, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x00, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x01, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x02, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x03, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x00, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x01, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x02, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x03, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x00, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x01, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x02, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x03, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x00, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x01, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x02, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x03, 0x01, 0x02},
-
-// SubFrame 5
-	{L2_SLOT_SERVICE, 0x00, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x01, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x02, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x03, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x00, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x01, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x02, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x03, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x00, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x01, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x02, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x03, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x00, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x01, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x02, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x03, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x00, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x01, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x02, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x03, 0x02, 0x01},
-
-// SubFrame 6
-	{L2_SLOT_SERVICE, 0x00, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x01, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x02, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x03, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x00, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x01, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x02, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x03, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x00, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x01, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x02, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x03, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x00, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x01, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x02, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x03, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x00, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x01, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x02, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x03, 0x01, 0x02},
-
-// SubFrame 7
-	{L2_SLOT_SERVICE, 0x00, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x01, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x02, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x03, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x00, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x01, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x02, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x03, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x00, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x01, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x02, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x03, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x00, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x01, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x02, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x03, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x00, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x01, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x02, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x03, 0x02, 0x01},
-
-// SubFrame 8
-	{L2_SLOT_SERVICE, 0x00, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x01, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x02, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x03, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x00, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x01, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x02, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x03, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x00, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x01, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x02, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x03, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x00, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x01, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x02, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x03, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x00, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x01, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x02, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x03, 0x01, 0x02},
-
-// SubFrame 9
-	{L2_SLOT_SERVICE, 0x00, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x01, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x02, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x03, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x00, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x01, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x02, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x03, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x00, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x01, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x02, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x03, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x00, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x01, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x02, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x03, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x00, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x01, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x02, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x03, 0x02, 0x01},
-};
-#else
 L2_RTNE_TABLE_ENTRY intraScanSubT[L2_SLOTS_PER_FRAME] = {
 // SubFrame 0
 	{L2_SLOT_SCAN, 0x00, 0x01, 0xFF},
@@ -572,116 +135,6 @@ L2_RTNE_TABLE_ENTRY intraScanSubT[L2_SLOTS_PER_FRAME] = {
 	{L2_SLOT_CONFIRM, 0x02, 0xFF, 0x01},
 	{L2_SLOT_CONFIRM, 0x03, 0xFF, 0x01},
 	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-
-// SubFrame 5
-	{L2_SLOT_CONFIRM, 0x00, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x01, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x02, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x03, 0x01, 0xFF},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-	{L2_SLOT_CONFIRM, 0x00, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x01, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x02, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x03, 0x01, 0xFF},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-	{L2_SLOT_CONFIRM, 0x00, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x01, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x02, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x03, 0xFF, 0x01},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-	{L2_SLOT_CONFIRM, 0x00, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x01, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x02, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x03, 0xFF, 0x01},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-
-// SubFrame 6
-	{L2_SLOT_CONFIRM, 0x00, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x01, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x02, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x03, 0x01, 0xFF},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-	{L2_SLOT_CONFIRM, 0x00, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x01, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x02, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x03, 0x01, 0xFF},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-	{L2_SLOT_CONFIRM, 0x00, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x01, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x02, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x03, 0xFF, 0x01},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-	{L2_SLOT_CONFIRM, 0x00, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x01, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x02, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x03, 0xFF, 0x01},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-
-// SubFrame 7
-	{L2_SLOT_CONFIRM, 0x00, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x01, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x02, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x03, 0x01, 0xFF},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-	{L2_SLOT_CONFIRM, 0x00, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x01, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x02, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x03, 0x01, 0xFF},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-	{L2_SLOT_CONFIRM, 0x00, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x01, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x02, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x03, 0xFF, 0x01},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-	{L2_SLOT_CONFIRM, 0x00, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x01, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x02, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x03, 0xFF, 0x01},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-
-// SubFrame 8
-	{L2_SLOT_CONFIRM, 0x00, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x01, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x02, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x03, 0x01, 0xFF},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-	{L2_SLOT_CONFIRM, 0x00, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x01, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x02, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x03, 0x01, 0xFF},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-	{L2_SLOT_CONFIRM, 0x00, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x01, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x02, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x03, 0xFF, 0x01},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-	{L2_SLOT_CONFIRM, 0x00, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x01, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x02, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x03, 0xFF, 0x01},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-
-// SubFrame 9
-	{L2_SLOT_CONFIRM, 0x00, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x01, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x02, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x03, 0x01, 0xFF},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-	{L2_SLOT_CONFIRM, 0x00, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x01, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x02, 0x01, 0xFF},
-	{L2_SLOT_CONFIRM, 0x03, 0x01, 0xFF},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-	{L2_SLOT_CONFIRM, 0x00, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x01, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x02, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x03, 0xFF, 0x01},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-	{L2_SLOT_CONFIRM, 0x00, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x01, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x02, 0xFF, 0x01},
-	{L2_SLOT_CONFIRM, 0x03, 0xFF, 0x01},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
 };
 
 L2_RTNE_TABLE_ENTRY normalSub[L2_SLOTS_PER_FRAME] = {
@@ -794,118 +247,7 @@ L2_RTNE_TABLE_ENTRY normalSub[L2_SLOTS_PER_FRAME] = {
 	{L2_SLOT_SERVICE, 0x02, 0x02, 0x01},
 	{L2_SLOT_SERVICE, 0x03, 0x02, 0x01},
 	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-
-// SubFrame 5
-	{L2_SLOT_SERVICE, 0x00, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x01, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x02, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x03, 0x01, 0x02},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-	{L2_SLOT_SERVICE, 0x00, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x01, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x02, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x03, 0x02, 0x01},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-	{L2_SLOT_SERVICE, 0x00, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x01, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x02, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x03, 0x01, 0x02},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-	{L2_SLOT_SERVICE, 0x00, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x01, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x02, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x03, 0x02, 0x01},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-
-// SubFrame 6
-	{L2_SLOT_SERVICE, 0x00, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x01, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x02, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x03, 0x01, 0x02},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-	{L2_SLOT_SERVICE, 0x00, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x01, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x02, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x03, 0x02, 0x01},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-	{L2_SLOT_SERVICE, 0x00, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x01, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x02, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x03, 0x01, 0x02},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-	{L2_SLOT_SERVICE, 0x00, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x01, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x02, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x03, 0x02, 0x01},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-
-// SubFrame 7
-	{L2_SLOT_SERVICE, 0x00, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x01, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x02, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x03, 0x01, 0x02},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-	{L2_SLOT_SERVICE, 0x00, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x01, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x02, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x03, 0x02, 0x01},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-	{L2_SLOT_SERVICE, 0x00, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x01, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x02, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x03, 0x01, 0x02},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-	{L2_SLOT_SERVICE, 0x00, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x01, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x02, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x03, 0x02, 0x01},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-
-// SubFrame 8
-	{L2_SLOT_SERVICE, 0x00, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x01, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x02, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x03, 0x01, 0x02},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-	{L2_SLOT_SERVICE, 0x00, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x01, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x02, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x03, 0x02, 0x01},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-	{L2_SLOT_SERVICE, 0x00, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x01, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x02, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x03, 0x01, 0x02},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-	{L2_SLOT_SERVICE, 0x00, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x01, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x02, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x03, 0x02, 0x01},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-
-// SubFrame 9
-	{L2_SLOT_SERVICE, 0x00, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x01, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x02, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x03, 0x01, 0x02},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-	{L2_SLOT_SERVICE, 0x00, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x01, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x02, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x03, 0x02, 0x01},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-	{L2_SLOT_SERVICE, 0x00, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x01, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x02, 0x01, 0x02},
-	{L2_SLOT_SERVICE, 0x03, 0x01, 0x02},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
-	{L2_SLOT_SERVICE, 0x00, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x01, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x02, 0x02, 0x01},
-	{L2_SLOT_SERVICE, 0x03, 0x02, 0x01},
-	{L2_SLOT_IDLE, 0x00, 0x00, 0x00},
 };
-#endif
 
 L2_RTNE_TABLE_ENTRY *initTable[L2_INIT_RTNE_PERIOD] =
 {
@@ -916,3 +258,6 @@ L2_RTNE_TABLE_ENTRY *normalTable[L2_NORMAL_RTNE_PERIOD] =
 {
 	normalSub
 };
+
+/** @} RoutineTable*/
+/** @} LinkLayer*/

df_datalink_sp/src/networking/link_layer/scan.c

@@ -1,18 +1,24 @@
 /*****************************************************************************/
 /**
- * Description: Implementations of df linklayer scan net.
+ * @file scan.c
+ * @author FanHao (hao_fan_bit_ee@163.com)
+ * @brief DF Linklayer scan implementation file.
+ * @version 0.1
+ * @date 2023-05-06
  *
- * Date: 2021-11-10 19:04
+ * @copyright Copyright(c) 2024 Beijing Institute of Technology.\n
- * LastEditTime: 2022-07-16 17:04
+ * Lab of Communication and Network
- * Revisions: Rev 0.1
- * History:
- * [2022-07-16]: New branch for DiJian.
- * [2021-11-10]: Initial version.
- *
- * Copyright(c) 2021 Beijing Institute of Technology.
- * Lab of Communication and Networking
  *
  ******************************************************************************/
+/**
+ * @addtogroup LinkLayer
+ * @{
+ */
+
+/**
+ * @addtogroup LinkLayer_Scan
+ * @{
+ */
 
 /***************************** Include Files *********************************/
 #include <string.h>
@@ -26,7 +32,7 @@
 
 /************************** Constant Definitions *****************************/
 #define ADV_LISTEN_TIMEOUT 40
-#define CFM_LISTEN_TIMEOUT 25
+#define CFM_LISTEN_TIMEOUT 5
 #define ADV_FRAME_SLOTS 4
 #define CFM_FRAME_SLOTS 5
 /***************** Macros (In-line Functions) Definitions *********************/
@@ -176,7 +182,7 @@ static void PendCfmAck(L2_SCAN_FSM *scanFsmPtr)
  ******************************************************************************/
 static void StageUpdate(L2_SCAN_FSM *scanFsmPtr, SCAN_STAGE newStage)
 {
-	ASSERT(newStage >= L2_SCAN_NONE_STAGE && newStage <= L2_SCAN_CFM_STAGE);
+	ASSERT((newStage >= L2_SCAN_NONE_STAGE) && (newStage <= L2_SCAN_CFM_STAGE));
 	DBG_INFO("ScanNet current stage: %" PRIu8 " -> ScanNet new stage: %" PRIu8 " \n",
 			 scanFsmPtr->scanStage, newStage);
 	scanFsmPtr->scanStage = newStage;
@@ -198,36 +204,39 @@ static int32_t Scan_InitScanHandler(L2_INST *instPtr)
 	L2_SCAN_FSM *scanFsmPtr = instPtr->scanFSM;
 	DBG_INFO("** Net-Setup - InitScan Procedure (Attempts: %" PRIu8 ")**\n", scanFsmPtr->scanCnt);
 
-	if(scanFsmPtr->scanCnt == 0)
+	if (scanFsmPtr->scanCnt == 0)
 	{
 		// Update scan beam table
 		L2_Scan_RefreashScanTable(instPtr);
 	}
-	else if(Phy_IsFrameDetected(phyRef))
+	else if (Phy_IsFrameDetected(phyRef))
 	{
 		// last scan beam number
-		instPtr->scanFSM->beamNo = Phy_LastScanBeamNo(instPtr->config.phyInstPtr);
+		scanFsmPtr->beamNo = Phy_LastScanBeamNo(phyRef);
 		// Update scan beam table
 		L2_Scan_RefreashScanTable(instPtr);
 	}
 
 	if (scanFsmPtr->isLocked == true)
 	{
-		StageUpdate(scanFsmPtr, L2_SCAN_ADV_STAGE);
+		scanFsmPtr->beamNo = Phy_LastScanBeamNo(phyRef);
-		/* Antenna setting (reserved.) */
+		Phy_SetBeamNo(phyRef, scanFsmPtr->beamNo, PHY_ANT_BEAM_16);
 		L2_SetupNextSlot(instPtr, L2_TOR_RX, L2_ADV_FRAME);
+		StageUpdate(scanFsmPtr, L2_SCAN_ADV_STAGE);
+		instPtr->log.lastBeamWidth = PHY_ANT_BEAM_16;
 	} /* Otherwise remain L2_SCAN_INIT_STAGE */
 	else
 	{
-		/* Antenna setting (reserved.) */
+		/* Antenna steering (reserved, automatically accomplished by physical layer) */
+		Phy_SetBeamNo(phyRef, scanFsmPtr->beamNo, PHY_ANT_BEAM_16);
 		L2_SetupNextSlot(instPtr, L2_TOR_RX, L2_SCAN_FRAME);
 		scanFsmPtr->scanCnt++;
+		instPtr->log.lastBeamWidth = PHY_ANT_BEAM_16;
 	}
 	return SUCCESS;
 }
 
 /*****************************************************************************/
-
 /**
  * @brief   Member node scan net BmAdvt stage handler.
  *
@@ -239,19 +248,36 @@ static int32_t Scan_InitScanHandler(L2_INST *instPtr)
  ******************************************************************************/
 static int32_t Scan_AdvHandler(L2_INST *instPtr)
 {
+	ASSERT(instPtr != NULL);
 	L2_SCAN_FSM *scanFsmPtr = instPtr->scanFSM;
+	PHY_INST *phyRef = instPtr->config.phyInstPtr;
+	TMC_INST *tmcRef = instPtr->config.tmcInstPtr;
 	DBG_INFO("** Net-Setup - Advertisement Procedure (Timeout: %" PRIu8 ") **\n", scanFsmPtr->advTimeout);
 
 	// if received a valid bm frame.
 	if (scanFsmPtr->isAdvRecvd == true)
 	{
 		// last scan beam number
-		instPtr->scanFSM->beamNo = Phy_LastScanBeamNo(instPtr->config.phyInstPtr);
+		scanFsmPtr->beamNo = Phy_LastScanBeamNo(phyRef);
+		// reset listen counter.
+		scanFsmPtr->advTimeout = 0;
 
-		scanFsmPtr->advTimeout = 0; /* reset listen counter. */
+		// Update scan stage
-		DBG_INFO("Received Adv frame, skipping 10ms for turn around...\n");
-		// TODO: check functionality.
 		StageUpdate(scanFsmPtr, L2_SCAN_CFM_STAGE);
+
+		// start a confirm frame reception if in the target slot
+		if ((TimeCtrl_GetIntCnt(tmcRef) + 1) % CFM_FRAME_SLOTS == 0)
+		{
+			// using pull mode to receive confirm frame
+			// since first time sync procedure is accomplished in ADV stage.
+			(void)Phy_SetBeamWidth(phyRef, PHY_ANT_BEAM_16);
+			(void)Phy_SetBeamNo(phyRef, scanFsmPtr->beamNo, PHY_ANT_BEAM_16);
+			(void)Phy_SetMode(phyRef, PHY_MODE_PULL);
+			(void)L2_SetupNextSlot(instPtr, L2_TOR_RX, L2_CFM_FRAME);
+			scanFsmPtr->cfmTimeout++; // increase counter.
+			instPtr->log.lastBeamWidth = PHY_ANT_BEAM_16;
+		}
+		// otherwise skip...
 		return SUCCESS;
 	}
 	// no valid bm frame was received.
@@ -260,16 +286,20 @@ static int32_t Scan_AdvHandler(L2_INST *instPtr)
 		/* if time out reached, go back to init scan stage. */
 		if (scanFsmPtr->advTimeout > ADV_LISTEN_TIMEOUT)
 		{
-			/* Antenna setting (reserved.) */
+			/* Antenna steering (reserved, automatically accomplished by physical layer) */
-			L2_SetupNextSlot(instPtr, L2_TOR_RX, L2_SCAN_FRAME);
+			(void)Phy_SetBeamNo(phyRef, scanFsmPtr->beamNo, PHY_ANT_BEAM_16);
+			(void)L2_SetupNextSlot(instPtr, L2_TOR_RX, L2_SCAN_FRAME);
 			DBG_WARNING("Adv timeout, restart net scan from L2_SCAN_INIT_STAGE.\n");
-			L2_Scan_Reset(scanFsmPtr);
+			(void)L2_Scan_Reset(scanFsmPtr);
+			instPtr->log.lastBeamWidth = PHY_ANT_BEAM_16;
 		}
 		else
 		{
-			/* Antenna setting (reserved.) */
+			/* Antenna steering (reserved, automatically accomplished by physical layer) */
-			L2_SetupNextSlot(instPtr, L2_TOR_RX, L2_ADV_FRAME);
+			(void)Phy_SetBeamNo(phyRef, scanFsmPtr->beamNo, PHY_ANT_BEAM_16);
+			(void)L2_SetupNextSlot(instPtr, L2_TOR_RX, L2_ADV_FRAME);
 			scanFsmPtr->advTimeout++;
+			instPtr->log.lastBeamWidth = PHY_ANT_BEAM_16;
 		}
 		return SUCCESS;
 	}
@@ -286,7 +316,9 @@ static int32_t Scan_AdvHandler(L2_INST *instPtr)
  ******************************************************************************/
 static int32_t Scan_CfmHandler(L2_INST *instPtr)
 {
+	ASSERT(instPtr != NULL);
 	L2_SCAN_FSM *scanFsmPtr = instPtr->scanFSM;
+	PHY_INST *phyRef = instPtr->config.phyInstPtr;
 	DBG_INFO("** Net-Setup - Confirm Procedure (Timeout: %" PRIu8 ") **\n", scanFsmPtr->cfmTimeout);
 
 	// 2 way acq failed, back to init stage.
@@ -300,10 +332,10 @@ static int32_t Scan_CfmHandler(L2_INST *instPtr)
 	{
 		// using pull mode to receive confirm frame
 		// since first time sync procedure is accomplished in ADV stage.
-		Phy_SetBeamWidth(instPtr->config.phyInstPtr, PHY_ANT_BEAM_16);
+		(void)Phy_SetBeamWidth(phyRef, PHY_ANT_BEAM_16);
-		Phy_SetBeamNo(instPtr->config.phyInstPtr, scanFsmPtr->beamNo, PHY_ANT_BEAM_16);
+		(void)Phy_SetBeamNo(phyRef, scanFsmPtr->beamNo, PHY_ANT_BEAM_16);
-		Phy_SetMode(instPtr->config.phyInstPtr, PHY_MODE_PULL);
+		(void)Phy_SetMode(phyRef, PHY_MODE_PULL);
-		L2_SetupNextSlot(instPtr, L2_TOR_RX, L2_CFM_FRAME);
+		(void)L2_SetupNextSlot(instPtr, L2_TOR_RX, L2_CFM_FRAME);
 		scanFsmPtr->cfmTimeout++; // increase counter.
 		instPtr->log.lastBeamWidth = PHY_ANT_BEAM_16;
 	}
@@ -327,12 +359,13 @@ static int32_t ScanMsg_Packing(L2_INST *instPtr, L2_FRAME_TYPE type, uint8_t dst
 	int32_t Status;
 	uint32_t dataChunk;
 	uint8_t *buff = instPtr->sendPktData;
-	if(type < L2_ADV_FRAME || type > L2_CFM_FRAME)
+	if ((type < L2_ADV_FRAME) || (type > L2_CFM_FRAME))
 	{
 		DBG_ERROR("Unexpected frame type: %" PRId8 ".\n", type);
 		return EPARAM;
 	}
 
+	// Common section of link layer package
 	dataChunk = L2_GetNextFrameNum(instPtr);
 	L2_FrameInsertChunk(buff, L2_MSG_FRAME_NUM, L2_MSG_FRAME_NUM_LEN, &dataChunk);
 	dataChunk = L2_GetNextSlotNum(instPtr);
@@ -382,7 +415,7 @@ static int32_t ScanMsg_Packing(L2_INST *instPtr, L2_FRAME_TYPE type, uint8_t dst
 
 		// Packing extra payload
 		uint32_t dataId;
-		if(L2_GetNodeType(instPtr) == L2_NODE_HEAD)
+		if (L2_GetNodeType(instPtr) == L2_NODE_HEAD)
 		{
 			SysMonitor_GetSendPayload(buff + L2_MSG_CFM_PAYLOAD, &dataId, PAYLOAD_LEN_FLJ_TX);
 		}
@@ -404,6 +437,10 @@ static int32_t ScanMsg_Packing(L2_INST *instPtr, L2_FRAME_TYPE type, uint8_t dst
 			DBG_ERROR("Fail to append CRC, error code: %" PRId32 ".\n", Status);
 			return Status;
 		}
+
+		// Logging...
+		memcpy(instPtr->log.txLog.data, buff, L2_CMF_PACK_LEN);
+		instPtr->log.txLog.dataId = dataId;
 		break;
 	}
 	default:
@@ -415,6 +452,208 @@ static int32_t ScanMsg_Packing(L2_INST *instPtr, L2_FRAME_TYPE type, uint8_t dst
 	return SUCCESS;
 }
 
+/*****************************************************************************/
+/**
+ * @brief   Scan net packet handler.
+ *
+ * @param   instPtr	a pointer to linklayer layer instance
+ * @param   msg A pointer to frame data buffer.
+ *
+ * @return
+ *
+ ******************************************************************************/
+int32_t L2_Scan_PktHandler(L2_INST *instPtr, uint8_t *msg)
+{
+	ASSERT(instPtr != NULL);
+	ASSERT(msg != NULL);
+	int32_t Status;
+	L2_SCAN_FSM *scanFsmPtr = instPtr->scanFSM;
+	L2_FRAME_TYPE frameType = L2_NONE_FRAME;
+	L2_FrameGetChunk(msg, L2_MSG_TYPE, L2_MSG_TYPE_LEN, &frameType);
+	switch (frameType)
+	{
+	case L2_SCAN_FRAME:
+	case L2_ADV_FRAME:
+	{
+		if (L2_GetLastOptFrameType(instPtr) == L2_SCAN_FRAME)
+		{
+			LockStateUpdate(scanFsmPtr, true);
+			StageUpdate(scanFsmPtr, L2_SCAN_ADV_STAGE);
+		}
+		if (L2_GetNodeType(instPtr) == L2_NODE_HEAD)
+		{
+			DBG_ERROR("Unexpected call from head node, only member Node can handle L2_SCAN_FRAME and L2_ADV_FRAME.\n");
+			Status = EUNEXP;
+			break;
+		}
+		uint8_t nodeId;
+		L2_FrameGetChunk(msg, L2_MSG_SRC_ID, L2_MSG_SRC_ID_LEN, &nodeId);
+		NODE_ENTRY *node;
+		node = L2_GetNodeById(instPtr->nodeList, nodeId);
+		if (node == NULL)
+		{
+			node = L2_AppendNode(instPtr->nodeList, nodeId, L2_NODE_MEMBER);
+			if (node == NULL)
+			{
+				DBG_ERROR("Failed to append new node [id: %" PRId8 "]", nodeId);
+				Status = ENOMEM;
+				break;
+			}
+		}
+		// Update node info.
+		float nodePos;
+		L2_FrameGetChunk(msg, L2_MSG_ADV_SRC_POSX, L2_MSG_ADV_SRC_POSX_LEN, &nodePos);
+		node->nodeInfo.pos.x = (double)nodePos;
+		L2_FrameGetChunk(msg, L2_MSG_ADV_SRC_POSY, L2_MSG_ADV_SRC_POSY_LEN, &nodePos);
+		node->nodeInfo.pos.y = (double)nodePos;
+		L2_FrameGetChunk(msg, L2_MSG_ADV_SRC_POSZ, L2_MSG_ADV_SRC_POSZ_LEN, &nodePos);
+		node->nodeInfo.pos.z = (double)nodePos;
+		node->nodeInfo.beamNo = Phy_LastScanBeamNo(instPtr->config.phyInstPtr);
+
+		// Reset node ttl
+		node->ttlCnt = 0;
+
+		uint32_t netstartTime;
+		// Update net start time.
+		L2_FrameGetChunk(msg, L2_MSG_ADV_SRC_NETSTART_TIME, L2_MSG_ADV_SRC_NETSTART_TIME_LEN, &netstartTime);
+		L2_EVENT netSetupDoneEvent = {
+			.event = L2_EV_NET_ADV_UPDATE,
+			.msg = &netstartTime};
+		AssertL2Event(instPtr, &netSetupDoneEvent);
+
+		// Calculate time deviation
+		uint32_t frameNum, slotNum = 0;
+		L2_FrameGetChunk(msg, L2_MSG_FRAME_NUM, L2_MSG_FRAME_NUM_LEN, &frameNum);
+		L2_FrameGetChunk(msg, L2_MSG_SLOT_NUM, L2_MSG_SLOT_NUM_LEN, &slotNum);
+		Status = L2_GetTimeDeviation(instPtr, frameNum, slotNum, true, &(instPtr->log.timeDev));
+		if (Status != SUCCESS)
+		{
+			DBG_ERROR("Failed to compute time deviation.\n")
+			break;
+		}
+
+		// Time sync.
+		L2_TimeAdjust(instPtr, &(instPtr->log.timeDev));
+
+		// trigger flag
+		AdvRecvStateUpdate(scanFsmPtr, true);
+		Status = SUCCESS;
+		break;
+	}
+	case L2_CFM_FRAME:
+	{
+		uint8_t nodeId;
+		L2_FrameGetChunk(msg, L2_MSG_SRC_ID, L2_MSG_SRC_ID_LEN, &nodeId);
+		NODE_ENTRY *node;
+		node = L2_GetNodeById(instPtr->nodeList, nodeId);
+		if (node == NULL)
+		{
+			node = L2_AppendNode(instPtr->nodeList, nodeId, L2_NODE_MEMBER);
+			if (node == NULL)
+			{
+				DBG_ERROR("Failed to append new node [id: %" PRId8 "]", nodeId);
+				Status = ENOMEM;
+				break;
+			}
+		}
+		// Update node info.
+		float nodePos;
+		L2_FrameGetChunk(msg, L2_MSG_CFM_SRC_POSX, L2_MSG_CFM_SRC_POSX_LEN, &nodePos);
+		node->nodeInfo.pos.x = (double)nodePos;
+		L2_FrameGetChunk(msg, L2_MSG_CFM_SRC_POSY, L2_MSG_CFM_SRC_POSY_LEN, &nodePos);
+		node->nodeInfo.pos.y = (double)nodePos;
+		L2_FrameGetChunk(msg, L2_MSG_CFM_SRC_POSZ, L2_MSG_CFM_SRC_POSZ_LEN, &nodePos);
+		node->nodeInfo.pos.z = (double)nodePos;
+		float nodeSpeed;
+		L2_FrameGetChunk(msg, L2_MSG_CFM_SRC_SPEEDX, L2_MSG_CFM_SRC_SPEEDX_LEN, &nodeSpeed);
+		node->nodeInfo.speed.x = (double)nodePos;
+		L2_FrameGetChunk(msg, L2_MSG_CFM_SRC_SPEEDY, L2_MSG_CFM_SRC_SPEEDY_LEN, &nodeSpeed);
+		node->nodeInfo.speed.y = (double)nodePos;
+		L2_FrameGetChunk(msg, L2_MSG_CFM_SRC_SPEEDZ, L2_MSG_CFM_SRC_SPEEDZ_LEN, &nodeSpeed);
+		node->nodeInfo.speed.z = (double)nodePos;
+
+		// Reset node ttl
+		node->ttlCnt = 0;
+
+		// Calculate time deviation
+		uint32_t frameNum, slotNum = 0;
+		L2_FrameGetChunk(msg, L2_MSG_FRAME_NUM, L2_MSG_FRAME_NUM_LEN, &frameNum);
+		L2_FrameGetChunk(msg, L2_MSG_SLOT_NUM, L2_MSG_SLOT_NUM_LEN, &slotNum);
+		Status = L2_GetTimeDeviation(instPtr, frameNum, slotNum, true, &(instPtr->log.timeDev));
+		if (Status != SUCCESS)
+		{
+			DBG_ERROR("Failed to compute time deviation.\n")
+			break;
+		}
+
+		if (L2_GetNodeType(instPtr) != L2_NODE_HEAD)
+		{
+			// check if net setup finished.
+			if (L2_isCxn2Net(instPtr) == false)
+			{
+				// Assert Net-Setup Done.
+				L2_EVENT l2Event;
+				l2Event.event = L2_EV_NET_SETUP_DONE;
+				l2Event.msg = NULL;
+				AssertL2Event(instPtr, &l2Event);
+
+				// Assert update routine event...
+				L2_RTNE_CONFIG newRtneConfig = {0};
+				L2_EVENT rtneUpEvent =
+					{
+						.event = L2_ROUTINE_UPDATE,
+						.msg = &newRtneConfig
+					};
+				newRtneConfig.rtneTable = initTable;
+				newRtneConfig.rtnePrd = ARRAY_SIZE(initTable);
+				(void)AssertL2Event(instPtr, &rtneUpEvent);
+			}
+			PendCfmAck(instPtr->scanFSM);
+			// Time sync.
+			L2_TimeAdjust(instPtr, &(instPtr->log.timeDev));
+		}
+		else
+		{
+			if (L2_GetMainState(instPtr) == L2_INIT_STATE
+				&& L2_GetNodeListLen(instPtr->nodeList) >= instPtr->config.netScale - 1)
+			{
+				// Assert Net-Setup Done.
+				L2_EVENT l2Event;
+				L2_NODE_STATE newState = L2_NORMAL_STATE;
+				l2Event.event = L2_EV_MAIN_STATE_UPDATE;
+				l2Event.msg = &newState;
+				(void)AssertL2Event(instPtr, &l2Event);
+			}
+		}
+
+		// Get data payload
+		uint32_t dataId;
+		L2_FrameGetChunk(msg, L2_MSG_CFM_PAYLOAD_ID, L2_MSG_CFM_PAYLOAD_ID_LEN, &dataId);
+
+		if (L2_GetNodeType(instPtr) == L2_NODE_HEAD)
+		{
+			SysMonitor_UpdateRecvPayload(msg + L2_MSG_CFM_PAYLOAD, dataId, PAYLOAD_LEN_FLJ_RX);
+		}
+		else
+		{
+			SysMonitor_UpdateRecvPayload(msg + L2_MSG_CFM_PAYLOAD, dataId, PAYLOAD_LEN_LJ_RX);
+		}
+
+		// Logging...
+		memcpy(instPtr->log.rxLog.data, msg, L2_CMF_PACK_LEN);
+		instPtr->log.rxLog.dataId = dataId;
+
+		Status = SUCCESS;
+		break;
+	}
+	default:
+		DBG_ERROR("Unsupported frame type: %" PRId8 ".\n", frameType);
+		Status = EUNEXP;
+		break;
+	}
+	return Status;
+}
+
 /*****************************************************************************/
 /**
  * @brief   Initialize scan FSM.
@@ -500,204 +739,6 @@ void L2_Scan_RefreashScanTable(L2_INST *instPtr)
 	}
 }
 
-/*****************************************************************************/
-/**
- * @brief   Scan net packet handler.
- *
- * @param   instPtr	a pointer to linklayer layer instance
- * @param   msg A pointer to frame data buffer.
- *
- * @return
- *
- ******************************************************************************/
-int32_t L2_Scan_PktHandler(L2_INST *instPtr, uint8_t *msg)
-{
-	ASSERT(instPtr != NULL);
-	ASSERT(msg != NULL);
-	int32_t Status;
-	L2_SCAN_FSM *scanFsmPtr = instPtr->scanFSM;
-	L2_FRAME_TYPE frameType = L2_GetLastOptFrameType(instPtr);
-	switch (frameType)
-	{
-	case L2_SCAN_FRAME:
-		LockStateUpdate(scanFsmPtr, true);
-		StageUpdate(scanFsmPtr, L2_SCAN_ADV_STAGE);
-	case L2_ADV_FRAME:
-	{
-		if (instPtr->config.myType == L2_NODE_HEAD)
-		{
-			DBG_ERROR("Unexpected call from head node, only member Node can handle L2_SCAN_FRAME and L2_ADV_FRAME.\n");
-			Status = EUNEXP;
-			break;
-		}
-		uint8_t nodeId;
-		L2_FrameGetChunk(msg, L2_MSG_SRC_ID, L2_MSG_SRC_ID_LEN, &nodeId);
-		NODE_ENTRY *node;
-		node = L2_GetNodeById(instPtr->nodeList, nodeId);
-		if (node == NULL)
-		{
-			node = L2_AppendNode(instPtr->nodeList, nodeId, L2_NODE_MEMBER);
-			if(node == NULL)
-			{
-				DBG_ERROR("Failed to append new node [id: %" PRId8 "]", nodeId);
-				Status = ENOMEM;
-				break;
-			}
-		}
-		// Update node info.
-		float nodePos;
-		L2_FrameGetChunk(msg, L2_MSG_ADV_SRC_POSX, L2_MSG_ADV_SRC_POSX_LEN, &nodePos);
-		node->nodeInfo.pos.x = (double) nodePos;
-		L2_FrameGetChunk(msg, L2_MSG_ADV_SRC_POSY, L2_MSG_ADV_SRC_POSY_LEN, &nodePos);
-		node->nodeInfo.pos.y = (double) nodePos;
-		L2_FrameGetChunk(msg, L2_MSG_ADV_SRC_POSZ, L2_MSG_ADV_SRC_POSZ_LEN, &nodePos);
-		node->nodeInfo.pos.z = (double) nodePos;
-		node->nodeInfo.beamNo = Phy_LastScanBeamNo(instPtr->config.phyInstPtr);
-
-		// Reset node ttl
-		node->ttlCnt = 0;
-
-		uint32_t netstartTime;
-		// Update net start time.
-		L2_FrameGetChunk(msg, L2_MSG_ADV_SRC_NETSTART_TIME, L2_MSG_ADV_SRC_NETSTART_TIME_LEN, &netstartTime);
-		L2_EVENT netSetupDoneEvent = {
-			.event = L2_EV_NET_ADV_UPDATE,
-			.msg = &netstartTime};
-		AssertL2Event(instPtr, &netSetupDoneEvent);
-
-		// Calculate time deviation
-		uint32_t frameNum, slotNum = 0;
-		L2_FrameGetChunk(msg, L2_MSG_FRAME_NUM, L2_MSG_FRAME_NUM_LEN, &frameNum);
-		L2_FrameGetChunk(msg, L2_MSG_SLOT_NUM, L2_MSG_SLOT_NUM_LEN, &slotNum);
-		Status = L2_GetTimeDeviation(instPtr, frameNum, slotNum, true, &(instPtr->log.timeDev));
-		if (Status != SUCCESS)
-		{
-			DBG_ERROR("Failed to compute time deviation.\n")
-			break;
-		}
-
-		// Time sync.
-		L2_TimeAdjust(instPtr, &(instPtr->log.timeDev));
-
-		// trigger flag
-		AdvRecvStateUpdate(scanFsmPtr, true);
-		Status = SUCCESS;
-		break;
-	}
-	case L2_CFM_FRAME:
-	{
-		uint8_t nodeId;
-		L2_FrameGetChunk(msg, L2_MSG_SRC_ID, L2_MSG_SRC_ID_LEN, &nodeId);
-		NODE_ENTRY *node;
-		node = L2_GetNodeById(instPtr->nodeList, nodeId);
-		if (node == NULL)
-		{
-			node = L2_AppendNode(instPtr->nodeList, nodeId, L2_NODE_MEMBER);
-			if(node == NULL)
-			{
-				DBG_ERROR("Failed to append new node [id: %" PRId8 "]", nodeId);
-				Status = ENOMEM;
-				break;
-			}
-		}
-		// Update node info.
-		float nodePos;
-		L2_FrameGetChunk(msg, L2_MSG_CFM_SRC_POSX, L2_MSG_CFM_SRC_POSX_LEN, &nodePos);
-		node->nodeInfo.pos.x = (double) nodePos;
-		L2_FrameGetChunk(msg, L2_MSG_CFM_SRC_POSY, L2_MSG_CFM_SRC_POSY_LEN, &nodePos);
-		node->nodeInfo.pos.y = (double) nodePos;
-		L2_FrameGetChunk(msg, L2_MSG_CFM_SRC_POSZ, L2_MSG_CFM_SRC_POSZ_LEN, &nodePos);
-		node->nodeInfo.pos.z = (double) nodePos;
-		float nodeSpeed;
-		L2_FrameGetChunk(msg, L2_MSG_CFM_SRC_SPEEDX, L2_MSG_CFM_SRC_SPEEDX_LEN, &nodeSpeed);
-		node->nodeInfo.speed.x = (double) nodePos;
-		L2_FrameGetChunk(msg, L2_MSG_CFM_SRC_SPEEDY, L2_MSG_CFM_SRC_SPEEDY_LEN, &nodeSpeed);
-		node->nodeInfo.speed.y = (double) nodePos;
-		L2_FrameGetChunk(msg, L2_MSG_CFM_SRC_SPEEDZ, L2_MSG_CFM_SRC_SPEEDZ_LEN, &nodeSpeed);
-		node->nodeInfo.speed.z = (double) nodePos;
-
-		// Reset node ttl
-		node->ttlCnt = 0;
-
-		// Calculate time deviation
-		uint32_t frameNum, slotNum = 0;
-		L2_FrameGetChunk(msg, L2_MSG_FRAME_NUM, L2_MSG_FRAME_NUM_LEN, &frameNum);
-		L2_FrameGetChunk(msg, L2_MSG_SLOT_NUM, L2_MSG_SLOT_NUM_LEN, &slotNum);
-		Status = L2_GetTimeDeviation(instPtr, frameNum, slotNum, true, &(instPtr->log.timeDev));
-		if (Status != SUCCESS)
-		{
-			DBG_ERROR("Failed to compute time deviation.\n")
-			break;
-		}
-
-		if (L2_GetNodeType(instPtr) != L2_NODE_HEAD)
-		{
-			// check if net setup finished.
-			if (L2_isCxn2Net(instPtr) == false)
-			{
-				// Assert Net-Setup Done.
-				L2_EVENT l2Event;
-				l2Event.event = L2_EV_NET_SETUP_DONE;
-				l2Event.msg = NULL;
-				AssertL2Event(instPtr, &l2Event);
-
-				// Assert update routine event...
-				L2_RTNE_CONFIG newRtneConfig = {0};
-				L2_EVENT rtneUpEvent =
-				{
-					.event = L2_ROUTINE_UPDATE,
-					.msg = &newRtneConfig
-				};
-				newRtneConfig.rtneTable = initTable;
-				newRtneConfig.rtnePrd = ARRAY_SIZE(initTable);
-				AssertL2Event(instPtr, &rtneUpEvent);
-			}
-			PendCfmAck(instPtr->scanFSM);
-		}
-		else
-		{
-			if (L2_GetMainState(instPtr) == L2_INIT_STATE
-				&& L2_GetNodeListLen(instPtr->nodeList) >= instPtr->config.netScale - 1)
-			{
-				// Assert Net-Setup Done.
-				L2_EVENT l2Event;
-				L2_NODE_STATE newState = L2_NORMAL_STATE;
-				l2Event.event = L2_EV_MAIN_STATE_UPDATE;
-				l2Event.msg = &newState;
-				AssertL2Event(instPtr, &l2Event);
-			}
-			// Time sync.
-			L2_TimeAdjust(instPtr, &(instPtr->log.timeDev));
-		}
-
-		// Get data payload
-		uint32_t dataId;
-		L2_FrameGetChunk(msg, L2_MSG_CFM_PAYLOAD_ID, L2_MSG_CFM_PAYLOAD_ID_LEN, &dataId);
-
-		if(dataId != DATA_ID_NONE)
-		{
-			if(L2_GetNodeType(instPtr) == L2_NODE_HEAD)
-			{
-				SysMonitor_UpdateRecvPayload(msg+L2_MSG_CFM_PAYLOAD, PAYLOAD_LEN_FLJ_RX);
-			}
-			else
-			{
-				SysMonitor_UpdateRecvPayload(msg+L2_MSG_CFM_PAYLOAD, PAYLOAD_LEN_LJ_RX);
-			}
-		}
-
-		Status = SUCCESS;
-		break;
-	}
-	default:
-		DBG_ERROR("Unsupported frame type: %" PRId8 ".\n", frameType);
-		Status = EUNEXP;
-		break;
-	}
-	return Status;
-}
-
-
 /*****************************************************************************/
 /**
  * @brief   Execute a member node scan net procedure.
@@ -755,8 +796,8 @@ int32_t L2_Scan_Routine(L2_INST *instPtr, const L2_RTNE_TABLE_ENTRY *rtneEntry)
 {
 	ASSERT(instPtr != NULL);
 	L2_TOR_TYPE torState;
-	int32_t Status;
+	const NODE_ENTRY *commNode;
-	const NODE_ENTRY* commNode;
+	PHY_INST *phyRef = instPtr->config.phyInstPtr;
 	DBG_INFO("-------- Scan Routine --------\n");
 
 	if (rtneEntry->slotSeq != 0)
@@ -782,11 +823,11 @@ int32_t L2_Scan_Routine(L2_INST *instPtr, const L2_RTNE_TABLE_ENTRY *rtneEntry)
 		}
 
 		// Setup antenna beam
-		Phy_SetBeamWidth(instPtr->config.phyInstPtr, PHY_ANT_BEAM_16);
+		Phy_SetBeamWidth(phyRef, PHY_ANT_BEAM_16);
 		instPtr->log.lastBeamWidth = PHY_ANT_BEAM_16;
 		if (commNode != NULL)
 		{
-			Phy_SetBeamNo(instPtr->config.phyInstPtr, commNode->nodeInfo.beamNo, PHY_ANT_BEAM_16);
+			(void)Phy_SetBeamNo(phyRef, commNode->nodeInfo.beamNo, PHY_ANT_BEAM_16);
 		}
 	}
 	else
@@ -804,7 +845,7 @@ int32_t L2_Scan_Routine(L2_INST *instPtr, const L2_RTNE_TABLE_ENTRY *rtneEntry)
 			torState = L2_TOR_SUSPEND;
 		}
 		// Setup antenna beam
-		Phy_SetBeamWidth(instPtr->config.phyInstPtr, PHY_ANT_BEAM_120);
+		(void)Phy_SetBeamWidth(phyRef, PHY_ANT_BEAM_120);
 		instPtr->log.lastBeamWidth = PHY_ANT_BEAM_120;
 	}
 
@@ -814,10 +855,9 @@ int32_t L2_Scan_Routine(L2_INST *instPtr, const L2_RTNE_TABLE_ENTRY *rtneEntry)
 		if (L2_GetNodeType(instPtr) != L2_NODE_HEAD && torState == L2_TOR_TX)
 		{
 			DBG_ERROR("Only head node can send init-scan Frame.\n");
-			Status = FAILURE;
+			return FAILURE;
-			goto routine_err;
 		}
-		L2_SetupNextSlot(instPtr, torState, L2_SCAN_FRAME);
+		(void)L2_SetupNextSlot(instPtr, torState, L2_SCAN_FRAME);
 		break;
 
 	case L2_SLOT_ADVERTISE:
@@ -826,18 +866,16 @@ int32_t L2_Scan_Routine(L2_INST *instPtr, const L2_RTNE_TABLE_ENTRY *rtneEntry)
 			if (L2_GetNodeType(instPtr) != L2_NODE_HEAD)
 			{
 				DBG_ERROR("Only head node can send ADV Frame.\n");
-				Status = FAILURE;
+				return FAILURE;
-				goto routine_err;
 			}
 			memset(instPtr->sendPktData, 0xAA, L2_PACK_LEN_MAX);
 			if (ScanMsg_Packing(instPtr, L2_ADV_FRAME, rtneEntry->dst) != SUCCESS)
 			{
-				Status = FAILURE;
+				return FAILURE;
-				goto routine_err;
 			}
 		}
 		/* Antenna setting (reserved.) */
-		L2_SetupNextSlot(instPtr, torState, L2_ADV_FRAME);
+		(void)L2_SetupNextSlot(instPtr, torState, L2_ADV_FRAME);
 		break;
 
 	case L2_SLOT_CONFIRM:
@@ -854,19 +892,18 @@ int32_t L2_Scan_Routine(L2_INST *instPtr, const L2_RTNE_TABLE_ENTRY *rtneEntry)
 			memset(instPtr->sendPktData, 0xAA, L2_PACK_LEN_MAX);
 			if (ScanMsg_Packing(instPtr, L2_CFM_FRAME, rtneEntry->dst) != SUCCESS)
 			{
-				Status = FAILURE;
+				return FAILURE;
-				goto routine_err;
 			}
 		}
 		/* Antenna setting (reserved.) */
-		L2_SetupNextSlot(instPtr, torState, L2_CFM_FRAME);
+		(void)L2_SetupNextSlot(instPtr, torState, L2_CFM_FRAME);
 		break;
 	default:
 		DBG_ERROR("Cannot start a routine for slot type [%" PRId8 "] properly.\n", rtneEntry->slotType);
-		Status = FAILURE;
+		return FAILURE;
-		goto routine_err;
 	}
 	return SUCCESS;
-routine_err:
-	return Status;
 }
+
+/** @} LinkLayer_Scan*/
+/** @} LinkLayer*/

df_datalink_sp/src/networking/link_layer/schdevent.c

@@ -1,19 +1,24 @@
 /*****************************************************************************/
 /**
- * Description: Event scheduling implementation
+ * @file schdevent.c
+ * @author FanHao (hao_fan_bit_ee@163.com)
+ * @brief DF Linklayer Event scheduling implementation file.
+ * @version 0.1
+ * @date 2023-05-06
  *
- * Date: 2023-12-21 13:32
+ * @copyright Copyright(c) 2024 Beijing Institute of Technology.\n
- * LastEditors: Fan Hao
+ * Lab of Communication and Network
- * LastEditTime: 2023-12-21 13:32
- * Revisions: Rev 0.0
- * History:
- * [2023-12-21]: Initial version.
- *
- * Copyright(c) 2021 Beijing Institute of Technology.
- * Lab of Communication and Networking
  *
  ******************************************************************************/
+/**
+ * @addtogroup LinkLayer
+ * @{
+ */
 
+/**
+ * @addtogroup LinkLayer_Scheduler
+ * @{
+ */
 /***************************** Include Files *********************************/
 #include <stdlib.h>
 #include "schdevent.h"
@@ -360,7 +365,7 @@ void L2_EventPoolHandler(L2_INST *instPtr)
 			if (event->schdFrame == L2_GetCurrentFrameNum(instPtr) && event->schdSlot == L2_GetCurrentSlotNum(instPtr))
 			{
 				DBG_INFO("Asserting scheduled event [%" PRIu32 "].\n", event->eventId);
-				AssertL2Event(instPtr, &(event->l2Event));
+				(void)AssertL2Event(instPtr, &(event->l2Event));
 				if (event->isVolatile == true)
 				{
 					DBG_INFO("Deleting scheduled event [%" PRIu32 "], since it is volatile.\n", event->eventId);
@@ -428,3 +433,6 @@ inline bool L2_isEventScheduled(const L2_SCHD_EVENT *schdEvent)
 	ASSERT(schdEvent != NULL);
 	return schdEvent->isSchd;
 }
+
+/** @} LinkLayer_Scheduler*/
+/** @} LinkLayer*/

df_datalink_sp/src/networking/link_layer/schdevent.h

@@ -1,18 +1,24 @@
 /*****************************************************************************/
 /**
- * Description: Event scheduling implementation
+ * @file schdevent.c
+ * @author FanHao (hao_fan_bit_ee@163.com)
+ * @brief DF Linklayer Event scheduling header file.
+ * @version 0.1
+ * @date 2023-05-06
  *
- * Date: 2023-12-21 13:32
+ * @copyright Copyright(c) 2024 Beijing Institute of Technology.\n
- * LastEditors: Fan Hao
+ * Lab of Communication and Network
- * LastEditTime: 2023-12-21 13:32
- * Revisions: Rev 0.0
- * History:
- * [2023-12-21]: Initial version.
- *
- * Copyright(c) 2021 Beijing Institute of Technology.
- * Lab of Communication and Networking
  *
  ******************************************************************************/
+/**
+ * @addtogroup LinkLayer
+ * @{
+ */
+
+/**
+ * @addtogroup LinkLayer_Scheduler
+ * @{
+ */
 #ifndef SCHDEVENT_H_
 #define SCHDEVENT_H_
 
@@ -24,8 +30,9 @@
 #include "clist.h"
 /***************** Macros (Inline Functions) Definitions *********************/
 /**************************** Type Definitions *******************************/
-/** @name L2 event
+/**
- * A definition of L2 event instance.
+ * @struct L2_SCHD_EVENT
+ * @brief Linklayer scheduled event descriptor
  */
 typedef struct
 {
@@ -38,8 +45,9 @@ typedef struct
 	uint32_t schdSlot;
 } L2_SCHD_EVENT;
 
-/** @name L2 event
+/**
- * A definition of L2 event instance.
+ * @struct L2_SCHD_POOL
+ * @brief Linklayer schedule event pool instance
  */
 typedef struct
 {
@@ -63,3 +71,6 @@ bool L2_isEventScheduled(const L2_SCHD_EVENT *schdEvent);
 int32_t L2_CancelEvent(L2_SCHD_EVENT *schdEvent);
 
 #endif // SCHDEVENT_H_
+
+/** @} LinkLayer_Scheduler*/
+/** @} LinkLayer*/

df_datalink_sp/src/networking/link_layer/service.c

@@ -1,18 +1,24 @@
 /*****************************************************************************/
 /**
- * Description: Implementations for df datalink service net.
+ * @file service.c
- * Date: 2021-11-16 00:08
+ * @author FanHao (hao_fan_bit_ee@163.com)
- * LastEditTime: 2022-07-16 17:04
+ * @brief DF Linklayer service implementation file.
- * Revisions: Rev 0.1
+ * @version 0.0
- * History:
+ * @date 2023-05-06
- * [2022-07-16]: New branch for DiJian.
- * [2021-11-16]: Initial version.
  *
- * Copyright(c) 2021 Beijing Institute of Technology.
+ * @copyright Copyright(c) 2024 Beijing Institute of Technology.\n
- * Lab of Communication and Networking
+ * Lab of Communication and Network
  *
  ******************************************************************************/
+/**
+ * @addtogroup LinkLayer
+ * @{
+ */
 
+/**
+ * @addtogroup LinkLayer_Service
+ * @{
+ */
 /***************************** Include Files *********************************/
 #include <string.h>
 #include <stdint.h>
@@ -88,6 +94,7 @@ static int32_t Service_Packing(L2_INST *instPtr, L2_FRAME_TYPE type, uint8_t dst
 	uint32_t dataChunk;
 	uint8_t *buff = instPtr->sendPktData;
 
+	// Common section of link layer package
 	dataChunk = L2_GetNextFrameNum(instPtr);
 	L2_FrameInsertChunk(buff, L2_MSG_FRAME_NUM, L2_MSG_FRAME_NUM_LEN, &dataChunk);
 	dataChunk = L2_GetNextSlotNum(instPtr);
@@ -113,7 +120,7 @@ static int32_t Service_Packing(L2_INST *instPtr, L2_FRAME_TYPE type, uint8_t dst
 		L2_FrameInsertChunk(buff, L2_MSG_SVC_SRC_SPEEDZ, L2_MSG_SVC_SRC_SPEEDZ_LEN, &(instPtr->sysInfo.vZ));
 
 		uint32_t dataId;
-		if(L2_GetNodeType(instPtr) == L2_NODE_HEAD)
+		if (L2_GetNodeType(instPtr) == L2_NODE_HEAD)
 		{
 			SysMonitor_GetSendPayload(buff + L2_MSG_SVC_PAYLOAD, &dataId, PAYLOAD_LEN_FLJ_TX);
 		}
@@ -128,12 +135,6 @@ static int32_t Service_Packing(L2_INST *instPtr, L2_FRAME_TYPE type, uint8_t dst
 			L2_FrameInsertChunk(buff, L2_MSG_SVC_PAYLOAD, L2_MSG_SVC_PAYLOAD_LEN, testData);
 		}
 
-		// // packing payload
-		// uint32_t dataId;
-		// dataId = DATA_ID_TEST;
-		// L2_FrameInsertChunk(buff, L2_MSG_SVC_PAYLOAD_ID, L2_MSG_SVC_PAYLOAD_ID_LEN, &dataId);
-		// L2_FrameInsertChunk(buff, L2_MSG_SVC_PAYLOAD, L2_MSG_SVC_PAYLOAD_LEN, testData);
-
 		Status = L2_CrcAppend(buff, L2_SVC_PACK_LEN - L2_MSG_SVC_CRC_LEN, L2_MSG_SVC_CRC, L2_CRC16_1021);
 		if (Status != SUCCESS)
 		{
@@ -141,8 +142,8 @@ static int32_t Service_Packing(L2_INST *instPtr, L2_FRAME_TYPE type, uint8_t dst
 			return Status;
 		}
 
-		memcpy(instPtr->serviceFSM->txLog.data, buff, L2_SVC_PACK_LEN);
+		memcpy(instPtr->log.txLog.data, buff, L2_SVC_PACK_LEN);
-		instPtr->serviceFSM->txLog.dataId = dataId;
+		instPtr->log.txLog.dataId = dataId;
 		break;
 	}
 	default:
@@ -159,62 +160,6 @@ static int32_t Service_Packing(L2_INST *instPtr, L2_FRAME_TYPE type, uint8_t dst
 #endif
 }
 
-/*****************************************************************************/
-/**
- * @brief   Initialize service net FSM
- *
- * @param   serviceFSM  A pointer to service FSM instance.
- *
- * @return  SUCCESS Initialize successfully.
- *          Other       Initialize failed.
- *
- ******************************************************************************/
-int32_t L2_Service_Init(L2_SVC_FSM **svcFSMPtr)
-{
-	ASSERT(svcFSMPtr != NULL);
-	*svcFSMPtr = (L2_SVC_FSM *)malloc(sizeof(L2_SVC_FSM));
-	if (*svcFSMPtr == NULL)
-	{
-		return ENOMEM;
-	}
-	L2_Service_Reset(*svcFSMPtr);
-	return SUCCESS;
-}
-
-/*****************************************************************************/
-/**
- * @brief  Reset ServiceNet FSM
- *
- * @param   scanFsmPtr a pointer to service net finite state machine
- *
- * @return  NONE
- *
- ******************************************************************************/
-void L2_Service_Reset(L2_SVC_FSM *svcFSMPtr)
-{
-	ASSERT(svcFSMPtr != NULL);
-	memset((&svcFSMPtr->rxLog), 0x00, sizeof(PAYLOAD));
-	memset((&svcFSMPtr->txLog), 0x00, sizeof(PAYLOAD));
-#ifdef DATALINK_ENABLE_BERTEST
-	svcFSMPtr->bitTotal = 0;
-	svcFSMPtr->bitError = 0;
-#endif
-}
-
-/*****************************************************************************/
-/**
- * @brief  Destroy ServiceNet FSM, free memory
- *
- * @param   scanFsmPtr a pointer to service net finite state machine
- *
- * @return  NONE
- *
- ******************************************************************************/
-void L2_Service_Destroy(L2_SVC_FSM *serviceFSM)
-{
-	free(serviceFSM);
-}
-
 /*****************************************************************************/
 /**
  * @brief   Handle service received packet. Send data up to MPC
@@ -231,7 +176,7 @@ int32_t L2_Service_PktHandler(L2_INST *instPtr, uint8_t *msg)
 	ASSERT(msg != NULL);
 	int32_t Status;
 #ifndef DATALINK_ENABLE_BERTEST
-	uint8_t frameType;
+	L2_FRAME_TYPE frameType = L2_NONE_FRAME;
 	L2_FrameGetChunk(msg, L2_MSG_TYPE, L2_MSG_TYPE_LEN, &frameType);
 	switch (frameType)
 	{
@@ -244,7 +189,7 @@ int32_t L2_Service_PktHandler(L2_INST *instPtr, uint8_t *msg)
 		if (node == NULL)
 		{
 			node = L2_AppendNode(instPtr->nodeList, nodeId, L2_NODE_MEMBER);
-			if(node == NULL)
+			if (node == NULL)
 			{
 				DBG_ERROR("Failed to append new node [id: %" PRIu8 "]", nodeId);
 				Status = ENOMEM;
@@ -255,18 +200,18 @@ int32_t L2_Service_PktHandler(L2_INST *instPtr, uint8_t *msg)
 		// Update node info.
 		float nodePos;
 		L2_FrameGetChunk(msg, L2_MSG_SVC_SRC_POSX, L2_MSG_SVC_SRC_POSX_LEN, &nodePos);
-		node->nodeInfo.pos.x = (double) nodePos;
+		node->nodeInfo.pos.x = (double)nodePos;
 		L2_FrameGetChunk(msg, L2_MSG_SVC_SRC_POSY, L2_MSG_SVC_SRC_POSY_LEN, &nodePos);
-		node->nodeInfo.pos.y = (double) nodePos;
+		node->nodeInfo.pos.y = (double)nodePos;
 		L2_FrameGetChunk(msg, L2_MSG_SVC_SRC_POSZ, L2_MSG_SVC_SRC_POSZ_LEN, &nodePos);
-		node->nodeInfo.pos.z = (double) nodePos;
+		node->nodeInfo.pos.z = (double)nodePos;
 		float nodeSpeed;
 		L2_FrameGetChunk(msg, L2_MSG_SVC_SRC_SPEEDX, L2_MSG_SVC_SRC_SPEEDX_LEN, &nodeSpeed);
-		node->nodeInfo.speed.x = (double) nodePos;
+		node->nodeInfo.speed.x = (double)nodePos;
 		L2_FrameGetChunk(msg, L2_MSG_SVC_SRC_SPEEDY, L2_MSG_SVC_SRC_SPEEDY_LEN, &nodeSpeed);
-		node->nodeInfo.speed.y = (double) nodePos;
+		node->nodeInfo.speed.y = (double)nodePos;
 		L2_FrameGetChunk(msg, L2_MSG_SVC_SRC_SPEEDZ, L2_MSG_SVC_SRC_SPEEDZ_LEN, &nodeSpeed);
-		node->nodeInfo.speed.z = (double) nodePos;
+		node->nodeInfo.speed.z = (double)nodePos;
 
 		// Reset node ttl
 		node->ttlCnt = 0;
@@ -285,21 +230,19 @@ int32_t L2_Service_PktHandler(L2_INST *instPtr, uint8_t *msg)
 		uint32_t dataId;
 		L2_FrameGetChunk(msg, L2_MSG_SVC_PAYLOAD_ID, L2_MSG_SVC_PAYLOAD_ID_LEN, &dataId);
 
-		if(dataId != DATA_ID_NONE)
+		if (L2_GetNodeType(instPtr) == L2_NODE_HEAD)
 		{
-			if(L2_GetNodeType(instPtr) == L2_NODE_HEAD)
+			SysMonitor_UpdateRecvPayload(msg + L2_MSG_SVC_PAYLOAD, dataId, PAYLOAD_LEN_FLJ_RX);
-			{
-				SysMonitor_UpdateRecvPayload(msg+L2_MSG_SVC_PAYLOAD, PAYLOAD_LEN_FLJ_RX);
 		}
 		else
 		{
-				SysMonitor_UpdateRecvPayload(msg+L2_MSG_SVC_PAYLOAD, PAYLOAD_LEN_LJ_RX);
+			SysMonitor_UpdateRecvPayload(msg + L2_MSG_SVC_PAYLOAD, dataId, PAYLOAD_LEN_LJ_RX);
-			}
 		}
 
 		// Logging
-		memcpy(instPtr->serviceFSM->rxLog.data, msg, L2_SVC_PACK_LEN);
+		memcpy(instPtr->log.rxLog.data, msg, L2_SVC_PACK_LEN);
-		instPtr->serviceFSM->rxLog.dataId = dataId;
+		instPtr->log.rxLog.dataId = dataId;
+		instPtr->serviceFSM->rxdCnt++;
 
 #ifdef DATALINK_ENABLE_AUTOTIMESYNC
 		// Implement a auto time sync.
@@ -346,6 +289,65 @@ int32_t L2_Service_PktHandler(L2_INST *instPtr, uint8_t *msg)
 #endif
 }
 
+/*****************************************************************************/
+/**
+ * @brief   Initialize service net FSM
+ *
+ * @param   serviceFSM  A pointer to service FSM instance.
+ *
+ * @return  SUCCESS Initialize successfully.
+ *          Other       Initialize failed.
+ *
+ ******************************************************************************/
+int32_t L2_Service_Init(L2_SVC_FSM **svcFSMPtr)
+{
+	ASSERT(svcFSMPtr != NULL);
+	*svcFSMPtr = (L2_SVC_FSM *)malloc(sizeof(L2_SVC_FSM));
+	if (*svcFSMPtr == NULL)
+	{
+		return ENOMEM;
+	}
+	L2_Service_Reset(*svcFSMPtr);
+	return SUCCESS;
+}
+
+/*****************************************************************************/
+/**
+ * @brief  Reset ServiceNet FSM
+ *
+ * @param   scanFsmPtr a pointer to service net finite state machine
+ *
+ * @return  NONE
+ *
+ ******************************************************************************/
+void L2_Service_Reset(L2_SVC_FSM *svcFSMPtr)
+{
+	ASSERT(svcFSMPtr != NULL);
+	svcFSMPtr->txCnt = 0;
+	svcFSMPtr->rxCnt = 0;
+	svcFSMPtr->rxdCnt = 0;
+#ifdef DATALINK_ENABLE_BERTEST
+	svcFSMPtr->bitTotal = 0;
+	svcFSMPtr->bitError = 0;
+	svcFSMPtr->lossRate = 0;
+	svcFSMPtr->errorRate = 0;
+#endif
+}
+
+/*****************************************************************************/
+/**
+ * @brief  Destroy ServiceNet FSM, free memory
+ *
+ * @param   scanFsmPtr a pointer to service net finite state machine
+ *
+ * @return  NONE
+ *
+ ******************************************************************************/
+void L2_Service_Destroy(L2_SVC_FSM *serviceFSM)
+{
+	free(serviceFSM);
+}
+
 /*****************************************************************************/
 /**
  * @brief   Service FSM Routine.
@@ -366,9 +368,10 @@ int32_t L2_Service_Routine(L2_INST *instPtr, const L2_RTNE_TABLE_ENTRY *rtneEntr
 		return SUCCESS; // skip
 	}
 
-	PHY_INST* phyRef = instPtr->config.phyInstPtr;
+	PHY_INST *phyRef = instPtr->config.phyInstPtr;
+	L2_SVC_FSM *svcFSMPtr = instPtr->serviceFSM;
 	L2_TOR_TYPE torState;
-	const NODE_ENTRY* commNode;
+	const NODE_ENTRY *commNode;
 	if (rtneEntry->src == L2_GetNodeId(instPtr))
 	{
 		torState = L2_TOR_TX;
@@ -402,6 +405,7 @@ int32_t L2_Service_Routine(L2_INST *instPtr, const L2_RTNE_TABLE_ENTRY *rtneEntr
 	case L2_SLOT_SERVICE:
 		if (torState == L2_TOR_TX)
 		{
+			svcFSMPtr->txCnt++;
 #ifndef DATALINK_ENABLE_BERTEST
 			// Packing service data
 			Service_Packing(instPtr, L2_SVC_FRAME, rtneEntry->dst);
@@ -409,6 +413,10 @@ int32_t L2_Service_Routine(L2_INST *instPtr, const L2_RTNE_TABLE_ENTRY *rtneEntr
 			memcpy(instPtr->sendPktData, testData, L2_SVC_PACK_LEN);
 #endif
 		}
+		else
+		{
+			svcFSMPtr->rxCnt++;
+		}
 		L2_SetupNextSlot(instPtr, torState, L2_SVC_FRAME);
 		break;
 	default:
@@ -417,11 +425,14 @@ int32_t L2_Service_Routine(L2_INST *instPtr, const L2_RTNE_TABLE_ENTRY *rtneEntr
 	}
 #ifdef DATALINK_ENABLE_BERTEST
 	uint32_t pktLoss;
-	pktLoss = instPtr->log.svcRecvCnt - instPtr->log.svcCorrectCnt;
+	pktLoss = svcFSMPtr->rxCnt - svcFSMPtr->rxdCnt;
-	instPtr->serviceFSM->lossRate = (instPtr->log.svcRecvCnt == 0) ? 0 : (double)pktLoss / (double)instPtr->serviceFSM->pktRecv;
+	svcFSMPtr->lossRate = (svcFSMPtr->rxCnt == 0) ? 0 : (double)pktLoss / (double)svcFSMPtr->rxCnt;
-	instPtr->serviceFSM->errorRate = (instPtr->serviceFSM->bitTotal == 0) ? 0 : (double)instPtr->serviceFSM->bitError / (double)instPtr->serviceFSM->bitTotal;
+	svcFSMPtr->errorRate = (svcFSMPtr->bitTotal == 0) ? 0 : (double)svcFSMPtr->bitError / (double)svcFSMPtr->bitTotal;
-	DBG_PRINT("Packet Loss Rate -- Total: %lu, Loss: %lu.\n", instPtr->serviceFSM->pktRecv, pktLoss);
+	DBG_PRINT("Packet Loss Rate -- Total: %lu, Loss: %lu.\n", instPtr->log.svcRxCnt, pktLoss);
-	DBG_PRINT("Bit Error Rate -- Total:%lu, Error:%lu.\n", instPtr->serviceFSM->bitTotal, instPtr->serviceFSM->bitError);
+	DBG_PRINT("Bit Error Rate -- Total:%lu, Error:%lu.\n", svcFSMPtr->bitTotal, svcFSMPtr->bitError);
 #endif
 	return SUCCESS;
 }
+
+/** @} LinkLayer_Service*/
+/** @} LinkLayer*/

df_datalink_sp/src/networking/link_layer/time_sync.c

@@ -1,21 +1,24 @@
 /*****************************************************************************/
 /**
- * Description: Time sync implementation file.
+ * @file time_sync.c
+ * @author FanHao (hao_fan_bit_ee@163.com)
+ * @brief DF Linklayer time sync implementation file.
+ * @version 0.0
+ * @date 2023-05-06
  *
- * Author: Author's name
+ * @copyright Copyright(c) 2024 Beijing Institute of Technology.\n
- * Date: 2021-12-04 16:32
+ * Lab of Communication and Network
- * LastEditors: FanHao
- * LastEditTime: 2022-07-10 20:43
- * Revisions: Rev 0.0
- * History:
- * [2022-07-10]: New branch for Dijian.
- * [2021-12-04]: Initial version.
- *
- * Copyright(c) 2021 Beijing Institute of Technology.
- * Lab of Communication and Networking
  *
  ******************************************************************************/
+/**
+ * @addtogroup LinkLayer
+ * @{
+ */
 
+/**
+ * @addtogroup LinkLayer_TimeSync
+ * @{
+ */
 /***************************** Include Files *********************************/
 #include <string.h>
 #include <stdlib.h>
@@ -49,7 +52,8 @@ int32_t L2_GetTimeDeviation(L2_INST *instPtr, uint32_t frameNum, uint32_t slotNu
 	ASSERT(instPtr != NULL);
 	ASSERT(timeDev != NULL);
 	L1_FRAME_TYPE lastRecvdFrame;
-	lastRecvdFrame = Phy_GetLastRecvFrameType(instPtr->config.phyInstPtr);
+	PHY_INST *phyRef = instPtr->config.phyInstPtr;
+	lastRecvdFrame = Phy_GetLastRecvFrameType(phyRef);
 	if (lastRecvdFrame == L1_NONE_FRAME)
 	{
 		DBG_ERROR("Invalid TimeAlign operation, no frame was received.");
@@ -68,7 +72,7 @@ int32_t L2_GetTimeDeviation(L2_INST *instPtr, uint32_t frameNum, uint32_t slotNu
 		expectTime += (uint64_t)instPtr->netStartTime * L2_SLOTS_PER_FRAME * TIME_FRAC_MAX;
 	}
 
-	Phy_GetLastReceivedFrameSyncTimeStamp(instPtr->config.phyInstPtr, &timeStamp);
+	Phy_GetLastReceivedFrameSyncTimeStamp(phyRef, &timeStamp);
 	currTime = (uint64_t)timeStamp.frac_part;
 	currTime += ((uint64_t)timeStamp.int_part) * TIME_FRAC_MAX;
 
@@ -76,7 +80,6 @@ int32_t L2_GetTimeDeviation(L2_INST *instPtr, uint32_t frameNum, uint32_t slotNu
 	return SUCCESS;
 }
 
-
 /*****************************************************************************/
 /**
  * @brief    Implement time adjustment by applying time deviation.
@@ -96,3 +99,7 @@ void L2_TimeAdjust(L2_INST *instPtr, const int64_t *timeDev)
 	slotTimerAdjmet.frac_part = (uint32_t)(*timeDev % TIME_FRAC_MAX);
 	TimeCtrl_TimeAdjust(instPtr->config.tmcInstPtr, &slotTimerAdjmet, TM_ADJ_ADD);
 }
+
+/** @} LinkLayer_TimeSync*/
+
+/** @} LinkLayer*/

df_datalink_sp/src/networking/phy_layer/phy_antenna.c

@@ -1,26 +1,36 @@
 /*****************************************************************************/
 /**
- * Description: Antenna configuration functions.
+ * @file phy_antenna.h
+ * @author FanHao (hao_fan_bit_ee@163.com)
+ * @brief Physical layer control antenna configuration functions.
+ * @version 0.0
+ * @date 2023-04-24
  *
- * Author: Fan Hao
+ * @copyright Copyright(c) 2024 Beijing Institute of Technology.\n
- * Date: 2022-06-18 16:37
+ * Lab of Communication and Network
- * LastEditors: Fan Hao
- * LastEditTime: 2022-06-18 17:15
- * Revisions: Rev 0.0
- * History:
- * [2024-01-20]: New branch for duifei.
- * [2022-06-18]: Initial version.
- *
- * Copyright(c) 2022 Beijing Institute of Technology.
- * Lab of Communication and Networking
  *
  ******************************************************************************/
+
+/**
+ * @addtogroup PhysicalLayer
+ * @{
+ */
+
+/**
+ * @addtogroup PhysicalLayer_AntennaControl
+ * @{
+ */
 #include <string.h>
 #include <stdint.h>
 #include <math.h>
 #include "error.h"
 #include "phy_layer.h"
 
+/**
+ * @name PhysicalLayer_AntennaConfig_Constants
+ * @{
+ */
+
 #define ANT_PI 3.14159265358979323846
 
 #define ANT_COINFO_HEAD 0xAA
@@ -57,81 +67,126 @@
 
 // Pair by regex
 // Regex: (([0-9]+, ){8})
-uint16_t hopPattern_Config[L1_FRAME_MAX_HOPS] =
+const uint16_t freqTable[L1_FRAME_MAX_HOPS] =
+{
+	1084U, 1097U, 1110U, 1123U, 1136U, 1149U, 1162U, 1175U,
+	1188U, 1201U, 1214U, 1227U, 1240U, 1253U, 1266U, 1279U,
+	1292U, 1305U, 1318U, 1331U, 1344U, 1357U, 1370U, 1383U,
+	1396U, 1409U, 1422U, 1435U, 1448U, 1461U, 1474U, 1487U,
+	1500U, 1513U, 1526U, 1539U, 1552U, 1565U, 1578U, 1591U,
+	1604U, 1617U, 1630U, 1643U, 1656U, 1669U, 1682U, 1695U,
+	1708U, 1721U, 1734U, 1747U, 1760U, 1773U, 1786U, 1799U,
+	1812U, 1825U, 1838U, 1851U, 1864U, 1877U, 1890U, 1903U,
+	1916U, 1929U, 1942U, 1955U, 1968U, 1981U, 1994U, 2007U,
+	2020U, 2033U, 2046U, 2059U, 2072U, 2085U, 2098U, 2111U,
+	2124U
+};
+
+const int16_t antCalTable[L1_FRAME_MAX_HOPS][L1_ANT_NUM_CH] =
+//Antenna-JG01
+{
+	{     0,   2525,  -7533,  -6846}, {     0,  12726,  -7818,  -6860},
+	{     0,   2490,  -7836,  -6907}, {     0,   4479,  -7716,  -6837},
+	{     0,   6409,  -7770,  -6776}, {     0,  14616,  -7977,  -6816},
+	{     0, -22557,  -8002,  -6911}, {     0, -22587,  -8121,  -6918},
+	{     0,  -1124,  -8123,  -7030}, {     0,   -152,  -8219,  -7042},
+	{     0,   1823,  -8209,  -7130}, {     0,   1790,  -8290,  -7214},
+	{     0,   1669,  -8362,  -7283}, {     0,   1634,  -8459,  -7276},
+	{     0,   1615,  -8315,  -7415}, {     0,   1698,  -8168,  -7366},
+	{     0,   1535,  -8285,  -7520}, {     0,   1619,  -8285,  -7532},
+	{     0,   1609,  -8201,  -7693}, {     0,   1671,  -8145,  -7769},
+	{     0,   1676,  -8135,  -7805}, {     0,    951, -10279,  -8871},
+	{     0,    976, -10235,  -8978}, {     0,   1118, -10127,  -9019},
+	{     0,   1175, -10003,  -9007}, {     0,   1386,  -9847,  -9039},
+	{     0,   1535,  -9572,  -9058}, {     0,   1729,  -9493,  -9006},
+	{     0,  -1158,  -9312,  -9003}, {     0,  23771,  -9147,  -8928},
+	{     0,  20733,  -9074,  -8924}, {     0,   2455,  -8841,  -8886},
+	{     0,   2622,  -8718,  -8735}, {     0,   2791,  -8615,  -8705},
+	{     0,   2861,  -8168,  -8331}, {     0,   3076,  -8091,  -8218},
+	{     0,   3257,  -8046,  -8100}, {     0,   3331,  -7923,  -8073},
+	{     0,   3396,  -7826,  -7994}, {     0,   3478,  -7842,  -8016},
+	{     0,   3518,  -7846,  -7765}, {     0,   3585,  -7753,  -7715},
+	{     0,    150,  -8145,  -8591}, {     0,    192,  -8090,  -8570},
+	{     0,    207,  -8150,  -8597}, {     0,    178,  -8142,  -8656},
+	{     0,     89,  -8557,  -8688}, {     0,    107,  -8614,  -8733},
+	{     0,    194,  -8605,  -8782}, {     0,    153,  -8655,  -8881},
+	{     0,     70,  -8615,  -8952}, {     0,     35,  -8596,  -9148},
+	{     0,     49,  -8636,  -9286}, {     0,      6,  -8587,  -9435},
+	{     0,    -51,  -8540,  -9549}, {     0,    -65,  -8588,  -9700},
+	{     0,    -55,  -8503,  -9820}, {     0,    -20,  -8414,  -9907},
+	{     0,   -112,  -8481, -10031}, {     0,    -69,  -8535, -10185},
+	{     0,      2,  -8550, -10052}, {     0,     -1,  -8493, -10291},
+	{     0,    -73,  -8441, -10380}, {     0,   1958,  -6930,  -8295},
+	{     0,  -1148,  -6939,  -8396}, {     0,   1915,  -6784,  -8370},
+	{     0,   1871,  -6970,  -8514}, {     0,   1821,  -6974,  -8387},
+	{     0,   1781,  -6906,  -8431}, {     0,   1736,  -6897,  -8462},
+	{     0,   1664,  -7024,  -8377}, {     0,   1629,  -7127,  -8436},
+	{     0,   1603,  -7148,  -8528}, {     0,   1577,  -7198,  -8500},
+	{     0,   1528,  -7311,  -8512}, {     0,   1577,  -7390,  -8570},
+	{     0,   1616,  -7436,  -8572}, {     0,   1589,  -7597,  -8590},
+	{     0,   1722,  -7550,  -8568}, {     0,   1741,  -7691,  -8449},
+	{     0,   1767,  -7775,  -8328},
+};
+
+const uint8_t hopPattern_2KBPS_20MS[L1_FRAME_2KBPS_20MS_HOPS] =
 {
 	0
 };
 
-uint16_t hopPattern_2KBPS_20MS[L1_FRAME_2KBPS_20MS_HOPS] =
+const uint8_t hopPattern_2KBPS_100MS[L1_FRAME_2KBPS_100MS_HOPS] =
 {
-	1500
+	 0U,  1U,  2U,  3U,  4U,  5U,  6U,  7U,
+	 8U,  9U, 10U, 11U, 12U, 13U, 14U, 15U,
+	16U, 17U, 18U, 19U, 20U, 21U, 22U, 23U,
+	24U, 25U, 26U, 27U, 28U, 29U, 30U, 31U,
+	32U, 33U, 34U, 35U, 36U, 37U, 38U, 39U,
+	40U, 41U, 42U, 43U, 44U, 45U, 46U, 47U,
+	48U, 49U, 50U, 51U, 52U, 53U, 54U, 55U,
+	56U, 57U, 58U, 59U, 60U, 61U, 62U, 63U,
+	64U, 65U, 66U, 67U, 68U, 69U, 70U, 71U,
+	72U, 73U, 74U, 75U, 76U, 77U, 78U, 79U,
+	80U
 };
 
-uint16_t hopPattern_2KBPS_100MS[L1_FRAME_2KBPS_100MS_HOPS] =
+const uint8_t hopPattern_10KBPS_10MS[L1_FRAME_10KBPS_10MS_HOPS] =
 {
-	   0,   44,   88,  131,  175,  219,  263,  306,
+	80U
-	 350,  394,  438,  481,  525,  569,  613,  656,
-	 700,  744,  788,  831,  875,  919,  963, 1006,
-	1050, 1094, 1138, 1181, 1225, 1269, 1313, 1356,
-	1400, 1444, 1488, 1531, 1575, 1619, 1663, 1706,
-	1750, 1794, 1838, 1881, 1925, 1969, 2013, 2056,
-	2100, 2144, 2188, 2231, 2275, 2319, 2363, 2406,
-	2450, 2494, 2538, 2581, 2625, 2669, 2713, 2756,
-	2800, 2844, 2888, 2931, 2975, 3019, 3063, 3106,
-	3150, 3194, 3238, 3281, 3325, 3369, 3413, 3456,
-	3500
 };
 
-uint16_t hopPattern_10KBPS_10MS[L1_FRAME_10KBPS_10MS_HOPS] =
+const uint8_t hopPattern_10KBPS_20MS[L1_FRAME_10KBPS_20MS_HOPS] =
 {
-	1500
+	 80U,  1U,  2U,  3U,  4U,  5U,  6U,  7U,
+	  8U,  9U, 10U
 };
 
-//uint16_t hopPattern_10KBPS_20MS[L1_FRAME_10KBPS_20MS_HOPS] =
+const uint8_t hopPattern_40KBPS_10MS[L1_FRAME_40KBPS_10MS_HOPS] =
-//{
-//	1500, 1600, 1700, 1800, 1900, 1400, 1300, 1200,
-//	1100, 1000,  900
-//};
-
-uint16_t hopPattern_10KBPS_20MS[L1_FRAME_10KBPS_20MS_HOPS] =
 {
-	1500, 1500, 1500, 1500, 1500, 1500, 1500, 1500,
+	 0U,  1U,  2U,  3U,  4U,  5U,  6U,  7U,
-	1500, 1500,  1500
+	 8U,
 };
 
-uint16_t hopPattern_40KBPS_10MS[L1_FRAME_40KBPS_10MS_HOPS] =
+const uint8_t hopPattern_40KBPS_20MS[L1_FRAME_40KBPS_20MS_HOPS] =
 {
-	1600, 1650, 1700, 1750, 1800, 1850, 1900, 1550,
+	 0U,  1U,  2U,  3U,  4U,  5U,  6U,  7U,
-	1500
+	 8U,  9U, 10U, 11U, 12U, 13U, 14U, 15U,
+	16U, 17U, 18U
 };
 
-//uint16_t hopPattern_40KBPS_20MS[L1_FRAME_40KBPS_20MS_HOPS] =
+const uint8_t hopPattern_200KBPS_5MS[L1_FRAME_200KBPS_5MS_HOPS] =
-//{
-//	1600, 1650, 1700, 1750, 1800, 1850, 1900, 1550,
-//	1500, 1450, 1400, 1350, 1300, 1250, 1200, 1150,
-//	1100, 1050, 1000
-//};
-
-uint16_t hopPattern_40KBPS_20MS[L1_FRAME_40KBPS_20MS_HOPS] =
 {
-	1700, 1800, 1900, 2000, 1700, 1700, 1700, 1700,
+	 0U,  1U,  2U,  3U,  4U,  5U,  6U,  7U,
-	1700, 1700, 1700, 1700, 1700, 1700, 1700, 1700,
+	 8U,  9U, 10U, 11U, 12U, 13U, 14U, 15U,
-	1700, 1700, 1700
+	16U, 17U, 18U, 19U
 };
 
-uint16_t hopPattern_200KBPS_5MS[L1_FRAME_200KBPS_5MS_HOPS] =
+const uint8_t hopPattern_1M2BPS_5MS[L1_FRAME_1M2BPS_5MS_HOPS] =
 {
-	 500, 1600, 1700, 1800, 1900, 2000, 1500, 1600,
+	 0U,  1U,  2U,  3U,  4U,  5U,  6U,  7U,
-	1700, 1800, 1900, 2000, 1500, 1600, 1700, 1800,
+	 8U,  9U, 10U, 11U, 12U, 13U, 14U, 15U,
-	1900, 2000, 1500, 1500
+	16U, 17U, 18U, 19U
 };
 
-uint16_t hopPattern_1M2BPS_5MS[L1_FRAME_1M2BPS_5MS_HOPS] =
+/** @} PhysicalLayer_AntennaConfig_Constants*/
-{
-	 500,  600,  700,  800,  900, 1000,  500,  600,
-	 700,  800,  900, 1000,  500,  600,  700,  800,
-	 900, 1000,  500,  500
-};
 
 /*****************************************************************************/
 /**
@@ -165,7 +220,7 @@ void Phy_AntConfigInit(PHY_ANT_CONFIG *antConfig)
 	// trSelect
 	antConfig->trSlect = 0;
 	// Antenna attenuation setting
-	antConfig->antAtt = 20;
+	antConfig->antAtt = 0;
 	// phase setting
 	antConfig->phase = 0;
 	// ***********************
@@ -224,11 +279,13 @@ void Phy_AntConfigMode(PHY_INST *instPtr, PHY_ANT_MODE mode)
 	}
 	instPtr->phyLog.antMode = mode;
 	instPtr->antConfig.antMode = config;
+	// Sync logs to system monitor
+	SysMonitor_UpdatePhysicalLayerLog(&(instPtr->phyLog));
 }
 
 /*****************************************************************************/
 /**
- * @brief	Update antenna beam width setting
+ * @brief	Update antenna beam table
  *
  * @param   instPtr	pointer to physical layer instance
  * @param   table	new beam table
@@ -243,10 +300,10 @@ void Phy_SetBeamTable(PHY_INST *instPtr, PHY_ANT_ANGLE *table, uint32_t offset)
 	ASSERT(table != NULL);
 	for (int i = 0; i < L1_NUM_ANT_NRRW_PATTERN; i++)
 	{
-		instPtr->antNrrwPattern[i] = table[(i+offset) % L1_NUM_ANT_NRRW_PATTERN];
+		instPtr->antNrrwPattern[i] = table[(i + offset) % L1_NUM_ANT_NRRW_PATTERN];
 	}
-	memcpy((uint32_t*)instPtr->antInfoAddr, instPtr->antNrrwPattern,
+	memcpy((uint32_t *)instPtr->antInfoAddr, instPtr->antNrrwPattern,
-				L1_NUM_ANT_NRRW_PATTERN*sizeof(PHY_ANT_ANGLE));
+		   L1_NUM_ANT_NRRW_PATTERN * sizeof(PHY_ANT_ANGLE));
 }
 
 /*****************************************************************************/
@@ -260,7 +317,7 @@ void Phy_SetBeamTable(PHY_INST *instPtr, PHY_ANT_ANGLE *table, uint32_t offset)
  * 			FAILURE beamNo exceeds the table size
  *
  ******************************************************************************/
-int32_t Phy_SetBeamNo(PHY_INST *instPtr, int32_t beamNo, PHY_ANT_BEAM_WIDTH beamWidth)
+int32_t Phy_SetBeamNo(PHY_INST *instPtr, size_t beamNo, PHY_ANT_BEAM_WIDTH beamWidth)
 {
 	ASSERT(instPtr != NULL);
 
@@ -302,7 +359,7 @@ int32_t Phy_SetBeamNo(PHY_INST *instPtr, int32_t beamNo, PHY_ANT_BEAM_WIDTH beam
  * @param   beamWidth	new beam width
  *
  * @return	SUCCESS.
- * 			EPARAM - the direction is exceeds predefined range
+ * 			EPARAM
  *
  ******************************************************************************/
 int32_t Phy_SetBeamWidth(PHY_INST *instPtr, PHY_ANT_BEAM_WIDTH beamWidth)
@@ -349,8 +406,8 @@ int32_t Phy_SetBeamAngle(PHY_INST *instPtr, double offAx, double rndAx)
 	ASSERT(instPtr != NULL);
 	uint16_t offAxDeg = 0;
 	uint16_t rndAxDeg = 0;
-	offAxDeg = (offAx >= 0) ? (((int32_t)(offAx * 180 / ANT_PI)) % 360) : (((int32_t)(offAx * 180 / ANT_PI)) % 360 + 360);
+	offAxDeg = (offAx >= 0) ? (((int32_t)(offAx * 180.0 / ANT_PI)) % 360) : (((int32_t)(offAx * 180.0 / ANT_PI)) % 360 + 360);
-	rndAxDeg = (rndAx >= 0) ? (((int32_t)(rndAx * 180 / ANT_PI)) % 360) : (((int32_t)(rndAx * 180 / ANT_PI)) % 360 + 360);
+	rndAxDeg = (rndAx >= 0) ? (((int32_t)(rndAx * 180.0 / ANT_PI)) % 360) : (((int32_t)(rndAx * 180.0 / ANT_PI)) % 360 + 360);
 	if (offAxDeg > 60)
 	{
 		DBG_ERROR("Angle out of range, off axis angle: %" PRIu16 " (should be 0~60), round axis angle: %" PRIu16 " (should be 0~360).\n",
@@ -365,3 +422,7 @@ int32_t Phy_SetBeamAngle(PHY_INST *instPtr, double offAx, double rndAx)
 	instPtr->antConfig.raxis[1] = (uint8_t)rndAxDeg;
 	return SUCCESS;
 }
+
+/** @} PhysicalLayer_AntennaControl*/
+
+/** @} PhysicalLayer*/

df_datalink_sp/src/networking/phy_layer/phy_layer.h

@@ -1,26 +1,21 @@
 /*****************************************************************************/
 /**
- * Description: Physical layer control definitions and function prototypes.
+ * @file phy_layer.c
+ * @author FanHao (hao_fan_bit_ee@163.com)
+ * @brief Physical layer control header file.
+ * @version 0.0
+ * @date 2023-04-24
  *
- * Date: 2021-12-04 16:32
+ * @copyright Copyright(c) 2024 Beijing Institute of Technology.\n
- * LastEditTime: 2024-01-20 17:41
+ * Lab of Communication and Network
- * Revisions: Rev 0.1
- * History:
- * [2021-12-08]: Initial version.
- * [2022-06-18]: New branch for glink control purpose:
- * 				 -Add poll mode, physical layer will start Tx/Rx procedure
- * 				  at specific time stamp.
- * 				 -Add 61/37 beam switch
- * 				 -Code simplification.
- * [2023-04-24]: Feature add:
- * 				- Read frame type from PL status register.
- * [2024-01-20]: New branch for DUIFEI.
- *
- * Copyright(c) 2021 Beijing Institute of Technology.
- * Lab of Communication and Networking
  *
  ******************************************************************************/
 
+/**
+ * @defgroup PhysicalLayer
+ * @{
+ */
+
 #ifndef PHY_CTRL_H_
 #define PHY_CTRL_H_
 
@@ -35,28 +30,34 @@
 #include "../../system_monitor.h"
 #include "../../time_ctrl/time_ctrl.h"
 /************************** Constant Definitions *****************************/
-#define L1_NUM_ANT_NRRW_PATTERN 37
+/**
-#define L1_INIT_BEAM_NO 0
+ * @name PhysicalLayer_Common_Constant
+ * @{
+ */
+#define L1_NUM_ANT_NRRW_PATTERN 37U
+#define L1_INIT_BEAM_NO 0U
 #define L1_INIT_ANT_WD PHY_ANT_BEAM_120
-#define L1_INIT_ANT_NO 0
+#define L1_ANT_NUM_CH 4U
 
 #define L1_FRAME_NONE_LEN UINT32_MAX  // byte
 #define L1_FRAME_NONE_COMP UINT32_MAX // *10ns(Timer_L)
 #define L1_FRAME_NONE_HOPS UINT32_MAX
-#define L1_FRAME_MAX_HOPS 81
+#define L1_FRAME_MAX_HOPS 81U
-#define L1_FRAME_2KBPS_20MS_HOPS 1
+#define L1_FRAME_2KBPS_20MS_HOPS 1U
-#define L1_FRAME_2KBPS_100MS_HOPS 81
+#define L1_FRAME_2KBPS_100MS_HOPS 81U
-#define L1_FRAME_10KBPS_10MS_HOPS 1
+#define L1_FRAME_10KBPS_10MS_HOPS 1U
-#define L1_FRAME_10KBPS_20MS_HOPS 11
+#define L1_FRAME_10KBPS_20MS_HOPS 11U
-#define L1_FRAME_40KBPS_20MS_HOPS 19
+#define L1_FRAME_40KBPS_20MS_HOPS 19U
-#define L1_FRAME_40KBPS_10MS_HOPS 9
+#define L1_FRAME_40KBPS_10MS_HOPS 9U
-#define L1_FRAME_200KBPS_5MS_HOPS 20
+#define L1_FRAME_200KBPS_5MS_HOPS 20U
-#define L1_FRAME_1M2BPS_5MS_HOPS 20
+#define L1_FRAME_1M2BPS_5MS_HOPS 20U
-
+#define PHY_LOG_EXPIRE 40U // 50*5ms
-#define PHY_TIME_WORD_H_MAX UINT32_MAX
+/** @} */
-#define PHY_TIME_WORD_L_MAX 0x0007A120 // 5ms/10ns
 /***************** Macros (Inline Functions) Definitions *********************/
 /**************************** Type Definitions *******************************/
+/**
+ * @enum L1_FRAME_TYPE
+ */
 typedef enum
 {
 	L1_NONE_FRAME = 0,
@@ -70,71 +71,67 @@ typedef enum
 	L1_1M2BPS_5MS_FRAME = 8
 } L1_FRAME_TYPE;
 
+/**
+ * @struct PHY_ANT_CONFIG
+ * @brief PhysicalLayer antenna config
+ */
 typedef struct
 {
 	/*** Ant Control ***/
-	/* Antenna control frame head 0xAA */
+	uint8_t ctrlWord;	 ///< Antenna control frame head 0xAA\n
-	/* default 0, reserved for further use */
+						 /// default 0, reserved for further use
-	uint8_t ctrlWord;
+	uint8_t antMode;	 ///< high 4 bits specified beam mode.\n
-	/* high 4 bits specified beam mode.
+						 /// low 4 bits specified power control
-	 * low 4 bits specified power control */
+	uint8_t oaxis[2];	 ///< off-axis angle range is 0~60 \n
-	uint8_t antMode;
+						 /// 0.1 degree each LSB
-	/* off-axis angle range is 0~60,
+	uint8_t raxis[2];	 ///< round-axis angle range is 0~360, \n
-	 * 0.1 degree each LSB */
+						 /// 0.1 degree each LSB
-	uint8_t oaxis[2];
+	uint8_t antFreq[2];	 ///< 0~3500Mhz, step 1MHz
-	/* round-axis angle range is 0~360,
+	uint8_t trSlect;	 ///< in single tr mode, 0~63 specified tr channel \n
-	 * 0.1 degree each LSB */
+						 /// in single subarray mode, 0~3 specified the subarray
-	uint8_t raxis[2];
+						 /// ! Only in debug mode!
-	/* 0~3500Mhz, step 1MHz */
+	uint8_t antAtt;		 ///< Antenna attenuation 0~31, 0.5dB each LSB, Only in debug mode
-	uint8_t antFreq[2];
+	uint8_t phase;		 ///< 0~63, 5.625 degree each LSB, Only in debug mode
-	/* in single tr mode, 0~63 specified tr channel
+	uint8_t rxtxMode;	 ///< Only for debug \n
-	 * in single subarray mode, 0~3 specified the subarray
+						 /// default 0x00
-	 * Only in debug mode*/
+	uint8_t calibrMode;	 ///< 0x00 Normal, 0x01 single tr calibration
-	uint8_t trSlect;
+	uint8_t antReserved; ///< reserved for further use
-	/* Antenna attenuation 0~31, 0.5dB each LSB, Only in debug mode */
-	uint8_t antAtt;
-	/* 0~63, 5.625 degree each LSB, Only in debug mode*/
-	uint8_t phase;
-	/* Only for debug */
-	/* default 0x00 */
-	uint8_t rxtxMode;
-	/* 0x00 Normal, 0x01 single tr calibration */
-	uint8_t calibrMode;
-	/* reserved for further use */
-	uint8_t antReserved;
 
 	/*** RF Control ***/
-	/* [7:4]RF enable: 0-On, 1-Off(Default); [3:0]Work mode: 0(default) */
+	uint8_t rfCtrl;		 ///< [7:4]RF enable: 0-On, 1-Off(Default); [3:0]Work mode: 0(default)
-	uint8_t rfCtrl;
+	uint8_t rfFreq[2];	 ///< 0~3500Mhz, step 1MHz
-	/* 0~3500Mhz, step 1MHz */
+	uint8_t rfTxMgc;	 ///< RF MGC control: 0~31, 1dB each LSB
-	uint8_t rfFreq[2];
+	uint8_t rf12CalMgc;	 ///< RF channel 1&2 calibration mgc\n
-	/* RF MGC control: 0~31, 1dB each LSB*/
+						 /// [7:4] Channle1 - max 15db, 1dB each LSB \n
-	uint8_t rfTxMgc;
+						 /// [3:0] Channle2 - max 15db, 1dB each LSB
-	/* RF channel 1&2 calibration mgc: [7:4] Channle1 - max 15db, 1dB each LSB
+	uint8_t rf34CalMgc;	 ///< RF channel 3&4 calibration mgc\n
-	 * 								   [3:0] Channle2 - max 15db, 1dB each LSB*/
+						 /// [7:4] Channle3 - max 15db, 1dB each LSB
-	uint8_t rf12CalMgc;
+						 /// [3:0] Channle4 - max 15db, 1dB each LSB
-	/* RF channel 3&4 calibration mgc: [7:4] Channle3 - max 15db, 1dB each LSB
+	uint8_t rcvMgc;		 ///< Receive channel 1-4 MGC: 0~31, 1dB each LSB
-	 * 								   [3:0] Channle4 - max 15db, 1dB each LSB*/
+	uint8_t rfMonitor;	 ///< Receive monitor, 0-normal, 1-switch to monitor port
-	uint8_t rf34CalMgc;
+	uint8_t rfReserved0; ///< reserved for further use
-	/* Receive channel 1-4 MGC: 0~31, 1dB each LSB */
+	uint8_t rfReserved1; ///< reserved for further use
-	uint8_t rcvMgc;
+	uint8_t ch0Cal[2];
-	/* Receive monitor, 0-normal, 1-switch to monitor port */
+	uint8_t ch1Cal[2];
-	uint8_t rfMonitor;
+	uint8_t ch2Cal[2];
-	/* reserved for further use */
+	uint8_t ch3Cal[2];
-	uint8_t rfReserved0;
-	uint8_t rfReserved1;
 } PHY_ANT_CONFIG;
 
+/**
+ * @struct PHY_ANT_ANGLE
+ * @brief Describe the PhysicalLayer antenna angle
+ */
 typedef struct
 {
-	/* off-axis angle range is 0~60,
+	uint16_t oaxis; ///< off-axis angle range is 0~60
-	 * 0.1 degree each LSB */
+					/// 0.1 degree each LSB
-	uint16_t oaxis;
+	uint16_t raxis; ///< round-axis angle range is 0~360
-	/* round-axis angle range is 0~360,
+					/// 0.1 degree each LSB
-	 * 0.1 degree each LSB */
-	uint16_t raxis;
 } PHY_ANT_ANGLE;
 
+/**
+ * @enum PHY_TIME_WORD_TYPE
+ */
 typedef enum
 {
 	PHY_TIME_WORD_NONE = 0,
@@ -142,6 +139,9 @@ typedef enum
 	PHY_TIME_WORD_LISTEN_TIMEOUT = 2
 } PHY_TIME_WORD_TYPE;
 
+/**
+ * @enum PHY_ANT_BEAM_WIDTH
+ */
 typedef enum
 {
 	PHY_ANT_BEAM_NONE = 0,
@@ -151,6 +151,9 @@ typedef enum
 	PHY_ANT_BEAM_16 = 4
 } PHY_ANT_BEAM_WIDTH;
 
+/**
+ * @enum PHY_TOR_TYPE
+ */
 typedef enum
 {
 	PHY_TOR_SUSPEND = 0,
@@ -158,6 +161,9 @@ typedef enum
 	PHY_TOR_RX = 2
 } PHY_TOR_TYPE;
 
+/**
+ * @enum PHY_MODE
+ */
 typedef enum
 {
 	PHY_MODE_NONE = 0,
@@ -166,6 +172,9 @@ typedef enum
 	PHY_MODE_PULL = 3
 } PHY_MODE;
 
+/**
+ * @enum PHY_ANT_MODE
+ */
 typedef enum
 {
 	PHY_ANT_MODE_NONE = 0,
@@ -174,23 +183,10 @@ typedef enum
 	PHY_ANT_MODE_POWER_FULL = 3,
 } PHY_ANT_MODE;
 
-typedef struct
+/**
-{
+ * @struct PHY_RCD
-	uint32_t devId;
+ * @brief Physical Layer recode buffer
-	uint32_t txBramId;
+ */
-	uint32_t rxBramId;
-	uint32_t antBramId;
-	uint32_t antInfoBramId;
-	uint32_t hwXadcId;
-	uintptr_t baseAddr;
-#ifndef EMULATION
-	uint8_t (*get_clk_state)(void);
-	uint8_t (*get_ad_lock_state)(void);
-	int8_t (*get_ad0_temp)(void);
-	int8_t (*get_ad1_temp)(void);
-#endif
-} PHY_CONFIG;
-
 typedef struct
 {
 	int32_t last;
@@ -198,84 +194,100 @@ typedef struct
 	int32_t next;
 } PHY_RCD;
 
+/**
+ * @struct PHY_CONFIG
+ * @brief struct holds all physical layer initialization parameters
+ */
 typedef struct
 {
-	PHY_CONFIG phyCofig; // Device address configs
+	uint32_t devId;			///< device ID
-	uintptr_t recvDataAddr;
+	uint32_t txBramId;		///< tx bram ID
-	uintptr_t sendDataAddr;
+	uint32_t rxBramId;		///< rx bram ID
-	uintptr_t antConfigAddr;
+	uint32_t antBramId;		///< antenna config bram ID
-	uintptr_t antInfoAddr;
+	uint32_t antInfoBramId; ///< antenna beam info bram ID
-	bool isPhyEn;			  // if physical layer running
+	uint32_t hwXadcId;		///< hardware xadc device ID
-	bool isAcq;				  // if last reception acquisition success
+	uintptr_t baseAddr;		///< Physical layer controller base address
-	bool isFrameSync;		  // if last reception frame sync success
-	bool isDecode;			  // if last reception decode success
-	bool isValid;			  // if last reception frame data valid (crc check pass)
-	bool isPresetHop;		  // if using preset frequency hop
-	TIME_WORD recvSlotTime;	  // last slot start time stamp
-	TIME_WORD recvFsTime;	  // last frame sync time stamp
-	PHY_RCD antNo;			  // antenna number record
-	PHY_RCD beamNo;			  // beam number record
-	PHY_RCD beamWd;			  // beam width record
-	PHY_RCD tor;			  // tx rx state record
-	PHY_RCD frameType;		  // frame type record
-	uint32_t sendDataOffset;  // antenna configuration bram offset (to implement ping-pong data flow)
-	uint32_t antConfigOffset; // antenna configuration bram offset (to implement ping-pong data flow)
-	PHY_ANT_CONFIG antConfig; // antenna configuration pointer
 #ifndef EMULATION
-	XAdcPs hwXadc;
+	uint8_t (*get_clk_state)(void);		///< function handle returns hardware clock state
+	uint8_t (*get_ad_lock_state)(void); ///< function handle returns adc lock state
+	int8_t (*get_ad0_temp)(void);		///< function handle returns adc0 temperature state
+	int8_t (*get_ad1_temp)(void);		///< function handle returns adc1 temperature state
 #endif
-	PHY_ANT_ANGLE antNrrwPattern[L1_NUM_ANT_NRRW_PATTERN];
+} PHY_CONFIG;
-	HWSTATE hwSate;
+
-	PHYLOG phyLog;
+/**
+ * @struct PHY_INST
+ * @brief Physical Layer operating instance
+ */
+typedef struct
+{
+	PHY_CONFIG phyCofig;	  ///< physical layer configuration parameters
+	uintptr_t recvDataAddr;	  ///< receive data bram address
+	uintptr_t sendDataAddr;	  ///< send data bram address
+	uintptr_t antConfigAddr;  ///< antenna config data bram address
+	uintptr_t antInfoAddr;	  ///< antenna beam info data bram address
+	bool isPhyEn;			  ///< indicates if physical layer running
+	bool isAcq;				  ///< indicates if last reception acquisition success
+	bool isFrameSync;		  ///< indicates if last reception frame sync success
+	bool isDecode;			  ///< indicates if last reception decode success
+	bool isValid;			  ///< indicates if last reception frame data valid (crc check pass)
+	TIME_WORD recvSlotTime;	  ///< last slot start time stamp
+	TIME_WORD recvFsTime;	  ///< last frame sync time stamp
+	PHY_RCD beamNo;			  ///< beam number record
+	PHY_RCD beamWd;			  ///< beam width record
+	PHY_RCD tor;			  ///< tx rx state record
+	PHY_RCD frameType;		  ///< frame type record
+	uint32_t sendDataOffset;  ///< antenna configuration bram offset (to implement ping-pong data flow)
+	uint32_t antConfigOffset; ///< antenna configuration bram offset (to implement ping-pong data flow)
+	PHY_ANT_CONFIG antConfig; ///< antenna configuration pointer
+#ifndef EMULATION
+	XAdcPs hwXadc; ///< hardware Xadc instance
+#endif
+	PHY_ANT_ANGLE antNrrwPattern[L1_NUM_ANT_NRRW_PATTERN]; ///< antenna beam scan pattern
+	HWSTATE hwSate;										   ///< hardware state log
+	PHYLOG phyLog;										   ///< physical state log
+	uint32_t lastLogTime;								   /// physical state log time stamp
 } PHY_INST;
 
-/************************** Variable Definitions *****************************/
-extern uint16_t hopPattern_Config[L1_FRAME_MAX_HOPS];
-extern uint16_t hopPattern_2KBPS_20MS[L1_FRAME_2KBPS_20MS_HOPS];
-extern uint16_t hopPattern_2KBPS_100MS[L1_FRAME_2KBPS_100MS_HOPS];
-extern uint16_t hopPattern_10KBPS_10MS[L1_FRAME_10KBPS_10MS_HOPS];
-extern uint16_t hopPattern_10KBPS_20MS[L1_FRAME_10KBPS_20MS_HOPS];
-extern uint16_t hopPattern_40KBPS_10MS[L1_FRAME_40KBPS_10MS_HOPS];
-extern uint16_t hopPattern_40KBPS_20MS[L1_FRAME_40KBPS_20MS_HOPS];
-
-extern uint16_t hopPattern_200KBPS_5MS[L1_FRAME_200KBPS_5MS_HOPS];
-extern uint16_t hopPattern_1M2BPS_5MS[L1_FRAME_1M2BPS_5MS_HOPS];
-
 /************************** Function Prototypes ******************************/
-int32_t Phy_InstInit(PHY_INST **instPtr, PHY_CONFIG *phyConfig);
+
+/**
+ * @defgroup PhysicalLayer_Main
+ * @{
+ */
+int32_t Phy_Init(PHY_INST **instPtr, PHY_CONFIG *phyConfig);
 void Phy_Destroy(PHY_INST *instPtr);
-
-void Phy_UpdateState(PHY_INST *instPtr);
-void Phy_RefreshHwSate(PHY_INST *instPtr);
-
 void Phy_Start(PHY_INST *instPtr);
 void Phy_Halt(PHY_INST *instPtr);
-int32_t Phy_SetMode(PHY_INST *instPtr, PHY_MODE modeCod);
 
+int32_t Phy_SetMode(PHY_INST *instPtr, PHY_MODE modeCod);
+int32_t Phy_SetTimeWord(PHY_INST *instPtr, const TIME_WORD *tmWord, PHY_TIME_WORD_TYPE tmType);
 int32_t Phy_SetupNextSlot(PHY_INST *instPtr, PHY_TOR_TYPE txrxMode, L1_FRAME_TYPE frameType, uint8_t *dataBuff);
+void Phy_UpdateState(PHY_INST *instPtr);
 void Phy_PeekRecvData(PHY_INST *instPtr, uint8_t *dataBuff);
 void Phy_RetrieveRecvData(PHY_INST *instPtr, uint8_t *dataBuff);
+void Phy_UpdateLogging(PHY_INST *instPtr);
+void Phy_RefreshHwSate(PHY_INST *instPtr);
+/** @} PhysicalLayer_Main*/
 
+/**
+ * @defgroup PhysicalLayer_Utility
+ * @{
+ */
 bool Phy_IsFrameDetected(PHY_INST *instPtr);
 bool Phy_IsFrameReceived(PHY_INST *instPtr);
 bool Phy_IsFrameValid(PHY_INST *instPtr);
 uint32_t Phy_GetFrameLen(L1_FRAME_TYPE frameType);
-
-L1_FRAME_TYPE Phy_GetLastRecvFrameType(PHY_INST *instPtr);
-L1_FRAME_TYPE Phy_GetLastSendFrameType(PHY_INST *instPtr);
-
-int32_t Phy_SetHopPattern(void *patternBuff, uint32_t patternLen);
 uint32_t Phy_GetHopLength(L1_FRAME_TYPE frameType);
 uint32_t Phy_GetTimeComp(L1_FRAME_TYPE frameType);
+L1_FRAME_TYPE Phy_GetLastRecvFrameType(PHY_INST *instPtr);
+L1_FRAME_TYPE Phy_GetLastSendFrameType(PHY_INST *instPtr);
+/** @} PhysicalLayer_Utility*/
 
-void Phy_AntConfigInit(PHY_ANT_CONFIG *antConfig);
+/**
-void Phy_AntConfigMode(PHY_INST *instPtr, PHY_ANT_MODE mode);
+ * @defgroup PhysicalLayer_Receive_Estimations
-void Phy_SetBeamTable(PHY_INST *instPtr, PHY_ANT_ANGLE *table, uint32_t offset);
+ * @{
-int32_t Phy_SetBeamWidth(PHY_INST *instPtr, PHY_ANT_BEAM_WIDTH beamWidth);
+ */
-int32_t Phy_SetBeamNo(PHY_INST *instPtr, int32_t beamNo, PHY_ANT_BEAM_WIDTH beamWidth);
-int32_t Phy_SetBeamAngle(PHY_INST *phyInstPtr, double offAx, double rndAx);
-int32_t Phy_SetTimeWord(PHY_INST *instPtr, const TIME_WORD *tmWord, PHY_TIME_WORD_TYPE tmType);
-
 uint8_t Phy_LastScanBeamNo(PHY_INST *instPtr);
 double Phy_GetFreqEst(PHY_INST *instPtr);
 double Phy_GetCoarseFreqEst(PHY_INST *instPtr);
@@ -284,4 +296,20 @@ void Phy_GetFrameSyncTimeStamp(PHY_INST *instPtr, TIME_WORD *frameSyncT);
 void Phy_GetLastReceivedFrameSyncTimeStamp(PHY_INST *instPtr, TIME_WORD *frameSyncT);
 void Phy_GetSlotStartTimeStamp(PHY_INST *instPtr, TIME_WORD *slotStart);
 void Phy_GetLastReceivedSlotStartTimeStamp(PHY_INST *instPtr, TIME_WORD *slotStart);
+/** @} PhysicalLayer_Receive_Estimations*/
+
+/**
+ * @defgroup PhysicalLayer_AntennaControl
+ * @{
+ */
+void Phy_AntConfigInit(PHY_ANT_CONFIG *antConfig);
+void Phy_AntConfigMode(PHY_INST *instPtr, PHY_ANT_MODE mode);
+void Phy_SetBeamTable(PHY_INST *instPtr, PHY_ANT_ANGLE *table, uint32_t offset);
+int32_t Phy_SetBeamWidth(PHY_INST *instPtr, PHY_ANT_BEAM_WIDTH beamWidth);
+int32_t Phy_SetBeamNo(PHY_INST *instPtr, size_t beamNo, PHY_ANT_BEAM_WIDTH beamWidth);
+int32_t Phy_SetBeamAngle(PHY_INST *phyInstPtr, double offAx, double rndAx);
+/** @} PhysicalLayer_AntennaControl*/
+
 #endif // PHY_CTRL_H_
+
+/** @} PhysicalLayer*/

df_datalink_sp/src/networking/phy_layer/phy_reg.h

@@ -1,24 +1,24 @@
 /*****************************************************************************/
 /**
- * Description: Physical layer register definitions
+ * @file phy_layer.h
+ * @author FanHao (hao_fan_bit_ee@163.com)
+ * @brief Physical layer controller register definition
+ * @version 0.0
+ * @date 2023-04-24
  *
- * Author: Fan Hao
+ * @copyright Copyright(c) 2024 Beijing Institute of Technology.\n
- * Date: 2021-11-16 00:08
+ * Lab of Communication and Network
- * LastEditors: Fan Hao
- * LastEditTime: 2023-04-24 17:32
- * Revisions: Rev 0.1
- * History:
- * [2021-11-16]: Initial version.
- * [2022-06-18]: New branch for glink control purpose:
- *               -Add poll mode physical layer will start Tx/Rx procedure
- * 				  at specific time stamp.
- * [2023-04-24]: Porting for DUIFEI.
- *
- * Copyright(c) 2021 Beijing Institute of Technology.
- * Lab of Communication and Networking
  *
  ******************************************************************************/
+/**
+ * @defgroup PhysicalLayer
+ * @{
+ */
 
+/**
+ * @name  PhysicalLayer_REG_Constants
+ * @{
+ */
 #ifndef PHY_REG_H_
 #define PHY_REG_H_
 
@@ -26,8 +26,8 @@
 #include "util.h"
 
 /***************** Macros (Inline Functions) Definitions *********************/
-#define PhyRead(instPtr, addr) IO_In32((instPtr)->phyCofig.baseAddr + addr)
+#define PhyRead(instPtr, addr) IO_In32((instPtr)->phyCofig.baseAddr + (addr))
-#define PhyWrite(instPtr, addr, value) IO_Out32((instPtr)->phyCofig.baseAddr + addr, value)
+#define PhyWrite(instPtr, addr, value) IO_Out32((instPtr)->phyCofig.baseAddr + (addr), (value))
 
 /************************** Constant Definitions *****************************/
 /**
@@ -491,3 +491,7 @@
 #define PHY_DEINTLV_AMPEST_MASK 0x0000FFFFU
 
 #endif /* PHY_REG_H_ */
+
+/** @} PhysicalLayer_REG_Constants*/
+
+/** @} PhysicalLayer*/

df_datalink_sp/src/system_monitor.c

@@ -1,9 +1,19 @@
+/**
+ * @addtogroup SystemMonitor
+ * @{
+ */
+
+/***************************** Include Files *********************************/
 #include <string.h>
 #include <stdlib.h>
 #include <stdint.h>
 #include "common.h"
 #include "system_monitor.h"
-
+/************************** Constant Definitions *****************************/
+/**
+ * @name SystemMonitor_Private_Constants
+ * @{
+ */
 #define BUFF_A 0x00
 #define BUFF_B 0x01
 #define BUFF_NONE 0xFF
@@ -13,14 +23,23 @@
 #define SLOTLOG_PACK_LEN 88	 // bytes
 #define PRTCLLOG_PACK_ELN 24 // bytes
 #define HWSTATE_PACK_ELN 12	 // bytes
-
+/** @} SystemMonitor_Private_Constants*/
+/************************** Data Type Definitions ****************************/
+/**
+ * @struct PINGPONG
+ * @brief PingPing Control
+ */
 typedef struct
 {
-	uint8_t latest;
+	uint8_t latest; ///< latest available index
-	uint8_t rBusy;
+	uint8_t rBusy;	///< current read busy index
-	uint8_t wBusy;
+	uint8_t wBusy;	///< current write busy index
 } PINGPONG;
 
+/**
+ * @struct SYSMONITOR
+ * @brief System Monitor struct holds all the system log info
+ */
 typedef struct
 {
 	PINGPONG recvCtrl;
@@ -37,12 +56,14 @@ typedef struct
 	HWSTATE hwState[2];
 } SYSMONITOR;
 
+/************************** Function Prototypes ******************************/
+static uint8_t GetWritable(PINGPONG ctrllor);
+static uint8_t GetReadable(PINGPONG ctrllor);
+/************************** Variable Definitions *****************************/
 static SYSMONITOR *sysMonitorInst;
 
-uint8_t GetWritable(PINGPONG ctrllor);
+/*********************** Function Implementations  ***************************/
-uint8_t GetReadable(PINGPONG ctrllor);
+inline static uint8_t GetWritable(PINGPONG ctrllor)
-
-inline uint8_t GetWritable(PINGPONG ctrllor)
 {
 	// Allow only one write.
 	ASSERT(ctrllor.wBusy == BUFF_NONE);
@@ -52,7 +73,7 @@ inline uint8_t GetWritable(PINGPONG ctrllor)
 		return ((ctrllor.rBusy == BUFF_B) ? BUFF_A : BUFF_B);
 }
 
-inline uint8_t GetReadable(PINGPONG ctrllor)
+inline static uint8_t GetReadable(PINGPONG ctrllor)
 {
 	if (ctrllor.wBusy == BUFF_NONE || ctrllor.wBusy != ctrllor.latest)
 		return ((ctrllor.latest == BUFF_NONE) ? BUFF_A : BUFF_B);
@@ -60,7 +81,11 @@ inline uint8_t GetReadable(PINGPONG ctrllor)
 		return ((ctrllor.wBusy == BUFF_B) ? BUFF_A : BUFF_B);
 }
 
-// System monitor initialise
+/**
+ * @brief Initialize System monitor
+ *
+ * @return SUCCESS
+ */
 int32_t SysMonitor_Init(void)
 {
 	sysMonitorInst = calloc(1, sizeof(SYSMONITOR));
@@ -82,18 +107,27 @@ int32_t SysMonitor_Init(void)
 	return SUCCESS;
 }
 
-// System monitor initialise
+/**
+ * @brief Destroy system monitor release all allocated memory
+ */
 void SysMonitor_Destroy(void)
 {
 	free(sysMonitorInst);
 }
 
-// @System Info
 /**
- * Update system info.
+ * @name SystemInfo_API
+ * @{
+ */
+
+/**
+ * @brief Update system info.
+ *
+ * @param info
  */
 void SysMonitor_UpdateSysinfo(const SYSINFO *info)
 {
+	ASSERT(info != NULL);
 	uint8_t buffIndx;
 	buffIndx = GetWritable(sysMonitorInst->sysInfoCtrl);
 	sysMonitorInst->sysInfoCtrl.wBusy = buffIndx;
@@ -103,11 +137,14 @@ void SysMonitor_UpdateSysinfo(const SYSINFO *info)
 }
 
 /**
- * Get system info.
+ * @brief Get system info.
+ *
+ * @param info
  */
 void SysMonitor_GetSysinfo(SYSINFO *info)
 {
 	ASSERT(sysMonitorInst != NULL);
+	ASSERT(info != NULL);
 	uint8_t buffIndx, buffIndex_old;
 	buffIndex_old = sysMonitorInst->sysInfoCtrl.rBusy;
 	if (buffIndex_old != BUFF_NONE)
@@ -118,14 +155,26 @@ void SysMonitor_GetSysinfo(SYSINFO *info)
 	memcpy(info, &(sysMonitorInst->sysInfo[buffIndx]), sizeof(SYSINFO));
 	sysMonitorInst->sysInfoCtrl.rBusy = buffIndex_old;
 }
+/** @} SystemInfo_API*/
 
-// @Send Payload
 /**
- * Update send payload by.
+ * @name ServicePayload_API
+ * @{
+ */
+
+/**
+ * @brief Update send payload by
+ *
+ * @param buff
+ * @param len
  */
 void SysMonitor_UpdateSendPayload(const uint8_t *buff, size_t len)
 {
 	ASSERT(sysMonitorInst != NULL);
+	if (len > PAYLOAD_LEN_MAX)
+	{
+		return;
+	}
 	uint8_t buffIndx;
 	buffIndx = GetWritable(sysMonitorInst->sendCtrl);
 	sysMonitorInst->sendCtrl.wBusy = buffIndx;
@@ -136,17 +185,31 @@ void SysMonitor_UpdateSendPayload(const uint8_t *buff, size_t len)
 }
 
 /**
- * Get the latest send payload.
+ * @brief Get the latest send payload.
+ *
+ * @param buff
+ * @param id
+ * @param len
  */
 void SysMonitor_GetSendPayload(uint8_t *buff, uint32_t *id, size_t len)
 {
 	ASSERT(sysMonitorInst != NULL);
+	ASSERT(buff != NULL);
+	ASSERT(id != NULL);
+	if (len > PAYLOAD_LEN_MAX)
+	{
+		return;
+	}
 	uint8_t buffIndx, buffIndex_old;
 	buffIndex_old = sysMonitorInst->sendCtrl.rBusy;
 	if (buffIndex_old != BUFF_NONE)
+	{
 		buffIndx = buffIndex_old; // Keep it busy
+	}
 	else
+	{
 		buffIndx = GetReadable(sysMonitorInst->sendCtrl);
+	}
 	sysMonitorInst->sendCtrl.rBusy = buffIndx;
 	if (sysMonitorInst->send[buffIndx].dataId != DATA_ID_NONE)
 	{
@@ -156,28 +219,46 @@ void SysMonitor_GetSendPayload(uint8_t *buff, uint32_t *id, size_t len)
 	sysMonitorInst->sendCtrl.rBusy = buffIndex_old;
 }
 
-// @Receive Payload
 /**
- * Update receive payload.
+ * @brief Update receive payload.
+ *
+ * @param buff
+ * @param id
+ * @param len
  */
-void SysMonitor_UpdateRecvPayload(const uint8_t *buff, size_t len)
+void SysMonitor_UpdateRecvPayload(const uint8_t *buff, uint32_t id, size_t len)
 {
 	ASSERT(sysMonitorInst != NULL);
+	ASSERT(buff != NULL);
+	if (id == DATA_ID_NONE || len > PAYLOAD_LEN_MAX)
+	{
+		return;
+	}
 	uint8_t buffIndx;
 	buffIndx = GetWritable(sysMonitorInst->recvCtrl);
 	sysMonitorInst->recvCtrl.wBusy = buffIndx;
 	memcpy(sysMonitorInst->recv[buffIndx].data, buff, len);
-	sysMonitorInst->recv[buffIndx].dataId++;
+	sysMonitorInst->recv[buffIndx].dataId = id;
 	sysMonitorInst->recvCtrl.latest = buffIndx;
 	sysMonitorInst->recvCtrl.wBusy = BUFF_NONE;
 }
 
 /**
- * Get the latest receive payload.
+ * @brief Get the latest receive payload.
+ *
+ * @param buff
+ * @param id
+ * @param len
  */
 void SysMonitor_GetRecvPayload(uint8_t *buff, uint32_t *id, size_t len)
 {
 	ASSERT(sysMonitorInst != NULL);
+	ASSERT(buff != NULL);
+	ASSERT(id != NULL);
+	if (len > PAYLOAD_LEN_MAX)
+	{
+		return;
+	}
 	uint8_t buffIndx, buffIndex_old;
 	buffIndex_old = sysMonitorInst->recvCtrl.rBusy;
 	if (buffIndex_old != BUFF_NONE)
@@ -192,14 +273,22 @@ void SysMonitor_GetRecvPayload(uint8_t *buff, uint32_t *id, size_t len)
 	*id = sysMonitorInst->recv[buffIndx].dataId;
 	sysMonitorInst->recvCtrl.rBusy = buffIndex_old;
 }
+/** @} ServicePayload_API*/
 
-// @Link layer log
 /**
- * Update link layer log
+ * @name Linklayer_Log_API
+ * @{
+ */
+
+/**
+ * @brief Update link layer log
+ *
+ * @param log
  */
 void SysMonitor_UpdateLinklayerLog(const LINKLOG *log)
 {
 	ASSERT(sysMonitorInst != NULL);
+	ASSERT(log != NULL);
 	uint8_t buffIndx;
 	buffIndx = GetWritable(sysMonitorInst->linkLogCtrl);
 	sysMonitorInst->linkLogCtrl.wBusy = buffIndx;
@@ -209,11 +298,14 @@ void SysMonitor_UpdateLinklayerLog(const LINKLOG *log)
 }
 
 /**
- * Get the latest link layer log
+ * @brief Get the latest link layer log
+ *
+ * @param log
  */
 void SysMonitor_GetLinklayerLog(LINKLOG *log)
 {
 	ASSERT(sysMonitorInst != NULL);
+	ASSERT(log != NULL);
 	uint8_t buffIndx, buffIndex_old;
 	buffIndex_old = sysMonitorInst->linkLogCtrl.rBusy;
 	if (buffIndex_old != BUFF_NONE)
@@ -224,14 +316,22 @@ void SysMonitor_GetLinklayerLog(LINKLOG *log)
 	memcpy(log, &(sysMonitorInst->linkLog[buffIndx]), sizeof(LINKLOG));
 	sysMonitorInst->linkLogCtrl.rBusy = buffIndex_old;
 }
+/** @} Linklayer_Log_API*/
 
-// @Physical layer log
 /**
- * Update physical layer log
+ * @name PhysicalLayer_Log_API
+ * @{
+ */
+
+/**
+ * @brief Update physical layer log
+ *
+ * @param log
  */
 void SysMonitor_UpdatePhysicalLayerLog(const PHYLOG *log)
 {
 	ASSERT(sysMonitorInst != NULL);
+	ASSERT(log != NULL);
 	uint8_t buffIndx;
 	buffIndx = GetWritable(sysMonitorInst->phyLogCtrl);
 	sysMonitorInst->phyLogCtrl.wBusy = buffIndx;
@@ -241,11 +341,14 @@ void SysMonitor_UpdatePhysicalLayerLog(const PHYLOG *log)
 }
 
 /**
- * Get the latest physical layer log
+ * @brief Get the latest physical layer log
+ *
+ * @param log
  */
 void SysMonitor_GetPhysicalLayerLog(PHYLOG *log)
 {
 	ASSERT(sysMonitorInst != NULL);
+	ASSERT(log != NULL);
 	uint8_t buffIndx, buffIndex_old;
 	buffIndex_old = sysMonitorInst->phyLogCtrl.rBusy;
 	if (buffIndex_old != BUFF_NONE)
@@ -256,15 +359,22 @@ void SysMonitor_GetPhysicalLayerLog(PHYLOG *log)
 	memcpy(log, &(sysMonitorInst->phyLog[buffIndx]), sizeof(PHYLOG));
 	sysMonitorInst->phyLogCtrl.rBusy = buffIndex_old;
 }
+/** @} */
 
-
-// @Hardware state
 /**
- * Log hardware running status.
+ * @name HardwareState_Log_API
+ * @{
+ */
+
+/**
+ * @brief Log hardware running status.
+ *
+ * @param state
  */
 void SysMonitor_UpdateHardwareStatus(const HWSTATE *state)
 {
 	ASSERT(sysMonitorInst != NULL);
+	ASSERT(state != NULL);
 	uint8_t buffIndx;
 	buffIndx = GetWritable(sysMonitorInst->hwStateCtrl);
 	sysMonitorInst->hwStateCtrl.wBusy = buffIndx;
@@ -274,11 +384,14 @@ void SysMonitor_UpdateHardwareStatus(const HWSTATE *state)
 }
 
 /**
- * Get the latest hardware running status.
+ * @brief Get the latest hardware running status.
+ *
+ * @param state
  */
 void SysMonitor_GetHardwareStatus(HWSTATE *state)
 {
 	ASSERT(sysMonitorInst != NULL);
+	ASSERT(state != NULL);
 	uint8_t buffIndx, buffIndex_old;
 	buffIndex_old = sysMonitorInst->hwStateCtrl.rBusy;
 	if (buffIndex_old != BUFF_NONE)
@@ -289,3 +402,7 @@ void SysMonitor_GetHardwareStatus(HWSTATE *state)
 	memcpy(state, &(sysMonitorInst->hwState[buffIndx]), sizeof(HWSTATE));
 	sysMonitorInst->hwStateCtrl.rBusy = buffIndex_old;
 }
+
+/** @} HardwareState_Log_API */
+
+/** @} SystemMonitor*/

df_datalink_sp/src/system_monitor.h

@@ -1,10 +1,21 @@
+/**
+ * @defgroup SystemMonitor
+ * @{
+ */
+
 #ifndef __SYSTEM_MONITOR_H_
 #define __SYSTEM_MONITOR_H_
 
+/***************************** Include Files *********************************/
 #include <stdint.h>
 #include <stdbool.h>
 #include "util.h"
 
+/************************* Constant Definitions ******************************/
+/**
+ * @name SystemMonitor_Constants
+ * @{
+ */
 #define PAYLOAD_LEN_MAX 256
 #define PAYLOAD_LEN_FLJ_RX 168
 #define PAYLOAD_LEN_FLJ_TX 66
@@ -36,15 +47,22 @@
 #define VOLT_ANT_NIL_OK BIT(4)
 #define ANT_STATE_OK BIT(6)
 
-#define IS_PS_VALID(x) (x <= 1.05 && x >= 0.95)
+// Xilinx Recommended
-#define IS_PSAUX_VALID(x) (x <= 1.89 && x >= 1.71)
+// #define IS_PS_VALID(x) (x <= 1.05 && x >= 0.95)
-#define IS_DDR_VALID(x) (x <= 1.89 && x >= 1.14)
+// #define IS_PSAUX_VALID(x) (x <= 1.89 && x >= 1.71)
-#define IS_PL_VALID(x) (x <= 1.03 && x >= 0.97)
+// #define IS_DDR_VALID(x) (x <= 1.89 && x >= 1.14)
-#define IS_PLAUX_VALID(x) (x <= 1.89 && x >= 1.71)
+// #define IS_PL_VALID(x) (x <= 1.03 && x >= 0.97)
-#define IS_BRAM_VALID(x) (x <= 1.03 && x >= 0.97)
+// #define IS_PLAUX_VALID(x) (x <= 1.89 && x >= 1.71)
+// #define IS_BRAM_VALID(x) (x <= 1.03 && x >= 0.97)
+#define IS_PS_VALID(x) ((x) <= 1.1 && (x) >= 0.9)
+#define IS_PSAUX_VALID(x) ((x) <= 2.0 && (x) >= 1.6)
+#define IS_DDR_VALID(x) ((x) <= 1.7 && (x) >= 1.3)
+#define IS_PL_VALID(x) (x <= 1.1 && (x) >= 0.9)
+#define IS_PLAUX_VALID(x) ((x) <= 2.0 && (x) >= 1.6)
+#define IS_BRAM_VALID(x) ((x) <= 1.1 && (x) >= 0.9)
 
-#define CLK_SP_PLL0_LOCK BIT(0)
+#define CLK_SP_PLL1_LOCK BIT(0)
-#define CLK_SP_PLL1_LOCK BIT(2)
+#define CLK_SP_PLL2_LOCK BIT(2)
 
 #define CLK_AD0_BBPLL_LOCK BIT(0)
 #define CLK_AD0_RFPLL_LOCK BIT(2)
@@ -52,137 +70,154 @@
 #define CLK_AD1_RFPLL_LOCK BIT(6)
 
 #define CLK_ANT_BBPLL_LOCK BIT(0)
-#define CLK_ANT_RFPLL0_LOCK BIT(2)
+#define CLK_ANT_RFPLL1_LOCK BIT(2)
-#define CLK_ANT_RFPLL1_LOCK BIT(4)
+#define CLK_ANT_RFPLL2_LOCK BIT(4)
 
 #define TEMPERATURE_LSB 1.0	   // Celsius degree
 #define TEMPERATURE_MAX 127.0  // Celsius degree
 #define TEMPERATURE_MIN -128.0 // Celsius degree
+/** @} SystemMonitor_Constants */
 
+/************************* Data Type Definitions ****************************/
+
+/**
+ * @struct SYSINFO
+ * @brief System Infomation log
+ */
 typedef struct __attribute__((packed))
 {
-	// -- unit: ms, 0~604799999
+	uint32_t psBDS; ///< -- unit: ms, 0~604799999
-	uint32_t psBDS;
+	uint16_t pBDS;	///< -- unit: week, 0~0~8191
-	// -- unit: week, 0~0~8191
+	uint32_t psGPS; ///< -- unit: ms, 0~604799999
-	uint16_t pBDS;
+	uint16_t pGPS;	///< -- unit: week, 0~0~8191
-	// -- unit: ms, 0~604799999
+	uint8_t tmInd;	///< Time validation indicator \n
-	uint32_t psGPS;
+					// -- [0] GPS\n
-	// -- unit: week, 0~0~8191
+					// -- [1] reserve.\n
-	uint16_t pGPS;
+					// -- [2] UTC\n
-	// Time validation indicator
+					// -- [3] BDS\n
-	// -- [0] GPS
+	float tmFly;	///< Time of flying uint: s
-	// -- [1] reserve.
+	uint8_t stFly;	///< Status of flying \n
-	// -- [2] UTC
+					// [7:6] departure status 11 - departed/00 - not departed \n
-	// -- [3] BDS
+					// [5:4] ready status 11 - ready/00 - not ready \n
-	uint8_t tmInd;
+					// [3:2] attitude status 11 - attitude ok/00 - attitude not ok \n
-	// Time of flying
-	// uint: s
-	float tmFly;
-	// Status of flying
-	// [7:6] departure status 11 - departed/00 - not departed
-	// [5:4] ready status 11 - ready/00 - not ready
-	// [3:2] attitude status 11 - attitude ok/00 - attitude not ok
 					// [1:0] attitude adjust status 11 - adjusted/00 - not adjusted
-	uint8_t stFly;
+	float posX;		///< coord X Position in launch coordinate system
-	// Position in launch coordinate system
+	float posY;		///< coord Y Position in launch coordinate system
-	float posX;
+	float posZ;		///< coord Z Position in launch coordinate system
-	float posY;
+	float vX;		///< Speed X in launch coordinate system
-	float posZ;
+	float vY;		///< Speed Y in launch coordinate system
-	// Speed in launch coordinate system
+	float vZ;		///< Speed Z in launch coordinate system
-	float vX;
+	float pitch;	///< Pitch Attitude in launch inertia coordinate system
-	float vY;
+	float yaw;		///< Yaw Attitude in launch inertia coordinate system
-	float vZ;
+	float roll;		///< Roll Attitude in launch inertia coordinate system
-	// Attitude in launch inertia coordinate system
-	float pitch;
-	float yaw;
-	float roll;
 } SYSINFO;
 
+/**
+ * @struct SYSBUSLOG
+ * @brief System Info holds the system bus log
+ */
 typedef struct __attribute__((packed))
 {
 	// SystemBus log
-	// -- last valid config
+
-	//    byte 0: 0x11 FLJ, 0x00 LJ
+	uint8_t lastConfig[2]; ///< Last valid config \n
+						   //  byte 0: 0x11 FLJ, 0x00 LJ \n
 						   //   byte 1: 0x66 Full Power, 0x88 Low Power
-	uint8_t lastConfig[2];
+	uint32_t pollCnt;	   ///< number of poll commands
-	uint32_t pollCnt;
+	uint32_t svcCnt;	   ///< number of service commands
-	uint32_t svcCnt;
+	uint32_t remoteCnt;	   ///< number of remote check commands
-	uint32_t remoteCnt;
 } SYSBUSLOG;
 
+/**
+ * @struct LINKLOG
+ * @brief Linklayer Log struct holds the Linklayer log
+ */
 typedef struct __attribute__((packed))
 {
 	// Network log
-	uint32_t tuNum;
+	uint32_t tuNum;			///< current time unite number
-	uint8_t slotNum;
+	uint8_t slotNum;		///< current slot number
-	uint8_t nodeType;
+	uint8_t nodeType;		///< current node type
-	uint8_t cxnStatus;
+	uint8_t cxnStatus;		///< current connection status
-	uint8_t linkStage;
+	uint8_t linkStage;		///< current linklayer working stage
-	uint32_t recxnCnt;
+	uint32_t recxnCnt;		///< reconnect trial count
-	uint8_t beamNo;
+	uint8_t beamNo;			///< current working beam number
-	uint8_t beamWidth;
+	uint8_t beamWidth;		///< current working beam width
-	uint16_t beamAz;
+	uint16_t beamAz;		///< current working beam angle Az
-	uint16_t beamEl;
+	uint16_t beamEl;		///< current working beam angle Ez
-	uint16_t advTxCnt;
+	uint16_t advTxCnt;		///< adv frame send count
-	uint16_t advRecvCnt;
+	uint16_t advRecvCnt;	///< adv frame received count
-	uint16_t advCorrectCnt;
+	uint16_t advCorrectCnt; ///< adv frame received correctly count
-	uint32_t cfmTxCnt;
+	uint32_t cfmTxCnt;		///< cfm frame send count
-	uint32_t cfmRecvCnt;
+	uint32_t cfmRecvCnt;	///< cfm frame received count
-	uint32_t cfmCorrectCnt;
+	uint32_t cfmCorrectCnt; ///< adv frame received correctly count
-	uint32_t svcTxCnt;
+	uint32_t svcTxCnt;		///< svc frame send count
-	uint32_t svcRecvCnt;
+	uint32_t svcRecvCnt;	///< svc frame received count
-	uint32_t svcCorrectCnt;
+	uint32_t svcCorrectCnt; ///< svc frame received correctly count
-	int32_t timeDev;
+	int32_t timeDev;		///< last time deviation result
-	uint32_t sendId;
+	uint32_t sendId;		///< last send data id
-	uint32_t recvId;
+	uint32_t recvId;		///< last received data id
-	uint8_t reserve[4];
+	uint8_t reserve[4];		///< reserved data
 } LINKLOG;
 
+/**
+ * @struct PHYLOG
+ * @brief Physical Layer Log struct holds the Linklayer log
+ */
 typedef struct __attribute__((packed))
 {
-	uint32_t acqCnt;
+	uint32_t acqCnt;		///< aquisition count
-	uint32_t fsyncCnt;
+	uint32_t fsyncCnt;		///< frame sync count
-	uint32_t decodeCnt;
+	uint32_t decodeCnt;		///< decode count
-	uint32_t crcCnt;
+	uint32_t crcCnt;		///< crc valid count
-	double doppler;
+	double doppler;			///< last doppler estimation result
-	uint64_t recvStamp;
+	uint64_t recvStamp;		///< last frame arrival time
-	double acqPAPR;
+	double acqPAPR;			///< last acquisition peak-average ration
-	uint8_t acqPhase;
+	uint8_t acqPhase;		///< last acquisition phase estimation
-	uint8_t acqFreqCh;
+	uint8_t acqFreqCh;		///< last acquisition frequency deviation estimation
-	double fsyncPAPR;
+	double fsyncPAPR;		///< last frame sync peak-average ration
-	uint8_t fsyncFreqCh;
+	uint8_t fsyncFreqCh;	///< last frame sync frequency estimation
-	uint16_t deintlvAmpEst;
+	uint16_t deintlvAmpEst; ///< de-interleave amplitude estimation
-	uint8_t antMode;
+	uint8_t antMode;		///< current antenna working mode
-	uint8_t reserve[3];
+	uint8_t reserve[3];		///< reserved data
 } PHYLOG;
 
+/**
+ * @struct HWSTATE
+ * @brief Hardware Status Log struct holds all hardware status
+ */
 typedef struct __attribute__((packed))
 {
-	// Hardware status
+	bool isSpOk;  ///< signal processor state
-	bool isSpOk;
+	bool isAntOk; ///< antenna state
-	bool isAntOk;
 	// -- Signal processor status
-	uint8_t spFpgaVolt;
+	uint8_t spFpgaVolt;	   ///< Signal processor voltage state indicator
-	uint8_t spClkState;
+	uint8_t spClkState;	   ///< Signal processor clock state indicator
-	uint8_t spAdLockState;
+	uint8_t spAdLockState; ///< Signal processor adc lock state indicator
-	uint8_t spAdTemp_0;
+	int8_t spAdTemp_0;     ///< Signal processor adc0 temperature
-	uint8_t spAdTemp_1;
+	int8_t spAdTemp_1;     ///< Signal processor adc1 temperature
-	uint8_t spFpgaTemp;
+	int8_t spFpgaTemp;     ///< Signal processor FPGA temperature
 	// -- Antenna status
-	uint8_t antVolt;
+	uint8_t antVolt; ///< Antenna voltage state indicator
-	uint8_t antTemp;
+	int8_t antTemp;  ///< Antenna rf temperature
-	uint8_t antPll;
+	uint8_t antPll;	 ///< Antenna rf lock state indicator
-	uint8_t antMgc0;
+	uint8_t antMgc0; ///< Antenna rf mgc0~1 indicator
-	uint8_t antMgc1;
+	uint8_t antMgc1; ///< Antenna rf mgc2~3 indicator
-	uint8_t reserve[2];
+	uint8_t phyId;
+	uint8_t reserve[1];
 } HWSTATE;
 
+/**
+ * @struct PAYLOAD
+ * @brief Payload struct holds the service payload
+ */
 typedef struct
 {
 	uint32_t dataId;
 	uint8_t data[PAYLOAD_LEN_MAX];
 } PAYLOAD;
 
+/************************** Function Prototypes ******************************/
 int32_t SysMonitor_Init(void);
 void SysMonitor_Destroy(void);
 
@@ -190,7 +225,7 @@ void SysMonitor_UpdateSysinfo(const SYSINFO *info);
 void SysMonitor_GetSysinfo(SYSINFO *info);
 
 void SysMonitor_UpdateSendPayload(const uint8_t *buff, size_t len);
-void SysMonitor_UpdateRecvPayload(const uint8_t *buff, size_t len);
+void SysMonitor_UpdateRecvPayload(const uint8_t *buff, uint32_t id, size_t len);
 void SysMonitor_GetSendPayload(uint8_t *buff, uint32_t *id, size_t len);
 void SysMonitor_GetRecvPayload(uint8_t *buff, uint32_t *id, size_t len);
 
@@ -202,3 +237,5 @@ void SysMonitor_GetPhysicalLayerLog(PHYLOG *log);
 void SysMonitor_GetHardwareStatus(HWSTATE *state);
 
 #endif //__SYSTEM_MONITOR_H_
+
+/** @} */

df_datalink_sp/src/systembus/systembus.c

@@ -1,22 +1,22 @@
 /*****************************************************************************/
 /**
- * Description: System bus protocol implementation file.
+ * @file systembus.c
+ * @author FanHao (hao_fan_bit_ee@163.com)
+ * @brief System bus protocol implementation file.
+ * @version 0.1
+ * @date 2023-05-06
  *
- * Date: 2023-05-06 10:13
+ * @copyright Copyright(c) 2024 Beijing Institute of Technology.\n
- * Last Edit Time: [2023-05-06 21:45]
- *
- * Revisions: Rev 0.0
- * History:
- * [2023-05-06]: Initial version.
- * [2023-09-13]: Update to 485 protocol-20220816
- *
- * Copyright(c) 2021 Beijing Institute of Technology.
  * Lab of Communication and Network
  *
  ******************************************************************************/
 
-/***************************** Include Files *********************************/
+/**
+ * @addtogroup SystemBus
+ * @{
+ */
 
+/***************************** Include Files *********************************/
 #include <stdlib.h>
 #include <string.h>
 #include <stdint.h>
@@ -27,10 +27,18 @@
 #include "common.h"
 #include "error.h"
 #include "circ_queue.h"
-
 #include "../system_monitor.h"
 
+/**
+ * @addtogroup SystemBus_Protocol_Routine
+ * @{
+ */
+
 /************************** Constant Definitions *****************************/
+/**
+ * @name SystemBus_MSG_Constants
+ * @{
+ */
 // Common Field
 // -- Command word
 #define WD_CMD 0x00
@@ -190,10 +198,9 @@
 
 #define LJ_RM_TEST_RESP_LEN 158
 
-
 // My Production Type
 #define MY_PRD_ID PRD_DL_K
-
+/** @} SystemBus_MSG_Constants*/
 /************************** Function Prototypes ******************************/
 static int32_t SystemBus_GenSelfTestRsp(SYSBUS *instPtr);
 static int32_t SystemBus_SystemConfig(SYSBUS *instPtr, uint8_t *msg);
@@ -238,7 +245,8 @@ static int32_t SystemBus_GenSelfTestRsp(SYSBUS *instPtr)
 {
 	ASSERT(instPtr != NULL);
 	SYSBUS_UART_FRAME *sysbusRsp = malloc(sizeof(SYSBUS_UART_FRAME));
-	if (sysbusRsp == NULL) {
+	if (sysbusRsp == NULL)
+	{
 		DBG_ERROR("Failed to allocate memory for SELF TEST Response!\n");
 		return ENOMEM;
 	}
@@ -248,13 +256,13 @@ static int32_t SystemBus_GenSelfTestRsp(SYSBUS *instPtr)
 	sysbusRsp->data[WD_CMD] = CMD_SELF_TEST;
 	sysbusRsp->data[WD_PRD] = MY_PRD_ID;
 	SysMonitor_GetHardwareStatus(hwStatsPtr);
-	if (linkInstPtr->isEnable == false)
+	if (L2_isStarted(linkInstPtr))
 	{
-		sysbusRsp->data[WD_ST_RET] = (hwStatsPtr->isSpOk) ? ST_RET_OK : ST_RET_ERROR;
+		sysbusRsp->data[WD_ST_RET] = (hwStatsPtr->isSpOk && hwStatsPtr->isAntOk) ? ST_RET_OK : ST_RET_ERROR;
 	}
 	else
 	{
-		sysbusRsp->data[WD_ST_RET] = (hwStatsPtr->isSpOk && hwStatsPtr->isAntOk) ? ST_RET_OK : ST_RET_ERROR;
+		sysbusRsp->data[WD_ST_RET] = (hwStatsPtr->isSpOk) ? ST_RET_OK : ST_RET_ERROR;
 	}
 	// apply status and omit 2 bytes of overhead.
 	memcpy(sysbusRsp->data + WD_SP_FPGA_VOLT, &(hwStatsPtr->spFpgaVolt), ST_RET_INFO_LEN);
@@ -278,30 +286,21 @@ static int32_t SystemBus_SystemConfig(SYSBUS *instPtr, uint8_t *msg)
 	PHY_INST *phyRef = linkInstPtr->config.phyInstPtr;
 	TMC_INST *tmcRef = linkInstPtr->config.tmcInstPtr;
 	bool reconfig = false;
-	bool start = false;
 
 	if (msg[WD_MODE_CMD] == MODE_CMD_HEAD)
-	{
-		// omit unnecessary reconfiguration
-		if (L2_GetNodeType(linkInstPtr) != L2_NODE_HEAD)
 	{
 		// head node config
+		reconfig = (L2_NODE_HEAD != L2_GetNodeType(linkInstPtr));
 		linkConfig.myType = L2_NODE_HEAD;
 		linkConfig.myId = 1;
-			reconfig = true;
-		}
 	}
 
-	else if (msg[WD_MODE_CMD] == MODE_CMD_MEMBER )
+	else if (msg[WD_MODE_CMD] == MODE_CMD_MEMBER)
-	{
-		// omit unnecessary reconfiguration
-		if (L2_GetNodeType(linkInstPtr) != L2_NODE_MEMBER)
 	{
 		// member node config
+		reconfig = (L2_NODE_MEMBER != L2_GetNodeType(linkInstPtr));
 		linkConfig.myType = L2_NODE_MEMBER;
 		linkConfig.myId = 2;
-			reconfig = true;
-		}
 	}
 	else
 	{
@@ -311,23 +310,30 @@ static int32_t SystemBus_SystemConfig(SYSBUS *instPtr, uint8_t *msg)
 		return EPARAM;
 	}
 
-	if(msg[WD_EN_CMD] == EN_CMD_ON_HIGH_POWER)
+	if (msg[WD_EN_CMD] == EN_CMD_ON_HIGH_POWER)
 	{
-		// high power config
+		// full power config
 		Phy_AntConfigMode(phyRef, PHY_ANT_MODE_POWER_FULL);
-		start = true;
+		if (reconfig || !L2_isStarted(linkInstPtr))
+		{
+			Linklayer_Reconfig(linkInstPtr, &linkConfig);
 		}
-	else if(msg[WD_EN_CMD] == EN_CMD_ON_LOW_POWER)
+		Linklayer_Start(linkInstPtr);
+	}
+	else if (msg[WD_EN_CMD] == EN_CMD_ON_LOW_POWER)
 	{
 		// low power config
 		Phy_AntConfigMode(phyRef, PHY_ANT_MODE_POWER_LOW);
-		start = true;
+		if (reconfig || !L2_isStarted(linkInstPtr))
+		{
+			Linklayer_Reconfig(linkInstPtr, &linkConfig);
 		}
-	else if(msg[WD_EN_CMD] == EN_CMD_SILENT)
+		Linklayer_Start(linkInstPtr);
+	}
+	else if (msg[WD_EN_CMD] == EN_CMD_SILENT)
 	{
 		// silence config
 		// TODO: better approach?
-		start = false;
 		Linklayer_Halt(linkInstPtr);
 		Phy_AntConfigMode(phyRef, PHY_ANT_MODE_STANDBY);
 		TIME_WORD pullTime = {0, 0};
@@ -338,13 +344,12 @@ static int32_t SystemBus_SystemConfig(SYSBUS *instPtr, uint8_t *msg)
 		}
 		Phy_SetupNextSlot(phyRef, PHY_TOR_RX, L1_10KBPS_10MS_FRAME, NULL);
 	}
-	if (reconfig == true)
+	else
 	{
-		Linklayer_Reconfig(linkInstPtr, &linkConfig);
+		// Ignore current command
-	}
+		DBG_ERROR("Unexpected config command 0x%02X:0x%02X",
-	if (start == true)
+				  WD_EN_CMD, msg[WD_EN_CMD]);
-	{
+		return EIGNORE;
-		Linklayer_Start(linkInstPtr);
 	}
 	instPtr->sysbusLog.lastConfig[0] = msg[WD_MODE_CMD];
 	instPtr->sysbusLog.lastConfig[1] = msg[WD_EN_CMD];
@@ -359,7 +364,8 @@ static int32_t SystemBus_Echo(SYSBUS *instPtr, SYSBUS_UART_FRAME *frame)
 	ASSERT(instPtr != NULL);
 	ASSERT(frame != NULL);
 	SYSBUS_UART_FRAME *sysbusRsp = malloc(sizeof(SYSBUS_UART_FRAME));
-	if (sysbusRsp == NULL) {
+	if (sysbusRsp == NULL)
+	{
 		DBG_ERROR("Failed to allocate memory for DATA TEST A Response!\n");
 		return ENOMEM;
 	}
@@ -384,12 +390,13 @@ static int32_t SystemBus_GenPollRsp(SYSBUS *instPtr, uint8_t *msg)
 	size_t dataLen;
 	uint8_t *payload;
 	SYSBUS_UART_FRAME *sysbusRsp = malloc(sizeof(SYSBUS_UART_FRAME));
-	if (sysbusRsp == NULL) {
+	if (sysbusRsp == NULL)
+	{
 		DBG_ERROR("Failed to allocate memory for FLJ POLL Response!\n");
 		return ENOMEM;
 	}
 
-	if(msg[WD_CMD] == CMD_FLJ_POLL)
+	if (msg[WD_CMD] == CMD_FLJ_POLL)
 	{
 		sysbusRsp->len = FLJ_POLL_RESP_LEN;
 		sysbusRsp->data[WD_CMD] = CMD_FLJ_POLL;
@@ -397,7 +404,7 @@ static int32_t SystemBus_GenPollRsp(SYSBUS *instPtr, uint8_t *msg)
 		dataLen = PAYLOAD_LEN_FLJ_RX;
 		payload = sysbusRsp->data + FLJ_DATA_OFFSET;
 	}
-	else if(msg[WD_CMD] == CMD_LJ_POLL)
+	else if (msg[WD_CMD] == CMD_LJ_POLL)
 	{
 		sysbusRsp->len = LJ_POLL_RESP_LEN;
 		sysbusRsp->data[WD_CMD] = CMD_LJ_POLL;
@@ -437,7 +444,8 @@ static int32_t SystemBus_GenRemoteTestRsp(SYSBUS *instPtr, uint8_t *msg)
 	ASSERT(instPtr != NULL);
 	ASSERT(msg != NULL);
 	SYSBUS_UART_FRAME *sysbusRsp = malloc(sizeof(SYSBUS_UART_FRAME));
-	if (sysbusRsp == NULL) {
+	if (sysbusRsp == NULL)
+	{
 		DBG_ERROR("Failed to allocate memory for LJ REMOTE TEST Response!\n");
 		return ENOMEM;
 	}
@@ -447,7 +455,7 @@ static int32_t SystemBus_GenRemoteTestRsp(SYSBUS *instPtr, uint8_t *msg)
 	TimeCtrl_GetCurrentTime(linkInstPtr->config.tmcInstPtr, &tmWord);
 	time = (uint64_t)tmWord.int_part * TIME_FRAC_MAX + tmWord.frac_part;
 
-	if(msg[WD_CMD] == CMD_FLJ_RM_TEST)
+	if (msg[WD_CMD] == CMD_FLJ_RM_TEST)
 	{
 		sysbusRsp->len = FLJ_RM_TEST_RESP_LEN;
 		memset(sysbusRsp->data, 0x00, FLJ_RM_TEST_RESP_LEN);
@@ -485,7 +493,8 @@ static int32_t SystemBus_GenRemoteTestRsp(SYSBUS *instPtr, uint8_t *msg)
 		return EUNEXP;
 	}
 
-	if (CircQueuePush(instPtr->txQueue, (void *)sysbusRsp) == false){
+	if (CircQueuePush(instPtr->txQueue, (void *)sysbusRsp) == false)
+	{
 		free(sysbusRsp);
 		DBG_WARNING("SystemBus::TX Queue overflowed!\n");
 		return EQUEUE;
@@ -494,64 +503,6 @@ static int32_t SystemBus_GenRemoteTestRsp(SYSBUS *instPtr, uint8_t *msg)
 	return SUCCESS;
 }
 
-/*****************************************************************************/
-/**
- * @brief   Initialize System Bus instance.
- *
- * @param   InstPtr A double pointer to System Bus instance.
- * @param   config  A pointer to System Bus configurations.
- *
- * @return  None.
- *
- ******************************************************************************/
-int32_t SystemBus_Init(SYSBUS **instPtr, SYSBUS_CONFIG *config)
-{
-	ASSERT(instPtr != NULL);
-	ASSERT(config != NULL);
-	SYSBUS_UART_CONFIG uartConfig;
-	int32_t Status;
-	(*instPtr) = malloc(sizeof(SYSBUS));
-	if ((*instPtr) == NULL)
-	{
-		return FAILURE;
-	}
-	(*instPtr)->rxQueue = NULL;
-	(*instPtr)->txQueue = NULL;
-	(*instPtr)->uartInst = NULL;
-	memcpy(&((*instPtr)->config), config, sizeof(SYSBUS_CONFIG));
-	memset(&((*instPtr)->sysbusLog), 0x00, sizeof(SYSBUSLOG));
-	memset(&((*instPtr)->linkLog), 0x00, sizeof(LINKLOG));
-	memset(&((*instPtr)->phyLog), 0x00, sizeof(PHYLOG));
-	memset(&((*instPtr)->hwState), 0x00, sizeof(HWSTATE));
-	uartConfig.baseAddr = config->baseAddr;
-	Status = SysbusUart_Init(&((*instPtr)->uartInst), &uartConfig);
-	if (Status != SUCCESS)
-	{
-		Status = ENOMEM;
-		goto sysbus_init_error;
-	}
-	if (CircQueueCreate(&((*instPtr)->txQueue), (*instPtr)->config.txQueueMax) == false)
-	{
-		Status = ENOMEM;
-		goto sysbus_init_error;
-	}
-	if (CircQueueCreate(&((*instPtr)->rxQueue), (*instPtr)->config.rxQueueMax) == false)
-	{
-		Status = ENOMEM;
-		goto sysbus_init_error;
-	}
-	(*instPtr)->isRxDone = false; // nothing received.
-	(*instPtr)->isTxDone = true;  // nothing to be sent.
-	return SUCCESS;
-
-sysbus_init_error:
-	free((*instPtr)->uartInst);
-	free((*instPtr)->txQueue);
-	free((*instPtr)->rxQueue);
-	free(*instPtr);
-	return Status;
-}
-
 /*****************************************************************************/
 /**
  * @brief   A handler function. This handler  evaluate the message from system
@@ -698,6 +649,82 @@ int32_t SystemBus_MakeResp(SYSBUS *instPtr)
 	return Status;
 }
 
+/** @} */
+
+/*****************************************************************************/
+/**
+ * @brief   Initialize System Bus instance.
+ *
+ * @param   InstPtr A double pointer to System Bus instance.
+ * @param   config  A pointer to System Bus configurations.
+ *
+ * @return  Error code.
+ *
+ ******************************************************************************/
+int32_t SystemBus_Init(SYSBUS **instPtr, SYSBUS_CONFIG *config)
+{
+	ASSERT(instPtr != NULL);
+	ASSERT(config != NULL);
+	SYSBUS_UART_CONFIG uartConfig;
+	int32_t Status;
+	(*instPtr) = malloc(sizeof(SYSBUS));
+	if ((*instPtr) == NULL)
+	{
+		return ENOMEM;
+	}
+	(*instPtr)->rxQueue = NULL;
+	(*instPtr)->txQueue = NULL;
+	(*instPtr)->uartInst = NULL;
+	memcpy(&((*instPtr)->config), config, sizeof(SYSBUS_CONFIG));
+	memset(&((*instPtr)->sysbusLog), 0x00, sizeof(SYSBUSLOG));
+	memset(&((*instPtr)->linkLog), 0x00, sizeof(LINKLOG));
+	memset(&((*instPtr)->phyLog), 0x00, sizeof(PHYLOG));
+	memset(&((*instPtr)->hwState), 0x00, sizeof(HWSTATE));
+	uartConfig.baseAddr = config->baseAddr;
+	Status = SysbusUart_Init(&((*instPtr)->uartInst), &uartConfig);
+	if (Status != SUCCESS)
+	{
+		SystemBus_Destroy(*instPtr);
+		return ENOMEM;
+	}
+	if (CircQueueCreate(&((*instPtr)->txQueue), (*instPtr)->config.txQueueMax) == false)
+	{
+		SystemBus_Destroy(*instPtr);
+		return ENOMEM;
+	}
+	if (CircQueueCreate(&((*instPtr)->rxQueue), (*instPtr)->config.rxQueueMax) == false)
+	{
+		SystemBus_Destroy(*instPtr);
+		return ENOMEM;
+	}
+	(*instPtr)->isRxDone = false; // nothing received.
+	(*instPtr)->isTxDone = true;  // nothing to be sent.
+	return SUCCESS;
+}
+
+
+/*****************************************************************************/
+/**
+ * @brief   Destroy System Bus instance.
+ *
+ * @param   InstPtr A pointer to System Bus instance.
+ *
+ * @return  None.
+ *
+ ******************************************************************************/
+void SystemBus_Destroy(SYSBUS *instPtr)
+{
+	if (instPtr == NULL)
+	{
+		return;
+	}
+
+	free(instPtr->uartInst);
+	free(instPtr->txQueue);
+	free(instPtr->rxQueue);
+	free(instPtr);
+}
+
 /*****************************************************************************/
 /**
  * @brief   This function handles the systembus tx irq events.
@@ -737,17 +764,17 @@ int32_t SystemBus_RxIntrHandler(SYSBUS *instPtr)
 	Status = SysbusUart_Recv(instPtr->uartInst, sysbusReq);
 	if (Status != SUCCESS)
 	{
-		goto recv_error;
+		free(sysbusReq);
+		return Status;
 	}
 	if (CircQueuePush(instPtr->rxQueue, (void *)sysbusReq) == false)
 	{
 		DBG_ERROR("SystemBus::RX Queue overflowed!\n");
-		Status = EQUEUE;
+		free(sysbusReq);
-		goto recv_error;
+		return EQUEUE;
 	}
 	instPtr->isRxDone = false; // another reception is undergoing.
 	return SUCCESS;
-recv_error:
-	free(sysbusReq);
-	return Status;
 }
+
+/** @} SystemBus*/

df_datalink_sp/src/systembus/systembus.h

@@ -1,18 +1,20 @@
 /*****************************************************************************/
 /**
- * Description: System bus protocol head file.
+ * @file systembus.h
+ * @author FanHao (hao_fan_bit_ee@163.com)
+ * @brief System bus protocol header file.
+ * @version 0.1
+ * @date 2023-05-06
  *
- * Date: 2023-05-06 10:12
+ * @copyright Copyright(c) 2024 Beijing Institute of Technology.\n
- * Last Edit Time: [2023-05-06 10:13]
+ * Lab of Communication and Network
- *
- * Revisions: Rev 0.0
- * History:
- * [2023-05-06]: Initial version.
- *
- * Copyright(c) 2021 Beijing Institute of Technology.
  *
  ******************************************************************************/
 
+/**
+ * @defgroup SystemBus
+ * @{
+ */
 #ifndef __SYSTEMBUS_H_
 #define __SYSTEMBUS_H_
 
@@ -25,34 +27,48 @@
 
 /************************** Constant Definitions *****************************/
 /************************** Data Type Definitions ****************************/
-// Definition of SystemBus instance.
+
+/**
+ * @struct SYSBUS_CONFIG
+ * @brief SystemBus Config struct holds SystemBus initialization parameters
+ */
 typedef struct
 {
-    uintptr_t baseAddr;
+	uintptr_t baseAddr;	 ///< base address in memory
-    uint32_t txQueueMax;
+	uint32_t txQueueMax; ///< maximum tx queue length
-    uint32_t rxQueueMax;
+	uint32_t rxQueueMax; ///< maximum rx queue length
 } SYSBUS_CONFIG;
 
+/**
+ * @struct SYSBUS
+ * @brief SystemBus Instance struct
+ */
 typedef struct
 {
-    SYSBUS_CONFIG config;
+	SYSBUS_CONFIG config;  ///< SystemBus initialization parameters
-    SYSBUSLOG sysbusLog; // systembus log
+	SYSBUSLOG sysbusLog;   ///< SystemBus log
-	LINKLOG linkLog; // Link layer log
+	LINKLOG linkLog;	   ///< Link layer log
-	PHYLOG phyLog; // Physical layer log
+	PHYLOG phyLog;		   ///< Physical layer log
-	HWSTATE hwState; // Hardware status
+	HWSTATE hwState;	   ///< Hardware status
-    SYSBUS_UART *uartInst;
+	SYSBUS_UART *uartInst; ///< physical uart controller instance
-    CIRC_QUEUE *txQueue;
+	CIRC_QUEUE *txQueue;   ///< tx queue
-    CIRC_QUEUE *rxQueue;
+	CIRC_QUEUE *rxQueue;   ///< rx queue
-    bool isRxDone;
+	bool isTxDone;		   ///< tx done indicator
-    bool isTxDone;
+	bool isRxDone;		   ///< rx done indicator
 } SYSBUS;
 
 /************************** Function Prototypes ******************************/
 
 int32_t SystemBus_Init(SYSBUS **instPtr, SYSBUS_CONFIG *config);
+void SystemBus_Destroy(SYSBUS *instPtr);
 
+/**
+ * @defgroup SystemBus_Protocol_Routine
+ * @{
+ */
 int32_t SystemBus_HandleCmd(SYSBUS *instPtr);
 int32_t SystemBus_MakeResp(SYSBUS *instPtr);
+/** @} */
 
 int32_t SystemBus_TxIntrHandler(SYSBUS *instPtr);
 int32_t SystemBus_RxIntrHandler(SYSBUS *instPtr);
@@ -64,3 +80,5 @@ bool SystemBus_IsTxBusy(SYSBUS *instPtr);
 bool SystemBus_IsRxBusy(SYSBUS *instPtr);
 
 #endif //__SYSTEMBUS_H_
+
+/** @} SystemBus*/

df_datalink_sp/src/systembus/systembus_uart.c

@@ -1,18 +1,27 @@
 /*****************************************************************************/
 /**
- * Description: System bus uart driver implementation file.
+ * @file systembus_uart.h
+ * @author FanHao (hao_fan_bit_ee@163.com)
+ * @brief System bus uart driver implementation file.
+ * @version 0.1
+ * @date 2023-05-06
  *
- * Date: 2023-05-06 10:59
+ * @copyright Copyright(c) 2024 Beijing Institute of Technology.\n
- * LastEditTime: 2023-05-06 21:56
+ * Lab of Communication and Network
- * Revisions: Rev 0.0
- * History:
- * [2023-05-06]: Initial version.
- *
- * Copyright(c) 2022 Beijing Institute of Technology.
  *
  ******************************************************************************/
 
-/***************************** Include Files *******************************/
+/**
+ * @addtogroup SystemBus
+ * @{
+ */
+
+/**
+ * @addtogroup SystemBus_UART
+ * @{
+ */
+
+
 #include <stdlib.h>
 #include <string.h>
 #include <stdint.h>
@@ -20,6 +29,10 @@
 #include "systembus_uart.h"
 #include "common.h"
 
+/**
+ * @name SystemBus_UART_Driver_Constants
+ * @{
+ */
 // Control and status register
 #define MODULE_VERSION 0
 #define UART_STATUS 4
@@ -47,7 +60,7 @@
 #define FRAME_CHECK_LEN 1	 // CheckSum
 #define FRAME_INFO_LEN 3	 // CheckSum, Dummy and DataLen
 #define FRAME_OVERHEAD_LEN 7 // CheckSum, Dummy and DataLen
-/*************************** Function Definitions ****************************/
+/** @} SystemBus_UART_Driver_Constants*/
 
 /*****************************************************************************/
 /**
@@ -246,3 +259,7 @@ bool SysbusUart_IsTxBusy(SYSBUS_UART *instPtr)
 		return false;
 	}
 }
+
+/** @} SystemBus_UART*/
+
+/** @} SystemBus*/

df_datalink_sp/src/systembus/systembus_uart.h

@@ -1,17 +1,25 @@
 /*****************************************************************************/
 /**
- * Description: System bus uart driver implementation file.
+ * @file systembus_uart.h
+ * @author FanHao (hao_fan_bit_ee@163.com)
+ * @brief System bus uart driver header file.
+ * @version 0.1
+ * @date 2023-05-06
  *
- * Date: 2023-05-06 10:59
+ * @copyright Copyright(c) 2024 Beijing Institute of Technology.\n
- * LastEditTime: 2023-05-06 21:48
+ * Lab of Communication and Network
- * Revisions: Rev 0.0
- * History:
- * [2023-05-06]: Initial version.
- *
- * Copyright(c) 2022 Beijing Institute of Technology.
  *
  ******************************************************************************/
 
+/**
+ * @addtogroup SystemBus
+ * @{
+ */
+
+/**
+ * @defgroup SystemBus_UART
+ * @{
+ */
 #ifndef SYSTEMBUS_UART_H
 #define SYSTEMBUS_UART_H
 
@@ -61,16 +69,28 @@
 	IO_In32((baseAddr) + (offset))
 
 /************************** Data Type Definitions ****************************/
+/**
+ * @struct SYSBUS_UART_CONFIG
+ * @brief SystemBus UART driver initialization parameters
+ */
 typedef struct
 {
 	uintptr_t baseAddr;
 } SYSBUS_UART_CONFIG;
 
+/**
+ * @struct  SYSBUS_UART
+ * @brief SystemBus UART driver instance
+ */
 typedef struct
 {
 	SYSBUS_UART_CONFIG config;
 } SYSBUS_UART;
 
+/**
+ * @struct  SYSBUS_UART_FRAME
+ * @brief SystemBus UART frame definition
+ */
 typedef struct
 {
 	uint16_t len;
@@ -96,3 +116,7 @@ bool SysbusUart_IsRxBusy(SYSBUS_UART *instPtr);
 bool SysbusUart_IsTxBusy(SYSBUS_UART *instPtr);
 
 #endif // SYSTEMBUS_UART_H
+
+/** @} SystemBus_UART*/
+
+/** @} SystemBus*/

df_datalink_sp/src/time_ctrl/time_ctrl.c

@@ -1,20 +1,21 @@
 /*****************************************************************************/
 /**
- * Description: Time sync implementation file.
+ * @file time_ctrl.c
- *
+ * @author FanHao (hao_fan_bit_ee@163.com)
- * Author: Author's name
+ * @brief Time sync controller driver implementation file.
- * Date: 2023-12-20 16:32
+ * @version 0.0
- * LastEditors: FanHao
+ * @date 2023-12-20
- * LastEditTime: 2023-12-22 20:43
+ * @copyright Copyright(c) 2024 Beijing Institute of Technology.\n
- * Revisions: Rev 0.0
+ * Lab of Communication and Network
- * History:
- * [2023-12-20]: Initial version.
- *
- * Copyright(c) 2021 Beijing Institute of Technology.
- * Lab of Communication and Networking
  *
  ******************************************************************************/
 
+/**
+ * @addtogroup TimeController_Driver
+ * @{
+ */
+
+
 /***************************** Include Files *********************************/
 #include <string.h>
 #include "time_ctrl.h"
@@ -23,6 +24,10 @@
 #include "util.h"
 
 /************************** Constant Definitions *****************************/
+/**
+ * @name TimeController_REG_Constants
+ * @{
+ */
 #define VERSION_REG 0x00000004
 #define TIME_INT_REG 0x00000008
 #define TIME_FRAC_REG 0x0000000C
@@ -36,6 +41,9 @@
 #define CNTSTEP_OPT 0x0000002c
 
 #define TM_RESET_CODE 0x5253542E
+
+/** @} TimeController_REG_Constants*/
+
 /***************** Macros (Inline Functions) Definitions *********************/
 #define TMC_Read(instPtr, addr) IO_In32(instPtr->config.baseAddr + addr)
 #define TMC_Write(instPtr, addr, value) IO_Out32(instPtr->config.baseAddr + addr, value)
@@ -296,3 +304,5 @@ void TimeCtrl_CalculateTimeGap(const TIME_WORD *a, const TIME_WORD *b, TIME_WORD
 	gap->frac_part = (TIME_FRAC)(timeDiff % TIME_FRAC_MAX);
 	gap->frac_part = (TIME_INT)(timeDiff / TIME_FRAC_MAX);
 }
+
+/** @} TimeController_Driver*/

df_datalink_sp/src/time_ctrl/time_ctrl.h

@@ -1,19 +1,20 @@
 /*****************************************************************************/
 /**
- * Description: A simplified version of timesync for datalink 814 (Dijian)
+ * @file time_ctrl.h
- *
+ * @author FanHao (hao_fan_bit_ee@163.com)
- * Date: 2023-12-20-04 16:32
+ * @brief Time sync controller driver header file.
- * LastEditors: Fan Hao
+ * @version 0.0
- * LastEditTime: 2023-12-20 16:32
+ * @date 2023-12-20
- * Revisions: Rev 0.0
+ * @copyright Copyright(c) 2024 Beijing Institute of Technology.\n
- * History:
+ * Lab of Communication and Network
- * [2023-12-20]: Initial version.
- *
- * Copyright(c) 2021 Beijing Institute of Technology.
- * Lab of Communication and Networking
  *
  ******************************************************************************/
 
+/**
+ * @defgroup TimeController_Driver
+ * @{
+ */
+
 #ifndef TIME_CTRL_H_
 #define TIME_CTRL_H_
 
@@ -23,30 +24,44 @@
 #define TIME_FRAC_MAX 500000 // how many 10ns in a 5ms
 /***************** Macros (Inline Functions) Definitions *********************/
 /**************************** Type Definitions *******************************/
+/**
+ * @enum TIMECTRL_ADJ_TYPE
+ * @brief defines the time adjustment methods
+ */
 typedef enum
 {
-	TM_ADJ_NONE = 0,
+	TM_ADJ_NONE = 0, ///< none
-	TM_ADJ_ADD = 1,
+	TM_ADJ_ADD = 1, ///< adjust time by add
-	TM_ADJ_SET = 2
+	TM_ADJ_SET = 2  ///< adjust time by set
 } TIMECTRL_ADJ_TYPE;
 
 typedef uint32_t TIME_FRAC;
 typedef uint32_t TIME_INT;
 
+/**
+ * @struct TIME_WORD
+ * @brief Time controller time word
+ */
 typedef struct
 {
-	/* 5ms each LSB */
+	TIME_INT int_part; ///< 5ms each LSB
-	TIME_INT int_part;
+	TIME_FRAC frac_part; ///< 10ns each LSB
-	/* 10ns each LSB */
-	TIME_FRAC frac_part;
 } TIME_WORD;
 
+/**
+ * @struct TMC_CONFIG
+ * @brief TmcConfig holds the initialization parameters of time controller
+ */
 typedef struct
 {
 	uintptr_t baseAddr;
 	uint32_t reset; // time for reset (unit: us)
 } TMC_CONFIG;
 
+/**
+ * @struct TMC_INST
+ * @brief An instance struct of time controller
+ */
 typedef struct
 {
 	TMC_CONFIG config;
@@ -72,3 +87,5 @@ void TimeCtrl_TimeAdjust(TMC_INST *instPtr, const TIME_WORD *tmWord, TIMECTRL_AD
 void TimeCtrl_CalculateTimeGap(const TIME_WORD *a, const TIME_WORD *b, TIME_WORD *gap);
 
 #endif /* TIME_SYNC_H_ */
+
+/** @} */

df_datalink_sp/src/util/circ_queue.c

@@ -1,34 +1,25 @@
 /*****************************************************************************/
 /**
- * Description: A simple circular FIFO bounded queue
+ * @file circ_queue.c
+ * @author FanHao (hao_fan_bit_ee@163.com)
+ * @brief A simple circular FIFO bounded queue
+ * @version 0.1
+ * @date 2023-02-23
+ * @note Forked from https://github.com/chrismerck/rpa_queue.git
+ * @copyright Copyright(c) 2024 Beijing Institute of Technology.\n
+ * Lab of Communication and Network
  *
- * Author: Fan Hao
- * Date: 2023-02-23 10:29
- * LastEditors: Fan Hao
- * LastEditTime: 2023-02-23 13:18
- * Revisions: Rev 0.0
- * History:
- * [2023-02-23]: Initial Version.
- *
- * Copyright(c) 2023 Beijing Institute of Technology.
- * Lab of Communication and Networking
- * NOTE: Forked from https://github.com/chrismerck/rpa_queue.git
- * Licensed to the Apache Software Foundation (ASF) under one or more
- * contributor license agreements.  See the NOTICE file distributed with
- * this work for additional information regarding copyright ownership.
- * The ASF licenses this file to You under the Apache License, Version 2.0
- * (the "License"); you may not use this file except in compliance with
- * the License.  You may obtain a copy of the License at
- *
- *   http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
  ******************************************************************************/
 
+/**
+ * @addtogroup Utility
+ * @{
+ */
+
+/**
+ * @addtogroup CircularQueue
+ * @{
+ */
 #include "circ_queue.h"
 #include "common.h"
 #include <stdio.h>
@@ -56,14 +47,14 @@ void CircQueueFree(CIRC_QUEUE *queue)
 }
 
 /**
- * Initialize the CIRC_QUEUE.
+ * @brief Initialize the CIRC_QUEUE.
  */
 bool CircQueueCreate(CIRC_QUEUE **q, uint32_t queueCapacity)
 {
 	ASSERT(q != NULL);
 	CIRC_QUEUE *queue;
 	queue = malloc(sizeof(CIRC_QUEUE));
-  if (!queue)
+	if (queue == NULL)
 	{
 		return false;
 	}
@@ -74,20 +65,18 @@ bool CircQueueCreate(CIRC_QUEUE **q, uint32_t queueCapacity)
 	queue->data = malloc(queueCapacity * sizeof(void *));
 	if (queue->data == NULL)
 	{
-    goto error;
+		free(queue);
+		return false;
 	}
 	queue->bounds = queueCapacity;
 	queue->nelts = 0;
 	queue->in = 0;
 	queue->out = 0;
 	return true;
-error:
-  free(queue);
-  return false;
 }
 
 /**
- * Push new data onto the queue.
+ * @brief Push new data onto the queue.
  */
 bool CircQueuePush(CIRC_QUEUE *queue, void *data)
 {
@@ -110,7 +99,7 @@ bool CircQueuePush(CIRC_QUEUE *queue, void *data)
 }
 
 /**
- * Return current number of element in queue.
+ * @brief Return current number of element in queue.
  */
 inline uint32_t CircQueueSize(CIRC_QUEUE *queue)
 {
@@ -118,7 +107,7 @@ inline uint32_t CircQueueSize(CIRC_QUEUE *queue)
 }
 
 /**
- * Retrieves the next item from the queue.
+ * @brief Retrieves the next item from the queue.
  */
 bool CircQueuePop(CIRC_QUEUE *queue, void **data)
 {
@@ -139,3 +128,5 @@ bool CircQueuePop(CIRC_QUEUE *queue, void **data)
 	}
 	return true;
 }
+/** @} CircularQueue*/
+/** @} Utility*/

df_datalink_sp/src/util/clist.c

@@ -1,3 +1,25 @@
+/*****************************************************************************/
+/**
+ * @file clist.c
+ * @author FanHao (hao_fan_bit_ee@163.com)
+ * @brief A basic list data structure
+ * @version 0.1
+ * @date 2023-02-23
+ * @note Forked from https://github.com/clibs/list
+ * @copyright Copyright(c) 2024 Beijing Institute of Technology.\n
+ * Lab of Communication and Network
+ *
+ ******************************************************************************/
+
+/**
+ * @addtogroup Utility
+ * @{
+ */
+
+/**
+ * @addtogroup cList
+ * @{
+ */
 #ifndef LIST_MALLOC
 #define LIST_MALLOC malloc
 #endif
@@ -6,19 +28,12 @@
 #define LIST_FREE free
 #endif
 
-//
-// list.c
-//
-// Copyright (c) 2010 TJ Holowaychuk <[email protected]>
-//
-
 #include <stdint.h>
 #include "clist.h"
 
-/*
+/**
- * Allocates a new clist_node_t. NULL on failure.
+ * @brief a new clist_node_t. NULL on failure.
  */
-
 clist_node_t *
 clist_node_new(void *val)
 {
@@ -31,10 +46,9 @@ clist_node_new(void *val)
 	return self;
 }
 
-/*
+/**
- * Allocate a new clist_t. NULL on failure.
+ * @brief Allocate a new clist_t. NULL on failure.
  */
-
 clist_t *
 clist_new(void)
 {
@@ -49,11 +63,10 @@ clist_new(void)
 	return self;
 }
 
-/*
+/**
- * Remove all the node in list.
+ * @brief Remove all the node in list.
- * @self: Pointer to the list
+ * @param self: Pointer to the list
  */
-
 void clist_clear(clist_t *self)
 {
 	clist_node_t *next;
@@ -71,24 +84,21 @@ void clist_clear(clist_t *self)
 	self->head = NULL;
 }
 
-/*
+/**
- * Free the list.
+ * @brief Free the list.
- * @self: Pointer to the list
+ * @param self: Pointer to the list
  */
-
 void clist_destroy(clist_t *self)
 {
 	clist_clear(self);
 	LIST_FREE(self);
 }
 
-/*
+/**
- * Append the given node to the list
+ * @brief Append the given node to the list and return the node, NULL on failure.
- * and return the node, NULL on failure.
+ * @param self: Pointer to the list for popping node
- * @self: Pointer to the list for popping node
+ * @param node: the node to push
- * @node: the node to push
  */
-
 clist_node_t *
 clist_rpush(clist_t *self, clist_node_t *node)
 {
@@ -112,9 +122,9 @@ clist_rpush(clist_t *self, clist_node_t *node)
 	return node;
 }
 
-/*
+/**
- * Return / detach the last node in the list, or NULL.
+ * @brief Return / detach the last node in the list, or NULL.
- * @self: Pointer to the list for popping node
+ * @param self: Pointer to the list for popping node
  */
 
 clist_node_t *
@@ -138,9 +148,9 @@ clist_rpop(clist_t *self)
 	return node;
 }
 
-/*
+/**
- * Return / detach the first node in the list, or NULL.
+ * @brief Return / detach the first node in the list, or NULL.
- * @self: Pointer to the list for popping node
+ * @param self: Pointer to the list for popping node
  */
 
 clist_node_t *
@@ -164,11 +174,10 @@ clist_lpop(clist_t *self)
 	return node;
 }
 
-/*
+/**
- * Prepend the given node to the list
+ * @brief Prepend the given node to the list and return the node, NULL on failure.
- * and return the node, NULL on failure.
+ * @param self: Pointer to the list for pushing node
- * @self: Pointer to the list for pushing node
+ * @param node: the node to push
- * @node: the node to push
  */
 
 clist_node_t *
@@ -194,10 +203,10 @@ clist_lpush(clist_t *self, clist_node_t *node)
 	return node;
 }
 
-/*
+/**
- * Return the node associated to val or NULL.
+ * @brief Return the node associated to val or NULL.
- * @self: Pointer to the list for finding given value
+ * @param self: Pointer to the list for finding given value
- * @val: Value to find
+ * @param val: Value to find
  */
 
 clist_node_t *
@@ -230,10 +239,10 @@ clist_find(clist_t *self, void *val)
 	return NULL;
 }
 
-/*
+/**
- * Return the node at the given index or NULL.
+ * @brief Return the node at the given index or NULL.
- * @self: Pointer to the list for finding given index
+ * @param self: Pointer to the list for finding given index
- * @index: the index of node in the list
+ * @param index: the index of node in the list
  */
 
 clist_node_t *
@@ -260,10 +269,10 @@ clist_at(clist_t *self, int index)
 	return NULL;
 }
 
-/*
+/**
- * Remove the given node from the list, freeing it and it's value.
+ * @brief Remove the given node from the list, freeing it and it's value.
- * @self: Pointer to the list to delete a node
+ * @param self: Pointer to the list to delete a node
- * @node: Pointer the node to be deleted
+ * @param node: Pointer the node to be deleted
  */
 
 void clist_remove(clist_t *self, clist_node_t *node)
@@ -283,8 +292,8 @@ void clist_remove(clist_t *self, clist_node_t *node)
 	--self->len;
 }
 
-/*
+/**
- * Allocate a new clist_iterator_t. NULL on failure.
+ * @brief Allocate a new clist_iterator_t. NULL on failure.\n
  * Accepts a direction, which may be LIST_HEAD or LIST_TAIL.
  */
 
@@ -297,8 +306,8 @@ clist_iterator_new(clist_t *list, clist_direction_t direction)
 	return clist_iterator_new_from_node(node, direction);
 }
 
-/*
+/**
- * Allocate a new clist_iterator_t with the given start
+ * @brief Allocate a new clist_iterator_t with the given start
  * node. NULL on failure.
  */
 
@@ -313,8 +322,8 @@ clist_iterator_new_from_node(clist_node_t *node, clist_direction_t direction)
 	return self;
 }
 
-/*
+/**
- * Return the next clist_node_t or NULL when no more
+ * @brief Return the next clist_node_t or NULL when no more
  * nodes remain in the list.
  */
 
@@ -331,8 +340,8 @@ clist_iterator_next(clist_iterator_t *self)
 	return curr;
 }
 
-/*
+/**
- * Free the list iterator.
+ * @brief Free the list iterator.
  */
 
 void clist_iterator_destroy(clist_iterator_t *self)
@@ -340,3 +349,5 @@ void clist_iterator_destroy(clist_iterator_t *self)
 	LIST_FREE(self);
 	self = NULL;
 }
+/** @} cList*/
+/** @} Utility*/

df_datalink_sp/src/util/common.c

@@ -10,11 +10,14 @@
  * [2022-07-16]: New branch for Dijian.
  * [2021-11-16]: Initial version.
  *
- * Copyright(c) 2021 Beijing Institute of Technology.
+ * Copyright(c) 2024 Beijing Institute of Technology.
  * Lab of Communication and Networking
  *
  ******************************************************************************/
-
+/**
+ * @addtogroup COMMON_MACRO
+ * @{
+ */
 /***************************** Include Files *********************************/
 #include "common.h"
 #include "error.h"
@@ -44,3 +47,5 @@ void AppAssert(const char *file, int line)
 	while (1)
 		;
 }
+
+/** @} */

df_datalink_sp/src/util/crc.c

@@ -11,11 +11,14 @@
  * [2022-07-17]: Add CRC16_0x8005 CRC8_0x31.
  * [2022-01-06]: Initial verion (Basic CRC-16).
  *
- * Copyright(c) 2021 Beijing Institute of Technology.
+ * Copyright(c) 2024 Beijing Institute of Technology.
  * Lab of Communication and Networking
  *
  ******************************************************************************/
-
+/**
+ * @addtogroup Utility
+ * @{
+ */
 #include "util.h"
 #include "error.h"
 
@@ -437,3 +440,5 @@ bool crc16_check(uint8_t *buffPtr, uint32_t dataLen, uint32_t crcOffset, uint16_
 		return false;
 	}
 }
+
+/** @}*/

df_datalink_sp/src/util/list.c

@@ -1,5 +1,5 @@
 /*******************************************************************************
-*   @file   list.c
+ *   @file   list.c
  *   @brief  List library implementation
  *   @author Mihail Chindris (mihail.chindris@analog.com)
 ********************************************************************************

df_datalink_sp/src/util/util.c

@@ -1,15 +1,30 @@
-/******************************************************************************/
+/*****************************************************************************/
+/**
+ * @file util.c
+ * @author FanHao (hao_fan_bit_ee@163.com)
+ * @brief Utility functions implementation file
+ * @version 0.0
+ * @date 2023-05-06
+ *
+ * @copyright Copyright(c) 2024 Beijing Institute of Technology.\n
+ * Lab of Communication and Network
+ *
+ ******************************************************************************/
+
 /***************************** Include Files **********************************/
-/******************************************************************************/
+
+/**
+ * @addtogroup Utility
+ * @{
+ */
+
 #include <string.h>
 #include <stdlib.h>
 // #include <arm_acle.h>
 #include "util.h"
 #include "error.h"
 
-/******************************************************************************/
 /************************** Functions Implementation **************************/
-/******************************************************************************/
 #ifdef __BITSWAP_TABLE
 static uint8_t byte_flipLR[256] =
 {
@@ -48,17 +63,26 @@ static uint8_t byte_flipLR[256] =
 };
 #endif
 
+/**
+ * @brief Write a 32bit word to specific memory address
+ */
 inline void IO_Out32(uintptr_t addr, uint32_t value)
 {
 	volatile uint32_t *localAddr = (volatile uint32_t *)addr;
 	*localAddr = value;
 }
 
+/**
+ * @brief Read a 32bit word from specific memory address
+ */
 inline uint32_t IO_In32(uintptr_t addr)
 {
 	return *(volatile uint32_t *)addr;
 }
 
+/**
+ * @brief Swap a byte word bit-wise
+ */
 uint8_t byte_bit_swap(uint8_t byte)
 {
 #ifdef __BITSWAP_TABLE
@@ -68,6 +92,9 @@ uint8_t byte_bit_swap(uint8_t byte)
 #endif
 }
 
+/**
+ * @brief Swap 32bit word bit-wise
+ */
 uint32_t word_bit_swap(uint32_t word)
 {
 #ifdef __BITSWAP_TABLE
@@ -85,6 +112,9 @@ uint32_t word_bit_swap(uint32_t word)
 #endif
 }
 
+/**
+ * @brief Count ones in an 32bit word
+ */
 uint32_t count_ones(uint32_t word)
 {
 #ifdef __GNUC__
@@ -101,13 +131,16 @@ uint32_t count_ones(uint32_t word)
 #endif
 }
 
+/**
+ * @brief Convert fix ;oint number to float number
+ */
 double fix2double(int32_t val, uint8_t frac_bits)
 {
 	return (((double)val) / (BIT(frac_bits)));
 }
 
 /**
- * Find first set bit in word.
+ * @brief Find first set bit in word.
  */
 uint32_t find_first_set_bit(uint32_t word)
 {
@@ -136,7 +169,7 @@ uint32_t find_first_set_bit(uint32_t word)
 }
 
 /**
- * Find last set bit in word.
+ * @brief Find last set bit in word.
  */
 uint32_t find_last_set_bit(uint32_t word)
 {
@@ -166,7 +199,7 @@ uint32_t find_last_set_bit(uint32_t word)
 }
 
 /**
- * Locate the closest element in an array.
+ * @brief Locate the closest element in an array.
  */
 uint32_t find_closest(int32_t val,
 					  const int32_t *array,
@@ -189,7 +222,7 @@ uint32_t find_closest(int32_t val,
 }
 
 /**
- * Shift the value and apply the specified mask.
+ * @brief Shift the value and apply the specified mask.
  */
 uint32_t field_prep(uint32_t mask, uint32_t val)
 {
@@ -197,7 +230,7 @@ uint32_t field_prep(uint32_t mask, uint32_t val)
 }
 
 /**
- * Get a field specified by a mask from a word.
+ * @brief Get a field specified by a mask from a word.
  */
 uint32_t field_get(uint32_t mask, uint32_t word)
 {
@@ -205,7 +238,7 @@ uint32_t field_get(uint32_t mask, uint32_t word)
 }
 
 /**
- * Log base 2 of the given number.
+ * @brief Log base 2 of the given number.
  */
 int32_t log_base_2(uint32_t x)
 {
@@ -213,7 +246,7 @@ int32_t log_base_2(uint32_t x)
 }
 
 /**
- * Find greatest common divisor of the given two numbers.
+ * @brief Find greatest common divisor of the given two numbers.
  */
 uint32_t greatest_common_divisor(uint32_t a,
 								 uint32_t b)
@@ -232,7 +265,7 @@ uint32_t greatest_common_divisor(uint32_t a,
 }
 
 /**
- * Calculate best rational approximation for a given fraction.
+ * @brief Calculate best rational approximation for a given fraction.
  */
 void rational_best_approximation(uint32_t given_numerator,
 								 uint32_t given_denominator,
@@ -257,7 +290,7 @@ void rational_best_approximation(uint32_t given_numerator,
 }
 
 /**
- * Calculate the number of set bits.
+ * @brief Calculate the number of set bits.
  */
 uint32_t hweight8(uint32_t word)
 {
@@ -274,7 +307,7 @@ uint32_t hweight8(uint32_t word)
 }
 
 /**
- * Calculate the quotient and the remainder of an integer division.
+ * @brief Calculate the quotient and the remainder of an integer division.
  */
 uint64_t do_div(uint64_t *n,
 				uint64_t base)
@@ -288,7 +321,7 @@ uint64_t do_div(uint64_t *n,
 }
 
 /**
- * Unsigned 64bit divide with 64bit divisor and remainder
+ * @brief Unsigned 64bit divide with 64bit divisor and remainder
  */
 uint64_t div64_u64_rem(uint64_t dividend, uint64_t divisor, uint64_t *remainder)
 {
@@ -298,7 +331,7 @@ uint64_t div64_u64_rem(uint64_t dividend, uint64_t divisor, uint64_t *remainder)
 }
 
 /**
- * Unsigned 64bit divide with 32bit divisor with remainder
+ * @brief Unsigned 64bit divide with 32bit divisor with remainder
  */
 uint64_t div_u64_rem(uint64_t dividend, uint32_t divisor, uint32_t *remainder)
 {
@@ -308,7 +341,7 @@ uint64_t div_u64_rem(uint64_t dividend, uint32_t divisor, uint32_t *remainder)
 }
 
 /**
- * Signed 64bit divide with 32bit divisor with remainder
+ * @brief Signed 64bit divide with 32bit divisor with remainder
  */
 int64_t div_s64_rem(int64_t dividend, int32_t divisor, int32_t *remainder)
 {
@@ -317,7 +350,7 @@ int64_t div_s64_rem(int64_t dividend, int32_t divisor, int32_t *remainder)
 }
 
 /**
- * Unsigned 64bit divide with 32bit divisor
+ * @brief Unsigned 64bit divide with 32bit divisor
  */
 uint64_t div_u64(uint64_t dividend, uint32_t divisor)
 {
@@ -327,7 +360,7 @@ uint64_t div_u64(uint64_t dividend, uint32_t divisor)
 }
 
 /**
- * Signed 64bit divide with 32bit divisor
+ * @brief Signed 64bit divide with 32bit divisor
  */
 int64_t div_s64(int64_t dividend, int32_t divisor)
 {
@@ -336,7 +369,7 @@ int64_t div_s64(int64_t dividend, int32_t divisor)
 }
 
 /**
- * Converts from string to int32_t
+ * @brief Converts from string to int32_t
  * @param *str
  * @return int32_t
  */
@@ -352,7 +385,7 @@ int32_t str_to_int32(const char *str)
 }
 
 /**
- * Converts from string to uint32_t
+ * @brief Converts from string to uint32_t
  * @param *str
  * @return uint32_t
  */
@@ -366,3 +399,5 @@ uint32_t srt_to_uint32(const char *str)
 	else
 		return value;
 }
+
+/** @} */

df_datalink_sp/unit_test/linklayer_emulate_unit_test.c

@@ -68,7 +68,7 @@ void linklayer_setup(void)
 	ASSERT_EQUAL(SUCCESS, Status);
 	Status = TimeCtrl_Init(&tmcInstPtr, &tmcConfig);
 	ASSERT_EQUAL(SUCCESS, Status);
-	Status = Phy_InstInit(&phyInstPtr, &l1Config);
+	Status = Phy_Init(&phyInstPtr, &l1Config);
 	ASSERT_EQUAL(SUCCESS, Status);
 
 	// Update l2 config

makecopy

@@ -1,14 +1,41 @@
 #! /bin/sh
 
+# GE Software
 GE_TXATT=0
 GE_RXATT=25
 
 DST_DIR=`pwd`
 PROJECT_DIR=$( cd -- "$( dirname -- "${BASH_SOURCE[0]}" )" &> /dev/null && pwd )
 
-cp -rL $PROJECT_DIR/df_datalink_sp/src $DST_DIR/df_datalink_sp
+echo "Creating <df_datalink_ge>..."
 cp -rL $PROJECT_DIR/df_datalink_ge/src $DST_DIR/df_datalink_ge
+sed -i'' -e "s/antConfig->rfTxMgc = 0;/antConfig->rfTxMgc = $GE_TXATT;/g" $DST_DIR/df_datalink_ge/networking/phy_layer/phy_antenna.c
+sed -i'' -e "s/antConfig->rcvMgc = 0;/antConfig->rcvMgc = $GE_RXATT;/g" $DST_DIR/df_datalink_ge/networking/phy_layer/phy_antenna.c
 
-cd $DST_DIR/df_datalink_ge/networking/phy_layer
+# SP Software
-sed -i'' -e "s/antConfig->rfTxMgc = 0;/antConfig->rfTxMgc = $GE_TXATT;/g" ./phy_antenna.c
+source $PROJECT_DIR/caldata
-sed -i'' -e "s/antConfig->rcvMgc = 0;/antConfig->rcvMgc = $GE_RXATT;/g" ./phy_antenna.c
+
+for key in ${!calMap[*]};do
+    projName=df_datalink_$key
+    id=$(echo "$key" | grep -o -E '[0-9]+')
+    type=$(echo "$key" | grep -o -E '(LJ)|(JG)')
+    echo "Creating <$projName>..."
+    cp -rL $PROJECT_DIR/df_datalink_sp/src $DST_DIR/$projName
+
+    # substitute ID
+    if [ $type == "LJ" ]; then
+        sed -i'' "s/#define PHY_DEVICE_ID 0/#define PHY_DEVICE_ID (0x$id | 0x80)/g" $DST_DIR/$projName/config/app_config.h
+    elif [ $type == "JG" ]; then
+        sed -i'' "s/#define PHY_DEVICE_ID 0/#define PHY_DEVICE_ID (0x$id | 0x00)/g" $DST_DIR/$projName/config/app_config.h
+    else
+        echo "Unrecognized node Type [$type] ID [$id]"
+        exit 1
+    fi
+    # substitute table
+    sed -i'' "/^const uint16_t antCalTable\[L1_FRAME_MAX_HOPS\]\[L1_ANT_NUM_CH\] =/{
+    :table
+    N
+    /\};/!b table
+    s/=.*\};/=\n\/\/Antenna-$key\n${calMap[$key]}/
+    }" $DST_DIR/$projName/networking/phy_layer/phy_antenna.c
+done