Difference between revisions of "Communicate"

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):

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: 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.

@@ Line 1: / Line 1: @@
+<noinclude>
 How-To connect your Armadeus board to your development Host.
 ==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]]).
-As you will have to transfer some mega bytes of data, the Ethernet link is mandatory.<br>
-In order to use these two media with the APF target a terminal emulator (for RS232 link) and a TFTP server (for Ethernet link) have to be configured.
+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>
 [[Image:BoardConnection.png]]
-==RS232 Terminal configuration==
+{{:RS232 Terminal configuration}}
-You will need a RS232 terminal emulator to communicate with U-Boot/Linux console. You can choose between:
-* [[Kermit]]
-* Minicom
-* GtkTerm
-We suggest you to use [[Kermit]] as Terminal emulator for RS232 connection. 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 RS232, then '''GTKTerm''' is the perfect choice ! (package gtkterm in Ubuntu)
-{{Note|Your terminal should 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 to your Armadeus board, you can use the Ethernet link and [http://en.wikipedia.org/wiki/Trivial_File_Transfer_Protocol a 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 [http://en.wikipedia.org/wiki/Trivial_File_Transfer_Protocol a TFTP server].
-Once the server started, the files located in the server shared directory (''/tftpboot'' by default) will be accessible from the U-Boot/Linux TFTP clients.
+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===
-* On *Ubuntu / Debian:
+====Install packages====
+{| cellpadding="20" cellspacing="0"
+|* On *Ubuntu / Debian:
 <pre class="host">
-  [  ] $ sudo apt-get install tftpd xinetd
+$ sudo apt-get install tftpd xinetd
 </pre>
-or use Synaptic<br>
+or use your preferred graphical package manager
-* On Fedora:
+||
+|* On Fedora:
 <pre class="host">
-  [  ] $ rpm -q tftpd xinetd
+$ 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]
+|}
-* Then create the directory that will contain all the files that the server will export (you have to be root to do that):
+====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 mkdir /tftpboot
-  [  ] $ sudo chmod 777 /tftpboot
+$ sudo chmod 777 /tftpboot
 </pre>
 ===Server configuration===
-* Edit or create the configuration file ''/etc/xinetd.d/tftp'' and modify/add it the following lines:
+* '''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
@@ Line 56: / Line 64: @@
   #       disable                 = yes
   }
 * Restart xinetd service:
 <pre class="host">
-  [  ] $ sudo killall -HUP xinetd
+$ sudo killall -HUP xinetd
 </pre>
-* Put some files in ''/tftpboot''
+<noinclude>
-* To test it from U-Boot:
+For more information regarding how-to setup a TFTP server please check one of many Web How-to:
-<pre class="apf">
+* [https://linuxlink.timesys.com/docs/linux_tftp Another how-to configure a TFTP Server for Linux]
-BIOS> setenv serverip 192.168.0.2                 (the IP address of your tftp server/PC hosting the files to download)
+* [http://www.webune.com/forums/how-to-install-tftp-server-in-linux.html till another how-to...]
-BIOS> tftp ${fileaddr} apf9328-linux.bin
+* [http://doc.ubuntu-fr.org/tftpd ubuntu TFTP server documentation in French]
-MAC: 00:1e:ac:00:00:01
-operating at 100M full duplex mode
+=== Troubleshooting ===
-TFTP from server 192.168.0.2; our IP address is 192.168.0.10
-Filename 'apf9328-linux.bin'.
+====Timeout in U-Boot====
-Load address: 0x8000000
+*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:
-Loading: #################################################################
+<pre class=host>
-         ######################################################
+tftp		dgram	udp	wait	nobody	/usr/sbin/tcpd	/usr/sbin/in.tftpd -s /tftpboot
-done
+</pre>
-Bytes transferred = 1604984 (187d78 hex)
+* Then restart inetd:
-BIOS>
+<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>
-(more detailed [[Target_Software_Installation#Configure_U-Boot|U-Boot configuration is in Setup Basics here]])
+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://doc.ubuntu-fr.org/tftpd
+* [http://www.linuxhomenetworking.com/wiki/index.php/Quick_HOWTO_:_Ch16_:_Telnet,_TFTP,_and_xinetd#TFTP TFTP server quick how-to]
-* [[Windows uBoot Connection | configuring RS-232 and TFTP on Windows to communicate with your board]]
+* [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>

Difference between revisions of "Communicate"

Latest revision as of 11:17, 15 April 2021

Contents

Forewords

Serial Terminal configuration

TFTP server

TFTP server installation

Install packages

Create server's directory

Server configuration

Troubleshooting

Timeout in U-Boot

Connection refused

Links

Navigation menu

Views

Personal tools

Navigation

Support/community

Development

Search

Tools