background image

DocID026814 Rev 1

11/52

UM1811

Getting started

52

G3LIB: this menu offers an interface to be able to configure the G3-PLC library and 
access additional parameters that are not specified in the G3-PLC protocol.

IPv6: the IPv6 menu offers the possibility to drive a specific firmware with the IPv6 on 
the top of G3. This feature will not be described in this document. Please contact your 
ST local support for additional information.

TEST: the TEST menu offers an interface for test purposes.

Each menu provides one specific SAP layer of the G3-PLC stack. In order to access a given 
SAP layer, the G3-PLC implementation needs to be configured to work in a specific 
operational mode. 

In order to do this, the G3LIB section exports the HI-MODE-SET command, which can set 
one of the following values:

0x00 - PHY_MODE: the PHY only working mode. The device may perform all the 
operations described by the G3-PLC standard for the PHY layer.

0x01 - MAC_MODE: the MAC working mode. The device may perform all the 
operations described by the G3-PLC standard for 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 mode. The device may perform all 
the operations described by the G3-PLC standard for the adaptation layer. In addition, 
the bootstrap application is activated. This is the default mode of operation.

Additional operational modes (such as IPv6) may be present. The related functions may be 
used in conjunction with specific firmware projects that may be obtained from your local 
support.

3.3 

GUI and Plugin Settings

Under the Plugin Settings button (1) represented in 

Figure 5

, some advanced G3-PLC GUI 

features may be enabled or disabled.

Request/Response Trace Layout: it changes the layout of the trace panel

Asynchronous Rx message thread: see 

Section 3.4 on page 12

TESTLAB panel: enables the test panel as described in 

Section 8 on page 38

Sniffer MAC Key: the 128-bit key used by the MAC layer to cipher data. Configuring the 
key is necessary to decipher the MAC frames captured by the Sniffer.

Additional information (i.e.: the version numbers) related to the G3-PLC GUI may be 
checked under the Plugin Information and ST PowerLine GUI buttons.

Содержание 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...

Отзывы: