42 RMH_API_IMPLEMENTATION_GENERIC_THEN_SOC(
51 "Initialize the RMH library and return a handle to the instance. This handle will be used in all future communication "
52 "with the RMH library. This function will fail if the MoCA driver is not properly install or is not able to operate. "
53 "Multiple simultaneous instances of RMH_Initialize are supported in single and multiprocess environments.",
57 INPUT_PARAM(eventCB,
const RMH_EventCallback,
58 "A pointer to a function which will handle any callbacks from the RMH MoCA library. A value of NULL is permitted if you do not wish to receive callbacks"),
60 INPUT_PARAM(userContext,
void*,
61 "A pointer to some data that will be passed back with each callback. A value of NULL is permitted if the client requires no context during callbacks")
74 RMH_API_IMPLEMENTATION_SOC_THEN_GENERIC(
101 RMH_API_IMPLEMENTATION_SOC_ONLY(
104 RMH_Result RMH_ValidateHandle(
RMH_Handle handle),
110 "Returns RMH_SUCCESS if the handle is still valid.",
128 RMH_API_IMPLEMENTATION_GENERIC_THEN_SOC(
137 "
Set the list of callbacks you which to receive. For each callback a call will be made to <eventCB> which is provided "
138 "in the call to <
RMH_Initialize>. By default all callbacks are disabled. Any subsequent calls to this API will "
139 "overwrite previous calls. For example, if you originally set value to 'RMH_API_PRINT' and later set to "
140 "'LINK_STATUS_CHANGED | MOCA_VERSION_CHANGED' you will stop receiving callbacks for 'RMH_API_PRINT'.",
145 INPUT_PARAM(value, const uint32_t, "A bitmask list of <RMH_Event> indicating the callbacks to be received.")
158 RMH_API_IMPLEMENTATION_GENERIC_ONLY(
167 "
Get the list of events for which the client has registered.",
172 OUTPUT_PARAM(response, uint32_t*, "A bitmask list of <RMH_Event> indicating the currently enabled callbacks.")
185 RMH_API_IMPLEMENTATION_GENERIC_ONLY(
194 "Return a list of all APIs which are part of
RMH.",
199 OUTPUT_PARAM(apiList,
RMH_APIList**, "Output list of APIs")
212 RMH_API_IMPLEMENTATION_GENERIC_ONLY(
222 "Return a list of all
RMH APIs which are unimplemented by the SoC library.",
227 OUTPUT_PARAM(apiList,
RMH_APIList**, "Output list of APIs")
240 RMH_API_IMPLEMENTATION_GENERIC_ONLY(
249 "Return the list of all
RMH APIs grouped into lists by their tags.",
254 OUTPUT_PARAM(apiTags,
RMH_APITagList**, "Output list of Tags and APIs which belong to them")
267 RMH_API_IMPLEMENTATION_GENERIC_ONLY(
276 "Convert <RMH_Result> to a
string",
280 INPUT_PARAM(value, const RMH_Result, "Value to be printed as a
string")
293 RMH_API_IMPLEMENTATION_GENERIC_ONLY(
302 "Convert <RMH_LinkStatus> to a
string",
306 INPUT_PARAM(value, const RMH_LinkStatus, "Value to be printed as a
string")
319 RMH_API_IMPLEMENTATION_GENERIC_ONLY(
328 "Convert <RMH_AdmissionStatus> to a
string",
332 INPUT_PARAM(value, const RMH_AdmissionStatus, "Value to be printed as a
string")
345 RMH_API_IMPLEMENTATION_GENERIC_ONLY(
354 "Convert <RMH_MoCAResetReason> to a
string",
358 INPUT_PARAM(value, const RMH_MoCAResetReason, "Value to be printed as a
string")
371 RMH_API_IMPLEMENTATION_GENERIC_ONLY(
380 "Convert <RMH_SubcarrierProfile> to a
string",
384 INPUT_PARAM(value, const RMH_SubcarrierProfile, "Value to be printed as a
string")
397 RMH_API_IMPLEMENTATION_GENERIC_ONLY(
406 "Convert <RMH_PERMode> to a
string",
410 INPUT_PARAM(value, const RMH_PERMode, "Value to be printed as a
string")
423 RMH_API_IMPLEMENTATION_GENERIC_ONLY(
432 "Convert <RMH_MoCAVersion> to a
string",
436 INPUT_PARAM(value, const RMH_MoCAVersion, "Value to be printed as a
string")
449 RMH_API_IMPLEMENTATION_GENERIC_ONLY(
452 const
char* const
RMH_PowerModeToString(const uint32_t value,
char* responseBuf, const
size_t responseBufSize),
458 "The input <value> should be a a bitmask of type <RMH_PowerMode>. This will be converted to a printable
string.",
462 INPUT_PARAM(value, const uint32_t, "A bitmask of <RMH_PowerMode> to be printed as a
string"),
463 OUTPUT_PARAM(responseBuf,
char*, "A buffer where the log level
string will be written"),
464 INPUT_PARAM(responseBufSize, const
size_t, "The size in bytes of the buffer <responseBuf>")
477 RMH_API_IMPLEMENTATION_GENERIC_ONLY(
486 "Convert <value> to a printable
string.",
490 INPUT_PARAM(value, const RMH_Band, "Value to be printed as a
string")
503 RMH_API_IMPLEMENTATION_GENERIC_ONLY(
506 const
char* const
RMH_LogLevelToString(const uint32_t value,
char* responseBuf, const
size_t responseBufSize),
512 "Return a the bitmask <value> as a
string. The bitmask is expected to contain one or more of <RMH_LogLevel>",
516 INPUT_PARAM(value, const uint32_t, "A bitmask of <RMH_LogLevel> to be printed as a
string"),
517 OUTPUT_PARAM(responseBuf,
char*, "A buffer where the log level
string will be written"),
518 INPUT_PARAM(responseBufSize, const
size_t, "The size in bytes of the buffer <responseBuf>")
531 RMH_API_IMPLEMENTATION_GENERIC_ONLY(
534 const
char* const
RMH_EventToString(const uint32_t value,
char* responseBuf, const
size_t responseBufSize),
540 "Return a the bitmask <value> as a
string. The bitmask is expected to contain one or more of <RMH_Event>",
544 INPUT_PARAM(value, const uint32_t, "A bitmask of <RMH_Event> to be printed as a
string"),
545 OUTPUT_PARAM(responseBuf,
char*, "A buffer where the log level
string will be written"),
546 INPUT_PARAM(responseBufSize, const
size_t, "The size in bytes of the buffer <responseBuf>")
559 RMH_API_IMPLEMENTATION_GENERIC_ONLY(
562 const
char* const
RMH_MacToString(const RMH_MacAddress_t value,
char* responseBuf, const
size_t responseBufSize),
568 "Return a the provded MAC address in <value> as a
string.",
572 INPUT_PARAM(value, const RMH_MacAddress_t, "A
byte array MAC address"),
573 OUTPUT_PARAM(responseBuf,
char*, "A buffer where the MAC
string will be written"),
574 INPUT_PARAM(responseBufSize, const
size_t, "The size in bytes of the buffer <responseBuf>")
587 RMH_API_IMPLEMENTATION_GENERIC_ONLY(
596 "Convert <value> to a printable
string.",
600 INPUT_PARAM(value, const RMH_ACAType, "Value to be printed as a
string")
613 RMH_API_IMPLEMENTATION_GENERIC_ONLY(
622 "Convert <value> to a printable
string.",
626 INPUT_PARAM(value, const RMH_ACAStatus, "Value to be printed as a
string")
639 RMH_API_IMPLEMENTATION_SOC_ONLY(
649 "Return if the MoCA driver is actively connected to or attempting to connect to a MoCA network",
654 OUTPUT_PARAM(response,
bool*,
655 "
Set to 'true' if the MoCA driver is active. Otherwise set to 'false'.")
668 RMH_API_IMPLEMENTATION_SOC_ONLY(
677 "Enable or disable the MoCA driver to connect to a MoCA network. Once enabled the driver will use whatever "
678 "parameters it has been configured for.",
683 INPUT_PARAM(value, const
bool,
684 "Pass 'true' to enable the MoCA driver. Otherwise pass to 'false'.")
691 "Configuration [
Set]"
697 RMH_API_IMPLEMENTATION_SOC_ONLY(
706 "Check if this device is actively connected to a MoCA network. If so, RMH_Network and RMH_Remote APIs will then be "
712 OUTPUT_PARAM(response,
bool*,
713 "
Set to 'true' if this is device is actively connected to a MoCA Network")
720 "Configuration [
Get],Link"
726 RMH_API_IMPLEMENTATION_SOC_ONLY(
735 "The last frequency on which this device operated.",
740 OUTPUT_PARAM(response, uint32_t*, "The last operating frequency of the device")
747 "Configuration [
Get],Frequency"
753 RMH_API_IMPLEMENTATION_SOC_ONLY(
762 "Manually set the last operating frequency of the device. This can be helpful to control what frequency is used for "
763 " future network connections.",
768 INPUT_PARAM(value, const uint32_t, "The desired last operating frequency of the device")
775 "Configuration [
Set],Frequency"
781 RMH_API_IMPLEMENTATION_SOC_ONLY(
790 "Return if the device is scanning only the last operating frequency when attempting to establish a connection to a "
796 OUTPUT_PARAM(response,
bool*,
797 "
Set to 'true' if only the LOF is being checked when joining a MoCA network. Otherwise set to 'false'.")
804 "Configuration [
Get],Frequency"
810 RMH_API_IMPLEMENTATION_SOC_ONLY(
819 "Indicate if the device should join networks only on the last operating frequency. This is helpful to control the "
820 "exact frequency used for MoCA",
825 INPUT_PARAM(value, const
bool,
826 "Pass 'true' to ensure this node will only join a network at the LOF. Otherwise pass to 'false'.")
833 "Configuration [
Set],Frequency"
839 RMH_API_IMPLEMENTATION_SOC_ONLY(
848 "Return if this device is a preferred NC.",
853 OUTPUT_PARAM(response,
bool*,
854 "
Set to 'true' if the device is a preferred NC. Otherwise set to 'false'.")
861 "Configuration [
Get],NC"
867 RMH_API_IMPLEMENTATION_SOC_ONLY(
876 "Enable or disable preferred NC on this device. If this is enabled the device has a greater chance of becoming the NC, "
877 "if set disable the chance of becoming the NC is reduced. However, please keep in mind that depending on your network "
878 "configuration, a device with preferred NC disabled could still become the NC."
879 "\n**NOTE: Setting this value may trigger a restart of the MoCA driver and cause the device to temporarily leave the network.",
884 INPUT_PARAM(value, const
bool,
885 "Pass 'true' to enable this device as a preferred NC. Otherwise pass to 'false'.")
892 "Configuration [
Set],NC"
898 RMH_API_IMPLEMENTATION_SOC_ONLY(
907 "TBD [mocaIfPrimaryChannelOffset]",
912 OUTPUT_PARAM(response, int32_t*, "TBD")
919 "Configuration [
Get],NC"
925 RMH_API_IMPLEMENTATION_SOC_ONLY(
934 "TBD [mocaIfSecondaryChannelOffset]",
939 INPUT_PARAM(value, const int32_t, "TBD")
946 "Configuration [
Set],NC"
952 RMH_API_IMPLEMENTATION_SOC_ONLY(
966 OUTPUT_PARAM(response, int32_t*, "TBD")
973 "Configuration [
Get],NC"
979 RMH_API_IMPLEMENTATION_SOC_ONLY(
993 INPUT_PARAM(value, const int32_t, "TBD")
1000 "Configuration [
Set],NC"
1006 RMH_API_IMPLEMENTATION_SOC_ONLY(
1015 "Return the version of software being used by the MoCA driver on this device. [mocaIfSoftwareVersion]",
1020 OUTPUT_PARAM(responseBuf,
char*, "A buffer where the software version
string will be written"),
1021 INPUT_PARAM(responseBufSize, const
size_t, "The size in bytes of the buffer <responseBuf>")
1034 RMH_API_IMPLEMENTATION_SOC_ONLY(
1043 "Return the highest version of MoCA supported by the MoCA driver on this device. [mocaIfMocaVersion]",
1048 OUTPUT_PARAM(response, RMH_MoCAVersion*, "The highest version of MoCA supported")
1061 RMH_API_IMPLEMENTATION_SOC_ONLY(
1070 "
Set the bit mask for specifying which frequencies should be scanned during the listening phase of network search. "
1071 "Depending on the RF band of operation, the MSB of this parameter corresponds to the lowest frequency channel of the band. "
1072 "Each subsequent bit of this parameter represents the next highest 25MHz channel. The base channels for each RF band "
1073 "are as follows:\n\n"
1074 "\tBand D-Low : 46 (1150 MHz)\n"
1075 "\tBand D-High: 56 (1400 MHz)\n"
1076 "\tBand Ext-D : 46 (1150 MHz)\n"
1077 "\tBand C4 : 40 (1000 MHz)\n"
1078 "\tBand E : 20 ( 500 MHz)\n"
1079 "\tBand F : 27 ( 675 MHz)\n"
1080 "\tBand H : 39 ( 975 MHz)",
1085 OUTPUT_PARAM(response, uint32_t*,
1086 "The bitmask of frequencies this device will use when joining a network")
1093 "Configuration [
Get],Frequency"
1099 RMH_API_IMPLEMENTATION_SOC_ONLY(
1108 "
Set the bit mask for specifying which frequencies should be scanned during the listening phase of network search. "
1109 "Depending on the RF band of operation, the MSB of this parameter corresponds to the lowest frequency channel of the band. "
1110 "Each subsequent bit of this parameter represents the next highest 25MHz channel. The base channels for each RF band "
1111 "are as follows:\n\n"
1112 "\tBand D-Low : 46 (1150 MHz)\n"
1113 "\tBand D-High: 56 (1400 MHz)\n"
1114 "\tBand Ext-D : 46 (1150 MHz)\n"
1115 "\tBand C4 : 40 (1000 MHz)\n"
1116 "\tBand E : 20 ( 500 MHz)\n"
1117 "\tBand F : 27 ( 675 MHz)\n"
1118 "\tBand H : 39 ( 975 MHz)\n",
1123 INPUT_PARAM(value, const uint32_t,
1124 "The bitmask of frequencies this device should use when joining a network")
1131 "Configuration [
Set],Frequency"
1137 RMH_API_IMPLEMENTATION_SOC_ONLY(
1146 "
Get the maximum number of packets this device will aggregate. [mocaIfPduNumber]",
1151 OUTPUT_PARAM(response, uint32_t*, "The maximum number of packets this device will aggregate")
1158 "Configuration [
Get]"
1164 RMH_API_IMPLEMENTATION_SOC_ONLY(
1173 "
Set the maximum allowed packets for aggregated transmissions.",
1178 INPUT_PARAM(value, const uint32_t, "The maximum number of packets this device can aggregate")
1185 "Configuration [
Set]"
1191 RMH_API_IMPLEMENTATION_SOC_ONLY(
1200 "The maximum number of bytes this node can receive in one frame (aggregated transmission). [mocaIfAggregationSize]",
1205 OUTPUT_PARAM(response, uint32_t*, "The maximum number of packets this device will aggregate")
1212 "Configuration [
Get]"
1218 RMH_API_IMPLEMENTATION_SOC_ONLY(
1227 "
Set the maximum number of bytes this node can receive in one frame (aggregated transmission).",
1232 INPUT_PARAM(value, const uint32_t, "The maximum number of packets this device can aggregate")
1239 "Configuration [
Set]"
1245 RMH_API_IMPLEMENTATION_SOC_ONLY(
1254 "
Get the current lower limit for PHY rate between two nodes.",
1259 OUTPUT_PARAM(response, uint32_t*, "The lower PHY limit")
1266 "Configuration [
Get]"
1272 RMH_API_IMPLEMENTATION_SOC_ONLY(
1281 "
Set the lower threshold for the PHY link bandwidth between two nodes. If the rate falls below this limit a callback "
1282 "of type <RMH_EVENT_LOW_BANDWIDTH> will be triggered",
1287 INPUT_PARAM(value, const uint32_t, "The new value to use as the lower PHY limit")
1294 "Configuration [
Set]"
1300 RMH_API_IMPLEMENTATION_SOC_ONLY(
1309 "The maximum PHY rate supported in non-turbo mode.",
1314 OUTPUT_PARAM(response, uint32_t*, "The maximum PHY rate")
1321 "Configuration [
Get],Phy"
1327 RMH_API_IMPLEMENTATION_SOC_ONLY(
1336 "
Set the maximum transmitter power level for this device."
1337 "\n**NOTE: Setting this value may trigger a restart of the MoCA driver and cause the device to temporarily leave the network.",
1342 INPUT_PARAM(value, const int32_t, "Desired transmitter power level. Minimum value -31, maximum value 3.")
1349 "Configuration [
Set],Power"
1355 RMH_API_IMPLEMENTATION_SOC_ONLY(
1364 "
Get the current maximum transmission power level for this device.",
1369 OUTPUT_PARAM(response, int32_t*, "The maximum transmission power for this device")
1376 "Configuration [
Get],Power"
1382 RMH_API_IMPLEMENTATION_SOC_ONLY(
1391 "Return a list of frequencies in the band used by this node. This frequency list does not account for taboo channels "
1392 "or other filters which would limit the scope of frequencies this device would use to join a network. [mocaIfChannelSupport]",
1397 OUTPUT_PARAM(responseArray, uint32_t*, "An array where the frequency list should be stored"),
1398 INPUT_PARAM(responseArraySize, const
size_t, "The size of the response array"),
1399 OUTPUT_PARAM(responseArrayUsed,
size_t*, "The number of entries in the response array which have valid data")
1406 "Configuration [
Get],Frequency"
1412 RMH_API_IMPLEMENTATION_SOC_ONLY(
1421 "Return the band supported by the MoCA device. [mocaIfSupportedBands]\n\n"
1422 " --- Band Frequencies -------------------------------------------------------\n"
1423 " RMH_BAND_C4 [MoCA 1.1]: 1000\n"
1424 " RMH_BAND_D [MoCA 1.1]: 1150, 1200, 1250, 1300, 1350, 1400, 1450, 1500\n"
1425 " RMH_BAND_D_LOW: 1125, 1150, 1175, 1200, 1225\n"
1426 " RMH_BAND_D_HIGH: 1350, 1375, 1400, 1425, 1450, 1475, 1500, 1525, 1550, 1575, 1600, 1625\n"
1427 " RMH_BAND_D_EX: 1150, 1200, 1250, 1300, 1350, 1400, 1450, 1500\n"
1428 " RMH_BAND_E: 500, 525, 550, 575, 600\n"
1429 " RMH_BAND_F: 675, 700, 725, 750, 775, 800, 825, 850\n"
1430 " RMH_BAND_H: 975, 1000, 1025\n",
1435 OUTPUT_PARAM(response, RMH_Band*, "The band supported by this MoCA device")
1442 "Configuration [
Get],Frequency"
1448 RMH_API_IMPLEMENTATION_SOC_ONLY(
1457 "Return if this device is set as QAM256 capable in admission negotiations.",
1462 OUTPUT_PARAM(response,
bool*, "
Set to 'true' if QAM256 support is enabled. Otherwise set to 'false'.")
1475 RMH_API_IMPLEMENTATION_SOC_ONLY(
1484 "Enable or disable the QAM256 ability in admission negotiations."
1485 "\n**NOTE: Setting this value may trigger a restart of the MoCA driver and cause the device to temporarily leave the network.",
1490 INPUT_PARAM(value, const
bool, "Pass 'true' to enable QAM256 support on this device. Otherwise pass to 'false'.")
1497 "Configuration [
Set],QAM"
1503 RMH_API_IMPLEMENTATION_SOC_ONLY(
1512 "
Get the target PHY rate for normal transmissions to MoCA 1.1 nodes when they support qam256",
1517 OUTPUT_PARAM(response, uint32_t*, "The target PHY rate in Mbps")
1530 RMH_API_IMPLEMENTATION_SOC_ONLY(
1539 "
Set the target PHY rate for normal transmissions to MoCA 1.1 nodes when they support qam256",
1544 INPUT_PARAM(value, const uint32_t, "The target PHY rate in Mbps")
1551 "Configuration [
Set],QAM,Phy"
1557 RMH_API_IMPLEMENTATION_SOC_ONLY(
1561 RMH_Result RMH_Self_GetPrimaryChannelTargetPhyRate(const
RMH_Handle handle, uint32_t* response),
1564 RMH_Self_GetPrimaryChannelTargetPhyRate,
1567 "
Get the target PHY rate for unicast transmissions on the primary channel.",
1572 OUTPUT_PARAM(response, uint32_t*, "The target PHY rate in Mbps")
1585 RMH_API_IMPLEMENTATION_SOC_ONLY(
1588 RMH_Result RMH_Self_SetPrimaryChannelTargetPhyRate(const
RMH_Handle handle, const uint32_t value),
1591 RMH_Self_SetPrimaryChannelTargetPhyRate,
1594 "
Set the target PHY rate for unicast transmissions on the primary channel.",
1599 INPUT_PARAM(value, const uint32_t, "The target PHY rate in Mbps")
1606 "Configuration [
Set],QAM,Phy"
1611 RMH_API_IMPLEMENTATION_SOC_ONLY(
1614 RMH_Result RMH_Self_GetSecondaryChannelTargetPhyRate(const
RMH_Handle handle, uint32_t* response),
1617 RMH_Self_GetSecondaryChannelTargetPhyRate,
1620 "
Get the target PHY rate for unicast transmissions on the secondary channel.",
1625 OUTPUT_PARAM(response, uint32_t*, "The target PHY rate in Mbps")
1638 RMH_API_IMPLEMENTATION_SOC_ONLY(
1641 RMH_Result RMH_Self_SetSecondaryChannelTargetPhyRate(const
RMH_Handle handle, const uint32_t value),
1644 RMH_Self_SetSecondaryChannelTargetPhyRate,
1647 "
Set the target PHY rate for unicast transmissions on the secondary channel.",
1652 INPUT_PARAM(value, const uint32_t, "The target PHY rate in Mbps")
1659 "Configuration [
Set],QAM,Phy"
1665 RMH_API_IMPLEMENTATION_SOC_ONLY(
1674 "Return if turbo mode is enabled on this device",
1679 OUTPUT_PARAM(response,
bool*, "
Set to 'true' if turbo is enabled. Otherwise set to 'false'.")
1692 RMH_API_IMPLEMENTATION_SOC_ONLY(
1701 "Enable or disable turbo mode on this device",
1706 INPUT_PARAM(value, const
bool, "Pass 'true' to enable turbo on this device. Otherwise pass to 'false'.")
1713 "Configuration [
Set],Turbo"
1719 RMH_API_IMPLEMENTATION_SOC_ONLY(
1728 "Return if bonding mode is enabled on this device",
1733 OUTPUT_PARAM(response,
bool*, "
Set to 'true' if bonding is enabled. Otherwise set to 'false'.")
1746 RMH_API_IMPLEMENTATION_SOC_ONLY(
1756 "Enable or disable bonding mode on this device",
1761 INPUT_PARAM(value, const
bool, "Pass 'true' to enable bonding on this device. Otherwise pass to 'false'.")
1768 "Configuration [
Set],Bonding"
1774 RMH_API_IMPLEMENTATION_GENERIC_ONLY(
1783 "Current operational status of the MoCA interface [mocaIfStatus]. This API combines all known information about the MoCA device, "
1784 "including the driver, MoCA link, interface status, ect. to determine if the link is functional. >RMH_LINK_STATUS_UP> "
1785 "indicates MoCA is ready for use.",
1790 OUTPUT_PARAM(status, RMH_LinkStatus*, "The current link state of MoCA")
1797 "Configuration [
Get],Link"
1803 RMH_API_IMPLEMENTATION_SOC_ONLY(
1812 "Return if MoCA privacy is enabled on this device",
1817 OUTPUT_PARAM(response,
bool*, "
Set to 'true' if MoCA privacy is enabled. Otherwise set to 'false'.")
1824 "Configuration [
Get],Self,Privacy"
1830 RMH_API_IMPLEMENTATION_SOC_ONLY(
1839 "Enable or disable MoCA privacy on this device. If enabled the device will only be permitted to join networks with "
1840 "other devices which have the same password.",
1845 INPUT_PARAM(value, const
bool, "Pass 'true' to enable MoCA privacy on this device. Otherwise pass to 'false'.")
1852 "Configuration [
Set],Self,Privacy"
1858 RMH_API_IMPLEMENTATION_SOC_ONLY(
1867 "
Get the current MoCA privacy password.",
1872 OUTPUT_PARAM(responseBuf,
char*, "A buffer where the MoCA password will be written"),
1873 INPUT_PARAM(responseBufSize, const
size_t, "The size in bytes of the buffer <responseBuf>")
1886 RMH_API_IMPLEMENTATION_SOC_ONLY(
1895 "
Set the network password used to generate privacy keys. This
string must be between 12 and 17 characters
long with "
1896 "each character being a decimal number (0-9).",
1901 INPUT_PARAM(value, const
char*, "The MoCA network password. Although this is a
string only 0-9 are permitted.")
1908 "Configuration [
Set],Privacy"
1914 RMH_API_IMPLEMENTATION_SOC_ONLY(
1923 "
Get the SHA1 hash of the MoCA password as an ASCII
string. [mocaIfPasswordHash]",
1928 OUTPUT_PARAM(responseBuf,
char*, "A buffer where the MoCA managment key will be written"),
1929 INPUT_PARAM(responseBufSize, const
size_t, "The size in bytes of the buffer <responseBuf>")
1943 RMH_API_IMPLEMENTATION_SOC_ONLY(
1952 "Return which channels will be taboo on this device. <channelMaskStart> will indicate the channel number of the lowest "
1953 "RF frequency covered by <channel mask>. The bitmask <channelMask> is then used to identify exactly which frequencies "
1954 "are taboo. Each consecutive bit of <channelMask> corresponds to channels offset by multiples of 25MHz. A bit in "
1955 "<channelMask> will be set to '1' if that channel is taboo.",
1960 INPUT_PARAM(channelMaskStart, uint32_t*, "The channel number of the lowest frequency which is taboo"),
1961 INPUT_PARAM(channelMask, uint32_t*,
1962 "A bitmask of channels which are taboo. The first bit corresponds to the frequency of <channelMaskStart>")
1969 "Self,Taboo,Frequency"
1975 RMH_API_IMPLEMENTATION_SOC_ONLY(
1984 "
Set which channels will be taboo on this device. <channelMaskStart> will indicate the channel number of the lowest "
1985 "RF frequency covered by <channel mask>. The bitmask <channelMask> is then used to identify exactly which frequencies "
1986 "are taboo. Each consecutive bit of <channelMask> corresponds to channels offset by multiples of 25MHz. A bit in "
1987 "<channelMask> must be set to '1' if that channel is taboo.",
1992 INPUT_PARAM(channelMaskStart, const uint32_t, "The channel number of the lowest frequency which is taboo"),
1993 INPUT_PARAM(channelMask, const uint32_t,
1994 "A bitmask of channels which are taboo. The first bit corresponds to the frequency of <channelMaskStart>")
2001 "Configuration [
Set],Taboo"
2007 RMH_API_IMPLEMENTATION_SOC_ONLY(
2016 "Return this device to its default MoCA configuration",
2027 "Configuration [
Set]"
2033 RMH_API_IMPLEMENTATION_GENERIC_ONLY(
2036 RMH_Result RMH_Self_RestoreRDKDefaultSettings(const
RMH_Handle handle),
2039 RMH_Self_RestoreRDKDefaultSettings,
2042 "Return this device to its default RDK MoCA configuration",
2053 "Configuration [
Set]"
2059 RMH_API_IMPLEMENTATION_SOC_ONLY(
2068 "Return the maximum number of allocation elements, excluding the TAUs and the Dummy DAUs, in one MAP the Node can process [mocaIfAeNumber]",
2073 OUTPUT_PARAM(response, uint32_t*, "Maximum number of allocation elements")
2080 "Configuration [
Get]"
2086 RMH_API_IMPLEMENTATION_SOC_ONLY(
2096 "Return the reason for the most recent link reset [mocaIfResetReason]",
2101 OUTPUT_PARAM(response, RMH_MoCAResetReason*, "The reason for the most recent link reset")
2108 "Network,Remote Node"
2114 RMH_API_IMPLEMENTATION_GENERIC_ONLY(
2123 "Check if the MoCA interface is enabled at the kernel level. Do not confuse with <
RMH_Self_GetEnabled> which checks if "
2124 "the MoCA driver is active",
2129 OUTPUT_PARAM(response,
bool*,
2130 "
Set to 'true' if the MoCA interface is enabled at the kernel level. Otherwise set to 'false'.")
2137 "Configuration [
Get],Interface"
2143 RMH_API_IMPLEMENTATION_GENERIC_ONLY(
2152 "
Set MoCA interface enabled or disabled at the kernel level. Do not confuse with <
RMH_Self_SetEnabled> which checks "
2153 "if the MoCA driver is active",
2158 INPUT_PARAM(value, const
bool, "Pass 'true' to enable the interface. Otherwise pass to 'false'.")
2165 "Configuration [
Set],Interface"
2171 RMH_API_IMPLEMENTATION_SOC_ONLY(
2180 "Return the Linux interface name associated with the MoCA device. [mocaIfName]",
2185 OUTPUT_PARAM(responseBuf,
char*, "A buffer where the interface name will be written"),
2186 INPUT_PARAM(responseBufSize, const
size_t, "The size in bytes of the buffer <responseBuf>")
2193 "Configuration [
Get],Interface"
2199 RMH_API_IMPLEMENTATION_SOC_ONLY(
2208 "Return the MAC address associated with this MoCA device. [mocaIfMacAddress]",
2213 OUTPUT_PARAM(response, RMH_MacAddress_t*, "The MAC address as a
byte array")
2220 "Configuration [
Get],Interface,mac"
2226 RMH_API_IMPLEMENTATION_SOC_ONLY(
2235 "
Set the MAC address associated with this MoCA device.",
2240 INPUT_PARAM(value, const RMH_MacAddress_t, "The desired MAC address as a
byte array")
2247 "Configuration [
Set],Interface,mac"
2253 RMH_API_IMPLEMENTATION_SOC_ONLY(
2262 "Return the current MoCA power state of this device.",
2267 OUTPUT_PARAM(response, RMH_PowerMode*, "The current power mode of this device")
2274 "Configuration [
Get],Power"
2280 RMH_API_IMPLEMENTATION_SOC_ONLY(
2289 "Return a bitmask of <RMH_PowerMode> indicating all MoCA power modes supported by this device. [mocaIfPowerStateCap]",
2294 OUTPUT_PARAM(response, uint32_t*, "A bitmask of <RMH_PowerMode> listing supported modes")
2301 "Configuration [
Get],Power"
2307 RMH_API_IMPLEMENTATION_SOC_ONLY(
2310 RMH_Result RMH_Power_GetStandbyMode(const
RMH_Handle handle, RMH_PowerMode* response),
2313 RMH_Power_GetStandbyMode,
2316 "Return the power state MoCA will go to when the system goes to standby.",
2321 OUTPUT_PARAM(response, RMH_PowerMode*, "The power mode of this device will use in standby")
2328 "Configuration [
Get],Power"
2334 RMH_API_IMPLEMENTATION_SOC_ONLY(
2337 RMH_Result RMH_Power_SetStandbyMode(const
RMH_Handle handle, const RMH_PowerMode response),
2340 RMH_Power_SetStandbyMode,
2343 "
Set the power state of the MoCA device when the device goes to standby. This may trigger MoCA to restart.",
2348 INPUT_PARAM(response, const RMH_PowerMode, "The desired power mode for the device")
2355 "Configuration [
Set],Power"
2361 RMH_API_IMPLEMENTATION_SOC_ONLY(
2370 "Return if transmit power control is enabled or disabled for this device",
2375 OUTPUT_PARAM(response,
bool*,
2376 "
Set to 'true' if transmission power control is enabled. Otherwise set to 'false'.")
2383 "Configuration [
Get],Power"
2389 RMH_API_IMPLEMENTATION_SOC_ONLY(
2398 "Enable or disable if transmit power control is enabled for this device",
2403 INPUT_PARAM(value, const
bool, "Pass 'true' to enable transmission power control on this device. Otherwise pass to 'false'.")
2410 "Configuration [
Set],Power"
2416 RMH_API_IMPLEMENTATION_SOC_ONLY(
2425 "Return if beacon power reduction is enabled on this device.",
2430 OUTPUT_PARAM(response,
bool*, "
Set to 'true' if beacon power reduction is enabled. Otherwise set to 'false'.")
2437 "Configuration [
Get],Power"
2443 RMH_API_IMPLEMENTATION_SOC_ONLY(
2452 "Enable or disable if beacon power reduction on this device.",
2457 INPUT_PARAM(value, const
bool, "Pass 'true' to enable beacon power control on this device. Otherwise pass to 'false'.")
2464 "Configuration [
Set],Power"
2470 RMH_API_IMPLEMENTATION_SOC_ONLY(
2479 "Return the power control back-off used by this node for transmitting beacons",
2484 OUTPUT_PARAM(response, uint32_t*, "Beacon power reduction")
2497 RMH_API_IMPLEMENTATION_SOC_ONLY(
2506 "
Set the power control back-off used by this node for transmitting beacons",
2511 INPUT_PARAM(value, const uint32_t, "Beacon power reduction. Minimum value 0, Maximum value 5.")
2518 "Configuration [
Set],Power"
2524 RMH_API_IMPLEMENTATION_SOC_ONLY(
2533 "Return the number of MoCA nodes in the network. [mocaIfNumNodes]",
2538 OUTPUT_PARAM(response, uint32_t*, "Number of MoCA nodes in the network")
2551 RMH_API_IMPLEMENTATION_SOC_ONLY(
2560 "Return the node ID of this device. [mocaIfNodeID] This is a zero based ID which uniquely identifies this node on the network.",
2565 OUTPUT_PARAM(response, uint32_t*, "The device's node ID")
2578 RMH_API_IMPLEMENTATION_SOC_ONLY(
2587 "Return a list of every node ID on the network. This differs from <
RMH_Network_GetRemoteNodeIds> as this API *includes* the self node",
2592 OUTPUT_PARAM(response,
RMH_NodeList_Uint32_t*, "Where the index is the node Id, if <nodePresent> is 'true', <nodeValue> is the node Id.")
2605 RMH_API_IMPLEMENTATION_SOC_ONLY(
2614 "Return a list of every node ID on the network. This differs from <
RMH_Network_GetNodeIds> as this API *does not include* the self node",
2619 OUTPUT_PARAM(response,
RMH_NodeList_Uint32_t*, "Where the index is the node Id, if <nodePresent> is 'true', <nodeValue> is the node Id.")
2626 "Network,Remote Node"
2632 RMH_API_IMPLEMENTATION_GENERIC_ONLY(
2641 "Return a list of the associated ID for every node on the network. This is a one-based index of every remote node on the network. The self node is not included in this list.",
2646 OUTPUT_PARAM(response,
RMH_NodeList_Uint32_t*, "Where the index is the node Id, if <nodePresent> is 'true', <nodeValue> is the associated Id for that node.")
2659 RMH_API_IMPLEMENTATION_SOC_ONLY(
2668 "Return the node ID of the network coordinator. [mocaIfNC]",
2673 OUTPUT_PARAM(response, uint32_t*, "The network coordinator node Id")
2686 RMH_API_IMPLEMENTATION_SOC_ONLY(
2695 "Return the node ID of the backup network coordinator. [mocaIfBackupNC]",
2700 OUTPUT_PARAM(response, uint32_t*, "The backup network coordinator node Id")
2713 RMH_API_IMPLEMENTATION_SOC_ONLY(
2722 "Return the MAC address of the network coordinator.",
2727 OUTPUT_PARAM(response, RMH_MacAddress_t*, "The MAC address of the network coordinator")
2740 RMH_API_IMPLEMENTATION_SOC_ONLY(
2749 "Returns the amount of time this node has been part of the MoCA network [mocaIfLinkUpTime]. Time is in seconds",
2754 OUTPUT_PARAM(response, uint32_t*, "Number of seconds this node has been in the network")
2767 RMH_API_IMPLEMENTATION_SOC_ONLY(
2776 "Returns the number of times the MoCA link has gone down since the last boot. [mocaIfResetCount]",
2781 OUTPUT_PARAM(response, uint32_t*, "Number of seconds this node has been in the network")
2794 RMH_API_IMPLEMENTATION_SOC_ONLY(
2803 "Returns the number of times the MoCA link has gone down since the last boot. [mocaIfLinkDownCount]",
2808 OUTPUT_PARAM(response, uint32_t*, "Number of seconds this node has been in the network")
2821 RMH_API_IMPLEMENTATION_SOC_ONLY(
2830 "Check if the MoCA network contains both 1.1 and 2.0 nodes",
2835 OUTPUT_PARAM(response,
bool*, "
Set to 'true' if both 1.1 and 2.0 nodes are present in the network. Otherwise set to 'false'.")
2848 RMH_API_IMPLEMENTATION_SOC_ONLY(
2857 "Return the frequency which the MoCA network is operating on. [mocaIfRFChannel]",
2862 OUTPUT_PARAM(response, uint32_t*, "The frequency of the MoCA network")
2875 RMH_API_IMPLEMENTATION_SOC_ONLY(
2884 "Return the primary MoCA 2.0 channel",
2889 OUTPUT_PARAM(response, uint32_t*, "The primary MoCA 2.0 channel")
2902 RMH_API_IMPLEMENTATION_SOC_ONLY(
2911 "Return the secondary MoCA 2.0 channel",
2916 OUTPUT_PARAM(response, uint32_t*, "The secondary MoCA 2.0 channel")
2929 RMH_API_IMPLEMENTATION_SOC_ONLY(
2938 "Return the version of MoCA under which the network is operating. [mocaIfNetworkVersion]",
2943 OUTPUT_PARAM(response, RMH_MoCAVersion*, "The MoCA version of the network")
2956 RMH_API_IMPLEMENTATION_SOC_ONLY(
2965 "Return the PHY rate at which broadcast packets are transmitted from this node",
2970 OUTPUT_PARAM(response, uint32_t*, "The broadcast transmission PHY rate")
2977 "Configuration [
Get],Phy"
2983 RMH_API_IMPLEMENTATION_SOC_ONLY(
2992 "Return the GCD PHY rate which packets are transmitted from this node. [mocaIfTxGcdRate]",
2997 OUTPUT_PARAM(response, uint32_t*, "The GCD transmission PHY rate")
3004 "Configuration [
Get],Phy"
3010 RMH_API_IMPLEMENTATION_SOC_ONLY(
3019 "Return the PHY rate at which MAP packets are transmitted from this node",
3024 OUTPUT_PARAM(response, uint32_t*, "The MAP transmission PHY rate")
3037 RMH_API_IMPLEMENTATION_SOC_ONLY(
3046 "The transmit power control back-off used for broadcast transmissions from this node. [mocaIfTxGcdPowerReduction]",
3051 OUTPUT_PARAM(response, uint32_t*, "Transmit power control reduction. Minimum value 0, Maximum value 35")
3064 RMH_API_IMPLEMENTATION_SOC_ONLY(
3073 "Return which beacon channels will be taboo on this device. <channelMaskStart> will indicate the channel number of the lowest "
3074 "RF frequency covered by <channel mask>. The bitmask <channelMask> is then used to identify exactly which frequencies "
3075 "are taboo. Each consecutive bit of <channelMask> corresponds to channels offset by multiples of 25MHz. A bit in "
3076 "<channelMask> will be set to '1' if that channel is taboo. [mocaIfTabooChannelMask]",
3081 INPUT_PARAM(channelMaskStart, uint32_t*, "The channel number of the lowest frequency which is taboo"),
3082 INPUT_PARAM(channelMask, uint32_t*,
3083 "A bitmask of channels which are taboo. The first bit corresponds to the frequency of <channelMaskStart>")
3090 "Network,Taboo,Frequency"
3096 RMH_API_IMPLEMENTATION_SOC_ONLY(
3105 "Return the unicast transmit PHY rates between all nodes on the network. The resulting matrix will be in "
3106 "<
RMH_NodeMesh_Uint32_t>. Where the index is the node Id, if <nodePresent> is 'true', then <nodeValue> is "
3107 "a list of the unicast PHY rates from this node Id to every other node on the network.",
3125 RMH_API_IMPLEMENTATION_SOC_ONLY(
3134 "Return the transmit VLPER (Very Low
Packet Error Rate) PHY rates *between* all MoCA 2.0 nodes on the network. The "
3135 "resulting matrix will be in <
RMH_NodeMesh_Uint32_t>. Where the index is the node Id, if <nodePresent> is 'true', "
3136 "then <nodeValue> is a list of the unicast PHY rates from this node Id to every other node on the network. Note, "
3137 "MoCA 1.1 nodes will have <nodePresent> set to 'true', however they <nodeValue> will be 0.",
3155 RMH_API_IMPLEMENTATION_SOC_ONLY(
3164 "Return the transmit NPER (Nominal
Packet Error Rate) PHY rates *from* all MoCA 2.0 nodes on the network. The "
3165 "resulting matrix will be in <
RMH_NodeMesh_Uint32_t>. Where the index is the node Id, if <nodePresent> is 'true', "
3166 "then <nodeValue> is a list of the unicast PHY rates from this node Id to every other node on the network. Note, "
3167 "MoCA 1.1 nodes will have <nodePresent> set to 'true', however they <nodeValue> will be 0.",
3185 RMH_API_IMPLEMENTATION_SOC_ONLY(
3212 RMH_API_IMPLEMENTATION_SOC_ONLY(
3218 RMH_Network_GetBondedConnections,
3221 "Return the bonded status for all nodes on the network. 'nodeValue' will 1 if the connection is bonded, 0 if not.",
3226 OUTPUT_PARAM(response,
RMH_NodeMesh_Uint32_t*, "A mesh table representing connections between all nodes.")
3239 RMH_API_IMPLEMENTATION_GENERIC_ONLY(
3248 "Convert an associated Id into a Node Id.",
3253 INPUT_PARAM(associatedId, const uint32_t, "The associated Id of the node"),
3254 OUTPUT_PARAM(response, uint32_t*, "The node Id")
3267 RMH_API_IMPLEMENTATION_GENERIC_ONLY(
3276 "Convert a node Id into an associated Id.",
3281 INPUT_PARAM(nodeId, const uint32_t, "The node Id of the remote node to inspect"),
3282 OUTPUT_PARAM(response, uint32_t*, "The associated Id of the node")
3295 RMH_API_IMPLEMENTATION_SOC_ONLY(
3304 "Return the MAC address of the remote node specificed by <nodeId>",
3309 INPUT_PARAM(nodeId, const uint32_t, "The node Id of the remote node to inspect"),
3310 OUTPUT_PARAM(response, RMH_MacAddress_t*, "The MAC address of the remote node as a
byte array")
3323 RMH_API_IMPLEMENTATION_SOC_ONLY(
3332 "Return if the node indicated by <nodeId> is a preferred NC or not.",
3337 INPUT_PARAM(nodeId, const uint32_t, "The node Id of the remote node to inspect"),
3338 OUTPUT_PARAM(response,
bool*, "
Set to 'true' if the remote node is a preferred NC. Otherwise set to 'false'.")
3351 RMH_API_IMPLEMENTATION_SOC_ONLY(
3360 "Return the highest supported version of MoCA by the remote node specified by <nodeId>",
3365 INPUT_PARAM(nodeId, const uint32_t, "The node Id of the remote node to inspect"),
3366 OUTPUT_PARAM(response, RMH_MoCAVersion*, "The highest version of MoCA supported")
3379 RMH_API_IMPLEMENTATION_SOC_ONLY(
3388 "Return the active supported version of MoCA by the remote node specificed by <nodeId>. There are cases where devices that "
3389 "support MoCA 2.0 may be actively using MoCA 1.1. For example, when the NC is a MoCA 1.1 node.",
3394 INPUT_PARAM(nodeId, const uint32_t, "The node Id of the remote node to inspect"),
3395 OUTPUT_PARAM(response, RMH_MoCAVersion*, "The active version of MoCA on the remote node")
3408 RMH_API_IMPLEMENTATION_SOC_ONLY(
3417 "Return if the node indicated by <nodeId> has QAM256 enabled or not.",
3422 INPUT_PARAM(nodeId, const uint32_t, "The node Id of the remote node to inspect"),
3423 OUTPUT_PARAM(response,
bool*, "
Set to 'true' if the remote node is a QAM256 capable. Otherwise set to 'false'.")
3436 RMH_API_IMPLEMENTATION_SOC_ONLY(
3445 "Return the maximum number of packets for aggregated transmissions for the node indicated by <nodeId>",
3450 INPUT_PARAM(nodeId, const uint32_t, "The node Id of the remote node to inspect"),
3451 OUTPUT_PARAM(response, uint32_t*, "The maximum number of packets <nodeId> will aggregate")
3464 RMH_API_IMPLEMENTATION_SOC_ONLY(
3473 "The maximum number of bytes this node can receive in one frame (aggregated transmission).",
3478 INPUT_PARAM(nodeId, const uint32_t, "The node Id of the remote node to inspect"),
3479 OUTPUT_PARAM(response, uint32_t*, "The maximum number of packets this device will aggregate")
3491 RMH_API_IMPLEMENTATION_SOC_ONLY(
3500 "Return if the node indicated by <nodeId> is bonding capable enabled or not.",
3505 INPUT_PARAM(nodeId, const uint32_t, "The node Id of the remote node to inspect"),
3506 OUTPUT_PARAM(response,
bool*, "
Set to 'true' if the remote node supports bonding. Otherwise set to 'false'.")
3513 "Remote Node,Bonding"
3519 RMH_API_IMPLEMENTATION_SOC_ONLY(
3528 "Return the PHY rate at which unicast packets are received from <nodeId> from the self node.",
3533 INPUT_PARAM(nodeId, const uint32_t, "The node Id of the remote node to inspect"),
3534 OUTPUT_PARAM(response, uint32_t*, "The unicast receive PHY rate")
3547 RMH_API_IMPLEMENTATION_SOC_ONLY(
3556 "Return the PHY rate at which broadcast packets are received from <nodeId>.",
3561 INPUT_PARAM(nodeId, const uint32_t, "The node Id of the remote node to inspect"),
3562 OUTPUT_PARAM(response, uint32_t*, "The broadcast receive PHY rate")
3575 RMH_API_IMPLEMENTATION_SOC_ONLY(
3584 "Return the power level at which broadcast packets are received from <nodeId>.",
3589 INPUT_PARAM(nodeId, const uint32_t, "The node Id of the remote node to inspect"),
3590 OUTPUT_PARAM(response,
float*, "The broadcast receive power level")
3603 RMH_API_IMPLEMENTATION_SOC_ONLY(
3612 "Return the power level at which unicast packets are received from <nodeId> from the self node.",
3617 INPUT_PARAM(nodeId, const uint32_t, "The node Id of the remote node to inspect"),
3618 OUTPUT_PARAM(response,
float*, "The unicast receive power level rate")
3631 RMH_API_IMPLEMENTATION_SOC_ONLY(
3640 "Return the power level at which MAP packets are received by <nodeId>.",
3645 INPUT_PARAM(nodeId, const uint32_t, "The node Id of the remote node to inspect"),
3646 OUTPUT_PARAM(response,
float*, "The MAP receive power level rate")
3659 RMH_API_IMPLEMENTATION_SOC_ONLY(
3668 "Return the number of packets <nodeId> has received.",
3673 INPUT_PARAM(nodeId, const uint32_t, "The node Id of the remote node to inspect"),
3674 OUTPUT_PARAM(response, uint32_t*, "Number of packets received by <nodeId>")
3687 RMH_API_IMPLEMENTATION_SOC_ONLY(
3696 "The signal to noise ratio of <nodeId> based on the Type 1 probe from per node. Measured in dB.",
3701 INPUT_PARAM(nodeId, const uint32_t, "The node Id of the remote node to inspect"),
3702 OUTPUT_PARAM(response,
float*, "The SNR of <nodeId>")
3715 RMH_API_IMPLEMENTATION_SOC_ONLY(
3724 "Return the number of packets with corrected errors <nodeId> has received",
3729 INPUT_PARAM(nodeId, const uint32_t, "The node Id of the remote node to inspect"),
3730 OUTPUT_PARAM(response, uint32_t*, "The number of corrected packets with errors")
3743 RMH_API_IMPLEMENTATION_SOC_ONLY(
3752 "Return the number of packets with uncorrected errors <nodeId> has received",
3757 INPUT_PARAM(nodeId, const uint32_t, "The node Id of the remote node to inspect"),
3758 OUTPUT_PARAM(response, uint32_t*, "The number of uncorrected packets with errors")
3771 RMH_API_IMPLEMENTATION_SOC_ONLY(
3780 "Return the total number of packets with errors <nodeId> has received",
3785 INPUT_PARAM(nodeId, const uint32_t, "The node Id of the remote node to inspect"),
3786 OUTPUT_PARAM(response, uint32_t*, "The number of total number of packets with errors")
3799 RMH_API_IMPLEMENTATION_SOC_ONLY(
3808 "Return the PHY rate at which unicast packets are transmitted from <nodeId> to the self node.",
3813 INPUT_PARAM(nodeId, const uint32_t, "The node Id of the remote node to inspect"),
3814 OUTPUT_PARAM(response, uint32_t*, "The unicast transmission PHY rate")
3827 RMH_API_IMPLEMENTATION_SOC_ONLY(
3836 "Return the power level rate at which unicast packets are transmitted from <nodeId> to the self node.",
3841 INPUT_PARAM(nodeId, const uint32_t, "The node Id of the remote node to inspect"),
3842 OUTPUT_PARAM(response,
float*, "The unicast transmission power level rate")
3855 RMH_API_IMPLEMENTATION_SOC_ONLY(
3864 "The transmit power control back-off used for transmissions from the specified <nodeId>",
3869 INPUT_PARAM(nodeId, const uint32_t, "The node Id of the remote node to inspect"),
3870 OUTPUT_PARAM(response, uint32_t*, "The transmission power reduction of <nodeId>")
3883 RMH_API_IMPLEMENTATION_SOC_ONLY(
3892 "Return the total number of packets <nodeId> has transmitted.",
3897 INPUT_PARAM(nodeId, const uint32_t, "The node Id of the remote node to inspect"),
3898 OUTPUT_PARAM(response, uint32_t*, "The total number of packets transmitted by <nodeId>")
3911 RMH_API_IMPLEMENTATION_SOC_ONLY(
3921 "Instruct one or more nodes to initiate a MoCA Reset command. This will result in the specfied nodes dropping from the network and then rejoining.",
3926 INPUT_PARAM(nodeListMask, const uint32_t, "A bitmask of nodes to be reset [mocaIfMrNodeMask]. For example, to reset a given node use 'nodeListMask |= (1 << nodeId)'"),
3927 INPUT_PARAM(startTime, const uint32_t, "The time in seconds to start the reset command [mocaIfMrStartTime]")
3934 "Network,Remote Node"
3940 RMH_API_IMPLEMENTATION_SOC_ONLY(
3949 "Return the unicast recieve subcarrier modulation profiles for the primary MoCA channel.",
3954 INPUT_PARAM(nodeId, const uint32_t, "The node Id of the remote node to inspect"),
3955 INPUT_PARAM(perMode, const RMH_PERMode, "The PER
Mode to check. This parameter will be ignored for MoCA devices older than 2.0"),
3956 OUTPUT_PARAM(responseArray, RMH_SubcarrierProfile*, "An array where the sub carrier modulation should be stored"),
3957 INPUT_PARAM(responseArraySize, const
size_t, "The size of the response array"),
3958 OUTPUT_PARAM(responseArrayUsed,
size_t*, "The number of entries in the response array which have valid data")
3971 RMH_API_IMPLEMENTATION_SOC_ONLY(
3980 "Return the unicast transmit subcarrier modulation profiles for the primary MoCA channel.",
3985 INPUT_PARAM(nodeId, const uint32_t, "The node Id of the remote node to inspect"),
3986 INPUT_PARAM(perMode, const RMH_PERMode, "The PER
Mode to check. This parameter will be ignored for MoCA devices older than 2.0"),
3987 OUTPUT_PARAM(responseArray, RMH_SubcarrierProfile*, "An array where the sub carrier modulation should be stored"),
3988 INPUT_PARAM(responseArraySize, const
size_t, "The size of the response array"),
3989 OUTPUT_PARAM(responseArrayUsed,
size_t*, "The number of entries in the response array which have valid data")
4002 RMH_API_IMPLEMENTATION_SOC_ONLY(
4011 "Return the unicast recieve subcarrier modulation profiles for the secondary MoCA channel.",
4016 INPUT_PARAM(nodeId, const uint32_t, "The node Id of the remote node to inspect"),
4017 INPUT_PARAM(perMode, const RMH_PERMode, "The PER
Mode to check. This parameter will be ignored for MoCA devices older than 2.0"),
4018 OUTPUT_PARAM(responseArray, RMH_SubcarrierProfile*, "An array where the sub carrier modulation should be stored"),
4019 INPUT_PARAM(responseArraySize, const
size_t, "The size of the response array"),
4020 OUTPUT_PARAM(responseArrayUsed,
size_t*, "The number of entries in the response array which have valid data")
4033 RMH_API_IMPLEMENTATION_SOC_ONLY(
4042 "Return the unicast transmit subcarrier modulation profiles for the secondary MoCA channel.",
4047 INPUT_PARAM(nodeId, const uint32_t, "The node Id of the remote node to inspect"),
4048 INPUT_PARAM(perMode, const RMH_PERMode, "The PER
Mode to check. This parameter will be ignored for MoCA devices older than 2.0"),
4049 OUTPUT_PARAM(responseArray, RMH_SubcarrierProfile*, "An array where the sub carrier modulation should be stored"),
4050 INPUT_PARAM(responseArraySize, const
size_t, "The size of the response array"),
4051 OUTPUT_PARAM(responseArrayUsed,
size_t*, "The number of entries in the response array which have valid data")
4064 RMH_API_IMPLEMENTATION_SOC_ONLY(
4073 "Return the broadcast subcarrier modulation profiles for the channel. In the case of a MoCA 1.1 connection this will return the SubcarrierModulation",
4078 INPUT_PARAM(nodeId, const uint32_t, "The node Id of the remote node to inspect"),
4079 INPUT_PARAM(perMode, const RMH_PERMode, "The PER
Mode to check. This parameter will be ignored for MoCA devices older than 2.0"),
4080 OUTPUT_PARAM(responseArray, RMH_SubcarrierProfile*, "An array where the sub carrier modulation should be stored"),
4081 INPUT_PARAM(responseArraySize, const
size_t, "The size of the response array"),
4082 OUTPUT_PARAM(responseArrayUsed,
size_t*, "The number of entries in the response array which have valid data")
4095 RMH_API_IMPLEMENTATION_SOC_ONLY(
4104 "Return the broadcast subcarrier modulation profiles for the channel. In the case of a MoCA 1.1 connection this will return the SubcarrierModulation",
4109 INPUT_PARAM(nodeId, const uint32_t, "The node Id of the remote node to inspect"),
4110 INPUT_PARAM(perMode, const RMH_PERMode, "The PER
Mode to check. This parameter will be ignored for MoCA devices older than 2.0"),
4111 OUTPUT_PARAM(responseArray, RMH_SubcarrierProfile*, "An array where the sub carrier modulation should be stored"),
4112 INPUT_PARAM(responseArraySize, const
size_t, "The size of the response array"),
4113 OUTPUT_PARAM(responseArrayUsed,
size_t*, "The number of entries in the response array which have valid data")
4126 RMH_API_IMPLEMENTATION_SOC_ONLY(
4129 RMH_Result RMH_RemoteNode_GetMaxConstellation_GCD100(const
RMH_Handle handle, const uint32_t nodeId, uint32_t* response),
4132 RMH_RemoteNode_GetMaxConstellation_GCD100,
4135 "Return the GCD (broadcast) constellation limit for 100 MHz profiles",
4140 INPUT_PARAM(nodeId, const uint32_t, "The node Id of the remote node to inspect"),
4141 OUTPUT_PARAM(response, uint32_t*, "The GCD constellation for 100MHz for <nodeId>")
4154 RMH_API_IMPLEMENTATION_SOC_ONLY(
4157 RMH_Result RMH_RemoteNode_SetMaxConstellation_GCD100(const
RMH_Handle handle, const uint32_t nodeId, const uint32_t maxConstellation),
4160 RMH_RemoteNode_SetMaxConstellation_GCD100,
4163 "
Set the GCD (broadcast) constellation limit for 100 MHz profiles",
4168 INPUT_PARAM(nodeId, const uint32_t, "The node Id of the remote node to inspect"),
4169 INPUT_PARAM(maxConstellation, const uint32_t, "The desired GCD constellation for 100MHz for <nodeId> between 0 and 10")
4182 RMH_API_IMPLEMENTATION_SOC_ONLY(
4185 RMH_Result RMH_RemoteNode_GetMaxConstellation_GCD50(const
RMH_Handle handle, const uint32_t nodeId, uint32_t* response),
4188 RMH_RemoteNode_GetMaxConstellation_GCD50,
4191 "Return the GCD (broadcast) constellation limit for 50 MHz profiles",
4196 INPUT_PARAM(nodeId, const uint32_t, "The node Id of the remote node to inspect"),
4197 OUTPUT_PARAM(response, uint32_t*, "The GCD constellation for 50MHz for <nodeId>")
4210 RMH_API_IMPLEMENTATION_SOC_ONLY(
4213 RMH_Result RMH_RemoteNode_SetMaxConstellation_GCD50(const
RMH_Handle handle, const uint32_t nodeId, const uint32_t maxConstellation),
4216 RMH_RemoteNode_SetMaxConstellation_GCD50,
4219 "
Set the GCD (broadcast) constellation limit for 50 MHz profiles",
4224 INPUT_PARAM(nodeId, const uint32_t, "The node Id of the remote node to inspect"),
4225 INPUT_PARAM(maxConstellation, const uint32_t, "The desired GCD constellation for 50MHz for <nodeId> between 0 and 10")
4238 RMH_API_IMPLEMENTATION_SOC_ONLY(
4241 RMH_Result RMH_RemoteNode_GetMaxConstellation_P2P100(const
RMH_Handle handle, const uint32_t nodeId, uint32_t* response),
4244 RMH_RemoteNode_GetMaxConstellation_P2P100,
4247 "Return the point-to-point (unicast) constellation limit for 100 MHz profiles",
4252 INPUT_PARAM(nodeId, const uint32_t, "The node Id of the remote node to inspect"),
4253 OUTPUT_PARAM(response, uint32_t*, "The point-to-point constellation for 100MHz for <nodeId>")
4266 RMH_API_IMPLEMENTATION_SOC_ONLY(
4269 RMH_Result RMH_RemoteNode_SetMaxConstellation_P2P100(const
RMH_Handle handle, const uint32_t nodeId, const uint32_t maxConstellation),
4272 RMH_RemoteNode_SetMaxConstellation_P2P100,
4275 "
Set the point-to-point (unicast) constellation limit for 100 MHz profiles",
4280 INPUT_PARAM(nodeId, const uint32_t, "The node Id of the remote node to inspect"),
4281 INPUT_PARAM(maxConstellation, const uint32_t, "The desired point-to-point constellation for 100MHz for <nodeId> between 0 and 10")
4294 RMH_API_IMPLEMENTATION_SOC_ONLY(
4297 RMH_Result RMH_RemoteNode_GetMaxConstellation_P2P50(const
RMH_Handle handle, const uint32_t nodeId, uint32_t* response),
4300 RMH_RemoteNode_GetMaxConstellation_P2P50,
4303 "Return the point-to-point (unicast) constellation limit for 50 MHz profiles",
4308 INPUT_PARAM(nodeId, const uint32_t, "The node Id of the remote node to inspect"),
4309 OUTPUT_PARAM(response, uint32_t*, "The point-to-point constellation for 50MHz for <nodeId>")
4322 RMH_API_IMPLEMENTATION_SOC_ONLY(
4325 RMH_Result RMH_RemoteNode_SetMaxConstellation_P2P50(const
RMH_Handle handle, const uint32_t nodeId, const uint32_t maxConstellation),
4328 RMH_RemoteNode_SetMaxConstellation_P2P50,
4331 "
Set the point-to-point (unicast) constellation limit for 50 MHz profiles",
4336 INPUT_PARAM(nodeId, const uint32_t, "The node Id of the remote node to inspect"),
4337 INPUT_PARAM(maxConstellation, const uint32_t, "The desired point-to-point constellation for 50MHz for <nodeId> between 0 and 10")
4350 RMH_API_IMPLEMENTATION_SOC_ONLY(
4359 "Return the maximum number of supported Ingress PQoS Flows by the Node [mocaIfSupportedIngressPqosFlows]",
4364 OUTPUT_PARAM(response, uint32_t*, "Maximum number of supported Ingress PQoS Flows by the Node")
4377 RMH_API_IMPLEMENTATION_SOC_ONLY(
4386 "Return the maximum number of supported Egress PQoS Flows by the Node [mocaIfSupportedEgressPqosFlows]",
4391 OUTPUT_PARAM(response, uint32_t*, "Maximum number of supported Egress PQoS Flows by the Node")
4404 RMH_API_IMPLEMENTATION_SOC_ONLY(
4413 "Return the number of ingress flows",
4418 OUTPUT_PARAM(response, uint32_t*, "The number of ingress flows")
4431 RMH_API_IMPLEMENTATION_SOC_ONLY(
4440 "Return the number of egress flows",
4445 OUTPUT_PARAM(response, uint32_t*, "The number of egress flows")
4458 RMH_API_IMPLEMENTATION_SOC_ONLY(
4467 "Return the amount of egress bandwidth available on a particular node.",
4472 INPUT_PARAM(nodeId, const uint32_t, "The node Id of the remote node to inspect"),
4473 OUTPUT_PARAM(response, uint32_t*, "The available egress bandwidth")
4486 RMH_API_IMPLEMENTATION_SOC_ONLY(
4495 "Return a list of the unique Id for each existing ingress flows.",
4500 OUTPUT_PARAM(responseArray, RMH_MacAddress_t*, "An array where the flow unique Ids should be returned"),
4501 INPUT_PARAM(responseArraySize, const
size_t, "The size of the response array"),
4502 OUTPUT_PARAM(responseArrayUsed,
size_t*, "The number of entries in the response array which have valid data")
4515 RMH_API_IMPLEMENTATION_SOC_ONLY(
4524 "Return the peak data rate in Kbps for the flow specified by <flowId>",
4529 INPUT_PARAM(flowId, const RMH_MacAddress_t, "The unique flow identifier"),
4530 OUTPUT_PARAM(response, uint32_t*, "The peak data rate in Kbps")
4543 RMH_API_IMPLEMENTATION_SOC_ONLY(
4552 "Return the number of packets per burst for the flow specified by <flowId>",
4557 INPUT_PARAM(flowId, const RMH_MacAddress_t, "The unique flow identifier"),
4558 OUTPUT_PARAM(response, uint32_t*, "The packets per burst")
4571 RMH_API_IMPLEMENTATION_SOC_ONLY(
4580 "Return the lease time in seconds for the flow specified by <flowId>. Zero indicates an infinite lease time.",
4585 INPUT_PARAM(flowId, const RMH_MacAddress_t, "The unique flow identifier"),
4586 OUTPUT_PARAM(response, uint32_t*, "The lease time in seconds")
4599 RMH_API_IMPLEMENTATION_SOC_ONLY(
4608 "Return the lease time remaining in seconds for the flow specified by <flowId>",
4613 INPUT_PARAM(flowId, const RMH_MacAddress_t, "The unique flow identifier"),
4614 OUTPUT_PARAM(response, uint32_t*, "The lease time remaining in seconds")
4627 RMH_API_IMPLEMENTATION_SOC_ONLY(
4636 "Return the tag for the flow specified by <flowId>. This is optional for application use",
4641 INPUT_PARAM(flowId, const RMH_MacAddress_t, "The unique flow identifier"),
4642 OUTPUT_PARAM(response, uint32_t*, "The flow tag")
4655 RMH_API_IMPLEMENTATION_SOC_ONLY(
4664 "Return the maximum latency of the flow specified by <flowId>",
4669 INPUT_PARAM(flowId, const RMH_MacAddress_t, "The unique flow identifier"),
4670 OUTPUT_PARAM(response, uint32_t*, "The maximum latency")
4683 RMH_API_IMPLEMENTATION_SOC_ONLY(
4692 "Return the
short term average ratio for the flow specified by <flowId>. This is the ratio of the
short term average "
4694 "serves as the numerator of the ratio. The denominator is 256. This value is only applicable when the maximun latency "
4695 "value is greater than or equal to 10 ms.",
4700 INPUT_PARAM(flowId, const RMH_MacAddress_t, "The unique flow identifier"),
4701 OUTPUT_PARAM(response, uint32_t*, "The
short term average ratio")
4714 RMH_API_IMPLEMENTATION_SOC_ONLY(
4723 "Retrun the maximum number of retransmission attempts for each MSDU of the flow specified by <flowId>.",
4728 INPUT_PARAM(flowId, const RMH_MacAddress_t, "The unique flow identifier"),
4729 OUTPUT_PARAM(response, uint32_t*, "The maximum retransmission attempts")
4742 RMH_API_IMPLEMENTATION_SOC_ONLY(
4751 "Return the VLAN priority for the flow specified by <flowId>. This is used for MSDU classification when "
4757 INPUT_PARAM(flowId, const RMH_MacAddress_t, "The unique flow identifier"),
4758 OUTPUT_PARAM(response, uint32_t*, "The VLAN tag")
4771 RMH_API_IMPLEMENTATION_SOC_ONLY(
4780 "Return the flow packet error ratio profile for the flow specified by <flowId>. This is to specify whether the flow "
4781 "should use the nominal packet error rate (PER) PHY profile or the Very Low PER PHY profile.",
4786 INPUT_PARAM(flowId, const RMH_MacAddress_t, "The unique flow identifier"),
4787 OUTPUT_PARAM(response, uint32_t*, "The flow PER profile")
4800 RMH_API_IMPLEMENTATION_SOC_ONLY(
4809 "Return the ingress classification rule for assigning MSDUs to the flow specified by <flowId>.",
4814 INPUT_PARAM(flowId, const RMH_MacAddress_t, "The unique flow identifier"),
4815 OUTPUT_PARAM(response, uint32_t*, "The ingress classification rule")
4828 RMH_API_IMPLEMENTATION_SOC_ONLY(
4837 "Return the packet size in bytes of the flow specified by <flowId>. This includes the VLAN header but not including "
4843 INPUT_PARAM(flowId, const RMH_MacAddress_t, "The unique flow identifier"),
4844 OUTPUT_PARAM(response, uint32_t*, "The flow packet size")
4857 RMH_API_IMPLEMENTATION_SOC_ONLY(
4866 "Return the total number of packets transmitted on the flow specified by <flowId>.",
4871 INPUT_PARAM(flowId, const RMH_MacAddress_t, "The unique flow identifier"),
4872 OUTPUT_PARAM(response, uint32_t*, "The total number of packets transmitted")
4885 RMH_API_IMPLEMENTATION_SOC_ONLY(
4894 "Return the DSCP MoCA value for the flow specified by <flowId>. The value of the three MSB of the DSCP Type of "
4900 INPUT_PARAM(flowId, const RMH_MacAddress_t, "The unique flow identifier"),
4901 OUTPUT_PARAM(response, uint32_t*, "The DSCP MoCA")
4914 RMH_API_IMPLEMENTATION_SOC_ONLY(
4923 "Return the destination flow ID of the flow specified by <flowId>.",
4928 INPUT_PARAM(flowId, const RMH_MacAddress_t, "The unique flow identifier"),
4929 OUTPUT_PARAM(response, uint32_t*, "The DFID of the flow")
4942 RMH_API_IMPLEMENTATION_SOC_ONLY(
4951 "Return the destination MAC address of the traffic to be sent to the flow specified by <flowId>.",
4956 INPUT_PARAM(flowId, const RMH_MacAddress_t, "The unique flow identifier"),
4957 OUTPUT_PARAM(response, RMH_MacAddress_t*, "The destination MAC of the flow")
4970 RMH_API_IMPLEMENTATION_SOC_ONLY(
4979 "Return the ingress MAC address of the flow specified by <flowId>.",
4984 INPUT_PARAM(flowId, const RMH_MacAddress_t, "The unique flow identifier"),
4985 OUTPUT_PARAM(response, RMH_MacAddress_t*, "The ingress MAC of the flow")
4998 RMH_API_IMPLEMENTATION_SOC_ONLY(
5007 "Return the egress MAC address of the flow specified by <flowId>.",
5012 INPUT_PARAM(flowId, const RMH_MacAddress_t, "The unique flow identifier"),
5013 OUTPUT_PARAM(response, RMH_MacAddress_t*, "The egress MAC of the flow")
5025 RMH_API_IMPLEMENTATION_GENERIC_ONLY(
5034 "Return the node Id with the maximum available bandwidth",
5039 OUTPUT_PARAM(response, uint32_t*, "The node Id with the maximum egress bandwidth")
5052 RMH_API_IMPLEMENTATION_GENERIC_ONLY(
5061 "Return the node Id with the minimum available bandwidth",
5066 OUTPUT_PARAM(response, uint32_t*, "The node Id with the minimum egress bandwidth")
5079 RMH_API_IMPLEMENTATION_SOC_ONLY(
5088 "Return the number of admission attempts this node has made. "
5094 OUTPUT_PARAM(response, uint32_t*, "The number of admission attempts")
5107 RMH_API_IMPLEMENTATION_SOC_ONLY(
5116 "Return the number of admission failures for this node"
5122 OUTPUT_PARAM(response, uint32_t*, "The number of admission failures by this node")
5135 RMH_API_IMPLEMENTATION_SOC_ONLY(
5144 "Return the number of successful admissions for this node. "
5150 OUTPUT_PARAM(response, uint32_t*, "The number of successful admissions by this node")
5163 RMH_API_IMPLEMENTATION_SOC_ONLY(
5172 "Return the number of admissions this node has denied when it was the NC. "
5178 OUTPUT_PARAM(response, uint32_t*, "The number of admissions this node has denied when it was the NC")
5191 RMH_API_IMPLEMENTATION_SOC_ONLY(
5194 RMH_Result RMH_Stats_GetAdmissionsFailedNoResponse(const
RMH_Handle handle, uint32_t* response),
5197 RMH_Stats_GetAdmissionsFailedNoResponse,
5200 "Return the number of admissions attempts that this node has failed with no response"
5206 OUTPUT_PARAM(response, uint32_t*, "The number of admissions this node has failed with no response")
5219 RMH_API_IMPLEMENTATION_SOC_ONLY(
5222 RMH_Result RMH_Stats_GetAdmissionsFailedChannelUnusable(const
RMH_Handle handle, uint32_t* response),
5225 RMH_Stats_GetAdmissionsFailedChannelUnusable,
5228 "Return the number of admissions attempts that this node has failed with an unusable channel"
5234 OUTPUT_PARAM(response, uint32_t*, "The number of admissions this node has failed with an unusable channel")
5247 RMH_API_IMPLEMENTATION_SOC_ONLY(
5250 RMH_Result RMH_Stats_GetAdmissionsFailedT2Timeout(const
RMH_Handle handle, uint32_t* response),
5253 RMH_Stats_GetAdmissionsFailedT2Timeout,
5256 "Return the number of admissions attempts that this node has failed with a T2 timeout"
5262 OUTPUT_PARAM(response, uint32_t*, "The number of admissions this node has failed with a T2 timeout")
5275 RMH_API_IMPLEMENTATION_SOC_ONLY(
5278 RMH_Result RMH_Stats_GetAdmissionsFailedResyncLoss(const
RMH_Handle handle, uint32_t* response),
5281 RMH_Stats_GetAdmissionsFailedResyncLoss,
5284 "Return the number of admissions attempts that this node has failed with resync lost"
5290 OUTPUT_PARAM(response, uint32_t*, "The number of admissions this node has failed with resync lost")
5303 RMH_API_IMPLEMENTATION_SOC_ONLY(
5306 RMH_Result RMH_Stats_GetAdmissionsFailedPrivacyFullBlacklist(const
RMH_Handle handle, uint32_t* response),
5309 RMH_Stats_GetAdmissionsFailedPrivacyFullBlacklist,
5312 "Return the number of admissions attempts that this node has failed because of a privacy issue, the network was full, or this node was blacklisted."
5318 OUTPUT_PARAM(response, uint32_t*, "The number of admissions this node has failed")
5331 RMH_API_IMPLEMENTATION_SOC_ONLY(
5340 "Return the total number of bytes transmitted by this node. "
5346 OUTPUT_PARAM(response, uint32_t*, "The total number of bytes transmitted by this node")
5359 RMH_API_IMPLEMENTATION_SOC_ONLY(
5368 "Return the total number of bytes received by this node. "
5374 OUTPUT_PARAM(response, uint32_t*, "The total number of bytes received by this node")
5387 RMH_API_IMPLEMENTATION_SOC_ONLY(
5396 "Return the total number of packets transmitted by this node. "
5402 OUTPUT_PARAM(response, uint32_t*, "The number of packets transmitted by this node")
5415 RMH_API_IMPLEMENTATION_SOC_ONLY(
5424 "Return the total number of packets received by this node. "
5430 OUTPUT_PARAM(response, uint32_t*, "The number of received transmitted by this node")
5443 RMH_API_IMPLEMENTATION_SOC_ONLY(
5452 "Return the number of unicast packets transmitted by this node. "
5458 OUTPUT_PARAM(response, uint32_t*, "The number of unicast packets transmitted by this node")
5471 RMH_API_IMPLEMENTATION_SOC_ONLY(
5480 "Return the number of unicast packets received by this node. "
5486 OUTPUT_PARAM(response, uint32_t*, "The number of unicast packets received by this node")
5499 RMH_API_IMPLEMENTATION_SOC_ONLY(
5508 "Return the number of broadcast packets transmitted by this node. "
5514 OUTPUT_PARAM(response, uint32_t*, "The number of broadcast packets transmitted by this node")
5527 RMH_API_IMPLEMENTATION_SOC_ONLY(
5536 "Return the number of broadcast packets received by this node. "
5542 OUTPUT_PARAM(response, uint32_t*, "The number of broadcast packets received by this node")
5555 RMH_API_IMPLEMENTATION_SOC_ONLY(
5564 "Return the number of multicast packets transmitted by this node. "
5570 OUTPUT_PARAM(response, uint32_t*, "The number of multicast packets transmitted by this node")
5583 RMH_API_IMPLEMENTATION_SOC_ONLY(
5592 "Return the number of multicast packets received by this node. "
5598 OUTPUT_PARAM(response, uint32_t*, "The number of multicast packets received by this node")
5611 RMH_API_IMPLEMENTATION_SOC_ONLY(
5620 "Return the number of reservation request packets transmitted by this node. "
5626 OUTPUT_PARAM(response, uint32_t*, "The number of reservation request packets transmitted by this node")
5639 RMH_API_IMPLEMENTATION_SOC_ONLY(
5648 "Return the number of reservation request packets received by this node. "
5654 OUTPUT_PARAM(response, uint32_t*, "The number of reservation request packets received by this node")
5667 RMH_API_IMPLEMENTATION_SOC_ONLY(
5676 "Return the number of MAP transmitted by this node. "
5682 OUTPUT_PARAM(response, uint32_t*, "The number of MAP packets transmitted by this node")
5695 RMH_API_IMPLEMENTATION_SOC_ONLY(
5704 "Return the number of MAP received by this node. "
5710 OUTPUT_PARAM(response, uint32_t*, "The number of MAP packets received by this node")
5723 RMH_API_IMPLEMENTATION_SOC_ONLY(
5732 "Return the number of link control transmitted by this node. "
5738 OUTPUT_PARAM(response, uint32_t*, "The number of link control packets transmitted by this node")
5751 RMH_API_IMPLEMENTATION_SOC_ONLY(
5760 "Return the number of link control received by this node. "
5766 OUTPUT_PARAM(response, uint32_t*, "The number of link control packets received by this node")
5779 RMH_API_IMPLEMENTATION_SOC_ONLY(
5788 "Return the number of beacons transmitted by this node. "
5794 OUTPUT_PARAM(response, uint32_t*, "The number of beacons transmitted by this node")
5807 RMH_API_IMPLEMENTATION_SOC_ONLY(
5816 "Return the number of beacons received by this node. "
5822 OUTPUT_PARAM(response, uint32_t*, "The number of beacons received by this node")
5835 RMH_API_IMPLEMENTATION_SOC_ONLY(
5844 "Return the number of unknown packets received by this node. "
5850 OUTPUT_PARAM(response, uint32_t*, "The number of unknown packets received by this node")
5863 RMH_API_IMPLEMENTATION_SOC_ONLY(
5872 "Return the number of packets this node has dropped before transmitting. "
5878 OUTPUT_PARAM(response, uint32_t*, "The number of packets dropped by this node before transmitting")
5891 RMH_API_IMPLEMENTATION_SOC_ONLY(
5900 "Return the number of packets this node has dropped after receiving. "
5906 OUTPUT_PARAM(response, uint32_t*, "The number of received packets dropped by this node")
5919 RMH_API_IMPLEMENTATION_SOC_ONLY(
5928 "Return the total number of transmit errors by this node. "
5934 OUTPUT_PARAM(response, uint32_t*, "The total number of transmit errors by this node")
5947 RMH_API_IMPLEMENTATION_SOC_ONLY(
5956 "Return the total number of received errors by this node. "
5962 OUTPUT_PARAM(response, uint32_t*, "The total number of receive errors by this node")
5975 RMH_API_IMPLEMENTATION_SOC_ONLY(
5984 "Return the total number of packets this node has received with CRC errors. "
5990 OUTPUT_PARAM(response, uint32_t*, "The total number of received packets with CRC errors")
6003 RMH_API_IMPLEMENTATION_SOC_ONLY(
6012 "Return the total number of packets this node has received with timeout errors. "
6018 OUTPUT_PARAM(response, uint32_t*, "The total number of received packets with timeout errors")
6031 RMH_API_IMPLEMENTATION_SOC_ONLY(
6040 "Return the total number of received aggregated packets. "
6046 OUTPUT_PARAM(response, uint32_t*, "The total number of received aggregated packets")
6059 RMH_API_IMPLEMENTATION_SOC_ONLY(
6068 "Return the total number of transmitted aggregated packets. "
6074 OUTPUT_PARAM(response, uint32_t*, "The total number of transmitted aggregated packets")
6086 RMH_API_IMPLEMENTATION_SOC_ONLY(
6096 "Return an array indicating the number of packets received per aggregation number. "
6102 OUTPUT_PARAM(responseArray, uint32_t*, "An array where the aggregation information should be returned"),
6103 INPUT_PARAM(responseArraySize, const
size_t, "The size of the response array"),
6104 OUTPUT_PARAM(responseArrayUsed,
size_t*, "The number of entries in the response array which have valid data")
6117 RMH_API_IMPLEMENTATION_SOC_ONLY(
6126 "Return an array indicating the number of packets transmitted per aggregation number. The array index indicates "
6127 "the number of transmitted bursts. So index 0 counts transmitted bursts with actual aggregation of 0, index 2 counts "
6128 "actual aggregation of 2, and so on."
6134 OUTPUT_PARAM(responseArray, uint32_t*, "An array where the aggregation information should be returned"),
6135 INPUT_PARAM(responseArraySize, const
size_t, "The size of the response array"),
6136 OUTPUT_PARAM(responseArrayUsed,
size_t*, "The number of entries in the response array which have valid data")
6149 RMH_API_IMPLEMENTATION_SOC_ONLY(
6158 "Return the number of received packets from every node with errors which were corrected. "
6165 "Where the index is the node Id, if <nodePresent> is 'true', <nodeValue> is the number of corrected errors for that node.")
6178 RMH_API_IMPLEMENTATION_SOC_ONLY(
6187 "Return the number of received packets from every node with errors which were not corrected. "
6194 "Where the index is the node Id, if <nodePresent> is 'true', <nodeValue> is the number of uncorrected errors for that node.")
6207 RMH_API_IMPLEMENTATION_SOC_ONLY(
6216 "Reset MoCA statistics counters back to zero.",
6232 RMH_API_IMPLEMENTATION_GENERIC_THEN_SOC(
6241 "Return a bitmask of <RMH_LogLevel> which indicates the currently enabled
RMH log types in the
RMH library. Note, this "
6242 "API is for log messages from
RMH libraries only. The log level of the lower level MoCA driver should be read with "
6248 OUTPUT_PARAM(response, uint32_t*, "The
RMH API log level")
6261 RMH_API_IMPLEMENTATION_GENERIC_THEN_SOC(
6270 "
Set the log level of the
RMH library. This is set as a bitmask of <RMH_LogLevel> indicating the
RMH log types to "
6271 "enable in the
RMH libraries. Note, this API is for log messages from
RMH libraries only. The log level of the lower "
6277 INPUT_PARAM(value, const uint32_t, "The desired
RMH API log level")
6290 RMH_API_IMPLEMENTATION_SOC_ONLY(
6299 "Return a bitmask of <RMH_LogLevel> which indicates the currently enabled
RMH log types in the MoCA driver. Note, this "
6300 "API is for log messages from SoC MoCA driver only. The log level of the
RMH library should be read with "
6306 OUTPUT_PARAM(response, RMH_LogLevel*, "The SoC MoCA
Driver log level")
6319 RMH_API_IMPLEMENTATION_SOC_ONLY(
6328 "
Set the log level of the MoCA driver. This is set as a bitmask of <RMH_LogLevel> indicating the
RMH log types to "
6329 "enable at the driver. Note, this API is for log messages from SoC MoCA driver only. The log level of the
RMH "
6335 INPUT_PARAM(value, const RMH_LogLevel, "The desired SoC MoCA
Driver log level")
6348 RMH_API_IMPLEMENTATION_SOC_ONLY(
6357 "
Get the file name where MoCA driver logs are currently being captured.",
6362 OUTPUT_PARAM(responseBuf,
char*, "A buffer where the filename will be written"),
6363 INPUT_PARAM(responseBufSize, const
size_t, "The size in bytes of the buffer <responseBuf>")
6376 RMH_API_IMPLEMENTATION_SOC_ONLY(
6385 "
Set the file name where MoCA driver logs should be captured to. If logs are already being captured to a file this "
6386 "capture will stop at that location and begin in this file. If the new log file already exists new logs will append "
6392 INPUT_PARAM(value, const
char*, "A file name where logs should be written.")
6405 RMH_API_IMPLEMENTATION_GENERIC_ONLY(
6414 "Create a new log file in standard RDK formate. This will:\n"
6415 "\t1. Locate the file at a writable location in the rootfs.\n"
6416 "\t2. Name the file using a RDK standard naming convention.\n"
6417 "\t3. Put any necessary static information at the beginning of the file.\n"
6418 "\t This includes build details and other useful information.",
6423 INPUT_PARAM(responseBuf,
char *, "The file name "),
6424 INPUT_PARAM(responseBufSize, const
size_t, "The size in bytes of the buffer <responseBuf>")
6437 RMH_API_IMPLEMENTATION_GENERIC_ONLY(
6446 "Print a generic status summary of the MoCA device and network. If <filename> is NULL all log messages are printed "
6447 "with RMH_LOG_MESSAGE. If it is not NULL the status will be appended to that file",
6453 INPUT_PARAM(filename, const
char *,
6454 "The file name where to write the status. If this is NULL the status will be written to RMH_LOG_MESSAGE")
6467 RMH_API_IMPLEMENTATION_GENERIC_ONLY(
6476 "Print a summary of of the Tx/Rx MoCA stats. If <filename> is NULL all log messages are printed "
6477 "with RMH_LOG_MESSAGE. If it is not NULL the status will be appended to that file",
6483 INPUT_PARAM(filename, const
char *,
6484 "The file name where to write the status. If this is NULL the status will be written to RMH_LOG_MESSAGE")
6497 RMH_API_IMPLEMENTATION_GENERIC_ONLY(
6506 "Print a generic status summary of the MoCA flows. If <filename> is NULL all log messages are printed with "
6507 "RMH_LOG_MESSAGE with RMH_LOG_MESSAGE. If it is not NULL the status will be appended to that file",
6513 INPUT_PARAM(filename, const
char *,
6514 "The file name where to write the status. If this is NULL the status will be written to RMH_LOG_MESSAGE")
6527 RMH_API_IMPLEMENTATION_GENERIC_ONLY(
6536 "Print a summary of the sub carrier modulation bitloading information.",
6542 INPUT_PARAM(filename, const
char *,
6543 "The file name where to write the status. If this is NULL the status will be written to RMH_LOG_MESSAGE")
6556 RMH_API_IMPLEMENTATION_SOC_ONLY(
6559 RMH_Result
RMH_ACA_Request(const
RMH_Handle handle, const uint32_t channelNum, const uint32_t sourceNodeId, const uint32_t destinationNodeMask, const RMH_ACAType type),
6565 "Instruct the driver to perform a new ACA operation [mocaIfAcaInitiate]. Returns RMH_SUCCESS if the ACA operation was started successfully. This call will fail if an ACA operation is already in progress.",
6570 INPUT_PARAM(channelNum, const uint32_t, "The channel number to perform the ACA on [mocaIfAcaChannel]"),
6571 INPUT_PARAM(sourceNodeId, const uint32_t, "The Node ID of the source node for the ACA. [mocaIfAcaNodeID]"),
6572 INPUT_PARAM(destinationNodeMask, const uint32_t, "The bitmask of the destination nodes for the ACA [mocaIfAcaReportNodeMask]. To include a given node in the ACA use 'destinationNodeMask |= (1 << nodeId)"),
6573 INPUT_PARAM(type, const RMH_ACAType, "The type of ACA to perform, either EVM or Quiet. [mocaIfAcaType]")
6586 RMH_API_IMPLEMENTATION_SOC_ONLY(
6595 "Return the channel number of the last requested ACA. [mocaIfAcaNodeID]",
6600 OUTPUT_PARAM(response, uint32_t*, "The channel number of the last requested ACA. [mocaIfAcaNodeID]")
6613 RMH_API_IMPLEMENTATION_SOC_ONLY(
6622 "Return the Node ID of the source node for the last requested ACA. [mocaIfAcaNodeID]",
6627 OUTPUT_PARAM(response, uint32_t*, "The Node ID of the source node for the last requested ACA. [mocaIfAcaNodeID]")
6640 RMH_API_IMPLEMENTATION_SOC_ONLY(
6649 "Return the bitmask of the destination nodes for the last requested ACA. [mocaIfAcaReportNodeMask]",
6654 OUTPUT_PARAM(response, uint32_t*, "The bitmask of the destination nodes for the last requested ACA. [mocaIfAcaReportNodeMask]")
6667 RMH_API_IMPLEMENTATION_SOC_ONLY(
6676 "Return the type of the last requested ACA operation",
6681 OUTPUT_PARAM(response, uint32_t*, "The type of the last requested ACA operation [mocaIfAcaType]")
6694 RMH_API_IMPLEMENTATION_SOC_ONLY(
6703 "Return the current status of the last requested ACA operation",
6708 OUTPUT_PARAM(response, RMH_ACAStatus*, "The current status of the previously started ACA operation [mocaIfAcaStatus]")
6721 RMH_API_IMPLEMENTATION_SOC_ONLY(
6730 "Return the total power from the last completed ACA operation. This call will fail if an ACA operation is already in progress",
6735 OUTPUT_PARAM(response, int32_t*, "The total power from the last completed ACA operation [mocaIfAcaTotalRxPower]")
6748 RMH_API_IMPLEMENTATION_SOC_ONLY(
6758 "Return the total power from the last completed ACA operation. This call will fail if an ACA operation already is in progress",
6763 INPUT_PARAM(responseArray, uint8_t*, "The ACA power profile. This is a binary
string array with 1
byte for each subcarrier. [mocaIfAcaPowerProfile]"),
6764 INPUT_PARAM(responseArraySize, const
size_t, "The size of <responseArray>"),
6765 OUTPUT_PARAM(responseArrayUsed,
size_t*, "The number of entries in the response array which have valid data")
6907 const char*
const RMH_PowerModeToString(
const uint32_t value,
char* responseBuf,
const size_t responseBufSize);
6925 const char*
const RMH_LogLevelToString(
const uint32_t value,
char* responseBuf,
const size_t responseBufSize);
6937 const char*
const RMH_EventToString(
const uint32_t value,
char* responseBuf,
const size_t responseBufSize);
6947 const char*
const RMH_MacToString(
const RMH_MacAddress_t value,
char* responseBuf,
const size_t responseBufSize);
8970 RMH_Result
RMH_ACA_Request(
const RMH_Handle handle,
const uint32_t channelNum,
const uint32_t sourceNodeId,
const uint32_t destinationNodeMask,
const RMH_ACAType type);