====== Linux-FBK 750-860 Tips ==
===== Links ==

[[http://www.wago.de/catalogue/documentDownload.do?docOid=020000040002ca3b00050092|Data sheet 750-860]] -- [[http://www.wago.de/catalogue/documentDownload.do?docOid=0200000a0001f61b00030092|data sheet 750-863]]

===== Installation of the Toolchain ==

Done on Slackware 12.2. Information Source: [[http://www.wago.com/cms/downloads/m086000e.pdf|Manual]]. The iso image is available at the [[http://www.wago.com//cps/rde/xchg/SID-53EFFEF9-5907BC14/wago/style.xsl/deu-11235.htm|Embedded-Linux page]] of the wago website (registration necessary).

<code bash>
su -
mount -o loop Linux_V3_20070403.iso /mnt/tmp #mount the BSP Cdrom Iso Image
cd /mnt/tmp/linux/toolchain
./install.sh
exit
</code>

This installs the following files and dirs (subdirs not listed; tested with ''find -mmin / -cmin''):
  /usr/bin/mkimage (via mkimage-0.3.0-1.i386.rpm)
  /usr/local/bin/arm-uclinux-elf-*
  /usr/local/arm-uclinux-tools
  /tftpboot
  /tagetfs

Additionally the following line is appended to ''/etc/sudoers''
  %users ALL = NOPASSWD: /bin/mknod

===== Install uClinux Kernel-Sourcecode and Example code ==

Installation as normal user!

<code bash>
cd /mnt/tmp/linux/sources
./install.sh
</code>

This installs the following files and dirs (subdirs not listed; tested with ''find -mmin / -cmin''):

  /$HOME/uclinux-dist (1.3 GB)
  /tftpboot/jffs2.img
  /tftpboot/linux.flashme

===== Compile all ==

<code bash>
cd $HOME/uclinux-dist
make menuconfig # and exit without save!
make
</code>

This also creates new jffs2.img and linux.flashme files in ''/tftpboot''

Note that the manual states to call ''make menuconfig''. But in my case it changed noting in ''uclinux-dist'', so i think it is unnecessary.

===== Set Date/Time on Target ==

  - Set the date/time in **UTC** with ''%%date MMDDhhmm[[CC]YY]%%''.\\ (According to the manual 4.3.2 date sets the realtimeclock, but this is //not// true.)
  - Save the system time to the hardware clock: ''hwclock --systohc''
  - Afer a reboot a call to ''date'' should print the correct //local// time.

===== Update the Target System ==

Sources:
  - Manual
  - [[http://denx.de/wiki/DULG/Manual|DENX U-Boot and Linux Guide (DULG)]] -> 5.9. U-Boot Command Line Interface

This guide is based on the manual -> 5.10 File System and Linux Kernel Update

  - Boot, log in as root and set the date/time (see above)
  - Reboot and enter uboot ((see manual->5.10.2)); ''LFBK #'' appears
  - Type ''printenv'' to check the environment variables and correct the ipaddresses of the FBK and the server if required:<code>setenv ipaddr 192.168.xxx.yyy
setenv serverip 192.168.xxx.zzz
</code>
  - Compare all other variables with the actual manual and correct them if required. Especially check ''update-rootfs'', ''update-kernel'' & ''update-ub''. (E.g. ''printenv update-kernel'')
  - Type ''saveenv'' to save the modifications into the flash.
  - Start TFTP on your development machine with ''/tftpboot'' as TFTP source directory (uncomment and modify the line in ''/etc/inetd.conf'' accordingly; make ''/etc/rc.d/rc.inetd'' runnable and start it with ''/etc/rc.d/rc.inetd restart'')
  - Only necessary if "Compile all" (see above) hasn't been done: Mount the toolchain.iso and copy ''linux.flashme'' and ''jffs2.img'' to ''/tftpboot''
  - Update:<code>run update-kernel
run update-rootfs</code>Dont use a managed Hub; if you encounter problems with your hub or switch, use a crosslink cable!
  - To see the boot messages and to get a login shell on the serial connection after the update to kernel 2.6 the little switch on the right side of the serial connector has to be set to the upper position!

===== Apply Patches ==
==== "soft lockup" Patch ==

The FBK freezes with this message: ''BUG: soft lockup detected on CPU#0!''

Download the patch from the [[http://www.wago.com/cps/rde/xchg/wago/style.xsl/deu-16260.htm|Wago service]] and apply the patch according to the help file. Afterwards you again have to [[#compile all]], [[#update the target system]] and configure the [[#webserver]].

==== "RAM disk handling" Patch ==

FIXME May affect Unix domain sockets!

===== Create a new App ==

Example App: "sbtimer"

==== Recipe ==

  * ''mkdir ~/uclinux-dist/user/sbtimer''
  * ''touch ~/uclinux-dist/user/sbtimer/sbtimer.c''
  * write a ''main()'' in ''sbtimer.c'' 
  * Add ''sbtimer'' to the ''dir_y'' variable in  ~/uclinux-dist/user/Makefile
  * Create ''~/uclinux-dist/user/sbtimer/Makefile''.
  * Cd to ''~/uclinux-dist'' and call ''make user''.
  * Upload ''sbtimer'' with FTP to the target

==== Makfile example ==

<code bash>
EXEC = sbtimer

all: install

# This adds an implicit rule for generating $(EXEC).o from $(EXEC).c:
$(EXEC): $(EXEC).o
	$(CC) $(LDFLAGS) -o $@ $(EXEC).o $(LDLIBS)
	cp $(EXEC) /targetfs/

romfs:
	$(ROMFSINST) /bin/$(EXEC)

clean:
	-rm -f $(EXEC) *.elf *.gdb *.o

install: $(EXEC)
	lftp -c "open root:wago@wago; cd bin; put $(EXEC); chmod a+x $(EXEC)"
</code>

==== What gets included? ==

FIXME

''$(CFLAGS)'' :?:((Where is CFLAGS?)) contains as the first ''-I''-switch the path ''$HOME/uClinux/lib/uClibc/include'', which points to ''$HOME/uClinux/uClibc/include''. Here are all common header files. 

Auch ''asm/types.h'' wird hier gefunden, jedoch löst das der asm-Symlink tatsächlich nach ''~/uClinux/linux-2.4.x/include/asm/types.h'' auf.

===== Webserver ==
==== Mime Types ==

The default Boa installation on the 750-860 serves CSS files with the mime type ''text/html'' instead of ''text/css''. This my lead to problems especially when HTML document type "strict" is used. Go around this by adding the line
  AddType text/css css
to ''/etc/boa/boa.conf''

:!: Note: The path to the mime.types file in ''boa.conf'' is wrong: ''/etc/mime.types'' instead of ''/etc/boa/mime.types''. But even wiht the correct path, the mime.types file seems to be ignored.

==== Logging ==

:!: Error- and access logging does not work. If the according directive in ''boa.conf'' ist activated, eg ''ErrorLog'', the server refuses to start.

===== Install cron ==

Two cron apps are coming with wago uclinux-dist: cron and vixie-cron. cron ist smaller so I use this one.

Add ''cron'' to the ''dir_y'' variable in ''~/uclinux-dist/user/Makfile'', compile and install it on the target.

Example: The following 2 files are necessary to make the digital output 4.0 change its state every minute:

<code bash>
cat /etc/config/crontab
#
*  *  *  *  *  root  /bin/beckis
</code>

<code bash>
cat /bin/beckis
#!/bin/msh
kbusdemo -n 4.0
sleep 2
kbusdemo -o 4.0
</code>

FIXME Start cron at PO. Where to add the cron start command? In ''/etc/startwago''? Lock at Manual!

===== Io-Api =====

  * /proc/driver/kbus/pab gibt Auskunft über die gesteckten IO-Module und deren Byte-Adressen
  * kbusdemo liegt in entgegen dem Manual in user/wagokbusdemo

===== Misc =====

  * [[http://www.wago.com/wagoweb/documentation/index_d.htm|Allgemeine Wago-Produkte-Doku]] / [[http://www.wago.com/wagoweb/documentation/navigate/nm0dc__e.htm|Links]] to Data Sheet & Manual
  * Wago stellt eine Support-Cd, diese wird im Folgendem CD_Linux_Controller genannt
  * Telnet und Ftp-Zugang mit ''root/wago''
  * Ip-Adresse ändern mit ''wagoset''
  * Bootstrap: /etc/inittab startet ua. /etc/startwago startet ua. /bin/mb_tcp (modbus)

===== Todo =====

  * NFS benutzen

===== Open Ends / To Do =====

  * Ist eine Austauschplattform (Wiki, Forum, FAQ's) zum 750-860 im Internet vorhanden?
  * Compiler: Woher kommen die Datentypen ''%%__u16, __u8, ...%%''
  * c++-code mit /usr/local/bin/arm-elf-g++ verwendbar? Mit welchen Paramtern aufzurufen?