Subscribe to Our Youtube Channel
Summary of Contents for metraTec TUC
- Page 1 User Guide for metraTec TCP/IP to UART Converter (TUC) Date: March 2017 Document-Version: 1.6 For Firmware 1.10 and higher User Guide metraTec TUC Page 1 of 30...
-
Page 2: Table Of Contents
2 Configuration via Web-Interface....................5 2.1 Login............................2.2 Network Settings........................2.3 Port Settings.......................... 2.4 Misc. Settings........................2.5 Applying Settings........................3 TUC Config Manager Software....................10 3.1 Overview Tab (Network Settings)..................10 3.2 Other Settings........................3.3 Firmware Update Tab......................12 4 Control Shell via TCP or UART 1....................14... - Page 3 6 Appendix: Third-Party Copyright Notices...................26 6.1 uIP TCP/IP Stack 1.0......................6.2 lwIP TCP/IP Stack 1.4.1......................26 6.3 TCP ISN Algorithm....................... 6.4 Secure Hash Algorithm (SHA1)....................27 6.5 Blueprint CSS Framework 0.9....................27 7 Version History..........................User Guide metraTec TUC Page 3 of 30...
-
Page 4: General Information
1 General Information Development of the TCP/IP to UART Converters (TUC) was focused on simple operability of the module, especially concerning its configuration. To make the setting of parameters for Ethernet communication as easy as possible, there are three possibilities for the configuration of the TUC... -
Page 5: Configuration Via Web-Interface
Default address upon shipping is 192.168.2.239. Entering the address into a browser of your choice opens the TUC's web interface. If “Home” is selected in the main menu the currently active configuration settings will be displayed. -
Page 6: Network Settings
Furthermore, the name of the device for identification, e.g. via the Config Manager software, can be changed here. Also, it is possible to disable the automatic UPnP advertisements on this page. This helps to lower the network traffic caused by the TUC module – UPnP should still work even without advertisements. -
Page 7: Misc. Settings
Via the sub menu “Misc. Settings” the module can be reset to default. Upon clicking the button, the default settings will be applied immediately and the device restarts. Default settings are as follows: User Guide metraTec TUC Page 7 of 30... - Page 8 Further, on this page you can change the web page login password to a custom password. NOTE When you change the password it will be sent over the network in plain text. In this User Guide metraTec TUC Page 8 of 30...
-
Page 9: Applying Settings
Instead these changes will be “staged” and have to be applied in a separate step. After changing a setting an “Apply Changes?” box will appear at the bottom of the page. Click “Apply” to apply all configuration changes (this will restart the TUC module). Fig. 6: “Apply Changes?” Box... -
Page 10: Tuc Config Manager Software
3 TUC Config Manager Software A comfortable way to configure a TUC module is via the free TUC Config Manager software. It is also the only tool able to perform firmware upgrades on a TUC module. This Java-based program works on all PCs with Windows (XP or higher), OS X or Linux with a sufficiently recent Java Runtime Environment (JRE). -
Page 11: Other Settings
After typing in the password, you can use the same navigational items as in the web interface to set up the TUC module. The layout looks different though, since the web interface will be optimized for display in the TUC Config Manager. -
Page 12: Firmware Update Tab
The firmware of the TUC module can be updated easily using the tab “Firmware Update”. Firmware images are to be found on the metraTec web page free of charge. To perform a firmware upgrade, first select the downloaded firmware image by clicking “Open File”. Finally, you can click “Start Update”... - Page 13 If this happens, the Config Manager will show these modules as “TUC Bootloader” in the device list. It is possible to assign an IP address manually and repeat the upgrade procedure on these devices.
-
Page 14: Control Shell Via Tcp Or Uart 1
To connect with “metraTerm”, choose “Ethernet” in its “Connection Settings”. Type in the TUC's IP address (it can also be located automatically using the “Get” button) and choose 40000 as the “TCP Port”. Clicking “Start” in metraTerm's main window establishes a connection and you can send commands by typing them in the left part of the window and pressing Enter. -
Page 15: Appendix: Control Commands
The command Read Hardware Revision gives the version of the hardware used. Command: RHR<CR> Answer: Example: 0102<CR> The command Read Hardware Name returns the name of the hardware (padded to 16 characters with spaces). Command: RHN<CR> Answer: Example: TUC <CR> User Guide metraTec TUC Page 15 of 30... -
Page 16: Spt [Only Available Via Tcp]
Each pin has an assigned number: Port Pin am Controller Pin Number for WOP/RIP Command: WOP Pin Level<CR> Parameter: Pin: Pin Number (ref. Table) Level: HI for +3.3V or LOW for 0V User Guide metraTec TUC Page 16 of 30... -
Page 17: Rip [Only Available Via Tcp]
IP address: Static IP address (e.g. 192.168.2.100) subnet mask: Static subnet mask (e.g. 255.255.255.0) gateway IP: IP address of the gateway server (e.g. 192.168.2.1) Answer: OK!<CR> ERR<CR> Error: Wrong IP address format UPA<CR> wrong parameter User Guide metraTec TUC Page 17 of 30... -
Page 18: Uart [Only Available Via Tcp]
UPA<CR> Error: Wrong port number, invalid parameter, case sensitive wrong input 5.10 UPNP UPnP is a protocol that allows other computers to find the TUC and query some information about it (e.g. name of the module). The UPNP command is now only used to enable and disable UPnP advertisements. -
Page 19: Sendtt
Dead connections are closed automatically to free up its resources. In server mode, this frees up one of the 3 connection slots while in client mode, this will result in the TUC trying to reestablish the connection. Keepalive probes do not result in additional payload traffic and do not demand any payload traffic –... -
Page 20: Clientriv
The command MODE is for setting the parameters that determine how a UART port is exposed on the network. There are two possibilities: 1. The TUC module operates as a server that peers can connect to. The TUC will listen on the specified TCP port for incoming connections. -
Page 21: Name
Changes will be applied after executing the command APPLY (as described in 5.17). Command: NAME Name<CR> Parameter: Name: New name of module (max. 40 characters) Answer: OK!<CR> 5.17 APPLY When changing settings, they are not applied immediately but are only staged. Settings are not User Guide metraTec TUC Page 21 of 30... -
Page 22: Discard
The “Current IP”, “Current subnet mask” and “Current gateway” fields of the output reflect the currently assigned addresses instead of the static IP settings – so there is no way to dump the User Guide metraTec TUC Page 22 of 30... - Page 23 Example 1 (DHCP is active, Ports defined as UART, Operating as a Raw TCP server): MAC: 00:50:c2:da:20:02<CR> Module name: metraTec TUC Module<CR> Firmware revision: 0110<CR> Current IP: 192.168.2.50<CR> Current subnet mask: 255.255.255.0<CR> Current gateway: 192.168.2.1<CR> Using DHCP<CR> UPnP port: 80<CR> Advertise UPnP: True<CR> Port 0 is a UART<CR> Baud rate: 115200<CR> Stop bits: 1<CR> Data size: 8<CR> Flow control: NONE<CR> Parity: NONE<CR> Flush Byte: Disabled<CR> Send timeout: 0 milliseconds<CR> Keepalive: 5000+5*1000 milliseconds<CR> I/O via RAW<CR> SERVER mode<CR> Local port: 23<CR> Timeout is: 10 seconds<CR> Port 1 is a UART<CR> Baud rate: 115200<CR> Stop bits: 1<CR> Data size: 8<CR> User Guide metraTec TUC Page 23 of 30...
- Page 24 Example 2 (Static IP assignment, Port 0 as GPIO port, Port 1 as Raw TCP client): MAC: 00:50:c2:da:20:02<CR> Module name: metraTec TUC Module<CR> Firmware revision: 0110<CR> Current IP: 192.168.2.50<CR> Current subnet mask: 255.255.255.0<CR> Current gateway: 192.168.2.1<CR> Using static IP<CR> UPnP port: 80<CR> Advertise UPnP: True<CR> Port 0 is a GPIO<CR> Port 1 is a UART<CR> Baud rate: 115200<CR> Stop bits: 1<CR> Data size: 8<CR> Flow control: NONE<CR> Parity: NONE<CR> Flush Byte: Disabled<CR> Send timeout: 0 milliseconds<CR> Keepalive: 5000+5*1000 milliseconds<CR> I/O via RAW<CR> Client mode<CR> Connecting to: 1.1.1.1 : 23<CR> Local Port: 26<CR> Reconnect Interval: 3000 milliseconds<CR> User Guide metraTec TUC Page 24 of 30...
-
Page 25: Close
Timeout is: 10 seconds<CR> 5.22 CLOSE The command CLOSE closes the current control connection. Command: CLOSE<CR> Parameter: none Answer: none User Guide metraTec TUC Page 25 of 30... -
Page 26: Appendix: Third-Party Copyright Notices
6 Appendix: Third-Party Copyright Notices The TCP/IP to UART Converter (TUC) firmware contains code from third-parties subject to special copyright conditions. This appendix lists these conditions. uIP TCP/IP Stack 1.0 Copyright (c) 2001-2003, Adam Dunkels. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. -
Page 27: Tcp Isn Algorithm
Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: User Guide metraTec TUC Page 27 of 30... - Page 28 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. User Guide metraTec TUC Page 28 of 30...
-
Page 29: Version History
Layout adapted 07.01.14 minor corrections 12.09.14 Major revision, adapted to firmware version 17.05.16 1.9 and TUC Config Manager 3, control commands updated Adapted to firmware version 1.10: “Flush 29.03.17 Byte” clarifications, only 3 concurrent TCP connections & single control port connection, RESET command added. - Page 30 Web: http://www.metratec.com Copyright © 2011 - 2017 metraTec GmbH Reprint or reproduction of this documentation for other than internal purposes is only allowed with written permission by metraTec GmbH. All trademarks are the property of their respective owners. All right reserved.
Need help?
Do you have a question about the TUC and is the answer not in the manual?
Questions and answers