Disclaimer
This manual represents the current state of the product. Please check with port.de for the latest version as the document may have a newer version since errors may be corrected or changes for a newer version of the product may be incorporated. Port.de assumes no responsibility for errors in this document. Qualified feedback is appreciated at service@port.de.
This document is the Intellectual Property of port.de and is intended to be used with the described product only. It may be forwarded and/or copied in the original and unmodified format. All rights reserved.
The product enables to use technologies such as PROFINET, EtherNet/IP and/or EtherCAT and others. These technologies are promoted by trade organizations, such as PNO (profibus.org), ODVA (odva.org) or ETG (ethercat.org). These trade organizations as well maintain the specification and care about legal issues.
We strongly recommend to become a member of these organizations. Most technologies are making use of patented or otherwise copyrighted technologies, approaches or other intellectual property. The membership usually automatically entitles the member for use of most of the technology-inherent copyrighted or otherwise protected Intellectual Property of the corresponding trade organization and most 3rd parties. Otherwise the user will need to obtain licenses for many patented technologies separately.
Further we suggest to you to subscribe to the corresponding Conformance Test Tool of these trade organizations. For instance the ODVA only accepts conformance test applications from companies who have a valid membership and have a valid subscription to the recent Conformance Test Tool. We as port are members in all corresponding organizations and are holding a subscription to these tools - however you as a customer need to have an own membership and an own subscription to the tool.
All rights reserved
The programs, boards and documentations supplied by port GmbH are created with due diligence, checked carefully and tested on several applications.
Nevertheless, port GmbH cannot guarantee and nor assume liability that the program, the hardware board or the documentation are error-free or appropriate to serve a specific customer purpose. In particular performance characteristics and technical data given in this document may not be interpreted to be guaranteed product features in any legal sense.
For consequential damages, every legal responsibility or liability is excluded.
port has the right to modify the products described or their documentation at any time without prior warning, as long as these changes are made for reasons of reliability or technical improvement.
All rights of this documentation are with port. Unless expressively granted - the transfer of rights to third parties or duplication of this document in any form, whole or in part, is subject to written approval by port. Copies of this document may however be made exclusively for the use of the user and his engineers. The user is thereby responsible that third parties do not obtain access to these copies.
The soft- and hardware designations used are mostly registered and are subject to copyright.
Copyright
© 2019 port GmbH
Regensburger Straße 7
D-06132 Halle
Tel. +49 345 - 777 55 0
Fax. +49 345 - 777 55 20
E-Mail service@port.de
Changelog
Version | Changes |
1.0
|
Initial release |
1.1
|
Formatting |
1.2
|
Removed ARIS board Add warning regarding folder depth on older windows versions Updated to current synergy development tools
|
Introduction
This document describes integration delivered example projects for irj45 using synergy target with development environment e2studio.
...
...
|
...
Preparations
Hardware Requirements
...
File | Content |
"2015013__V1_1_7_0__20191205__Renesas_Synergy_CCM_ci73" | Goal Library and Headers |
“iRJ45 Management Tool“iCommExplorer-201808221413-win32.win32.x86_64_ci117-v1.3.1.zip" | Management Tool |
...
Industrial Communication Explorer |
Industrial Communication Explorer
To use the PROFINET master functionality, WinPCap[1] needs to be installed.
Please unpack the delivery " iRJ45 Management TooliCommExplorer-*-win32.win32.x86_64.zip" to a local folder. The resulting folder contains the executable “mantool”, which can be started.
...
Use the import dialog of e2studio to import the project located in the unpacked project delivery into e2studio. Chose "Existing projects into workspace" when prompted for import type.
...
| Note |
|---|
Older windows versions limit path length to 256 bytes. Thus please make sure that the installation file us unpacked to the root of a drive. |
...
Select the root directory of the unpacked e2studio project for import and “Finish” import (see Figure 4 e2studio Import project dialog). There are several types of projects, which can be imported all or selectively.
...
After importing the projects can be built. Use the project context menu, menu item “Build Project” to do so. As a result, a binary should be generated and the “Console” log should show the following text:…
| Code Block |
|---|
... 'Invoking: Cross ARM GNU Create Flash Image' |
...
'Invoking: Cross ARM GNU Print Size' |
...
arm-none-eabi-objcopy -O srec "01_pnio_simple_io_lib.elf" "01_pnio_simple_io_lib.srec" |
...
arm-none-eabi-size --format=berkeley "01_pnio_simple_io_lib.elf" |
...
text data bss dec hex filename |
...
149852 3824 282908 436584 6a968 01_pnio_simple_io_lib.elf |
...
'Finished building: 01_pnio_simple_io_lib.siz' |
...
'Finished building: 01_pnio_simple_io_lib.srec |
...
' '
' '
09:38:10 Build Finished. 0 errors, 0 warnings. (took 5s.962ms) |
...
| Info |
|---|
Warning may occur regarding redefinition of the symbol TX_TIMER_TICKS_PER_SECOND. This is caused by adding the source version of ThreadX to the application. This is required to get the required timer resolution of 1 ms and cannot be omitted. |
...
| Note |
|---|
If compilation fails, please make sure you followed step involving code generation from configuration.xml. |
...
You will be prompted to select a debugging hardware. Choose „J-Link ARM“ for the Synergy Aris board.
...
After initiating the debug session, the “Debug perspective” will be shown, where the application can be started by “Resuming” execution (needs to be done twice since there a two breakpoints automatically set on startup).
...
| Note |
|---|
If the communication module was previously started up using another application, a manual reboot will be required of the module (reset button on the Arduino shield). |
Management Tool
...
Industrial Communication Explorer
The Management Tool Industrial Communication Explorer allows development related configuration and management of the irj45 application. This management is based on a UDP broadcast communication. Thus, it works independently from IP settings of the management PC and the irj45SoM.
...
This tool is organized in panels. The “Network Navigator” shows a list of available networks. The panel “Messages” shows information regarding actions. The panel “Outline” shows additional information depending on the selected function panel.
Following function panels are available:
Panel | Function |
EtherCAT Master | Provides simple EtherCAT master functionality. |
EtherNet/IP Master | Provides simple EtherNet/IP master functionality |
Exception Log | Shows error messages, which are saved in the non volatile storage of the communication controller. |
Device Log | shows Shows log messages of the running application from both communication controller (CC) and application controller (AC). |
Network state | Shows link state of the available network interfaces of the RJ45SoM. |
PNIO Master | Provides simple PNIO master functionality. |
Config ManagerConfigManager | Provides access to the config manager variables of the irj45SoM. |
Firmware Update | Allows update of the firmware in of the irj45SoM. |
Device Detection
At first a communication needs to establish be established with the irj45SoM. Thus, connect the irj45 SoM to the network. Between the management PC and the irj45 SoM a network connection must be possible.
...
To communicate with the irj45SoM, at first open the “Networks” list in the “Network Navigator”. Choose the network interface where the irj45 SoM is reachable. The Then select the “Scan Network” button in the toolbar.
The following dialog appears and 1 found device will be reported:
...
As a result, a new irj45 SoM will be shown in the „Network Navigator“ within the scanned network.
...
Please select the newly found irj45 SoM for further steps.
Logging
With the selected irj45 SoM and within the “Device Log” function panel, it is now is possible to read the logging buffer using “Start reading log”. For the demo application, it shows both the log messages from the communication controller (irj45SoM) and the application controller (Synergy ArisRaspberry Pi). Those can be distinguished by the “Source” column, which either shows “CC” ore “AC”. A successful started application reports a successful initialization of PROFINET:
| Code Block |
|---|
[I| goal_miMctcLoop:499] running appl_setup |
...
[I| goal_pnioNewAc:369] PROFINET Application Core successfully started |
...
[I| appl_setup:226] Initializing device structure |
...
[I| appl_setup:275] PROFINET ready |
...
[I| appl_setup:281] Configuring DD |
...
[I| appl_setup:309] DD ready |
To stop logging push the button again.
Config Manager / IP Configuration
This The function panel “ConfigManager” provides access to the config manager variables of the irj45 SoM (volatile and nonvolatile stored configuration variables).
To read a list of all variables, select the “Read configuration” button in the toolbar.
...
As a result, all variables with value are shown.
...
To communicate with the irj45SoM, the IP address of the irj45 it must be within the same IP network as the IP address of the Management PC IP address. Thus, chose choose a valid IP address and configure the irj45 SoM accordingly.
To configure an IP address, navigate to the variables of the “Module” GOAL_ID_NET. There . Make sure, that the variable DHCP_ENABLED is set to 0x00, as this option is prioritized. Now it is possible to configure IP, NETMASK and GW. Modify required values. Make sure Set the variable “VALID” is set to 10x01.
The Management Tool will show locally modified variables with a yellow highlight.
...
Those locally modified variables are downloaded to the irj45 SoM using the “Write configuration” button in the toolbar. When prompted if changed values shall be written, answer “Yes”. Afterwards the locally modified values are transferred to the irj45SoM, where there are only modified in RAM. To make changes permanently, use the “Save config to flash” buttonanswer the following prompt with “Yes”. Modified IP settings are applicated after restart of the system (power cycle the ArisRenesas Synergy/irj45SoM).
Examples
01_pnio_simple_io
...
To establish a PROFINET communication, at first the irj45 SoM must be selected in the “Network Navigator”. Then select the PNIO Master function panel. At first use “Scan device” to detect the PROFINET device.
...
Use the “Wink” command to identify the connected irj45SoM, which will be shown with a flashing “LED1” on the Arduino shield.
To establish a cyclic PROFINET communication use the I/O panel of the PNIO Master.
...
Please start the example “01_pnio_simple_io” according to the previous descriptions.
To establish a PROFINET communication, at first the SoM must be selected in the “Network Navigator”. Then select the function panel PNIO Master.
...
. At first use “Scan device” to detect the PROFINET device.
...
Use the “Wink” command to identify the connected SoM, which will be shown with a flashing “LED1” on the Arduino shield.
To establish a cyclic PROFINET communication use the I/O panel of the PNIO Master.
...
To continue, load the GSDML file provided with the distribution, located in “goal\appl\2015013_irj45\ac\gsdml\GSDML-V2.32-portGmbH-irj45-20180810.xml".
In the selector “Device Access Point” select “2-port Device”.
Afterwards press the “Connect” button. This button initiated a cyclic PROFINET communication.
| Info |
|---|
If the cyclic connection failes, try to decrease the “Device Interval”. Take also a look at our Support Knowledge Base and FAQ. |
The example application on the application controller will mirror the output data to the input data. I/O data can be manipulated and monitored in the I/O Data table. Beside that if a connection is established, the “LED1” Led on the Arduino shield will be enabled.
...