TMDS64GPEVM: Ethernet/IP support

Hi
Please check following page to get more details on the example : https://software-dl.ti.com/mcu-plus-sdk/esd/AM64X/08_01_00_36/exports/docs/industrial_protocol_docs/am64x/ethernetip_adapter/page_quickstart_example_app.html

Aaron Renny said:

 Please correct me if i am wrong, I understand that we can change the ip address of the slave and set it to a permissible value using this API. I would like to know if we have to configure any other parameters before calling this API or will simply calling this API changes the IP address. I would also like to know about the values of the other parameters given in this API in order to set an IP address.

Yes, you can use this API to change the IP address. The stack needs to be running obviously before you call this API. You can check the usage of this API in the example, and see the other APIs called before this.

For understanding the meaning of parameters, you can check the references mentioned here : https://software-dl.ti.com/mcu-plus-sdk/esd/AM64X/08_01_00_36/exports/docs/industrial_protocol_docs/am64x/ethernetip_adapter/index.html

API documentation includes the class code and attribute affected.

Aaron Renny said:

Also, I would like to know how the data exchange takes place between the master and slave(am64xgpevm). My understanding is that a attribute will have a service attached to it and a callback function is run everytime this service is called. Please do correct me if I am wrong.

You can check the references mentioned above for more details.

Aaron Renny said:

Also, please do list out any software that can be used to test out the ethernet/ip adapter functionality of the am64xgpevm. I do not have a PLC, and I am trying to use my Laptop as the ethernet/ip master. Please share any documentation on how to test out the ethernet/ip adapter functionality.

At this point, we have documented steps with following 3 options:

• CODESYS Runtime on a Texas Instruments AM64x Sitara Processor
• CODESYS Runtime on a KUNBUS RevPI Controller
• Allen-Bradley CompactLogix Controller

None of them is a simple PC based solution. But you can check out first option (CODESYS Runtime on a Texas Instruments AM64x Sitara Processor), where you can use an AM64x EVM as master.

Regards
Dhaval Khandla

Hi Dhaval,

Thank you for the reply.

I was using the APIs given in this documentation for creating class, instance and attribute.

https://dev.ti.com/tirex4-desktop/content/mcu_plus_sdk_am64x_08_01_00_36/docs/industrial_protocol_docs/am64x/ethernetip_adapter/index.html

My idea is to create a class and give it an instance and an attribute. Then define a callback function that gets triggered whenever the services defined in the attribute are called by the ethernet/ip master. I understand that this is how the communication works. Please do correct me if I am wrong.

I was trying to create the callback function inside an attribute using the API as per the code snippet given in:

dev.ti.com/.../group___e_i___a_p_i___c_i_p___i_n_s_t_a_n_c_e_gaa32b748fbe42f484b5659849be4df2d1.html

 I noticed that the structure attr defined in the code snippet doesnot contain a member called callback, which is used to give the callback function.

The same was reflected in the error I got while compiling the code. Can please provide some clarification to this issue ?.

Also please mention any other APIs used for the above said functionality. Also tried using 

EI_API_CIP_setClassAttrFunc()

but got the same error.

Please provide a clarification for this issue.

Thank you,

Aaron Renny

Hi
Sorry about this inconsistency.

Please check the  EI_API_CIP_SAttr_t  structure definition, which has get_callback and set_callback members. You can use those members.

You can check  AppClass71.c file in the example for more details on usage of user defined class.

Regards
Dhaval Khandla

Hi Dhaval,

Thank you for the reply.

I would like to know how the ip address is assinged to the ethernet slave deive. When the slave is initialised, is it automatically allocated an ip address by the DHCP server or by any other method. Or do we have to call other APIs to initialise the ip address of the slave.

Thank you,

Aaron Renny

Hi

In SDK example, IP address is read from the non-volatile memory and set. If you are running EtherNet/IP Adapter for the first time, check-sum of data read from non-volatile memory will not match and default values will be written to non-volatile memory. Please see EI_APP_PERM_read() in "AppPerm.c" for more details. Default IP address is 192.168.1.10 (which can be confirmed using "EI_APP_PERM_SCfgData_t tDefaultPermData_s" variable).

You can check the call sequence of "EI_APP_init() -> EI_APP_adpInit() -> EI_APP_PERM_read() -> EI_API_ADP_setIpConfig()" in the example.

Regards
Dhaval Khandla

Hi  Dhaval,

Thank you for the reply.   Is there any API that support getting IP address from the DHCP server.

I was going through the API documentation about this API using the link: 

dev.ti.com/.../group___e_i___a_p_i___c_i_p___i_n_s_t_a_n_c_e_ga646556cb474c0a708311ac40d3776f3e.html

EI_API_CIP_setInstanceServiceFunc()

I saw that the printf function was used to indicate the callback function being called.

I would like to know where the output of the printf is being displayed. It would greatly help in debugging the program. Also is there any way to display outputs to the linux core or to any ports available on the EVM board.

Thank you,

Aaron Renny

Hi

Aaron Renny said:

Is there any API that support getting IP address from the DHCP server.

You can use EI_API_ADP_setIpConfig API. Did you try it?

Aaron Renny said:

I saw that the printf function was used to indicate the callback function being called.

I would like to know where the output of the printf is being displayed.

You can see the prints in the UART console.

Regards
Dhaval Khandla

Hi Dhaval,

Thank you for the reply.

I have not yet tried out the setipconfig API. I would like to know if a DHCP client functionality is provided within the ethernet/ip stack. 

Also, to which UART console are the printf messages being displayed.  We are running linux on A53 core. Will this conflict with the UART port?. 

I would like to print the callback messages on the linux core. I have been looking into using the RPmessage for giving data  from the R5F core to the A53 core. Can this be used along with the ethernet/ip example for displaying callback messages on the linux side. If not, please suggest other methods by which this can be made possible.

Thank you,

Aaron Renny

Hi
Yes, DHCP is supported.

Aaron Renny said:

Also, to which UART console are the printf messages being displayed.  We are running linux on A53 core. Will this conflict with the UART port?. 

Prints can be seen on the port mentioned here : https://software-dl.ti.com/mcu-plus-sdk/esd/AM64X/08_01_00_36/exports/docs/api_guide_am64x/EVM_SETUP_PAGE.html#CCS_UART_TERMINAL

If the port is conflicting with A53, you can try changing the "UART Instance" from USART0 to something else in the "Debug Log" module in SysConfig GUI for he example.

Aaron Renny said:

I have been looking into using the RPmessage for giving data  from the R5F core to the A53 core. Can this be used along with the ethernet/ip example for displaying callback messages on the linux side. If not, please suggest other methods by which this can be made possible.

Yes, you can use the RP Message. There are some examples demonstrating it's usage in the SDK. Refer https://software-dl.ti.com/mcu-plus-sdk/esd/AM64X/08_01_00_36/exports/docs/api_guide_am64x/IPC_GUIDE.html for more details.

Regards
Dhaval Khandla

Hi Dhaval,

Thank you for the reply. 

I was going through the  EI_API_ADP_setIpConfig API provided in the documents. My understanding is that the dhcp_p parameter should be set to true in order to enable the DHCP functionality. Is it correct or is there any other way to enable the DHCP client functionality in am64x EVM board.

Thank you,

Aaron Renny

Hi

Aaron Renny said:

I was going through the  EI_API_ADP_setIpConfig API provided in the documents. My understanding is that the dhcp_p parameter should be set to true in order to enable the DHCP functionality. Is it correct or is there any other way to enable the DHCP client functionality in am64x EVM board.

Yes.

You can also configure it using any adapter configuration tool or from PLC.

Regards
Dhaval Khandla

Hi Dhaval,

Thank you for the reply. My understanding is that after enabling the DHCP functionality, we can get the ip address, set by the DHCP server, by using the API

EI_API_ADP_getIpAddr()  

Please do correct me if I am wrong.

Also, the am64x GPEVM has three ethernet ports and two PRU. I would like to know which R5F core controls which PRU and together which ethernet port is being controlled by them.

I would also like to know which ethernet port does the example provided by the SDK control.

Thank you,

Aaron Renny 

Hi

Aaron Renny said:

Also, the am64x GPEVM has three ethernet ports and two PRU. I would like to know which R5F core controls which PRU and together which ethernet port is being controlled by them.

I would also like to know which ethernet port does the example provided by the SDK control.

EtherNet/IP Adapter solution uses PRU0 and PRU1 cores of an ICSSG instance. ICSSG has interfaces to two PHYs. Both PHYs are used in EtherNet/IP.

More details on which two ports (out of three) are ICSSG ports can be known from Section 3.4.9 Ethernet Interface of EVM User Guide.

Regards
Dhaval Khandla

Hi Dhaval,

Thank you for the reply. I looked into the document provided above and found that the first port(J14) is not a ICSSG port. Also while going through the sysconfig file of the example provided, I found that the example uses ICSSG 1 instance. 

I would like to know to which ethernet port (stacked RJ45 connector J21) is this ICSSG instance connected to so that I can make the necessary connections in order to test out the ethernet/ip adapter functionality. My idea is to flash this example code into the R5F0_0 core.

Also, my understanding is that after setting the dhcp_p parameter in the EI_API_ADP_setIpConfig API , we can get the ip address set by the DHCP server by using the getIp_addr() API. Please do correct me if I am wrong.

Thank you,

Aaron Renny

Hi

Aaron Renny said:

Thank you for the reply. I looked into the document provided above and found that the first port(J14) is not a ICSSG port. Also while going through the sysconfig file of the example provided, I found that the example uses ICSSG 1 instance. 

I would like to know to which ethernet port (stacked RJ45 connector J21) is this ICSSG instance connected to so that I can make the necessary connections in order to test out the ethernet/ip adapter functionality. My idea is to flash this example code into the R5F0_0 core.

Both ports (stacked connectors) are corresponding to ICSSG1. 

Aaron Renny said:

Also, my understanding is that after setting the dhcp_p parameter in the EI_API_ADP_setIpConfig API , we can get the ip address set by the DHCP server by using the getIp_addr() API. Please do correct me if I am wrong.

Yes, you can use EI_API_ADP_getIpAddr API.

Regards
Dhaval Khandla

Hi Dhaval,

Thank you for the reply. So I understand that either of the stacked connectors can be controlled using the ICSSG1 instance. I would like to know which port (J21A or J21B ) ,(top or bottom port),  is being controlled by ICSSG1 instance in the SDK example provided.

Also, I was going through the EI_API_ADP_setIpConfig API for enabling the DHCP client functionality. The second parameter of this function is the new ip address. My understanding is that when we enable the DHCP client, then the IP address will be set by the DHCP server.

In that case, what should be the value of the new ip address parameter (ipAddr_p,) when the setIpConfig function is called.

Thank you,

Aaron Renny

Hi

Aaron Renny said:

Thank you for the reply. So I understand that either of the stacked connectors can be controlled using the ICSSG1 instance. I would like to know which port (J21A or J21B ) ,(top or bottom port),  is being controlled by ICSSG1 instance in the SDK example provided.

EtherNet/IP uses both ports, because it is used as a two port switch.

Aaron Renny said:

Also, I was going through the EI_API_ADP_setIpConfig API for enabling the DHCP client functionality. The second parameter of this function is the new ip address. My understanding is that when we enable the DHCP client, then the IP address will be set by the DHCP server.

In that case, what should be the value of the new ip address parameter (ipAddr_p,) when the setIpConfig function is called.

As mentioned in the API documentation page, second parameter is not an input, but an output. You need to pass a pointer where the IP address of the adapter specified by parameter pAdp_p will be stored.

Regards
Dhaval Khandla

Hi Dhaval,

Thanks for the reply. 

My understanding was that only one of the ethernet ports is used to implement the ethernet IP adapter functionality using the SDK example. 

https://software-dl.ti.com/mcu-plus-sdk/esd/AM64X/08_01_00_36/exports/docs/industrial_protocol_docs/am64x/ethernetip_adapter/page_quickstart_example_plc.html

These setup connections also depict the use of only one port . Am I missing something? Please do correct me if I am wrong.

The setIpConfig API, given in the below link, has all the parameters as inputs. Is this an error in the documentation?

https://dev.ti.com/tirex4-desktop/content/mcu_plus_sdk_am64x_08_01_00_36/docs/industrial_protocol_docs/am64x/ethernetip_adapter/group___e_i___a_p_i___a_d_p___t_c_p_gaeaae8ef26bafcc7a51bacab3719bd1e8.html#gaeaae8ef26bafcc7a51bacab3719bd1e8

My understanding till now was that we could use the laptop as a ethernet IP scanner and the am64xGPEVM as the ethernetIP adapter and only one ethernet port on the board was used. Please do provide some clarification on this matter

Thank you,

Aaron Renny

Hi

Aaron Renny said:

My understanding was that only one of the ethernet ports is used to implement the ethernet IP adapter functionality using the SDK example. 

https://software-dl.ti.com/mcu-plus-sdk/esd/AM64X/08_01_00_36/exports/docs/industrial_protocol_docs/am64x/ethernetip_adapter/page_quickstart_example_plc.html

These setup connections also depict the use of only one port . Am I missing something? Please do correct me if I am wrong.

Sorry for the confusion. Please refer to following documents for more details. 

• EtherNet/IP on TI's Sitara processors
• MAC vs Switch mode : https://software-dl.ti.com/mcu-plus-sdk/esd/AM64X/08_01_00_36/exports/docs/api_guide_am64x/ICSS_EMAC_DESIGN.html#autotoc_md739

Aaron Renny said:

The setIpConfig API, given in the below link, has all the parameters as inputs. Is this an error in the documentation?

https://dev.ti.com/tirex4-desktop/content/mcu_plus_sdk_am64x_08_01_00_36/docs/industrial_protocol_docs/am64x/ethernetip_adapter/group___e_i___a_p_i___a_d_p___t_c_p_gaeaae8ef26bafcc7a51bacab3719bd1e8.html#gaeaae8ef26bafcc7a51bacab3719bd1e8

I misunderstood your question last time, and referred to  EI_API_ADP_getIpAddr API in my last reply by mistake. For EI_API_ADP_setIpConfig API, the value passed in ipAddr_p will be used until a new value is configured using DHCP.

Regards
Dhaval Khandla

Hi Dhaval,

Thank you for the reply.

Our goal is to just set up an ethernet/IP adapter using am64x GP evm and Scanner(using laptop) in order to test out simple data transfer facility over ethernet using a single port of the EVM.

Please do tell me how such a functionality can be implemented using the EVM. We do not need the use of two ports because the data is transferred back and forth from the master (Scanner) to slave (Adapter) and back.  

Thank you,

Aaron Renny

Hi
The example implements EtherNet/IP Adapter based on two port switch. If you want to use only one port connected to Scanner, that will still work with the same example.

Regards
Dhaval Khandla

Hi Dhaval,

Thank you for the reply. So I understand that we can use just one port for the ethernet ip adapter functionality. So can the unused port be left open?. Or is it mandatory for devices to be connected to both the ports of the am64x GP EVM ?.

Thank you ,

Aaron Renny

Hi
It is okay if the unused port is left open.

Regards
Dhaval Khandla

Hi Dhaval,

Thank you for the reply. I was testing out the ethernet/IP example. I am using the am64x sdk version 8.0. I am using the SDK base image. 

Here is how I tested the example code.

1) Compiled the example given in the sdk version 8.0

2) Copied the binary to the evm board.

3) Moved the binary file to /lib/firmware/ and renamed it to  am64-main-r5f0_0-fw

4) Executed the command 

echo stop > /sys/class/remoteproc/remoteproc0/state
and then

echo start > /sys/class/remoteproc/remoteproc0/state


But the code failed to load to the core The error log is given below:

root@am64xx-evm:/lib/firmware# echo start > /sys/class/remoteproc/remoteproc0/state
[ 3251.257961] remoteproc remoteproc0: powering up 78000000.r5f
[ 3251.265260] remoteproc remoteproc0: Booting fw image am64-main-r5f0_0-fw, size 1224520
[ 3251.273951] remoteproc remoteproc0: bad phdr da 0x70080000 mem 0x8ee00
[ 3251.280530] remoteproc remoteproc0: Failed to load program segments: -22
-sh: echo: write error: Invalid argument
[ 3251.287787] remoteproc remoteproc0: Boot failed: -22

When we used the ifconfig , we could see all the three ethernet ports . Please provide a clarification on how we can resolve 
this issue so that we can successfully test out the example. 

These same steps where used to test out the RPMessage example and it was successful:

https://software-dl.ti.com/processor-sdk-linux/esd/docs/08_00_00_21/linux/Foundational_Components_IPC64x.html

Please provide a clarification on the subject.

Thank you,

Aaron Renny

Hi,

Any updates?