Token Based Switch over IP (TBS-IP) software
============================================

1) TBS-IP software
===================
TBS-IP uses Intel IXDP2850 network processor controlled by a hostPC 
and consists of the following software modules:
(a) the data-plane "fix2850" that runs on the IXDP2850 parallel architecture;
(b) the control-plane slave "fe" that runs on the control processor of IXDP2850;
(c) the control-plane master "forceg" that runs on a hostPC under linux 
and provides a gateway between a higher-level module (webservice) and the low-level "Fe".
(d) the webservice interface of the whole TBS-IP system for interconnection to a service-plane system.


2) License 
=============
Licensed under the LGPL.

3) Installation/usage how to
===============================
a) The microengine project "fix2850" needs to be compiled using Intel IXA-SDK 4.3 tools.
b) "fe" tool (ForCES slave running on XScale control processor) needs to be cross-compiled in Linux.
c) "forceg" tool (ForCES master running on hostPC) needs to be compiled using java.
d) The binary objects (Ingress.uof and Egress.uof) need be transferred into 
the nfs mounted folders available under the IXDP2850 control processor.
e) IXDP2850 boots embedded linux from a hostPC which provides nfs-mounted folders
f) IXDP2850 accepts ssh control-connections to deploy binary files for microengines
g) after login into each control-processor (e.g., ingress, and egress) then run
./fe tool that will wait for master connectivity
h) start forceg tool in the host: master-slave connection establishes over ForCES protocol;
j) configure the webservice on the host and deploy the forceg-webservice on the hostPC;

4) Documents
===============
"TBS-IP router: Functional Design Document": FS_SD_TBS-IP_0.1.pdf
"TBS-IP router: Software Design Description": SRS_SDD_TBS-IP_0.5.pdf
Deliverable D4.3.2 "ForCES Token Based Switch Design and Implementation"

5) Notes
=========================
Intel IXA-SDK framework available to download from Intel or Netronome (http://www.netronome.com/pages/intel-sdk-downloads)
Cross-compiled Linux for XScale available at: http://ixp2xxx.sourceforge.net
Guide to IXP network processors setup at: http://www.run.montefiore.ulg.ac.be/~martin/enp-faq.html