Readme

1. Build Environment
====================
1.1 PC Host Configurations
=====================
The build requires a linux machine.
The build has been tested against the following PC configurations:
- CPU: Intel Core i5 CPU M 540 @ 2.53GHz
- OS: ubuntu 12.04.1 LTS 32 bit
- Memory: 1.5 GB
- minimum free disk space: 3 GB
- shell: bash

Build using a PC configuration which deviates from the above is possible, but is not guaranteed to work.

1.2 Tool chains
===============
The file emlix.tar.gz contains the tool chain package.
When going through this README.txt file, a command to be typed into a terminal window begins with the $ sign.  The $ sign is not part of the command.
Unpack the tool chains by following these instructions:
$ Login as root
$ cd /opt
copy emlix.tar.gz to /opt directory
$ tar zxf emlix.tar.gz

Set up path at the terminal windows, or place it in the bash startup file .bashrc:
$ export PATH=/opt/emlix/pnx8181/bin:/opt/emlix/e2-2.2/bin:$PATH

2. Build Instructions
=====================
The file payton_1.3.2.009_gpl.tar.gz contains the source code for building the firmware used by Cisco device SPA112, SPA122 and SPA232D.
Follow these instructions to build the firmware:
Login as root or user
$ cd ~
$ mkdir test
$ cd test
copy the file payton_1.3.2.009_gpl.tar.gz to ~/test directory
$ tar zxf payton_1.3.2.009_gpl.tar.gz
$ cd payton_1.3.2.009_gpl/payton/src
$ make
$ make install-232d

The firmware binaries can be found under the directory "payton/src/image".
Payton_1.3.2_009_MMDDYY_hhmm_pfmwr.bin is the firmware for SPA112 and SPA122.
Payton_232D_1.3.2_009_MMDDYY_hhmm_pfmwr_hsfw.bin is the firmware for SPA232D.
Note that the file name is appended with a date code MMDDYY_hhmm which corresponds to the host PC system time when the build is generated, and will be different every time the build is re-generated.

3. Archive Structure
====================
payton/src is the main directory to build the firmware.
payton_src/cy_proile contains configuration files.
payton_src/host_tools contains utilities to be run on host for successful compilation.
payton/src/linux contains the linux source code for building the target OS.
payton/src/router contains proprietary and open source packages required to run on top of target linux OS.

4. Glibc 2.5
====================
The source code of glibc 2.5 is provided in glibc-2.5.tar.bz2.

4. Build Verification
=====================
If compilation succeeds, the aforementioned binaries under the directory "payton/src/image" will be generated.
As a sanity check, upgrade the device SPA112, SPA122, and SPA232D with the corresponding firmware via the web interface.  One is expected to see the "Upgrade is successful" message.  The firmware version should be changed to 1.3.2 (009), and one should be able to make a phone call if the box has been preconfigured with a VoIP account.