background image

G3LIB menu

UM1811

14/52

DocID026814 Rev 1

Below this SET command, a list of options or a text box allows providing the value with 
which the selected attribute is set.

G3LIB-SWRESET.Request: this command performs a software reset of the G3-PLC 
protocol stack (RTE and non-RTE part.).

G3LIB-GET/SET.confirm: these commands are used to get asynchronous confirm 
message from the application to 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. This menu offers the user the ability to 
read/modify any attribute of the library information base. 

It is made of a white board in which the user can drag and drop the desired attribute from 
the list on the left side.

Figure 8. G3LIB information base explorer 

More than one attribute may be added in the white board. A generic set/get method is then 
available to write/read the attribute.

Содержание G3-PLC

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Отзывы: