Difference between revisions of "Communicate"

From ArmadeusWiki
Jump to: navigation, search
m (move specific part somewhere else)
(http://www.linuxhomenetworking.com is down)
 
(35 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 +
<noinclude>
 
How-To connect your Armadeus board to your development Host.
 
How-To connect your Armadeus board to your development Host.
  
 
==Forewords==
 
==Forewords==
−
The default connection uses a simple RS232 Null-Modem cable (with or without USB<->serial adapter). <br>
+
The default connection uses a simple Serial Link either with a RS232 Null-Modem cable (with or without USB<->serial adapter) or with a miniUSB cable ([[APF51]] / [[APF28]] / [[APF6]]).
−
If you want to transfer data in a faster way, the Ethernet link is recommended.<br>
+
 
 +
As you will have to transfer some MBytes of data, the Ethernet link is nice to have, if not mandatory.<br>
 +
In order to use these two ways of transfer with the APF target, a terminal emulator (for Serial link) and a TFTP server (for Ethernet link) have to be configured.
 +
</noinclude>
 
At this stage, you should have something looking like that (IP addresses may change):<br><br>
 
At this stage, you should have something looking like that (IP addresses may change):<br><br>
 
[[Image:BoardConnection.png]]
 
[[Image:BoardConnection.png]]
  
−
==Connection Setup==
+
{{:RS232 Terminal configuration}}
−
A Terminal emulator (for RS232 link) and a TFTP server (for Ethernet link) have to be configured, depending on your Host operating system:
+
 
−
* '''Linux''': [[Connection with U-Boot on Linux|configuring RS-232 and TFTP on a Linux Host to communicate with your board]]
+
==TFTP server==
−
* '''Window$''': [[Windows uBoot Connection | configuring RS-232 and TFTP on a Window$ Host to communicate with your board]]
+
In order to send your image files (U-Boot, Linux, rootfs or FPGA's firmware) at higher speed (than serial port) to your Armadeus board, you can use the Ethernet link and [http://en.wikipedia.org/wiki/Trivial_File_Transfer_Protocol a TFTP server].
 +
Once the server configured, the files located in the server shared directory (''/tftpboot'' by default) will be accessible from the U-Boot/Linux TFTP clients.
 +
 
 +
===TFTP server installation===
 +
====Install packages====
 +
{| cellpadding="20" cellspacing="0"
 +
|* On *Ubuntu / Debian:
 +
<pre class="host">
 +
$ sudo apt-get install tftpd xinetd
 +
</pre>
 +
or use your preferred graphical package manager
 +
||
 +
|* On Fedora:
 +
<pre class="host">
 +
$ rpm -q tftpd xinetd
 +
</pre>
 +
||
 +
|* On OpenSUSE 11.3:
 +
<pre class="host">
 +
sudo zypper install tftp yast2-tftp-server
 +
sudo yast2 tftp-server
 +
</pre>
 +
Choose Enable to start the TFTP server. It might be required to open the TFTP port in your firewall.
 +
For more details see: [http://en.opensuse.org/SDB:YaST_TFTP_Server YaST TFTP Server on OpenSUSE site]
 +
|}
 +
 
 +
====Create server's directory====
 +
* Then create the directory (''/tftpboot/'') that will contain all the files that the server will export:
 +
<pre class="host">
 +
$ sudo mkdir /tftpboot
 +
$ sudo chmod 777 /tftpboot
 +
</pre>
 +
 
 +
===Server configuration=== 
 +
* '''As root user''' edit or create the ''/etc/xinetd.d/tftp'' configuration file and modify/add it the following lines:
 +
# default: off
 +
# description: The tftp server serves files using the trivial file transfer
 +
#      protocol.  The tftp protocol is often used to boot diskless
 +
#      workstations, download configuration files to network-aware printers,
 +
#      and to start the installation process for some operating systems.
 +
service tftp
 +
{
 +
        socket_type            = dgram
 +
        protocol                = udp
 +
        wait                    = yes
 +
        user                    = root
 +
        server                  = /usr/sbin/in.tftpd
 +
        server_args            = -s /tftpboot
 +
#      disable                = yes
 +
}
 +
 
 +
* Restart xinetd service:
 +
<pre class="host">
 +
$ sudo killall -HUP xinetd
 +
</pre>
 +
<noinclude>
 +
For more information regarding how-to setup a TFTP server please check one of many Web How-to:
 +
* [https://linuxlink.timesys.com/docs/linux_tftp Another how-to configure a TFTP Server for Linux]
 +
* [http://www.webune.com/forums/how-to-install-tftp-server-in-linux.html till another how-to...]
 +
* [http://doc.ubuntu-fr.org/tftpd ubuntu TFTP server documentation in French]
 +
 
 +
=== Troubleshooting ===
 +
 
 +
====Timeout in U-Boot====
 +
*On recent Debian distribution (sid?), it seems that installing ''ckermit'' package may switch inetd server from ''xinetd'' to ''openbsd-inetd''. If you fall in that case, then you have to configure ''/etc/inetd.conf'' by adding the following line:
 +
<pre class=host>
 +
tftp dgram udp wait nobody /usr/sbin/tcpd /usr/sbin/in.tftpd -s /tftpboot
 +
</pre>
 +
* Then restart inetd:
 +
<pre class=host>
 +
/etc/init.d/openbsd-inetd restart
 +
</pre>
 +
 
 +
====Connection refused====
 +
It looks like xinetd configuration is not sufficient in some recent versions of this tool. IPv6 is enabled by default and seems to be not compatible with the TFTP protocol. A simple inetd configuration should work for people who have this problem (''connection refused'' in system logs with addresses like ::ffff:192.168.0.100).
 +
 
 +
* Edit (as root user) - if necessary - the ''/etc/inetd.conf'' file and add this line:
 +
<pre>
 +
tftp dgram udp wait nobody /usr/sbin/tcpd /usr/sbin/in.tftpd -s /tftpboot
 +
</pre>
 +
 
 +
* Install inetd tools
 +
 
 +
On Ubuntu/Debian
 +
<pre>
 +
$ sudo apt-get install inetutils-tools
 +
</pre>
 +
 
 +
* Setup the hosts rules: edit (as root user) ''/etc/hosts.allow'' and add the following lines:
 +
<pre>
 +
in.tftpd: ALL
 +
tftpd: ALL
 +
</pre>
 +
 
 +
* Restart inetd
 +
<pre>
 +
$ /etc/init.d/openbsd-inetd restart
 +
</pre>
 +
 
 +
It's done... and should work for most people.
 +
 
 +
==Links==
 +
* [http://www.columbia.edu/kermit/ Kermit Homepage]
 +
* [http://www.jls-info.com/julien/linux/ GTKTerm Homepage]
 +
* [http://www.linuxhomenetworking.com/wiki/index.php/Quick_HOWTO_:_Ch16_:_Telnet,_TFTP,_and_xinetd#TFTP TFTP server quick how-to]
 +
* [https://linuxlink.timesys.com/docs/linux_tftp Another how-to configure a TFTP Server for Linux]
 +
* [http://www.webune.com/forums/how-to-install-tftp-server-in-linux.html till another how-to...]
 +
* [http://doc.ubuntu-fr.org/tftpd ubuntu TFTP server documentation in French]
 +
* [[Connection_with_U-Boot_under_Windows | configuring RS-232 and TFTP on Windows to communicate with your board]]
 +
</noinclude>

Latest revision as of 11:17, 15 April 2021

How-To connect your Armadeus board to your development Host.

Forewords

The default connection uses a simple Serial Link either with a RS232 Null-Modem cable (with or without USB<->serial adapter) or with a miniUSB cable (APF51 / APF28 / APF6).

As you will have to transfer some MBytes of data, the Ethernet link is nice to have, if not mandatory.
In order to use these two ways of transfer with the APF target, a terminal emulator (for Serial link) and a TFTP server (for Ethernet link) have to be configured.

At this stage, you should have something looking like that (IP addresses may change):

BoardConnection.png

Serial Terminal configuration

You will need a Serial terminal emulator to communicate with U-Boot/Linux console. You can choose between:

We suggest you to use Kermit as Terminal emulator. Minicom was sadly reported to have problems when communicating with U-Boot (ZModem data transfer). If you just need a simple serial console and not to transfer data through the serial link, then GTKTerm is the perfect choice ! (gtkterm package in Ubuntu)

Note Note: Your terminal should now be configured with: 115200 bauds 8N1 parameters


TFTP server

In order to send your image files (U-Boot, Linux, rootfs or FPGA's firmware) at higher speed (than serial port) to your Armadeus board, you can use the Ethernet link and a TFTP server. Once the server configured, the files located in the server shared directory (/tftpboot by default) will be accessible from the U-Boot/Linux TFTP clients.

TFTP server installation

Install packages

* On *Ubuntu / Debian: 
$ sudo apt-get install tftpd xinetd

or use your preferred graphical package manager

* On Fedora: 
$ rpm -q tftpd xinetd
* On OpenSUSE 11.3: 
sudo zypper install tftp yast2-tftp-server
sudo yast2 tftp-server

Choose Enable to start the TFTP server. It might be required to open the TFTP port in your firewall. For more details see: YaST TFTP Server on OpenSUSE site

Create server's directory

  • Then create the directory (/tftpboot/) that will contain all the files that the server will export:
$ sudo mkdir /tftpboot
$ sudo chmod 777 /tftpboot

Server configuration

  • As root user edit or create the /etc/xinetd.d/tftp configuration file and modify/add it the following lines:
# default: off
# description: The tftp server serves files using the trivial file transfer
#       protocol.  The tftp protocol is often used to boot diskless
#       workstations, download configuration files to network-aware printers,
#       and to start the installation process for some operating systems.
service tftp
{
       socket_type             = dgram
       protocol                = udp
       wait                    = yes
       user                    = root
       server                  = /usr/sbin/in.tftpd
       server_args             = -s /tftpboot
#       disable                 = yes
}
  • Restart xinetd service:
$ sudo killall -HUP xinetd

For more information regarding how-to setup a TFTP server please check one of many Web How-to:

Troubleshooting

Timeout in U-Boot

  • On recent Debian distribution (sid?), it seems that installing ckermit package may switch inetd server from xinetd to openbsd-inetd. If you fall in that case, then you have to configure /etc/inetd.conf by adding the following line:
tftp		dgram	udp	wait	nobody	/usr/sbin/tcpd	/usr/sbin/in.tftpd -s /tftpboot
  • Then restart inetd:
/etc/init.d/openbsd-inetd restart

Connection refused

It looks like xinetd configuration is not sufficient in some recent versions of this tool. IPv6 is enabled by default and seems to be not compatible with the TFTP protocol. A simple inetd configuration should work for people who have this problem (connection refused in system logs with addresses like ::ffff:192.168.0.100).

  • Edit (as root user) - if necessary - the /etc/inetd.conf file and add this line:
tftp		dgram	udp	wait	nobody	/usr/sbin/tcpd	/usr/sbin/in.tftpd -s /tftpboot
  • Install inetd tools

On Ubuntu/Debian 

$ sudo apt-get install inetutils-tools
  • Setup the hosts rules: edit (as root user) /etc/hosts.allow and add the following lines:
in.tftpd: ALL
tftpd: ALL
  • Restart inetd
$ /etc/init.d/openbsd-inetd restart

It's done... and should work for most people.

Links

Retrieved from "http://armadeus.org/wiki/index.php?title=Communicate&oldid=14989"