background image

ADP menu

UM1811

36/52

DocID026814 Rev 1

adpBroadcastLogTable                                                                                                      Contains the broadcast log table

adpRoutingTable                                                                                                           Contains the routing table

adpUnicastRREQGenEnable                                                                                                  

If TRUE, the RREQ shall be generated with its ''unicast RREQ'' flag set to '1'
If FALSE, the RREQ shall be generated with its ''unicast RREQ'' flag set to '0'

adpGroupTable                                                                                                             Contains the group addresses to which the device belongs

adpMaxHops                                                                                                                Defines the maximum number of hops to be used by the routing algorithm

adpDeviceType                                                                                                            

Defines the type of the device connected to the modem:
0: PAN device
1: PAN coordinator
2: not defined

adpNetTraversalTime                                                                                                      

Maximum time that a packet is expected to take to reach any node from any 
node in seconds

adpRoutingTableEntryTTL                                                                                                   Maximum time to live of a routing table entry (in seconds)

adpKr                                                                                                                     A weight factor for the robust mode to calculate the link cost

adpKm                                                                                                                     A weight factor for modulation to calculate the link cost

adpKc                                                                                                                     A weight factor for the number of active tones to calculate the link cost

adpKq                                                                                                                     A weight factor for LQI to calculate the route cost

adpKh                                                                                                                     A weight factor for hop to calculate the link cost

adpRREQRetries                                                                                                            The number of RREQ retransmission in case of RREP reception timeout

adpRREQRERRWait                                                                                                           Time in seconds to wait between two consecutive RREQ or RRER generations

adpWeakLQIValue                                                                                                          

The weak link value defines the LQI value below which a link to a neighbor is 
considered as a weak link. A value of 52 represents an SNR of 3 dB.

adpKrt                                                                                                                   

A weight factor for the number of active routes in the routing table to calculate 
the link cost

adpSoftVersion                                                                                                            The software version

adpSnifferMode                                                                                                            The Sniffer mode activation/deactivation

adpBlacklistTable                                                                                                         Contains the list of the blacklisted neighbors

adpBlacklistTableEntryTTL                                                                                                 Maximum time to live of a blacklisted neighbor entry (in minutes)

adpMaxJoinWaitTime                                                                                                        Network join timeout in seconds for LBD 

adpPathDiscoveryTime                                                                                                      Timeout for path discovery in seconds

adpActiveKeyIndex                                                                                                         Index  of the active GMK to be used for data transmission

adpDisableDefaultRouting                                                      

If TRUE, the default routing (LOADng) is disabled. If FALSE, the default routing 
(LOADng) is enabled

Table 8. ADP G.9903 information base attributes52 (continued)

Standard G.9903 ADP information base attributes

Summary of Contents for G3-PLC

Page 1: ...ST G3 PLC library This document does not describe in details the plugin the host interface application nor the ST G3 PLC library It describes the PC tool features it details the options that it offers...

Page 2: ...3 2 Node tree panel 9 3 3 GUI and Plugin Settings 11 3 4 Automatic confirm and indication events parsing 12 4 G3LIB menu 13 4 1 G3LIB root menu 13 4 2 G3LIB IB EX menu 14 4 3 G3LIB information base at...

Page 3: ...e attributes description 35 8 BER Test panel 38 8 1 Typical setup 38 8 2 Test description 38 9 Sniffer panel 41 9 1 Introduction 41 9 2 Data logs 42 10 Basic G3 operations 43 10 1 Environment setup 43...

Page 4: ...e 19 ADP root panel 31 Figure 20 ADPM control menu 32 Figure 21 LoWPAN bootstrap protocol menu 33 Figure 22 ADPM_IB menu 34 Figure 23 Effect of show routing table command 35 Figure 24 BER Test setup 3...

Page 5: ...viations Abbreviation Description 6LoWPAN IPv6 over low power wireless personal area networks ADP Adaptation layer BER Bit error rate GUI Graphical user interface G3 G3 PLC powerline protocol MAC Medi...

Page 6: ...to be uncompressed One or more USB ports 2 2 G3 PLC GUI release The GUI is released in a zip archive To run the application the archive needs to be uncompressed on the user local disk Once the archive...

Page 7: ...the configuration panel 3 Plugin Information button it shows the plugin information panel 4 ST Power Line GUI information button it shows the G3 PLC GUI information panel 5 Node tree navigation panel...

Page 8: ...ely right click on the ST PowerLine Host icon and click on Add Node Figure 3 Add a node Once the Add Node cross has been selected one new tab appears in the command panel In the node tree panel select...

Page 9: ...offers access to the Service Access Points SAP of each layer specified by the G3 PLC standard plus some additional features such as a bootstrap application or the G3 library configuration Once a G3 P...

Page 10: ...nu offers an interface to use the PHY primitives of the G3 PLC protocol MAC the MAC menu offers an interface to use the MAC primitives of the G3 PLC protocol ADP the ADP menu offers an interface to us...

Page 11: ...or the MAC layer 0x02 ADP_MODE the ADP 6LoWPAN working mode The device may perform all the operations described by the G3 PLC standard for the adaptation layer 0x03 BOOT_MODE default the BOOT working...

Page 12: ...tomatic management of the Confirm and Indication events communicated by the G3 PLC platform As a consequence the user does not need to periodically poll the status of the G3 PLC platform It is possibl...

Page 13: ...rational mode of the host interface application HI STATE GET Request this command performs a basic action to test the connection with the board HI HWRESET Request this command performs a system reset...

Page 14: ...the connected device Note that the Confirm message is sent automatically by the application as described in Section 3 4 on page 12 4 2 G3LIB IB EX menu IB EX stands for the information base explorer T...

Page 15: ...EFWVERSION The protocol engine firmware version PEPROTOVERSION The protocol engine protocol version PEDEBUGLEVEL Debug mode settings PEMODE The G3 PLC library working mode 0 PHY 1 MAC 2 ADP 3 BOOT PEU...

Page 16: ...GCRESETTIMEOUT The number of SYNCP preamble symbols without any preamble detection after which the AGC is reset PHYCENELECLEGACYMODE 0 elementary interleaving interleaver parameters are not swapped 1...

Page 17: ...quest button 2 Figure 9 Configure the host interface in PHY mode Once the PHY mode is selected the following menu panels may be accessed PHY root menu it allows to send data in the physical layer mode...

Page 18: ...tic event is disabled Data shall be specified in the hexadecimal or ASCII format selecting the proper button Note that in case of the Hex format if the payload is entered manually the payload length m...

Page 19: ...menu offers 2 options set the RX and TX chain status and get the status of the line carrier sense Figure 11 PLME control menu Concerning the PLME_SET_TRX_STATE Request command two options may be selec...

Page 20: ...matic event is disabled The following transmission options are available in the panel ToneMap bitmap containing the list of the active sub bands bit set to 1 or inactive bit set to zero Active means t...

Page 21: ...g coexistence mechanism Frequency notching allows a G3 device to coexist with the existing narrow band FSK PSK systems operating over the same frequency band This checkbox acts on the ToneMask field P...

Page 22: ...le modes 1 and press the HI MODE SET Request button 2 Figure 13 Configure the host interface in MAC mode Once the MAC mode is selected the user can access one of the following menu MAC root menu a com...

Page 23: ...are available in the panel Security Level the security level to be used No Security ENC MIC 32 CCM Src Address Mode the source address mode BITS16 short address BITS64 extended address Dst Address Mo...

Page 24: ...5 Figure 15 MLME control menu On the MLME_control panel the following commands are available MLME RESET Request resets the MAC layer MLME RESET Confirm forces generation of a confirm message if automa...

Page 25: ...er management entity menu offers the possibility to read and write the information base parameters of the G3 PLC MAC layer as represented in Figure 16 Figure 16 MAC IB menu From this menu the followin...

Page 26: ...ows the explorer menu of the information base for the MAC entity Figure 17 MAC information base explorer This menu offers the same set of commands as the MLME IB ones The main difference is the white...

Page 27: ...ing macFrameCounter The outgoing frame counter for this device Table 6 MAC G 9903 information base attributes Standard G 9903 attributes macHighPriorityWindowSize The high priority contention window s...

Page 28: ...9903 attributes Table 7 MAC ST implementation defined information base attributes ST implementation defined attributes aExtendedAddress EUI 64 address to be used SNRdBLOW The low threshold for the SN...

Page 29: ...dBROBO The tone map algorithm threshold for the robust mode SNRdBDBPSK The tone map algorithm threshold for DBPSK modulation SNRdBDQPSK The tone map algorithm threshold for DQPSK modulation SNRdBD8PSK...

Page 30: ...P_MODE from the available modes 1 and press the HI MODE SET Request button 2 Figure 18 Configure the host interface in ADP mode Once the ADP mode is selected the following menus are accessible ADP roo...

Page 31: ...ts the hexadecimal or ASCII input mode for the NSDU Payload content free text window to enter the NSDU to be sent note that the data has to be a valid IPv6 packet Max Payload Size check box to configu...

Page 32: ...ified PANId ADPM NETWORK JOIN Request this primitive allows the next upper layer to join a network identified by PANId through a low bootstrap agent short address ADPM NETWORK LEAVE Request this primi...

Page 33: ...adecimal or ASCII input mode for the NSDU Payload content a free text window to enter the NSDU to be sent note that the data has to be a valid LBP message Max Payload Size a check box to configure the...

Page 34: ...formation base The attribute to read can be selected from a list ADPM SET Request writes the value of one attribute of the ADP information base The attribute to set can be selected from a list and its...

Page 35: ...and is not affected by the prefixes defined in the prefix table adpBroadcastLogTableEntryTTL Maximum time to live of a adpBroadcastLogTable entry in seconds adpMetricType A metric type to be used for...

Page 36: ...r for LQI to calculate the route cost adpKh A weight factor for hop to calculate the link cost adpRREQRetries The number of RREQ retransmission in case of RREP reception timeout adpRREQRERRWait Time i...

Page 37: ...bleHeaderCompression If set to 1 it enables the IPv6 header compression default if set to 0 it disables the IPv6 header compression adpRREQFfwdMaxTime The maximum time in ms that can take a RREQ to be...

Page 38: ...ored single carrier etc may also impact the BER performance 8 2 Test description To be able to perform the BER Test two G3 PLC platforms need be connected to the G3 PLC GUI Both boards need to be conf...

Page 39: ...n the right area 1 Do the same for the RX Node 2 Figure 26 Configure BER Test panel One last step is needed in the configuration process for the BER the deactivation of the Reed Solomon filter for the...

Page 40: ...smission parameters this could be smaller 128 bytes is an adequate size Once the configuration is done the user may click the START button to start the BER session The BER Test session ends when the T...

Page 41: ...In order to perform the deciphering the G3 PLC GUI interface needs to be configured with the GMK used to cipher the MAC frames as shown in Figure 28 First the Plugin Settings button has to be pressed...

Page 42: ...are displayed in white color If the PHY payload is encapsulating a MAC frame the row is displayed in light blue color The MAC header fields are then displayed on the same row MAC source address MAC d...

Page 43: ...sonal computer and the Node 2 enhanced Com port is mapped on the COM59 10 3 PHY layer data exchange To be able to execute a PHY command the Node 1 and 2 working modes need to be set to the PHY mode as...

Page 44: ...gure Node 2 in RX Now that the boards are plugged in the mains and the setup has been completed data can be sent at the PHY level as represented in Figure 33 To do this go to the PHY root menu of the...

Page 45: ...the amount of data inserted doesn t reach an acceptable length for the PHY block This results in additional byte shown in the data field of the PD DATA Indication message Also note that there s a limi...

Page 46: ...click on the MLME SET Request button 4 Figure 35 Configure Node 1 PANId As shown in Figure 35 the same can be done for the macShortAddress parameter Select first the attribute macShortAddress in the...

Page 47: ...ure 37 Figure 38 Configure Node 2 short address Now that the Node 1 and Node 2 are properly configured data can be exchanged from one node to the other one To do this go in the MAC root menu as show i...

Page 48: ...RX To check that the transmission was successful look for the MCPS DATA Indication message in the trace window with the SUCCESS status When hovering over this message its detailed content appears in a...

Page 49: ...IB menu 1 In the list of attributes for the set command select the attribute macKeyTable 2 Then enter the security key in the Text area 3 leave the Index set to 0 and click on the MLME SET Request but...

Page 50: ...00002AFE8000000000000078 1D00FFFE00010CF0B1F0B20017EE2C112233445566778899AABBCCDDEEFF Once the Nsdu is correctly set 1 and the ADPD DATA Request command has been executed 2 the ADPD DATA Indication me...

Page 51: ...DocID026814 Rev 1 51 52 UM1811 Revision history 52 11 Revision history Table 10 Document revision history Date Revision Changes 07 Oct 2014 1 Initial release...

Page 52: ...sers are solely responsible for the choice selection and use of ST products and ST assumes no liability for application assistance or the design of Purchasers products No license express or implied to...

Reviews: