changes

[docs.git] / todo.txt

-------------------------------------------------------------------------------
----------------------------------- Common ------------------------------------
-------------------------------------------------------------------------------
Documents format project{{{
A.   Product Requirement Document(PRD){{{2
        
        Table of Contents
        Introduction{{{3
                This document describes the Software Product Specifications.

                Product Overview
                        Brief description of the product goal and objectives
                        by priorities. Reference to product requirements.

                        Product Scope & Definition
                                Describe the product main functionality
                                included in the product. If necessary,
                                explain what the product will not include.

                        Product Perspective
                                Give product perspective with related products
                                if it is not independent. If the product is a
                                component of a larger system, give a block
                                diagram showing the interconnections of the
                                product with the larger system.

                Reference
                        List all documents & other sources of information
                        referenced in the document.
                        ------------------------------------------------------
                        | Title         |       Date(ver.)      |   Author   |
                        ------------------------------------------------------
                        |               |                       |            |

                Definitions & Acronyms
                        Define or provide reference to definitions to all
                        terms in the document and to acronyms used throughout
                        the document.
        }}}3
        Product Functionality{{{3
                Major Functionalities - List
                        List all the major functionalities of the product
                        (DBMS, Report Generator, etc.)

                Specific Functionality Specifications
                        The specifications can be organized using a common
                        method, such as:
                        - Structured (DFD)
                        - Object Oriented
                        - Behavioral (abstract description, state charts or
                                user-screens form prototype)
                        For each feature specify the following:
                        - Introduction
                        - Input & Validity checks on the inputs
                        - Operations: Normal & Abnormal (with valid/not valid
                                input)
                        - Reaction to abnormal situation, such as:
                                - Overflow
                                - Error handling & recovery
                        - Output & Input->Output Sequences
                        - Priority (by necessity or stability)

                Database Specifications
                        For each information that is put in the database,
                        describe:
                        - Types
                        - Access capability
                        - Data entities & relationships between them
                        - Integrity Constrains
                        - Retention

                Future - List
                        List all the functions to be delayed until later
                        versions of the product.
        }}}3
        External Interfaces{{{3
                User Interface - Concept
                        Define the Look & Feel of the User Interface for the
                        whole product.

                Hardware Interface

                System/Software Interface

        }}}3
        Design Constrains{{{3
        }}}3
        Assumptions & Dependencies{{{3
        }}}3
        Performance{{{3
                1.Static
                2.Dynamic
        }}}3
        Attributes{{{3
                1.Reliability
                2.Availability
                3.Security
                4.Maintainability
                5.Portability
                6.Scalability
                7.Usefulness & Friendliness
        }}}3
        Appendixes{{{3
        }}}3
}}}2
B.   Note document{{{2

Requirements:
Possibility to describe subject and highlight most significant words, which
supposed to be links to notes describing them.

Research:
XML? Links in XML? DTD?

Design:
each entry/record have follow structure:
<entry ver=?>
   <times format=?>
      <created/>           - time&date of creation
      <modified/>          - last modified time&date
      <deleted/>           - time&date of deletion
   </times>
   <operations ver=?>
      <open
         name              - name of function/method
      />
   </operations>
   <data>
   </data>
</entry>

}}}2
}}}
Logging Service {{{

Description: Log server on php5.
Sources: php5 help, C++ Network progrmming.

Design:
Client processes generate log records ranging from debugging msgs to critical
error msgs. The info sent by client indicates log record time, pid, priority
level of msg, logging data.

Marshalling/Demarshalling - operating in different compiler alignments and byte
order rules, so have to marshall msg to some common structure (CORBA) and
demarshall after.

}}}
PHP Articles {{{

Ideas:
        php compilation w/ description of all modules.
        new changes in PHP5
        SNMP
        compression (bzip2)
{{{2 Compression

Couple of words for people new to compression. Actually the word itself
gives you the clue about meanings here. We want to squeeze large number of
data in to small place like file.
Of course, the file can have almost arbitrary size, so where is a problem?
Today we can buy huge harddrives and put there lot of small, big, huge files.
The place where you should consider about file size is where your site placed.
Remember all that "gold", "silver" and "platinum" packages which gives you 
amount of space on a server.
Let say you can place twice the size of you can buy.

Saving the place.

open file modes:
r
r+
w
w+
a
a+

}}}2
Open files {{{2

In order to open file in PHP use fopen() function. Here is how it look like:

        $file_handle = fopen ( "/opr/src/any.txt", "r"); 

There are two parameters which this function takes. The name of required file
and mode in which that file should be open. More common description of the 
function would be

        fopen (string name, string mode)

First parameter mode has number of meanings which are follows:

        a. The file If file not exist should we create new one.

        b. Are we opening that file only for reading, only writing or both reading
           and writing.

        c. If file opened for writing (reading/writing too) where to start.

Let's describe it a litttle bit.
First of all, we have to decide if file not exist to create new or not. Imagine
situation where you expect file to be there and it's not. In this case probably
the best thing to do is to aware by sending warning (or even error) message. 
Second, we have to know the purpose of opening. Only for reading, only for
writing or both (reading and writing). If you don't know which one to choose
just do it in read/write mode where both reading and writing possible.
Third, we have to choose the point in file where to start writing. There are
2 options start of the file or end of it.


Suppose your file opened for writing (or reading and write). 
names of the modes are 
        'r' for only reading,
        'w' for only writing,
        'a' for both('all') reading and writing.
Those modes have additinal meanings. They are coming from question where to
start writing from the beginning of the file or from the end of it. The answer
depend if you want 
You have this file with lot of info and want to open it. The PHP has that
function called fopen() which is opening files.
The next question would be what am i going to do with that file? 
Would i only read from there or only write to or even both? That actually are
the modes of o

}}}2
}}}
Genealogy {{{
    15jun2006

basic types: {{{
time - sec, min, hour
date - day, month, year
name - 1st, nickname, 2nd, patronimyc, last
address - country, state/region, city, street, house, flat
}}}
personal structure: {{{

id
|--name
|--birthday
|  |--date
|  |--address
|  |__source
|--death
|  |--date
|  |--address
|  |--cause
|  |__source
|--education
|  |--start date
|  |--finish date
|  |--name
|  |--address
|  |__source
|--sex
|--occupation
|
|--father
|  |__id
|--mother
|  |__id
|__children
   |--id
   |__...

}}}

Tables:
-------
Main (key, id)
Names (key, id, name)
Dates (key, id, date)
Places (key, id, place)

TODO:
1. design of tables
2. personal parser
3. research charsets

}}}
Code analyzer article {{{1

ctags cbrowser cscope cflow

}}}1
miscfiles {{{
    29mar2009

  Miscfiles is looking for a maintainer.  Programming skill is not
  needed, since the package does not include any programs.  Rather, it's a
  matter of keeping these data files up to date on a regular basis and
  releasing new versions of the package.  In addition, the sources and
  licenses of the various data needs to be investigated and recorded.

Theory {{{
abbrevs.talk, abbrevs.gen:
  Some common abbreviations used in electronic communication

airport
  List of three letter codes for some major airports

ascii
  A map of the ascii character set.

birthtoken
  Traditional stone and flower for each month.

cities.dat
  geographic coordinates of many major cities

connectives
  English `connectives'; prepositions, pronouns, and the like.

countries
  country abbreviations and names and capital cities

currency
  currency abbreviations and names

inter.phone
  International country telephone codes

languages
  two-letter codes for languages, from ISO 639-1.

latin1
  like `ascii'; describing the ISO Latin-1 character set

mailinglists
  Description of all the public Project GNU related mailing lists.

na.phone
  North American (+1) telephone area codes

na.postalcodes
  postal codes for US states and Canadian provinces

operator
  Precedence table for operators in the C language

propernames
  Some common proper names

unicode
  The official Unicode character set table

rfc-index.txt, fyi-index.txt, std-index.txt, bcp-index.txt
  Indexes of internet standardization documents.

dictionary:
}}}

Additions and changes (proposals):

1. Add list of current TLDs. (Alfred M. Szmidt <ams@gnu.org>)
    TLD - top level domain names
2. Consider to move the dictionary to project http://wordlist.sourceforge.net/

Usefull {{{
--- Run follows
ssh-keygen -t rsa1
which creates (/home/gxk/.ssh/identity and /home/gxk/.ssh/identity.pub),
where key fingerprint is
0e:51:eb:bd:85:26:38:8d:12:a0:14:13:a1:17:3b:cc gxk@smiley.scopus.net
e0:16:4f:8d:0b:ad:be:f7:ec:0d:e1:80:eb:65:ab:9d gxk@gxk-lnx

--- CheckOut
cvs -z3 -d :ext:gxk@cvs.savannah.gnu.org:/sources/miscfiles co miscfiles

}}}

Changes:
    30mar2009
    Add top-level.domains
    Change ORIGIN, README, Makefile.in
    Add scripts/tld/parse_TLDs.sh

}}}
VIM features {{{

1= syntax folding for C/C++ files and marker folding for txt.
2. closing folds automaticly after search
3. jump to the next fold
4= change properties of folded line.
5. in fdm=manual: how to keep folds after closing file

}}}
Stuff 2.4 {{{1

ADSL params
stone-barak.net.il@IBarak
X4C5Vng

scp gxk@linux-s:/stuff2/repository/kernel/tools/tms-cx-tools-26112003.tar.bz2 .

export GCC2C_NO_CONVERTER_INVOCATION=0

route add -net 0.0.0.0 gw 192.168.2.1

to apply patch:
cd uClinux-dist
patch -p0 < ../0_patch

Initialization {{{2

linux_start_kernel() from linux-2.4.x/arch/tms320c6/bios/start_linux.c
|-> kki_get_CURRENT()
|-> linux_init_task()
|-> kki_get_init_task()

}}}2

Memory {{{

ISRAM configuration (from <uclinux>/linux-2.4.x/kad/bios/configcfg.cmd)
MEMORY {
   ISRAM       : origin = 0x0,         len = 0x20000
   CACHE_L2    : origin = 0x20000,     len = 0x20000
   SDRAM0      : origin = 0x80000000,  len = 0x100000
   SRAM0       : origin = 0xa0000000,  len = 0x80000
}
ISRAM - 128K
CACHE L2 - 128K
SDRAM0 - 1M
SRAM0 - 512K

Physical                 loader
0x0000 0000              0x400 boot
ox0010 0000- ISRAM       0xc0000 L2

0x6000 0000
0x6008 0000- SRAM ext

0x6400 0000
0x6480 0000- Flash ~8M

0x8000 0000              0x8000 0000 linux  ~2M
0x8100 0000- SDRAM       0x80c0 0000 loader 128K

0xb000 0000              0xb000 0000 romfs 
0xb100 0000- SDRAM

Now Flash devided:
0x6400 0000 - 0x640 0000 boot loader
0x6402 0000 - linux.out
0x6447 f000 - romfs.img

Linux boot can load at 0x80000000-0x80c00000 (12M) and 0x00000-0xc0000 (768K)

BL map file sections (coff file - linnx.out and data file - romfs) to memory.
}}}

Kernel build {{{2
cvs {{{
make linux-dep linux lib-dep lib user-dep user

Checkout uClinux-dist:
* have script in prjs/scripts/get_all.sh
cvs co -r kernel-build-83 uClinux-kernel
cvs co -r infra-11 uClinux-infra
cvs co -r libs-14 uClinux-libs
cvs co -r user-17 uClinux-user

Tag whole release
cd uClinux-dist
cvs update -A
cvs rtag -R libs-11 uClinux-libs

make image
make uClibc_clean
make user_clean
make linux-2.4.x_clean

Build uclinux projects
Libs: after 1st make dep && make can rebuild libs w/ `make lib'
Users: after 1st make dep && make can rebuild users w/ `make user'

Build all:
checkout
sh mklinks.sh
source /usr/local/tools/env.src
if FC3 add `export LD_ASSUME_KERNEL"2.2.19"'
make xconfig
make dep
make
}}}

192.168.2.227/
    kernelrep   bsprep      appsrep
    kerneltrac  bsptrac     appstrac

Get module

Building Times History {{{
Time for build 1h 27min (k95-i13-l18-u20) on gxk-dt-lnx
Time for `make lib' (k97-l14-l21-u20) is 25min on gxk-dt-lnx

k114-i19-l33-u31 (gxk-dt-lnx) = 1h 07m

k127-i21-l41-u39 (gxk-nb) - my tools w/o cxoffice + new kernel
`make' > 15:11 - 16:58 = 01 47

MDM
main 141-31-45-56 (gxk-dt-lnx FC5) = 1h 31m

MDM3
main 141-31-45-56 (gxk-dt-lnx FC3) = 2h 07m
upg  141-31-45-56 (gxk-dt-lnx FC3) = 1h 31m
}}}
}}}2

Process creation flow {{{2
sys_execve_wrapper() linux-2.4.x/arch/armnommu/kernel/entry-common.S
        add r3, sp, #S_OFF
        b   SYMBOL_NAME(sys_execve)
|
sys_execve() linux-2.4.x/arch/tms320c6/kernel/sys_tms320c6.c
|  
|     nios_execve() linux-2.4.x/arch/niosnommu/kernel/process.c
|     |
do_execve() linux-2.4.x/fs/exec.c
|
search_binary_handler()

load_coff_binary() from linux-2.4.x/arch/tms320c6/kernel/binfmt_coff.c
|
start_thread() from linux-2.4.x/arch/tms320c6/kernel/processinit.c
|
kad_start_thread() from linux-2.4.x/kad/kernel/start_thread.c
}}}2

Changes for build uClinux for VM1_w/o_AO
change at line 250 in <uclinux>/linux-2.4.x/driver/block/blkmem.c address to
        0x900c0000

The jffs2 image should be burned before.
LoAD LInux.out
Copy entry point
Load KAD
View->Memory and change address to 0x80000000
Now see KAD symbols where double-click on 0x80000000 and paste previously
copied entry point address to Data field.

How mamy can be addressed w/ 32b?
0   0 00 0000  - this is 32b
|   | || ||||
16  | || ||||
256   || ||||
4K     | ||||
64K      ||||
1M        |||
16M        ||
256M        |
4G

Print address of text and data from uclinux/linux-2.4.x/kad/coff/coff_cls.c
in load_coff()

Softier ftp server {{{
194.90.150.243

212.150.247.141
gxk/softier /mdm3/141/cramfs

}}}

NTP servers for rdate client
192.43.244.18   time.nist.gov
128.138.140.44  utcnist.colorado.edu
216.200.93.8    nist1-dc.glassey.com

make >0__log 2>&1
more 0__log

mremap() always returns EINVAL from
        uclinux/linux-2.4.x/arch/tms320c6/kernel/sys_tms320c6.c
msync() uclinux/linux-2.4.x/mmnommu/filemap.c
        always returns ENOSYS from
sys_brk() uclinux/linux-2.4.x/mmnommu/filemap.c
        allows shrinking:
build libpthreads in Debug:
unmark in libpthreads/linuxthreads/Makefile option -DDEBUG_PT

Where to take build number from uClinux?
uClinux-dist/linux-2.4.x/include/linux/uts.h

mount -o remount,wr -t jffs2 rootfs /

echo PAL/NTSC > /proc/dmx/config

install vpnclient
untar, sudo ./vpn_install
after that to run it:
/etc/init.d/vpnclient_init start

vpn connection output:
{{{3
Cisco Systems VPN Client Version 4.0.5 (Rel)
Copyright (C) 1998-2003 Cisco Systems, Inc. All Rights
Client Type(s): Linux
Running on: Linux 2.6.9-1.681_FC3 #1 Thu Nov 18 15:10:

Enter a group password: 
Initializing the VPN connection.
Contacting the gateway at 212.143.109.38
Negotiating security policies.
Securing communication channel.
Your VPN connection is secure.

VPN tunnel information.
Client address: 192.168.5.1
Server address: 212.143.109.38
Encryption: 168-bit 3-DES
Authentication: HMAC-MD5
IP Compression: None
NAT passthrough is inactive
Local LAN Access is disabled

Disconnecting the VPN connection.
[gxk@80 prjs]$ vpnclient connect softier
Cisco Systems VPN Client Version 4.0.5 (Rel)
Copyright (C) 1998-2003 Cisco Systems, Inc. All Rights Reserved.
Client Type(s): Linux
Running on: Linux 2.6.9-1.681_FC3 #1 Thu Nov 18 15:10:10 EST 2004 i686

Enter a group password: 
Initializing the VPN connection.
Contacting the gateway at 212.143.109.38
Negotiating security policies.
Securing communication channel.
Your VPN connection is secure.

VPN tunnel information.
Client address: 192.168.5.1
Server address: 212.143.109.38
Encryption: 168-bit 3-DES
Authentication: HMAC-MD5
IP Compression: None
NAT passthrough is inactive
Local LAN Access is disabled

}}}3
}}}1
stuff-2.6 {{{
        23aug2005

tools: {{{2
original tools 24aug2005 - 40 min on gxk-nb
w/o cxoffice   24aug2005 - 40 min on gxk-nb
+ w/ tmpfs     24aug2005 - 60 min on gxk-nb
Can add msvcrt.dll?

-- changes --
linux-2.6.7:
arch/tms320c6/Makefile change to
arch/tms320c6/bsl/Makefile change also.

libs-2.6:
uClibc/libpthread/linuxthreads/Makefile
libnet/Makefile
libcrypt_old/Makefile

}}}2

Check out kernel source:
cvs co linux-2.6.7
cvs co libs-2.6
cvs co user-2.6

Make it:
Kernel - env.src + `export ARCH=tms320c6' + `export LD_ASSUME_KERNEL="2.2.19"' + mkkernel.sh
Lib - fix in uClibc/.config value of KERNEL_SOURCE = /home/gxk/prjs/2.6/linux-2.6.7;
      make dep && make
User - make && make romfs && make image

In order not to load data each time have to change file
`linux-2.6.7/arch/tms320c6/kernel/vmlinux.lds.s' where line 68 change to
`.romfs: align=0x200000 {'
This would cancel filling of memory for data (romfs) by newly started kernel.

This can be done manualy in CCS. Menus Edit->Memory->Fill, where fill follows
Address = 0x80080000    Pattern = 0xffffffff
Length  = 0x200000

modules placed at initramfs (look http://lwn.net/Articles/14776/), where load
happened in arch/tms320c6/usr/initramfs/init

25aug2005 currently start/end addresses of root fs create at vmlinux build and
placed at ramsfs_start/ramfs_end at System.map or vmlinux.map
Same addreses used when jffs2 image created at <user>/config/Makefile

Build modules w/ map files>
add `-m $@.map' at scripts/Makefile.modpost line 84 (LD command)

Link modules w/o output redirection: in file scripts/Makefile.modpost
delete `$($(quiet)REDIR_ALL_TO_DEVNULL)' from `cmd_ld_ko_o'

To see loaded modules:
`cat /proc/modules' or `lsmod'

put breakpoint in code:
asm("   .word 0x10000000");

find arch/tms320c6/ -type f -iname '*.[ch]' | xargs grep GPIO_hGPIO
diff -rNu ../linux-2.6.7/drivers/mtd/ drivers/mtd/ |less

cvs -q rdiff -u -D 2005/10/26 user-2.6 > patch

}}}
MontaVista {{{
    26jun2006

Build 2.6.16-rt29 {{{
`scp gxk@linux-s:/stuff/share/gxk/montavista/linux-2.6.16-rt29.tbz'
`scp gxk@linux-s:/stuff/share/gxk/montavista/config-2.6.16-rt29'
`tar jxf linux-2.6.16-rt29.tbz'
`cd linux-2.6.16-rt29'
`make distclean'
`make menuconfig'
choose "Load alternative config file"
enter `/root/srcs/config-2.6.16-rt29'
choose "exit & save"
`make'
`make modules'
`make modules_install'
`cp arch/i386/boot/bzImage /boot/vmlinuz-2.6.16-fb'
`vi /etc/lilo.conf'
`/sbin/lilo'
`reboot'
}}}

Build 2.6.17... {{{
        03sep2006
get patch-2.6.17-rt8 from http://people.redhat.com/mingo/realtime-preempt/
get linux-2.6.17.6 from kernel.org
untar 2.6.17.6
cd linux...
patch -sfp1 < ../patch-2.6.17-rt8
cd drivers/video && rm -rf intelfb
tar jxf intelfb.tbz

}}}

Configuration
uncomment SET_DNS in /etc/dhcpc/config

}}}
Davinci {{{
        22aug2006
Connect board and press enter to stop autoload.
Write follows:
setenv bootdelay 5
setenv autoload no
setenv serverip 192.168.2.84
setenv bootargs 'mem=120M console=ttyS0,115200n8 root=/dev/nfs nfsroot=192.168.2.84:/opt/davinci'
setenv bootcmd 'dhcp;setenv serverip 192.168.2.84;tftpboot 0x80700000 uImage;bootm 0x80700000'
setenv serverip 192.168.2.84
tftpboot 0x80700000 uImage
bootm 0x80700000

In order to connect usb keyboard:
Connect device
mknod /dev/tty0 c 4 0
cat /dev/tty0 - this will print 
}}}
sigma 8622L {{{
    10jul2006
svn co http://192.168.2.227/kernelrep/sigma/trunk/armutils_2.5.127.0

        On FC3 (gxk-tools)
armutils 2.5.127
`make config' and change chipset to 8622
`make download'
`make toolchain'
`. ./path.sh' and `. ./kernelpath.sh'
`make linux-config'
`make linux'
`make rootfs'
`make romfs'
All binaries under bin directory.
        On FC5 (gxk-dt-lnx)
armutils 2.5.127
`make config' and change chipset to 8622
`make download'
`make toolchain'
    
mount -o nolock 192.168.215:/opt /mnt
}}}
sigma 8634 {{{
        19sep2006
Toolchain flow {{{

                Toolchain

cp and untar linux-libc-headers-2.4.29.tar.bz2 to toolchain_build_mipsel/linux
untar uClibc-0.9.27.tar.bz2 to toolchain_build_mipsel/uClibc-0.9.27
patch toolchain_build_mipsel/uClibc-0.9.27 w/ files from toolchain/uClibc/
change toolchain_build_mipsel/uClibc-0.9.27/Rules.mak
cp toolchain/uClibc/uClibc.config to toolchain_build_mipsel/uClibc-0.9.27/
make changes to toolchain_build_mipsel/uClibc-0.9.27/.config
build and install uClibc-0.9.27 to toolchain_build_mipsel/uClibc-dev
untar binutils-2.15.91.0.2.tar.bz2 and patch it from toolchain/binutils/2.15.91.0.2/
configure and build in toolchain_build_mipsel/binutils-2.15.91.0.2-build
untar gcc-3.4.2.tar.bz2 to toolchain_build_mipsel/gcc-3.4.2
patch to from toolchain/gcc/3.4.2/
configure and build toolchain_build_mipsel/gcc-3.4.2-initial to build_mipsel
        using sysroot=toolchain_build_mipsel/uClibc_dev/
cd toolchain_build_mipsel/uClibc-0.9.27/libc/sysdeps/linux/mips/
        and build ld-uClibc-0.9.27.so
cd toolchain_build_mipsel/uClibc-0.9.27/libc/ and build libc.a
cd toolchain_build_mipsel/uClibc-0.9.27/libcrypt and build libcrypt.a
cd toolchain_build_mipsel/uClibc-0.9.27/libresolv and build libresolv.a
cd toolchain_build_mipsel/uClibc-0.9.27/libnsl and build libnsl.a
cd toolchain_build_mipsel/uClibc-0.9.27/libutil and build libutil.a
cd toolchain_build_mipsel/uClibc-0.9.27/libm and build libm.a
cd toolchain_build_mipsel/uClibc-0.9.27/libpthread and build libpthread.a
cd toolchain_build_mipsel/uClibc-0.9.27/librt and build librt.a
cd toolchain_build_mipsel/uClibc-0.9.27/libc/ and build libuClibc-0.9.27.so
Going through dirs and build libdl-0.9.27.so, libcrypt-0.9.27.so, 
        libresolv-0.9.27.so, libnsl-0.9.27.so, libutil-0.9.27.so, libm-0.9.27.so
        libpthread-0.9.27.so, librt-0.9.27.so
Install previously built libs and includes to build_mipsel/staging_dir/
configure and build toolchain_build_mipsel/gcc-3.4.2-final
install gcc to build_mipsel/staging_dir/
untar ccache-2.3.tar.gz to toolchain_build_mipsel/ccache-2.3
build and install to build_mipsel/staging_dir/bin-ccache
build stuff in tools and install to build_mipsel/staging_dir/bin
GDB . . .

                Bootloaders

zboot
yamon

                RootFS

`make menuconfig', which creates .config,.config.cmd,.tmpconfig.h
untar uClibc-0.9.27.tar.bz2 to toolchain_build_mipsel/uClibc-0.9.27 and patch
        it from toolchain/uClibc/
untar linux-libc-headers-2.4.29.tar.bz2 to toolchain_build_mipsel/linux and
        patch it from toolchain/kernel-headers/
change toolchain_build_mipsel/uClibc-0.9.27/Rules.mak
cp toolchain/uClibc/uClibc.config toolchain_build_mipsel/uClibc-0.9.27/ and
        change follows:
        TARGET_mips
        TARGET_ARCH
        KERNEL_SOURCE
        RUNTIME_PREFIX
        DEVEL_PREFIX
        SHARED_LIB_LOADER_PREFIX
        UCLIBC_HAS_LFS
        UCLIBC_HAS_WCHAR
configure toolchain_build_mipsel/uClibc-0.9.27
build stuff under toolchain_build_mipsel/uClibc-0.9.27/utils: ldd, ldconfig,
        readelf and install to build_mipsel/root/
untar ncurses-5.2.tar.gz to build_mipsel/ncurses-5.2 and patch it from 
        package/ncurses/
configure, build and install to build_mipsel/staging_dir/ and build_mipsel/root
untar busybox-1.00.tar.bz2 . . .
install build_mipsel/root
untar bash-3.0.tar.gz . . .
install build_mipsel/root
cp <toolchain>/build_mipsel/staging_dir/lib/ld-uClibc-0.9.27.so to
        build_mipsel/root/lib/
same for follows: libuClibc-0.9.27.so, libdl-0.9.27.so, etc.
untar cramfs-1.1.tar.gz and create root_fs_mipsel.cramfs from
        build_mipsel/root

                Kernel

Source
untar linux-2.6.15.tar.bz2 and patch it from pf/patches/linux-2.6.15/
cp config-2.6.15-smp86xx to linux-2.6.15/.config
Make vmlinux modules modules_install zbimage-linux-xrpc
}}}
---- 142 {{{
cd ~/prjs/sigma8634/142
svn co http://192.168.2.227/kernelrep/sigma-34/trunk/smp86xx fc5
cd fc5
./mkenv26.sh
comment all MRUA vars in smp86.env
cp -r ../dl ./smp86xx_toolchain_2.7.147.0/
cd ./smp86xx_toolchain_2.7.147.0
vi ./toolchain/uClibc/Config.in and change locale to y
vi ./toolchain/gdb/Config.in and change gdb to n
cp ../uClibc.config-locale ./toolchain/uClibc/uClibc.config-locale
make menuconfig
make
. ./smp86.env
cd smp..boot
make zboot
make yamon
cd smp...kernel/linux
make menuconfig
make vmlinux (should error)
cd smp...rootfs
cp ../uClibc.config-tools ./toolchain/uClibc/uClibc.config
make menuconfig
make
cd smp...kernel/linux
make vmlinux
cd mrua...
delete printk() in MRUA_src/rua/emhwlib_kernel/kernel_src/em8xxx_fb.c
make
. ./MRUA.env
rm -rf lib/{librmjpeg.so,librmhttp.so, libsamples.so}
pushd lib
make librmjpeg.so librmhttp.so libsamples.so
make kernel
make apps
cd smp...kernel/linux
make menuconfig
General Setup -> initramfs source file; 
Device drivers -> Graphics support -> * Support FB
File systems -> Network file systems -> * NFS filesystem support and * Root file system on NFS
make vmlinux modules modules_install zbimage-linux-xrpc
cd smp...rootfs
make
nfsroot

sudo cp smp86xx_boot_loader_2.7.142.0/bin/* /tftpboot/sigma8634/142/
sudo cp linux/arch/mips/boot/vmlinux.bin /tftpboot/sigma8634/142/
sudo cp -r smp86xx_rootfs_2.7.142.0/build_mipsel/nfsroot /opt/sigma8634/142/

net init
load -b tftp://192.168.2.84/sigma8634/142/zboot2.bin 0xb0100000
load -b tftp://192.168.2.84/sigma8634/142/zbimage-yamon 0xb0200000
pflash write 0x00000 0xb0100000 328020
pflash write 0x60000 0xb0200000 199680
reboot
net init
setxenv a.linux_cmd console=ttyS0\ lpj=148480\ ip=dhcp\ root=/dev/nfs\ nfsroot=192.168.2.84:/opt/sigma8634/142/nfsroot,v3,nolock
load -b tftp://192.168.2.84/sigma8634/142/vmlinux.bin 0x90020000
go
export LD_LIBRARY_PATH="/mrua/lib:/mnt/gtkdfb/lib"
/mrua/bin/osdbuf_control -c -Ftc:32bpp
insmod em8xxxfb <info from previous>
mount -o nolock 192.168.2.84:/opt/sigma8634/142/gtkdfb /mnt/gtkdfb
mount -o nolock 192.168.2.84:/opt/sigma8634/142/mozilla /mnt/mozilla
}}}
Build {{{
if build on FC6 do `. ~/gcc34.env'
tar jxf /misc/share/sigma8634/147/smp86xx_toolchain_2.7.147.0.tar.bz2
cp -r ../dl ./smp86xx_toolchain_2.7.147.0/
cd ./smp86xx_toolchain_2.7.147.0
vi ./toolchain/uClibc/Config.in and change locale to y
vi ./toolchain/gdb/Config.in and change gdb to n
cp ../uClibc.config-tools ./toolchain/uClibc/uClibc.config-locale
make menuconfig
make
. ./toolchain-path.env
cd ..
tar zxf /misc/share/sigma8634/147/CPU_KEYS_SMP8634_xosMc0-1.tar.gz
cd ./CPU_KEYS_SMP8634_xosMc0-1
. ./CPU_KEYS.env
cd ..
tar jxf /misc/share/sigma8634/147/smp86xx_boot_loader_2.7.147.0.tar.bz2
cd ./smp86xx_boot_loader_2.7.147.0
ln -s ./tools/genxenv/configs/852-E2.config xenv.config
make zboot
make yamon
cd ..
tar jxf /misc/share/sigma8634/147/smp86xx_rootfs_2.7.147.0.tar.bz2
cp -r ../dl ./smp86xx_rootfs_2.7.147.0
cd ./smp86xx_rootfs_2.7.147.0
cp ../uClibc.config-tools ./toolchain/uClibc/uClibc.config
make menuconfig
make
. ./rootfs-path.env
cd ..
tar jxf /misc/share/sigma8634/147/smp86xx_kernel_source_2.7.147.0.tar.bz2
cp ./dl/linux-2.6.15.tar.bz2 ./smp86xx_kernel_source_2.7.147.0/
cd ./smp86xx_kernel_source_2.7.147.0
make kernel-source-2.6.15
cd linux-2.6.15
make menuconfig
General Setup -> initramfs source file; 
Device drivers -> Graphics support -> * Support FB
File systems -> Network file systems -> * NFS filesystem support and * Root file system on NFS
make vmlinux modules modules_install zbimage-linux-xrpc
cp ./arch/mips/boot/vmlinux.bin /tftpboot/sigma8634/147/
cd ../../
tar zxf /misc/share/sigma8634/147/mrua_SMP8634_2.7.147.0_legacy_dev.mips.nodts.tgz
export UCLINUX_KERNEL=/home/gxk/prjs/sigma8634.fc3/147/smp86xx_kernel_source_2.7.147.0/linux-2.6.15
cd ./mrua_SMP8634_2.7.147.0_legacy_dev.mips.nodts
make
. ./MRUA.env
make kernel
make apps
cd ../smp86xx_rootfs_2.7.147.0
make
./nfsroot.sh
}}}
Burning/Loading {{{

load -b tftp://192.168.2.70/sigma8634/142/vmlinux.bin 0x90020000
go
export LD_LIBRARY_PATH="/mrua/lib:/mnt/gtkdfb/lib"
/mrua/bin/osdbuf_control -c -Ftc:32bpp
insmod em8xxxfb <info from previous>
mount -o nolock 192.168.2.70:/opt/sigma8634/142/gtkdfb /mnt/gtkdfb

Rebuild MRUA libs (librmjpeg.so, librmhttp.so):
cd mrua
. ./MRUA.env
pushd MRUA_src/rmlibjpeg/src/
make
cp librmjpeg.so ../../lib
popd

Get yamon prompt `YAMON>', where write:
load uu -z 0xb0100000
On the host do (as root):
gzip -c zboot2.bin | uuencode x > /dev/ttyS0
pflash write 0x0 0xb0100000 <length in hex>

On the host do (as root):
gzip -c zbimage-yamon | uuencode x > /dev/ttyS0
pflash write 0x40000 0xb0100000 <length in hex>,
where length can be taken from download report called "output length"

load uu 0xb0100000
and on host side from linux-2.6.15/arch/mips/boot/
uuencode zbimage-linux-xrpc x > /dev/ttyS0
pflash write 0x80000 0xb0100000 <length>
where length can be taken from download report called "received"

Loading kernel from flash to RAM:
xrpc 0xac080090
load zbf 0xb3000000
go
username `root' and when gets shell prompt
ifconfig eth0 192.168.2.179
route add default gw 192.168.2.1

The device file placed at <rootfs>/target/generic/device_table.txt
MRUA_src/rua/emhwlib_kernel/kernel_src/...

Run onli once:
`setxenv a.linux_cmd console=ttyS0\ lpj=148480\ ip=dhcp\ root=/dev/nfs\ nfsroot=192.168.2.84:/opt/sigma8634/142/nfsroot,nolock'
[ mknod /dev/mum0 c 126 0 ]
[ mknod /dev/em8xxx0 c 127 0 ]
[ mknod /dev/em8xxx1 c 127 1 ]

net init
load -b tftp://192.168.2.70/sigma8634/142/vmlinux.bin 0x90020000
go
insmod llad
insmod em8xxx
export LD_LIBRARY_PATH="/mrua/lib:/mnt/gtkdfb/lib"
/mrua/bin/osdbuf_control -c -Ftc:32bpp
insmod em8xxxfb <info from previous>
mount -o nolock 192.168.2.70:/opt/sigma8634/142/gtkdfb /mnt/gtkdfb

On card do follows
modprobe nfs
mount -o nolock 192.168.2.84:/opt/sigma34 /mnt

Compile uClibc w/ locale support
set BR2_ENABLE_LOCALE to yes under <toolchain src>/toolchain/uClibc/Config.in
and run `make' from top dir.
}}}
}}}
scopus {{{
    24may2007

Moxa config:
usb0   - IRP 192.168.0.10
ttyr00 - IRP 192.168.0.20
ttyr01 - IRP 192.168.0.30

Encoder {{{

There is telnet and web interfaces.

--- Upgrade.
connect ftp (anonymous)
put file
reboot

}}}

Satellite config Hotbird {{{
DVBS {{{
Canale Italia 12245 H (L 1645) x77-119
RTVi - HotBird 8 - 12322 H (1722) - Conax, MediaGuard, Viaccess 2.5/2.6
Freq -  1185 + 10600 = 11785
        11862 - 10600 = 1262 Sky Italia (progID 4327)
        11804 - 10600 = 1204 RAI
        11117 > 517
mpeg4-hd 12130 > 1530

10723 (973) H 29900 3/4 - BuzzTV x120d=4621

}}}
DVBS2 {{{
11996 V (L 1396) - Videoguard - (Sky Italia)
}}}
}}}

IRD data {{{

username: protect
password: 301206

protect/log/set_log_level

ftp <ip>
username root, no passwd
put ird2900_application.bin /rom/sw_image.bin
It will start upgrade

}}}

IRP files to change for adding db api and related cli {{{

db/sql/irp.sql                  - db version
common/inc/irp_product.h        - db version
db/src/db_request_data.cpp
common/inc/config_attr_data.h
db/inc/db_fe.h
db/src/db_fe.cpp

/home/gxk/scopus/irp/dev/sw/cfgmgr/src/req_map.cpp
/home/gxk/scopus/irp/dev/sw/cli/inc/params_order.h
/home/gxk/scopus/irp/dev/sw/cli/xml/gjobs.xml
/home/gxk/scopus/irp/dev/sw/common/inc/config_attr_data.h
}}}

--- Burn U-boot {{{
Copy full fpga project
Open XPS
Copy files xmd_ppc405_0.opt and xmd_ppc405_1.opt to <project>/etc/
Copy binary u-boot to <project> dir
Open project in XPS
Debug->Launch XMD
New terminal opened w/ prompt XMD%. Type follows:
XMS% rst
XMD% dow u-boot
Output:
        section, .text: 0x03300000-0x0332157f
        section, .resetvec: 0x033300e8-0x033300eb
        section, .rodata: 0x03321580-0x03326327
        section, .reloc: 0x03326400-0x033271db
        section, .data: 0x033271dc-0x03327a03
        section, .data.rel.local: 0x03327a04-0x03327ea3
        section, .data.rel: 0x03327ea4-0x03327ecf
        section, .u_boot_cmd: 0x03327ed0-0x03328397
        section, .bss: 0x03328400-0x033300e7
    Downloaded Program u-boot
    Setting PC with Program Start Address 0x03300100
XMD% run
}}}
Xilinx tools on linux {{{
--- Installing ISE 9.1
cd /media/Xilinx
sudo ./setup
ISE registration id 8967-1972-8833-8277
EDK registration id 0487-6041-7416-4274
Chipscope (9.1 Linux) 

--- Installing ISE 10.1
/media/Xilinx_ISE_DS/setup

IRP MUX {{{
    08jul2008
--- Set frontend input
mux ilp 1 5
mux inp 1 ena
mux s
--- Set ASI output
mux xs11 1 1 1 1

}}}

--- Running 9.x
export LD_PRELOAD=/opt/x86/lib/libusb-driver.so
export LD_LIBRARY_PATH=/opt/EDK/bin/lin:/opt/Xilinx91i/bin/lin:/opt/x86/lib
xil9
impact &
xps &

--- Running 10.x
export XIL_IMPACT_USE_LIBUSB=1
xil10

--- Running XMD from shell
connect ppc hw -cable type xilinx_platformusb -configdevice devicenr 2 idcode 01eb4093 irlength 14 partname XC4VFX60

}}}

IRP flash mapping {{{
    18may2008 10sep2008 03nov2008
offset               size               name        start addr      end addr
------------|--------------------|---------------|---------------|-------------
0x0000 0000   0x00040000 2*128K    mb spartan      0xb000 0000     0xb003 ffff
0x0004 0000   0x00320000 3M+128K   mb virtex       0xb004 0000     0xb036 0000
0x0080 0000   0x00100000 1M        bootloader      0xb080 0000     0xb090 0000
0x0092 0000   0x01400000 20M       kernel          0xb092 0000     0xb1d2 0000
0x01d4 0000   0x02800000 40M       user            0xb1d4 0000     0xb454 0000
0x0456 0000   0x00a00000 10M       ems             0xb4f6 0000     0xb6d6 0000
0x04f8 0000   0x01400000 20M       jre             0xb4f8 0000     0xb5fc 0000

--- Upgrade main board spartan
bitBurn 3800000 spartan.bin
erase b0000000 b003ffff
cp 3800000 b0000000 2480c

---===<<< GOLD VERSION >>>===---

offset               size               name        start addr      end addr
------------|---------------------|---------------|---------------|-------------
0x0000 0000   0x00040000 2*128K    mb spartan      0xb000 0000     0xb004 0000
0x0004 0000   0x002a0000 2M+6*128K mb gold virtex  0xb004 0000     0xb02e 0000
0x002e 0000   0x002a0000 2M+6*128K mb norm virtex  0xb02e 0000     0xb058 0000
0x0080 0000   0x00100000 1M        bootloader      0xb080 0000     0xb090 0000
0x0092 0000   0x01400000 20M       kernel          0xb092 0000     0xb1d2 0000
0x01d4 0000   0x02800000 40M       user            0xb1d4 0000     0xb454 0000
0x0456 0000   0x00a00000 10M       ems             0xb456 0000     0xb6d6 0000
0x04f8 0000   0x01400000 20M       jre             0xb4f8 0000     0xb5fc 0000

}}}

IRP i2c address {{{
The IRP board have 3 different i2c buses, start from hardware rev B.

0-002e sensore ()
0-0051 eeprom ()
0-0068 rtc (ds1337)

}}}

Enlarge available memory Of IRP {{{
<Mux>

<Uboot>
u-boot/dev/board/xilinx_irp/ml405/xparameters.h from "DDR_SIZE 0x8000000"
to "DDR_SIZE 0xE000000" 128+64+32.
or "DDR_SIZE 0xa000000" 160 MB. 
}}}

IRP configurations {{{
    29jul2008
--- 8VSB to ASI
mux xs2 ...

--- 8VSB to Ofek
/config/decoder/service/

--- ASI1 to ASI1
mux tsxc 1 1 2

--- disable new PMT for ASI1.out
/config/interface/output/multiplex/psi_si/enable_transmission 1 pmt no

}}}

Running CLI scripts {{{
Prepare file cli.cmd where
/status/unit/versions/sw_ver
/exit
and run follows
cat cli.cmd | ./cli.elf
}}}

FTP sites
ftp.scopus.net u: irp p: scopus folder irp
ftp.scopusamericas.com u: gues1 p: guest07

Reserved IPs
10.2.1.111
10.2.1.197

proxy configurations
athena:8080 except 10.*.*.*,192.168.210.*,hebe.scopus.net,62.90.123.44

sleepy  MB: Intel DG965SS BIOS: MQ96510J.86A updated 16jul2007
bashfull    2:15:17:38:CB:F5
smiley  MB: Intel DG965WH 00:19:D1:7F:E1:C8 updated maj2008
grumpy 00:B0:D0:5F:D9:55

CVS 2401, 4000 (TCP/UDP)
SVN 3690
1100

smbmount //hercules/public$ /mnt/tmp -o username=geryk,workgroup=scopus
//hercules/rnd
//hercules/users/geryk

Eli d-21302
Akiva d-21597
Micha d-21299
Dima dima-linux
Emily grumpy

//hercules/users$ /mnt/hercules/users smbfs username=michaw,password=m12345!,workgroup=scopus,uid=root,noauto,user,rw 0 0
//hercules/public$ /mnt/hercules/public smbfs username=michaw,password=m12345!,workgroup=scopus,uid=root,noauto,user,rw 0 0
//Artemis/temp$ /mnt/hercules/temp smbfs username=michaw,password=m12345!,workgroup=scopus,uid=root,noauto,user,rw 0 0
//hercules/rnd$ /mnt/hercules/rnd smbfs username=michaw,password=m12345!,workgroup=scopus,uid=root,noauto,user,rw 0 0
//hercules/oldshare$ /mnt/hercules/oldshare smbfs username=michaw,password=m12345!,workgroup=scopus,uid=root,noauto,user,rw 0 0

-- Build printers (as root) {{{
copy rndonIxion.ppd to /usr/share/cups/model/
lpadmin -p rndonIxion -m rndonIxion.ppd -v smb://SCOPUS/IXION/RnD -D "IRP_Group"
accept rndonIxion
lpadmin -d rndonIxion
Need to add username/password from gui (system-config-printer)
}}}
--- Setting Uboot on ML-405 {{{

setenv bootargs 'mem=120M console=ttyS0,115200n8 root=/dev/nfs nfsroot=192.168.2.84:/opt/davinci'
setenv bootcmd 'dhcp;setenv serverip 192.168.2.84;tftpboot 0x80700000 uImage;bootm 0x80700000'

setenv loads_echo=1
setenv baudrate 115200
setenv bootdelay 3
setenv ethaddr 00:0a:35:00:22:01
setenv netboot 'tftp 3800000 pMulti; bootm 3800000'
setenv ipaddr 10.2.1.111
setenv serverip 10.2.1.41
setenv loadip 10.2.1.111
setenv gatewayip 10.2.0.1
setenv netmask 255.255.252.0
setenv hostname gxk_irp
setenv netdev eth0
setenv use_dhcp off
setenv hw_rev 503227A 
setenv user_opt 0
setenv serial_num 12345
setenv bootargs_base console=ttyS0,115200 root=/dev/ram rw
setenv addip 'setenv bootargs ${bootargs_base} ip=${loadip}:${serverip}:${gatewayip}:${netmask}:${hostname}:${netdev}:${use_dhcp}'
setenv bootcmd 'run addip; run netboot'
saveenv

setenv bootcmd 'run addip; bootm b0900000'
}}}
--- NFS mount from ML405 board
mount -o nolock,tcp 10.2.1.41:/opt/ppc405 /mnt

IRP SNMP agent config (17oct2007) {{{
  SNMP Versions Supported:    1 2c 3
  Net-SNMP Version:           5.4.1
  Building for:               linux
  Network transport support:  Callback Unix TCP UDP
  SNMPv3 Security Modules:     usm
  Agent MIB code:             ucd-snmp/dlmod mibII/system_mib mibII/sysORTable default_modules =>  util_funcs util_funcs mibII/system_mib snmpv3mibs mibII/snmp_mib mibII/system_mib mibII/sysORTable mibII/vacm_vars utilities/execute
  Embedded Perl support:      disabled
  SNMP Perl modules:          disabled
  SNMP Python modules:        disabled
  Authentication support:     MD5 SHA1
  Encryption support:         DES AES
    }}}
}}}
ivirtus {{{
    21sep2009

IBM server (NASDAQ) {{{
        x3400 7976
    hostname: nasdaq
    ip: 192.168.1.61
    MAC: 00-21-5e-4f-84-fa
    s/n: 7976KJG-KD8489N

support phone: *6557
}}}

ESP email {{{
    KIWINET
Alex 052-8066614
gery.kahn@espinc.com
password: 12Gex!@oo
}}}

wireless solution for Sting3G, SingHD n StingCOFDM {{{
    from \\server\Running Projects\Sting 3G\HW\DataSheets\WiFi_BT\WG7310-00-HDG-R01_2009.pdf
    and Wireless core from SWAS0013_WiLink_6_0_WL1273_Product_Prevew_Rev0.5.pdf

The project using chip from Jorjin company called WG7310. It is module or 
package of 2 cores from TI: 

Accepting code from Ohad 30nov12009 {{{

The tarball named DM365-1271-v1.tar.bz2 contents follow:
arago-rootfs-3.36 - rootfs from Arago project
aux - 
kernel - kernel, paches and drivers
packages - open source prjs, used for Bluetooth solution
wlan-driver - wireless solution for the project chip

}}}

}}}

Sting 3G, HD, COFDM {{{

--- dm365 NAND properties
page - 2048B
block - 64 pages - 128KB
Cheap has 8192 blocks 8192*128KB=1GiB

--- Burn U-boot
entry point

--- Burn kernel
tftp 80700000 uImage
nand erase x400000 0x200000
nand write x80700000 x400000 x200000

--- Burn rootfs
tftp 0x82000000 ramdisk.gz
nand erase 0xc00000 0x300000
nand write 0x82000000 0xc00000 0x300000

--- Using jtag USB510L w/ dm365
Copy gel file to C:\CCStudio_v3.3\cc\gel\evmdm365_gel_Board_Rev_C+D.gel and
the config file to C:\CCStudio_v3.3\drivers\import\Sightsys_BH-USB510L_DM365.ccs
Open CCS setup. Import config file.
Appears new device in System Configuration window.
Open properties of ARM9_0 and change gel file to previously added.
Save & close. This will start CCS (Parallel Debug Manager)
Open right-click menu on ARM9_0 and Connect to device.
Open right-click menu on ARM9_0 and Open.

--- Burn NAND flash
ARM9_0 - Connect device
Debug/Connect
Debug/Open from dm36x/CCS/NAND Writer/Debug/*.out (from PSP package - NANDwriter_DM36x.out)
F5
Give UBL_DM36x_NAND.bin w/ entire path
Give u-boot-1.3.4-dm365_evm.bin w/ entire path
Give both U-booth entry point n load address value 0x81080000

--- Using NANDeraser
Load NANDeraser.out
It will ask to input the locagtion where NAND is connected: 0x02000000
This will erase the lower part of the flash.To erase upper run the program again and
input 0x02004000

--- UBL src
Under <PSP>/board_utilities/flash_utils/DM36x/CCS/

--- Flash (nand) mt29f16g08faa
This is 16gb capacity, block size 128KB, page size 2KB

--- dm365 Flash map {{{
bootloader 30*128KB = x3c0000
params      2*128KB = x040000 _____ x400000
kernel      4MB     = x400000
fs1        512MB    = x20000000
fs2
}}}

Uboot options {{{

Yura {{{
NFS boot:

setenv bootargs0 'console=ttyS0,115200n8 noinitrd rw ip=dhcp root=/dev/nfs nfsroot=192.168.1.23:/opt/rootfs,nolock mem=80M video=davincifb:vid0=OFF:vid1=OFF:osd0=OFF'
setenv bootargs1 'dm365_imp.oper_mode=0 davinci_capture.device_type=4 davinci_enc_mngr.ch0_output=COMPOSITE davinci_enc_mngr.ch0_mode=ntsc'
setenv bootargs ${bootargs0} ${bootargs1} setenv serverip 192.168.1.23 setenv bootcmd 'dhcp;bootm'

Flash JFFS2 boot:

setenv bootargs0 'console=ttyS0,115200n8 noinitrd ip=off root=/dev/mtdblock3 ro rootfstype=jffs2 mem=80M video=davincifb:vid0=OFF:vid1=OFF:osd0=OFF'
setenv bootargs1 'dm365_imp.oper_mode=0 davinci_capture.device_type=4 davinci_enc_mngr.ch0_output=COMPOSITE davinci_enc_mngr.ch0_mode=ntsc'
setenv bootargs ${bootargs0} ${bootargs1} setenv bootcmd 'nboot 0x80700000 0 0x400000; bootm'

Flash YAFFS2 boot:

setenv bootargs0 'console=ttyS0,115200n8 noinitrd ip=off root=/dev/mtdblock3 rootfstype=yaffs2 rw mem=80M video=davincifb:vid0=OFF:vid1=OFF:osd0=OFF'
setenv bootargs1 'dm365_imp.oper_mode=0 davinci_capture.device_type=4 davinci_enc_mngr.ch0_output=COMPOSITE davinci_enc_mngr.ch0_mode=ntsc'
setenv bootargs ${bootargs0} ${bootargs1} setenv bootcmd 'nboot 0x80700000 0 0x400000; bootm'

RAM disk:

setenv bootargs0 'console=ttyS0,115200n8 root=/dev/ram0 rw initrd=0x82000000,3M ip=off mem=80M video=davincifb:vid0=OFF:vid1=OFF:osd0=OFF'
setenv bootargs1 'dm365_imp.oper_mode=0 davinci_capture.device_type=4 davinci_enc_mngr.ch0_output=COMPOSITE davinci_enc_mngr.ch0_mode=ntsc'
setenv bootargs ${bootargs0} ${bootargs1} setenv serverip 192.168.1.23 setenv bootcmd 'nand read 0x82000000 0x800000 0x400000; nboot 0x80700000 0 0x400000; bootm'
}}}

setenv serverip 192.168.1.41
setenv ipaddr 192.168.1.131
setenv bootargs1 'console=ttyS0,115200n8 noinitrd rw ip=dhcp root=/dev/nfs nfsroot=192.168.1.41:/opt/dm365/rootfs,nolock mem=80M'
setenv bootargs2 'video=davincifb:vid0=OFF:vid1=OFF:osd0=OFF'
setenv setargs 'setenv bootargs ${bootargs1} ${bootargs2}'
setenv net_boot 'run setargs; tftp 80700000 uImage; bootm 80700000'
setenv bootcmd 'run net_boot'


setenv serverip 192.168.1.41
setenv ipaddr 192.168.1.131
setenv bootargs1  'console=ttyS0,115200n8 noinitrd mem=80M'
setenv nfsargs    'ip=dhcp root=/dev/nfs nfsroot=192.168.1.41:/opt/dm365/rootfs,nolock rw'
setenv yaffs2args 'ip=off root=/dev/mtdblock3 rootfstype=yaffs2 rw'
setenv videoargs  'video=davincifb:vid0=OFF:vid1=OFF:osd0=OFF'
setenv setnfsargs    'setenv bootargs ${bootargs1} ${videoargs} ${nfsargs}'
setenv setyaffs2args 'setenv bootargs ${bootargs1} ${videoargs} ${yaffs2args}'
setenv net_nfs_b     'run setnfsargs; tftp 80700000 uImage; bootm 80700000'
setenv local_nfs_b   'run setnfsargs; nboot 80700000 0 400000; bootm'
setenv local_local_b 'run setyaffs2args; nboot 80700000 0 400000; bootm'
setenv net_local_b   'run setyaffs2args; tftp 80700000 uImage; bootm 80700000'
setenv bootcmd    'run net_nfs_b'

}}}
}}}

Netsticks

SIM free is 080.250.159.037 - SIM 971 - 052-5236299
}}}
ti {{{
    01aug2010

TI's linux {{{
sudo /bin/tar -C /work/zoom2 -xjf ./wl1271-v2/zoom2/rootfs.tar.bz2
sudo /bin/tar -C /work/bb/1273 -cjf /work/apps/beagleboard/rootfs-bb-29nov2010.tar.bz2 .
sudo /bin/chmod o+w -R --preserve-root /work/zoom2/myfs2
sudo /bin/chown a0387671:generic -R --preserve-root /work/bb/Angstrom/lib/pkgconfig/libnl-2.1.pc
sudo exportfs -a
sudo /etc/init.d/nfs-kernel-server restart
sudo /bin/rm -Rf --preserve-root /tmp/evil-wlan/
sudo /bin/rm -Rf --preserve-root /media/disk/
sudo /bin/mkdir -m 777 /media/disk/abc
sudo /bin/cp -ax /work/zoom2/nfsroot/lib/modules/2.6.35-wl-48655-g842c161-dirty /media/disk/lib/modules/
sudo /bin/cp -ax /work/zoom2/1273 /work/bb
git archive HEAD | gzip > wl12xx-06oct2010.tar.gz
sudo /usr/bin/tail -f /var/log/messages

Prepare SDcard. Follows will format n mount:
/etc/osa/bin/sd_card_helper /dev/sdd -am
copy MLO, u-boot.bin, uImage to /media/boot

Repare maping on Windows machine:
cd \\dncad02\NETLOGON\Israel
TI-isreal.bat
}}}

Common {{{

iw event > /var/log/iwevents
wpa_supplicant -P/var/run/wpa_supplicant.pid -iwlan0 -c/etc/wpa_supplicant.conf -Dnl80211 -f/var/log/wpa_supplicant.log
iw wlan0 cqm rssi -55 2
wpa_supplicant -ddt -iwlan0 -c/etc/wpa_supplicant.conf -Dnl80211

set uboot env:
setenv bootcmd 'mmcinit 0; fatload mmc 0 0x81c00000 uImage; bootm 0x81c00000'
setenv bootargs mem=256M console=ttyS0,115200n8 noinitrd root=/dev/nfs rw nfsroot=137.167.20.65:/home/nfs,nolock,devfs=mount ip=137.167.21.31

Trio                  Quattro
1271  W B G     1281  W B G FM
      +               +
1273  a         1283  a
                1383

RefClock
b00 - 19.2MHz
b01 - 26MHz
b10 - 38.4MHz
b11 - 54MHz

--- Front end modules (FEM)
FEM is separate chip from WLAN w/ own numbers.
There are 2 FEM (RFDM n TQS).
6M9 - TQS
ES 1.7 - v1.7

The RFDM v3.5 works good w/ fw v336, has no dual band (no 5GHz)
The TQS v1.7 should be for dual band.

The fw should get from drv radio params depend on FEM. The automatic detection
works from fw v339.

How to find which FEM onboard? To read from chip.

Is carrier board changes because of FEM???

How tiwlan_dual_1273.ini get updated??? To talk w/ Boris Presman

--- To check which FEM is it? (from Rinat Mansour)
Go to windows map (N) for Engineering>PROJ>WLAN>1273...

PCA-A|B-033504
A - RFMD
B - TQS

RFMD 3.5 - PCA-A-033404

--- Ref Clock

Trio ext 38.x MHz
     int 26MHz
Quattro ext / int 26MHz

On Trio written on the chip on the board's traverse

--- FW logger
Trio on external board needs on board PCB-036701 
to set jumper J22 connect pin 1 n 2.
Quattro on external board needs on board PCB-036701 to disconnect 
jumper J22 connect pin 1 n 2.

--- 
WL1271 PG3.1
WL1271L PG3.32

--- Documentation
Trio init:
http://mcsdocs.isr.asp.ti.com:81/WLAN/index.php?dir=MCS_WLAN_Docs/System%20Integration/Wilink%20Projects/Wilink%206/WL6.1/Top%20Init/
Quattro init
http://mcsdocs.isr.asp.ti.com:81/WLAN/index.php?dir=MCS_WLAN_Docs/System Integration/Wilink Projects/Wilink 7/wilink 7.1/init/

Packet filtering
http://mcsdocs.isr.asp.ti.com/WLAN/index.php?dir=CCSS_IL_RnD_Docs/Architecture/WiLink%20Products/Feature%20Specs/&file=Receive%20Packet%20Filtering%20FS.doc

}}}

the wizery {{{

ftp ftp.wizery.com
user: anonymous
pass: geryk@ti.com
cd incoming
put file

ssh -lgeryk wizery.com -p13117
Add to .ssh/config
Host wizery.com
Port 13117
git clone ssh://wizery.com:/pub/wl1271.git

}}}

Zoom3 external{{{

Hardware
PCB-033404 - wless card
PCB-036702 - mb card

and fix in arch/arm/mach-omap2/board-zoom-peripherals.c (07dec2010)
#define OMAP_ZOOM_WLAN_PMENA_GPIO   (157)
.board_ref_clock = 2,
.board_tcxo_clock = 1
.caps           = MMC_CAP_4_BIT_DATA | MMC_CAP_POWER_OFF_CARD

Build krnl for zoom3 (2.6.36-rc6):
On
System Type -> TI OMAP2/3/4 Specific Features -> OMAP3630 Zoom3 board

}}}

Beagleboard {{{
        http://elinux.org/BeagleBoard#Source

OMAP3630/3730-GP ES2.0, CPU-OPP2, L3-165MHz, Max CPU Clock 1 Ghz

--- Sources
git clone git://gitorious.org/x-load-omap3/mainline.git xloader
cd xloader
make distclean
make omap3530beagle_config
make

git clone git://git.gitorious.org/beagleboard-validation/u-boot.git
git clone git://git.denx.de/u-boot.git u-boot-main
cd u-boot-main
git checkout --track -b omap3 origin/master
make CROSS_COMPILE=arm-none-linux-gnueabi- mrproper
make CROSS_COMPILE=arm-none-linux-gnueabi- omap3_beagle_config
make CROSS_COMPILE=arm-none-linux-gnueabi- 

--- Enable ethernet on xM
create etc/sysconfig/network-scripts/ifcfg-eth0 with follows
DEVICE=usb0
BOOTPROTO=none
ONBOOT=yes
IPADDR=192.168.1.1
NETMASK=255.255.255.0
GATEWAY=192.168.1.1
DNS1=192.168.1.1
TYPE=Ethernet
USERCTL=no

insmod /lib/modules/2.6.38-rc4-wl-gxk-00332-gaaa9dbb-dirty/kernel/drivers/net/usb/smsc95xx.ko
insmod /lib/modules/2.6.38-rc4-wl-gxk-00332-gaaa9dbb-dirty/kernel/drivers/net/usb/usbnet.ko

--- Prepare u-boot env file for xM


--- Burn images to NAND from u-boot:

mmc init

fatload mmc 0 0x80200000 x-load.bin.ift
nandecc sw
nand erase 0 80000
nand write.i 0x80200000 0 80000

fatload mmc 0 0x80200000 flash-uboot.bin
nand erase 80000 160000
nand write.i 0x80200000 80000 160000

fatload mmc 0 0x80300000 uImage
nand erase 280000 47FFFF
nand write.i 0x80300000 280000 1FFFFF
nand erase 280000 400000
nand write.i 0x80300000 280000 400000


}}}

Panda {{{

Board ref clock is 38.4MHz from omap_panda_wlan_data.board_ref_clock
arch/arm/mach-omap2/board-omap4panda.c

TWL6030 power management companion chip

}}}

Address mapping{{{
PART_DOWN
mem st 0x0
mem sz 0x000177c0
reg st 0x00300000
reg sz 0x00008800
Part_WORK
mem st 0x00040000
mem sz 0x00014fc0
reg st 0x00300000
reg sz 0x0000a000
me2 st 0x003004f8
me2 sz 0x00000004
me3 st 0x00040404
me3 sz 0x00000004
PART_DRPw
mem st 0x00040000
mem sz 0x00014fc0
reg st 0x00310000
reg sz 0x00006000

Calculate
if PART_WORK n addr is 0x00300004
this is region reg n real addr is
    real addr = addr - mem.sz + reg.st
    0x00300004 - 0x14fc0 + 0x00300000 ???
}}}

driver {{{

Chip Id {{{

from http://mcsdocs.isr.asp.ti.com/WLAN/vobs/MCS_WLAN_Docs/ASIC/WiLink%20Products/WiLink%207/registers/latest_register_files/wsoc/soc_1273_vbus.html#IO_Control_CHIP_ID_B

To read arch (Trio/Quattro/Penta) from reg SOC CHIP_ID_B addr 0x0030 5674,
where bits
31:16 give 0403 Trio, 0503 Quattro
7:0   give 01 PG 1.0
           11 PG 2.0
           12 PG 1.2
           13 PG 1.3

To read PG ver from TOP reg REG_FUSE_DATA_2_1 from 0x050a (127x), where bits
5:4   give ROM ver
3:2   give PG ver
The REG_FUSE_DATA_2_1 for 128x is 0x2152

In case of Trio there is additional reg from TOP 0x0000 051a, where bits
3:0   give New PG ver

_plt_start() (main.c)
|-> _chip_wakeup()
|   |-> read chip_id from reg CHIP_ID_B
|-> _boot() (boot.c)
|   |-> _load_firmware()
|       |-> wl127x_boot_clk()
|       |   |-> _boot_hw_version()
|       |       |-> read reg REG_FUSE_DATA_2_1
|       |       |-> ...
|       |-> wl128x_boot_clk()
|       |       |-> 
|-> _plt_init()
|-> ...

}}}

Quattro {{{
    The driver should define partitions w/ start addr and size.

DRP - Digital Radio Processor

from drivers/net/wireless/wl12xx/wl1271_io.c 
    SPI partitions

/* Set the SPI partitions to access the chip addresses
 *
 * To simplify driver code, a fixed (virtual) memory map is defined for
 * register and memory addresses. Because in the chipset, in different stages
 * of operation, those addresses will move around, an address translation
 * mechanism is required.
 *
 * There are four partitions (three memory and one register partition),
 * which are mapped to two different areas of the hardware memory.
 *
 *                                Virtual address
 *                                     space
 *
 *                                    |    |
 *                                 ...+----+--> mem.start
 *          Physical address    ...   |    |
 *               space       ...      |    | [PART_0]
 *                        ...         |    |
 *  00000000  <--+----+...         ...+----+--> mem.start + mem.size
 *               |    |         ...   |    |
 *               |MEM |      ...      |    |
 *               |    |   ...         |    |
 *  mem.size  <--+----+...            |    | {unused area)
 *               |    |   ...         |    |
 *               |REG |      ...      |    |
 *  mem.size     |    |         ...   |    |
 *      +     <--+----+...         ...+----+--> reg.start
 *  reg.size     |    |   ...         |    |
 *               |MEM2|      ...      |    | [PART_1]
 *               |    |         ...   |    |
 *                                 ...+----+--> reg.start + reg.size
 *                                    |    |
 *
 */

}}}

Boot procedure {{{
        02dec2010

Load module wl12xx
Load modules wl12xx_sdio
Start wless interface
  Chip wakeup

Boot FW n NVS:

wl1271_plt_start() or 

wl1271_chip_wakeup()
|-> ...
|-> wl1271_fetch_firmware() - read fw file to structure
|_> wl1271_fetch_nvs() - read nvs file to structure

wl1271_boot()
|-> wl1271_load_firmware()
|   |->...
|   |-> wl1271_boot_upload_nvs()
|   |->...
|   |_> wl1271_boot_upload_firmware()
|-> wl1271_boot_run_firmware()
|-> wl1271_boot_enable_interrupts()
|_> wl1271_event_mbox_config()

wl1271_plt_init()
|-> wl1271_cmd_general_parms()
|   send TEST_CMD_INI_FILE_GENERAL_PARAM
|-> wl1271_cmd_radio_parms
|   send TEST_CMD_INI_FILE_RADIO_PARAM
|-> wl1271_cmd_ext_radio_parms()
|   send TEST_CMD_INI_FILE_RF_EXTENDED_PARAM

        INI file:

--- General prms
TXBiPFEMAutoDetect
TXBiPFEMManufacturer
RefClk                                          wl1271_ini_general_params 1
SettlingTime                                    wl1271_ini_general_params 1
ClockValidOnWakeup                              wl1271_ini_general_params 1
DC2DCMode                                       wl1271_ini_general_params 1
Single_Dual_Band_Solution                       wl1271_ini_general_params 1
Settings                                        wl1271_ini_general_params 1
SRState                                         wl1271_ini_general_params 1
SRF1                                            wl1271_ini_general_params 16
SRF2                                            wl1271_ini_general_params 16
SRF3                                            wl1271_ini_general_params 16
--- 2.4G params
RxTraceInsertionLoss_2_4G                       wl1271_ini_band_params_2 1
TXTraceLoss_2_4G                                wl1271_ini_band_params_2 1
RxRssiAndProcessCompensation_2_4G               wl1271_ini_band_params_2 15
--- 5G params
RxTraceInsertionLoss_5G                         wl1271_ini_band_params_5 7
TXTraceLoss_5G                                  wl1271_ini_band_params_5 7
RxRssiAndProcessCompensation_5G                 wl1271_ini_band_params_5 15
--- TQS 2.4G params
FEM1_TXBiPReferencePDvoltage_2_4G
FEM1_TxBiPReferencePower_2_4G
FEM1_TxBiPOffsetdB_2_4G
FEM1_TxPerRatePowerLimits_2_4G_Normal
FEM1_TxPerRatePowerLimits_2_4G_Degraded
FEM1_TxPerRatePowerLimits_2_4G_Extreme
FEM1_DegradedLowToNormalThr_2_4G
FEM1_NormalToDegradedHighThr_2_4G
FEM1_TxPerChannelPowerLimits_2_4G_11b
FEM1_TxPerChannelPowerLimits_2_4G_OFDM
FEM1_TxPDVsRateOffsets_2_4G
FEM1_TxIbiasTable_2_4G
FEM1_RxFemInsertionLoss_2_4G
--- TQS 5G params
FEM1_TXBiPReferencePDvoltage_5G                 wl1271_ini_fem_params_5 7
FEM1_TxBiPReferencePower_5G                     wl1271_ini_fem_params_5 7
FEM1_TxBiPOffsetdB_5G                           wl1271_ini_fem_params_5 7
FEM1_TxPerRatePowerLimits_5G_Normal             wl1271_ini_fem_params_5 6
FEM1_TxPerRatePowerLimits_5G_Degraded           wl1271_ini_fem_params_5 6
FEM1_TxPerRatePowerLimits_5G_Extreme            wl1271_ini_fem_params_5 6
FEM1_DegradedLowToNormalThr_5G                  wl1271_ini_fem_params_5 1
FEM1_NormalToDegradedHighThr_5G                 wl1271_ini_fem_params_5 1
FEM1_TxPerChannelPowerLimits_5G_OFDM            wl1271_ini_fem_params_5 35      
FEM1_TxPDVsRateOffsets_5G                       wl1271_ini_fem_params_5 6
FEM1_TxIbiasTable_5G                            wl1271_ini_fem_params_5 6
FEM1_RxFemInsertionLoss_5G                      wl1271_ini_fem_params_5 7
--- RFMD 2.4G params
FEM0_TXBiPReferencePDvoltage_2_4G               wl1271_ini_fem_params_2 2
FEM0_TxBiPReferencePower_2_4G                   wl1271_ini_fem_params_2 1
FEM0_TxBiPOffsetdB_2_4G                         wl1271_ini_fem_params_2 1
FEM0_TxPerRatePowerLimits_2_4G_Normal           wl1271_ini_fem_params_2 6
FEM0_TxPerRatePowerLimits_2_4G_Degraded         wl1271_ini_fem_params_2 6
FEM0_TxPerRatePowerLimits_2_4G_Extreme          wl1271_ini_fem_params_2 6
FEM0_DegradedLowToNormalThr_2_4G                wl1271_ini_fem_params_2 1       
FEM0_NormalToDegradedHighThr_2_4G               wl1271_ini_fem_params_2 1
FEM0_TxPerChannelPowerLimits_2_4G_11b           wl1271_ini_fem_params_2 14
FEM0_TxPerChannelPowerLimits_2_4G_OFDM          wl1271_ini_fem_params_2 14
FEM0_TxPDVsRateOffsets_2_4G                     wl1271_ini_fem_params_2 6
FEM0_TxIbiasTable_2_4G                          wl1271_ini_fem_params_2 6
FEM0_RxFemInsertionLoss_2_4G                    wl1271_ini_fem_params_2 1
}}}

keep alive {{{
        The fw sends pkts to AP, in order to get ACK.

The idea is to send pkt to an AP and get ACK during CIF

The KA pkt can be send if
  No Tx for period of time (cfgd)
  Just after cfgd timeout
  The TSF not in sync
The retry will happened during 0.5sec (hardcoded time)

--- Configuration
wl1271_acx_keep_alive_config() (acx.c)
Parameters:
period - period of time 
tpl_validation - enable/disable keep alive
trigger - NO_TX=when no Tx for period of time, PERIOD_ONLY=just every period

}}}

--- Get driver state (debugfs)
cat /sys/kernel/debug/ieee80211/phy0/wl12xx/driver_state

--- Manage dynamic debug (debugfs)
cat /debug/ieee80211/phy0/wl12xx/debug_level
echo '0x2000' > /debug/ieee80211/phy0/wl12xx/debug_level
echo 'module wl12xx +p' > /debug/dynamic_debug/control


/sys/devices/platform/wl1271/power

--- Cfg beacon interval
debugfs ... beacon_interval

--- Cfg DTIM interval
debugfs ... dtim_interval

Beacon early termination (BET)

Cfg params:
Tx
    tx_compl_timeout
    tx_compl_threshold  - nbr of pkts 

}}}

--- using dynamic debug {{{
from Documentation/dynamic-debug-howto.txt

kernel cfg: CONFIG_DYNAMIC_DEBUG
Kernel hacking->Enable dynamic printk() support

Load modules w parameter: debug_level=<nbr>
        DEBUG_IRQ       = BIT(0),
        DEBUG_SPI       = BIT(1),
        DEBUG_BOOT      = BIT(2),
        DEBUG_MAILBOX   = BIT(3),
        DEBUG_TESTMODE  = BIT(4),
        DEBUG_EVENT     = BIT(5),
        DEBUG_TX        = BIT(6),
        DEBUG_RX        = BIT(7),
        DEBUG_SCAN      = BIT(8),
        DEBUG_CRYPT     = BIT(9),
        DEBUG_PSM       = BIT(10),
        DEBUG_MAC80211  = BIT(11),
        DEBUG_CMD       = BIT(12),
        DEBUG_ACX       = BIT(13),
        DEBUG_SDIO      = BIT(14),
        DEBUG_FILTERS   = BIT(15),
        DEBUG_ADHOC     = BIT(16),
        DEBUG_ALL       = ~0

--- To check current debug_level
cat /debug/ieee80211/phy0/wl12xx/debug_level

--- To set new debug_level
echo '0x2000' > /debug/ieee80211/phy0/wl12xx/debug_level

--- To start debug prints
echo 'module wl12xx +p' > /debug/dynamic_debug/control


> Next time please use the debug mask 0x63c00. Can be done like this:
>
> adb shell insmod /system/lib/modules/wl12xx.ko debug_level=0x63c00
> adb shell "echo -n 'module cfg80211 +p' >
> /sys/kernel/debug/dynamic_debug/control"
> adb shell "echo -n 'module mac80211 +p' >
> /sys/kernel/debug/dynamic_debug/control"
> adb shell "echo -n 'module wl12xx +p' > /sys/kernel/debug/dynamic_debug/control"
>
> of course no need for "adb shell" if this is not android.
>

echo -n 'module wl12xx +p' > /sys/kernel/debug/dynamic_debug/control

}}}

Cisco 1250 {{{
        2011-03-03
Downloaded fw c1250-rcvk9w8-tar.124-21a.JA2.tar
}}}

Firmware logger GUI {{{

Install app
Connect USB cable and check that 4 new COM ports appeared.
The 4th is FW logger.

In app:
Alt+F7
Setup button

Port setting: 

}}}

install vpn {{{
        2011-04-26
apt-get install vpnc
sudo vi /etc/vpnc/ti.mercury.conf
IPSec gateway mercury.ext.ti.com
IPSec ID linuxvpn
IPSec secret 2001vpn
Xauth username ENT/a0387671
Xauth password <psswd>

connect:
sudo vpnc-connect ti.mercury.conf
sudo vpnc-disconnect

ifconfig shows new dev tun0. need to set its mtu:
sudo ifconfig tun0 mtu 1300

}}}

ClearQuest web access:
https://dilcqweb.isr.asp.ti.com/cqweb/

git clone git://git.isr.asp.ti.com/git.kernel.org/linux/kernel/git/dwmw2/linux-firmware.git
or
git://git.kernel.org/pub/scm/linux/kernel/git/dwmw2/linux-firmware.git

git://git.kernel.org/pub/scm/linux/kernel/git/luca/wl12xx.git

git://git.kernel.org/pub/scm/linux/kernel/git/linville/wireless-testing.git

Workplace {{{
                      ______________________________
                     |                              |
   eth=172.16.1.7 ---|                              |__> eth0=
      Blaze          |         PC (ubtdsk2)         |     PC (ub102666)
   08:00:28:07:64:31 |       eth0=10.167.14.133     |  eth1=172.16.1.11
                     |       eth1=172.16.1.10       |  eth2=192.168.1.11
   eth=172.16.1.6 ---|              |               |
      Beagle         |              |               |
   08:00:28:06:64:31 |              |               |
                     |              |               |__> PC (ub102267) x64
   eth=172.16.1.8 ---|              |                    eth1=172.16.1.12
      Panda          |              |
   08:00:28:08:64:31 |              |
                     |              |
   eth=172.16.1.5 ---   /-------------------------------------\
      Blaze Android    |        |                   |          |
   08:00:28:05:64:31   |        |                   |          |
                       |        |                   |          |
              ---------         |                   |          |
             |                  |                   |          |
      192.168.1.1        192.168.1.2         192.168.1.3       192.168.1.4
      AP1 WRT610Nv2      AP2 WRT610Nv2       AP3 Cisco 1250    AP Cisco 1250
 2.4  00:25:9C:C9:59:9A  00:25:9C:57:19:66   00:23:5E:B0:4E:60 00:
   5  00:25:9C:C9:59:9B  00:25:9C:57:19:67   00:21:A0:00:00:D0 00:
 eth                                         00:23:5E:69:A0:EA 00:


--- Proxy
FF: http://proxyconfig.itg.ti.com/proxy.pac

wwweuproxy.ith.ti.com:80

in .bashrc:
export http_proxy="http://wwweuproxy.itg.ti.com:80"
export https_proxy="http://wwweuproxy.itg.ti.com:80"
export ftp_proxy="http://wwweuproxy.itg.ti.com:80"

git:
git config --global http.proxy wwweuproxy.ith.ti.com:80


apt-get:
Add in /etc/apt/apt.conf.d/70debconf
Acquire {http {Proxy "http://wwweuproxy.itg.ti.com:80/";No-Cache "false";Max-Age "86400";No-Store "false";};};



}}}

U-Boot env:
setenv ipaddr 172.16.1.5
setenv serverip 172.16.1.10
setenv bootcmd 'run netboot'
setenv netboot 'tftp ${loadaddr} ${bootfile}; run netargs; bootm ${loadaddr}'
setenv loadaddr '0x81c00000'
setenv bootfile '1273e/uImage'
setenv netargs 'setenv bootargs console=${console} root=${netroot} rw nfsroot=${serverip}:/work/zoom2/1273,nolock ip=${ipaddr}'
setenv console 'ttyS0,115200n8'
setenv netroot '/dev/nfs'
saveenv

Build the prj:
export CONCURRENCY_LEVEL=3
make uImage modules
cp ./arch/arm/boot/uImage /work/tftpboot/1273e/
make modules_install INSTALL_MOD_PATH=${NFSROOT}

The calibration {{{
        01nov2010 from Efi Leibovitch 6893

This is link to INI generator:
http://mcsdocs.isr.asp.ti.com:81/WLAN/index.php?dir=MCS_WLAN_Docs/System%20Integration/Wilink%20Projects/Wilink%206/WL6.1/Init%20Docs/&file=INI%20File%20Generator.xls

--- TxBip procedure
1st command to set references to power n voltage for certain subband
TEST_CMD_UPDATE_PD_REFERENCE_POINT 375 128 0
2nd cmd to proceed w/ calibration for ceratain subband
T_CMD_P2G_CAL 1 0 0 0 0 0 0 0
The result of 2nd cmd brings buffer w/ calibration data for 8 sub bands always

If given zeros in set reference point cmd, firmware will take def values for 
each subband.

from docs {{{

http://mcsdocs.isr.asp.ti.com:81/WLAN/index.php?dir=MCS_WLAN_Docs/Architecture/WiLink%20Products/WiLink%206/WL6.1/FS_L/&file=WL6%201.0%20PLT%20and%20ATE%20API%20v0%208_ir.doc

BiP sequences:

Tx continuous
TEST_CMD_CHANNEL_TUNE - set working channel
TEST_CMD_FCC - fill Tx params n activate
TEST_CMD_STOP_TX - stop active Tx

Tx tone

Tx BIP
TEST_CMD_CHANNEL_TUNE
TEST_CMD_UPDATE_PD_REFERENCE_POINT
TEST_CMD_P2G_CAL


--- from Ilanit's email

Tx BIP procedure for single band:
To put 50 Ohm terminator on the RF and perform
Set to active mode
/ w p 1 l 2 f 2
Actual TxBIP cmds
/ t r h 0 7              biT Radio_debug cHannel_tune
/ t b b 375 128 0        biT Bip update_Buffer_calref_point
/ t b t 1 0 0 0 0 0 0 0  biT Bip Tx_bip

Tx BIP procedure for dual band:
To put 50 Ohm terminator on the RF and perform
Set to active mode
/ w p 1 l 2 f 2
Actual TxBIP cmds
/ w p 1                 poWer/set_Power_mode
/ w l 2                 poWer/set_powersave_powerLevel
/ w f 2                 poWer/set_deFault_powerlevel
/ t r h 0 7
/ t b b 423 128 0


TxCont procedure (G band):
/ t r t n 2000 1 100 0 5000 0 3 0 0 0 0 0 1 0 11:22:33:44:55:66
/ t r t n 2000 2048 100 0 5000 0 3 0 0 4 0 0 1 0 11:22:33:44:55:66
/ t r t n 2000 4096 100 0 15000 0 3 0 0 4 0 0 1 0 11:22:33:44:55:66
/ t r t n 2000 4096 100 0 15000 0 3 0 0 0 0 0 0 0 11:22:33:44:55:66
/ t r t n 2000 1 100 0 5000 0 3 0 0 0 0 0 1 0 11:22:33:44:55:66

TxCont procedure (N band):
/ t r t n 2000 1048576 1000 0 15875 0 3 0 0 6 0 0 0 0 11:22:33:44:55:66
        biT/Radio_debug/Tx_debug/coNtinues
/ t r t n 2000 1048576 1000 0 13000 0 3 0 0 6 0 0 55 0 11:22:33:44:55:66
/ t r t n 2000 1048576 1000 0 5000 0 3 0 0 6 0 0 55 0 11:22:33:44:55:66
/ t r t n 50 1048576 1000 0 15875 0 3 0 0 6 0 0 0 0 11:22:33:44:55:66

TxCont procedure (A band):
/ t r h 1 56
/ t r t n 2000 2048 100 0 10000 0 3 0 0 4 0 0 1 0 11:22:33:44:55:66
/ t r t n 2000 6 100 0 5000 0 3 0 0 4 0 0 0 0 11:22:33:44:55:66

}}}

NLCP NVS file structure {{{

0x01
0x6d 0x54
0xXX 0xXX 0xXX 0xXX     MAC addr (5,4,3,2)
0x01 0x71 0x54
0xXX 0xXX               MAC addr (1,0)
0x00 0x00
0x00 0x00 0x00 0x00 0x00 0x00 0x00
0x00 0x00 0x00
0x01                    Tx sec type
0x01 0x99               Tx sec len (409B)
Tx values - def 0x00
0x02                    Rx sec type
0x00 0x13               Rx sec len (19B)
Rx values - def 0x00
0xaa                    Ver sec type
0x00 0x03               Ver sec len
0x00 0x02 0x00
0xff 0xff 0x00 0x00     the end of NVS sec

}}}

}}}

Patch creation {{{
git commit -a -m "xxx"
git format-patch -s -o patches/misc -1 --subject-prefix="PATCH"
scripts/checkpatch.pl patches/misc/*
t format-patch -s -o patches/misc -1 --subject-prefix="PATCH"
git send-email --suppress-cc=self --suppress-cc=sob --annotate \
--from "Gery Kahn <geryk@ti.com>" --to "<mcs-mac80211@list.ti.com>" \
--cc "Luciano Coelho <coelho@ti.com>" \
patches/plt/0001-fix-of-P2G_CAL-struct-to-align-w-firmware.patch

git send-email --suppress-cc=self --suppress-cc=sob --annotate \
--from "Gery Kahn <geryk@ti.com>" --to "<linux-wireless@vger.kernel.org>"
--cc "Luciano Coelho <coelho@ti.com>" patches/misc/

Prepare patch series - this will create 2 patches like "PATCH n/m":
git add a.c
git commit -a -m "a.c"
git add b.c
git commit -a -m "b.c"
git format-patch -s -o patches/ -n --subject-prefix="PATCH" -2 --cover-letter


git request-pull 8654e2dd962899cbc81b3735c7122ca40fa5ea0e git://github.com/gxk/linux-firmware.git > add_bt_script-request-pull.txt
}}}
}}}
-------------------------------------------------------------------------------
------------------------------ TexasInstruments--------------------------------
-------------------------------------------------------------------------------
001. Build mac prj env for ZOOM2 {{{
    27jul2010
Install ./arm-2008q3-72-arm-none-linux-gnueabi.bin into default dir 
Change PATH to /home/a0387671/CodeSourcery/Sourcery_G++_Lite/bin

clone the wireless testing branch:
git clone http://git.kernel.org/pub/scm/linux/kernel/git/linville/wireless-testing.git
git branch 1271_func
git checkout 1271_func

open wl1271-v2.tar.bz2
cd <to kernel dir>
git apply <full path>/<filename>
The patch nbr 11 should be done manualy
cp <wl1271>/zoom2/config-zoom2
`make oldconfig' and answer No for 4 questions
export ARCH=arm
export CROSS_COMPILE=arm-none-linux-gnueabi-
export NFSROOT=/work/zoom2/nfsroot
make uImage modules -j10
cp ./arch/arm/boot/uImage /work/tftpboot/trio/
make modules_install INSTALL_MOD_PATH=${NFSROOT}

Commiting:
git add arch/arm/mach-omap2/board-zoom-wlan.c
git add include/linux/wl12xx.h
git commit -a

set uboot env:
nand unlock
nand ecc sw
setenv ipaddr 192.168.1.10
setenv serverip 192.168.1.1
setenv vout 'omap24xxvout omap_vout.video1_numbuffers=6 omap_vout.vid1_static_vrfb_alloc=y omapfb.vram=0:4M'
setenv bootargs_base 'console=ttyS3,115200n8'
}}}
002. Build iw app for Zoom2 {{{
    03aug2010
from http://linuxwireless.org/en/users/Documentation/iw
The iw is new nl802.11 based CLI configuration utility for wless devs.
download libnl-1.1 deb pkg and extract the lib to rootfs
download iw from https://launchpad.net/ubuntu/+source/iw/0.9.19-1/+build/1776712 as deb
cp it to usr/sbin
download wpasupplicant_0.7.2+0m6_armel.deb and cp 3 files: wpa_*

created fs binary rootfs-03aug2010-gxk.tar.bz2 and placed at 
    \\dilfs14\wlan\WLAN\mac802.11\Driver\Version_Tree\rootfs-03aug-gxk.tar.bz2
sudo /bin/chmod 777 -R  --preserve-root /media/disk
sudo /bin/tar -C /media/disk -jxf ~/rootfs-03aug2010-gxk.tar.bz2
}}}
003. Bringup Nokia (gekko) board {{{
    03aug2010
connect minicom
minicom -D /dev/ttyS0
config it w/o hardware support

cd /work/nokia
sudo /bin/tar -C /work/nokia -xf ../apps/nokia/core.linux-dali.tar
sudo /bin/chown a0387671:generic -R  --preserve-root /work/nokia/core.linux-dali
sudo /bin/tar -C /work/nokia -xf ../apps/nokia/core.initrd-dali.tar
sudo /bin/chown a0387671:generic -R  --preserve-root /work/nokia/core.initrd-dali
cd /work/nokia/core.linux-dali
make rm581_defconfig
make zImage modules -j 10
cd /work/nokia/core.initrd-dali
add to .config follow:
    KERNEL_DIR=/work/nokia/core.linux-dali
    FLASHER=sudo /work/nokia/core.linux-dali/flasher/flasher
make run
It will stop on waiting USB
run to switch board on:
`/work/nokia/core.linux-dali/flasher/setSerialSignal /dev/ttyS0 0 0'
while boot come to initrd - plugout the USB cable from board
}}}
004. Evaluate Nokia testsuite {{{

--- Setup configuration {{{

    eth=172.16.1.7 ---> eth2=172.16.1.10
      Target                    PC
    wlan                 eth1=192.168.1.100
                                |
                            --------
                           |        |
               eth=192.168.1.1    eth=192.168.1.2
                    AP1             AP2
                wlan              wlan

The testsuite splited in 2 parts: client on Targer side and server on PC.
The client side listening for connection from the server. They communicate
by wired ethernet.

Add to /etc/network/interfaces

auto eth1
iface eth1 inet static
       address 192.168.1.100
       netmask 255.255.255.0

auto eth2
iface eth2 inet static
       address 172.16.1.10
       netmask 255.255.255.0


Supported APs: WRT54GL, WRT610n
}}}
--- Nokia testsuite analyzes

 basic_functionality
 BT_Funcional_tests_-_Release_test_set
 nft_4_hours
 WLAN_FuTe_RelSet
 WLAN_FuTe_RelSet_PS
 WLAN_Misc_tests
 WLAN_NFT_24H
 WLAN_NFT_Xh
 WLAN_Pairwise
 WLAN_tput_reg
 WLAN_Validation
 WLAN_WMM

--- Get the proj from git
git clone https://geryk:z2aEqfsGw@dvcs.projects.maemo.org/git/peripherals-wlan-tests

--- Build the server side
pushd peripherals-wlan-tests/peripherals-test-framework
dpkg-buildpackage -rfakeroot
The results are in parent dir:
peripherals-test-autom-client_<ver>.deb
peripherals-test-autom-client-debug_<ver>.deb
peripherals-test-autom-server_<ver>.deb
Install server tests:
sudo /usr/bin/dpkg -i peripherals-test-autom-server_0.0.8_all.deb
Install python:
download python2.5-minimal_2.5.2-15+lenny1_armel.deb
pushd /work/zoom2/nfsroot
dpkg -x ~/ti/nokia_testing/python2.5-minimal_2.5.2-15+lenny1_armel.deb .
pushd /work/zoom2/nfsroot/usr/bin
ln -s python2.5 python
dpkg -x ~/ti/nokia_testing/python-wpactrl_1.0.7-1+0m6_armel.deb .
dpkg -x ~/ti/nokia_testing/iperf_2.0.0+0m6_armel.deb .
dpkg -x ~/ti/nokia_testing/peripherals-client-data_0.0.10+0m6_armel.deb .
dpkg -x ~/ti/nokia_testing/peripherals-wlan-tests/peripherals-test-autom-client_0.0.8_all.deb .

Boot the TARGET and run follow
------------------------------
echo 8 > /proc/sys/kernel/printk
mount -t debugfs none /sys/kernel/debug
insmod /lib/modules/`uname -r`/kernel/net/wireless/cfg80211.ko
insmod /lib/modules/`uname -r`/kernel/net/mac80211/mac80211.ko
insmod /lib/modules/`uname -r`/kernel/lib/crc7.ko
insmod /lib/modules/`uname -r`/kernel/drivers/base/firmware_class.ko
insmod /lib/modules/`uname -r`/kernel/drivers/net/wireless/wl12xx/wl1271.ko
insmod /lib/modules/`uname -r`/kernel/drivers/net/wireless/wl12xx/wl1271_sdio.ko
sleep 1
ifconfig wlan0 hw ether 00:22:33:44:55:66
sleep 1
cat /sys/kernel/debug/mmc2/ios
sleep 1
ifconfig wlan0 up
#insmod /lib/modules/`uname -r`/kernel/drivers/usb/gadget/g_ether.ko
#ifup usb0
iw event > /var/log/iwevents &
wpa_supplicant -f/var/log/wpa_supplicant.log -Dnl80211 -iwlan0 -c/etc/wpa_supplicant.conf -B
python /usr/share/peripherals-test-autom/dut.py -v

On the SERVER side
------------------
use usb0 {{{
sudo /sbin/modprobe /lib/modules/2.6.32-23-server/kernel/drivers/usb/gadget/g_ether.ko
sudo /sbin/ifconfig usb1 192.168.7.1 netmask 255.255.255.0 up
sudo /sbin/route add -host 192.168.7.2 dev usb1
}}}
pushd /usr/share/peripherals-test-autom
sudo /usr/bin/python host.py -v -f /usr/share/peripherals-test-autom/tests/WLAN_FuTe_RelSet/001_ifup_down -a 192.168.2.7 &
sudo /usr/bin/python host.py -v -f /usr/share/peripherals-test-autom/tests/WLAN_FuTe_RelSet/003_associate -a 192.168.2.7 &


Results are in /tmp/evil-wlan
Possible to create html file:
    process_results.py /tmp/evil-wlan > testrun-results.html

}}}
005. BringUp Zoom2 - Quattro w/ mac802.11 driver {{{
    09aug2010

    The Quattro docs:
http://mcsdocs.isr.asp.ti.com:81/WLAN/index.php?dir=MCS_WLAN_Docs/System%20Integration/Wilink%20Projects/Wilink%207/wilink%207.1/init/

    Bringup Zoom2 w/ external Quattro chip.
Hardware setup {{{
extrenal sdio adapter - PCB-038101
motherboard - PCB-036701
Quattro external board - PCB-036701
Add power supply 6V to Quattro external board
}}}

Prepare kernel {{{
git checkout 1271_func
git branch 1271_quattro
git checkout 1271_quattro
Apply Quattro patches:
git apply /work/ti/zoom2/quattro/0001-1283-add-support-build-only-not-tested-yet.patch
git apply /work/ti/zoom2/patches/quattro/0001-Add-support-for-falling-edge-as-well.patch
and fix in arch/arm/mach-omap2/board-zoom-wlan.c :
#define OMAP_ZOOM_WLAN_PMENA_GPIO   (157)
#define OMAP_ZOOM_WLAN_IRQ_GPIO     (162)

make oldconfig add support for 1283 SDIO
make menuconfig - uncheck support for 1271
Copy fw to <rootfs>/lib/firmware/wl1281-fw.bin (YES 1281)
cp ./Fw1283r1c_sta_cortex.bin /work/zoom2/nfsroot/lib/firmware/wl1281-fw.bin
Prepare NVS file: cd ~/ti/zoom2/wl1271-v2/generate_fw
copy data in wilink6_nvs.h under name wilink6_nvs[]...
run `./go_generate' which creates ./wl1271-nvs.bin
cp ./wl1271-nvs.bin /work/zoom2/nfsroot/lib/firmware/wl1281-nvs.bin

make uImage modules -j10
cp ./arch/arm/boot/uImage /work/tftpboot/quattro/
make modules_install INSTALL_MOD_PATH=${NFSROOT}

Prepare sdcard:
/etc/osa/bin/sd_card_helper /dev/sdc
cp /work/apps/zoom2/MLO /media/boot/
cp /work/apps/zoom2/u-boot.bin /media/boot/
cp ./wireless-testing/arch/arm/boot/uImage /media/boot/
}}}

Investigation on USE_ACTIVE_HIGH {{{
There is patch 0001-Add-support-for-falling-edge-as-well.patch
Why need it?

This macro used in
        wl1271_reg.h
        wl1271_sdio.c
        wl1271_boot.c

Current status

load wl1271_sdio
|-> wl1271_plat_probe()
    |-> set_irq_type() - RISING or FALLING

wl1271_op_add_interface()
|-> wl1271_boot()
    |-> ...
    |-> wl1271_boot_write_irq_polarity()
    |   |-> set reg OCP_REG_POLARITY to 0 if rising
    |-> ...
    |-> wl1271_boot_enable_interrupts()
        |-> wl1271_enable_interrupts()
        |-> wl1271_write32() - w to ACX_REG_INTERRUPT_MASK
        |-> wl1271_write32() - w to HI_CFG if falling 0x00000080

19aug2010 from Asaf Carmeli
There isn't same way to configure FW in Trio n Quattro to enable interrupt
rising or falling. We should also appropriate configure host gpio.
Solution:
Need to change this behaviour, update Quattro init document
What will happened after wakeup w/ such configuration?
}}}

}}}
006. Update Nokia testsuite (new ver 0.0.9, 0.0.11) {{{
        22aug2010 02sep2010
--- Setup configuration {{{

    eth=172.16.1.7 ---> eth2=172.16.1.10
      Target                    PC
    wlan                 eth1=192.168.1.100
                                |
                    +---------------------+
                    |                     |
             eth=192.168.1.1    eth=192.168.1.2
           00:25:9c:c9:59:98    00:25:9c:57:19:64
                   AP1                   AP2
              wlan                 wlan
           00:25:9c:c9:59:9b    00:25:9c:57:19:67 5GHz
           00:25:9c:c9:59:9a    00:25:9c:57:19:65 2.4GHz

The testsuite splited in 2 parts: client on Targer side and server on PC.
The client side listening for connection from the server. They communicate
by wired ethernet.

Supported APs: WRT54GL, WRT610n
}}}
Getting new source n build:
pushd /work/ti/nokia_testing/peripherals-wlan-tests
git pull
pushd ./peripherals-test-framework
dpkg-buildpackage -rfakeroot
Install server side:
popd && sudo /usr/bin/dpkg -i peripherals-test-autom-server_0.0.11_all.deb
to remove package
sudo /usr/bin/dpkg -r peripherals-test-autom-server
Add packages to client side:
pushd /work/zoom2/1271_nfs
dpkg -x ~/iptables_1.4.9-1_armel.deb .
dpkg -x ~/wireless-tools_30~pre9-3ubuntu4_armel.deb .
dpkg -x ~/libiw30_30~pre9-3ubuntu4_armel.deb .
Demands iw >= 0.9.20

Config kernel
Networking support->Network options->Network packet filtering framework->
        Core Netfilter Config->Netfilter Xtables support
Networking support->Network options->Network packet filtering framework->
        IP Netfilter Config-> *
Install client side: ???
make uImage modules -j10
cp ./arch/arm/boot/uImage /work/tftpboot/trio/
make modules_install INSTALL_MOD_PATH=${NFSROOT}

Running tests:
target -
    python /usr/share/peripherals-test-autom/dut.py -v
server -
    pushd /usr/share/peripherals-test-autom
    sudo /usr/bin/python host.py -v -d /usr/share/peripherals-test-autom/tests/WLAN_FuTe_RelSet -a 172.16.1.9 &

Getting testresults:
python /usr/bin/process_results.py /tmp/evil-wlan > /work/ti/nokia_testing/testrun-results-01sep2010.html

Status:
    1. Tests use `iwconfig' instead of `iw'. Are there plans to switch? Yes (Tuomas)

Open issues:
1. Unable to remove deb package (IT)
2. After new install, can't run tests (IT)
3. Unable to build client side (Tuomas)

}}}
007. Enable 802.11a on Zoom2 Trio external {{{
    17aug2010

TODO: check for support of 802a in mac802, operate it (scan), to understand the cmd flow

Assemble hw: {{{
external Adapter SDIO - PCB-038101
motherboard - PCB-036701
Trio 1273 board - PCB-033501

On motherboard LD4 (red) should be ON from the power on.
On motherboard LD5 (green) should be OFF always.

}}}
BringUp Zoom2 w/ external Trio (1273): {{{
git checkout 1271_func
git branch 1273_ext
git checkout 1273_ext

Change in arch/arm/mach-omap2/board-zoom-peripherals.c :
#define OMAP_ZOOM_WLAN_PMENA_GPIO (157)
.board_ref_clock = 1

config kernel to support 1271+sdio
make uImage modules -j10
cp ./arch/arm/boot/uImage /work/tftpboot/1273e/
make modules_install INSTALL_MOD_PATH=${NFSROOT}
}}}

add to wl1271.h
#define WL1271_80211A_ENABLED

in drivers/net/wireless/wl12xx/wl1271_main.c delete checking for NVS file size
line 572 :
if (fw->size != sizeof(struct wl1271_nvs_file) &&
        (fw->size != WL1271_INI_LEGACY_NVS_FILE_SIZE)) {

Status:
1. hardcoded macro WL1271_80211A_ENABLED in wl1271.h  - Done
2. The ChipID gives only 7 or 8 from 1271/1281. The 1 or 3 taken from INI file.
3. Sometimes not connected w/ errors:
wlan0 (phy #0): failed to connect, status: 1: Unspecified failure

Running testing {{{
On PC side:
iperf -s -i1    
On target side:
echo 8 > /proc/sys/kernel/printk
#mount -t debugfs none /sys/kernel/debug
mount -t debugfs debugfs /debug
insmod /lib/modules/`uname -r`/kernel/net/wireless/cfg80211.ko
insmod /lib/modules/`uname -r`/kernel/net/mac80211/mac80211.ko
insmod /lib/modules/`uname -r`/kernel/lib/crc7.ko
insmod /lib/modules/`uname -r`/kernel/drivers/base/firmware_class.ko
insmod /lib/modules/`uname -r`/kernel/drivers/net/wireless/wl12xx/wl1271.ko
insmod /lib/modules/`uname -r`/kernel/drivers/net/wireless/wl12xx/wl1271_sdio.ko
sleep 1
ifconfig wlan0 hw ether 00:22:33:90:64:31
ifconfig wlan0 up
iw wlan0 connect peripherals-conn-5ghz
dhclient wlan0 &
iperf -c 192.168.1.100 -i1
}}}

16sep2010
Send patch to switch support 11a by kernel config as experimental.
20sep2010
Send patch to community. NACKed by Luca, cause have runtime recognition.

}}}
008. Prepare P1 release {{{
        03oct2010

git clone git://git.kernel.org/pub/scm/linux/kernel/git/luca/wl12xx.git
copy .config from my wireless-testing
Added patches: pm_lenient_, sdio_runtime v2, 11n v1, pkt_aggregation v3,
        ba_initiator 
git apply --reject ./patches/sdio_runtime/v2/...
make uImage modules -j10
cp ./arch/arm/boot/uImage /work/tftpboot/1273e/
make modules_install INSTALL_MOD_PATH=${NFSROOT}

pushd /work/zoom2/1273e
tar cxf rootfs-06oct.tar.bz2 ./*

rebuild iw:
make CFLAGS=-DCONFIG_LIBNL20 LIBS=-lnl-genl NLLIBNAME=libnl-2.0

--- libnl
git clone git://git.kernel.org/pub/scm/libs/netlink/libnl.git
cd libnl
autogen.sh
./configure --prefix=/work/zoom2/1273e CC=arm-none-linux-gnueabi-gcc --host=arm-linux LD=arm-none-linux-gnueabi-ld
make && make install

--- iw
git clone http://git.sipsolutions.net/iw.git
make CC=arm-none-linux-gnueabi-gcc NLLIBNAME=libnl-2.0 CFLAGS="-DCONFIG_LIBNL20 -I/work/zoom2/nfsroot/include" LIBS="-lnl-genl -lnl -L/work/zoom2/nfsroot/lib" NL2FOUND=Y
make CC=arm-none-linux-gnueabi-gcc NLLIBNAME=libnl-2.0 CFLAGS="-DCONFIG_LIBNL20 -I/work/zoom2/nfsroot/include" LIBS="-lnl-genl -lnl -L/work/zoom2/nfsroot/lib" NL2FOUND=Y PREFIX=/work/zoom2/1273e/usr install

--- wpa_supplicant
git clone git://w1.fi/srv/git/hostap.git

Running w       pa_cli:
wpa_cli -p /var/run/wpa_supplicant -iwlan0 scan_results

The binaries placed at
g:\\wlan\mac802.11\driver\version_tree\p1-05oct2010\
boot\
        MLO, uboot, uImage
fs\
        rootfs-05oct2010.tar
Also added source archive at 
g:\\wlan\mac802.11\driver\version_tree\p1-05oct2010\source\wl12xx-06oct2010.tar.gz

STATUS: released p1-06oct2010 w/ mac802.11 tracing, chariot endpoint, dynamic debugging n set_nvs utility.
}}}
009. ref_clock cosmetic patch {{{
        05oct2010
commit changes
cd /work/ti/wl12xx && mkdir patches/misc
git format-patch -s -o patches/misc -1 --subject-prefix="PATCH"
scripts/checkpatch.pl patches/misc/*
git send-email --suppress-cc=self --suppress-cc=sob --annotate \
--from "Gery Kahn <geryk@ti.com>" --to "<linux-wireless@vger.kernel.org>" \
--cc "Luciano Coelho <luciano.coelho@nokia.com>" patches/misc/

The patch send. Send v2.

ACKed by Luca at 08oct2010

}}}
010. Tracing n dynamic debug {{{
        06oct2010

To enable event tracing for testing purposes.

http://wireless.kernel.org/en/developers/Documentation/mac80211/tracing

Tracing
make menuconfig
FUNCTION_TRACER=y
Kernel Hacking -> Tracers -> Kernel function tracer
MAC80211_DRIVER_API_TRACER=y
Network support -> Wireless -> Select mac80211 debugging features -> 
    Driver API tracer

How to use:
mkdir /debug
mount -t debugfs debugfs /debug
and run:
echo 1 > /debug/tracing/events/mac80211/enable
cat /debug/tracing/trace

Dynamic debug
make menuconfig
Kernel Hacking -> Enable dynamic printk() support

How to use:

}}}
011. Support P1 release {{{
        10oct10
1. Add mod param ref-clock
Added module param ref_clk
Added to debugfs: /debug/wl1271/ref_clk

2. Added option to read MAC from
/sys/class/ieee80211/phy1/macaddress
This is place for permanent MAC addr.

3. How to get FW statistics?
Found FW statistics in fw src/public_infoele.h which need to compare w/
driver code in _acx.h
There are nbr of stat groups:
Ring
Dbg
Tx
Rx
DMA
Isr
WEP
Pwr
Aes
Mic
Event
PsPoll
RxFilter
CalibrationFail
Gem

4. How to get driver statistics?
-

5. How to FW recovery by driver?
wl1271_recovery_work() (x_main.c)

6. Ability to config Single/Dual board

7. Ability to config Long/Short/Auto/Active PS

------------------------------------------
git format-patch -s -o patches/misc -1 --subject-prefix="PATCH"
scripts/checkpatch.pl patches/misc/*
git send-email --suppress-cc=self --suppress-cc=sob --annotate \
--from "Gery Kahn <geryk@ti.com>" --to "<mcs-mac80211@list.ti.com>" \
--cc "Luciano Coelho <luciano.coelho@nokia.com>" patches/fw_statistics
------------------------------------------

Status (11oct2010) - there 2 patches w/ 1,2,3 released for local mlist.
The 4,5,6,7 delayed w/ Ohad

}}}
012. Prepare release P1.1 {{{
        17oct2010
git checkout master
git branch rel-p1.1
git checkout rel-p1.1
Added patches: pm_lenient_, sdio_runtime v2, 11n v4, pkt_aggregation v3,
        ba_initiator v2, tx opts v3

git tag release-p1.1

}}}
013. bug #80228,80332 - BT-Coex {{{
        10oct2010

While Wl Rx there is problem in Bt Rx/Tx

Check if driver has SoftGemini?
There are default cfg params in _main.c
struct conf_drv_settings default_conf ...

NLPC code source {{{
wl1271_probe() (_sdio.c)
|-> ...
|-> wl1271_alloc_hw()
    |-> set sg_enabled = true
|-> ...

wl1271_op_add_interface()
|-> ...
|-> wl1271_hw_init()
    |-> ...
    |-> wl1271_init_pta()
        |-> wl1271_acx_sg_cfg() (_acx.c)
            |-> ...
            |-> ...
        |_> wl1271_acx_sg_enable() (_acx.c)
            |-> ...
            |-> wl1271_cmd_configure( ACX_SG_ENABLE )
            |-> ...
    |-> ...
|-> ...

wl1271_sysfs_store_bt_coex_state() (_main.c)

wl1271_sysfs_show_bt_coex_state() (_main.c)
}}}
WiLink source {{{
TWD_SetParam() (TWD/TWDriver/TWDriverCtrl.c)
case TWD_SG_CONFIG_PARAM_ID:    

The params are in TWD/FirmwareApi/public_infoele.h:

The begining cfg at platform/os/common/src/osRgstry.c

}}}

Gemini cfg params {{{
                                        WiLink  NLCP
Per threshold                           7500
HV3 max override                        0
NFS sample interval                     400
Load ratio                              50
Auto PS mode                            1
Auto scan prob-req                      170
Active scan duration factor HV3         50
Antenna config                          0
Beacon miss percent                     60
Rate adapt thres                        12
Rate adapt SNR                          0

WLAN_PS_BT_ACL_MASTER_MIN_BR            10
WLAN_PS_BT_ACL_MASTER_MAX_BR            30
WLAN_PS_MAX_BT_ACL_MASTER_BR            8
WLAN_PS_BT_ACL_SLAVE_MIN_BR             20
WLAN_PS_BT_ACL_SLAVE_MAX_BR             50
WLAN_PS_MAX_BT_ACL_SLAVE_BR             8
WLAN_PS_BT_ACL_MASTER_MIN_EDR           7
WLAN_PS_BT_ACL_MASTER_MAX_EDR           25
WLAN_PS_MAX_BT_ACL_MASTER_EDR           20
WLAN_PS_BT_ACL_SLAVE_MIN_EDR            8
WLAN_PS_BT_ACL_SLAVE_MAX_EDR            40
WLAN_PS_MAX_BT_ACL_SLAVE_EDR            20

RXT                                     1200
TXT                                     1000
ADAPTIVE_RXT_TXT                        1
PS_POLL_TIMEOUT                         10
UPSD_TIMEOUT                            10
WLAN_ACTIVE_BT_ACL_MASTER_MIN_EDR       7
WLAN_ACTIVE_BT_ACL_MASTER_MAX_EDR       15
WLAN_ACTIVE_MAX_BT_ACL_MASTER_EDR
WLAN_ACTIVE_BT_ACL_SLAVE_MIN_EDR
WLAN_ACTIVE_BT_ACL_SLAVE_MAX_EDR
WLAN_ACTIVE_MAX_BT_ACL_SLAVE_EDR
WLAN_ACTIVE_BT_ACL_MIN_BR
WLAN_ACTIVE_BT_ACL_MAX_BR
WLAN_ACTIVE_MAX_BT_ACL_BR

PASSIVE_SCAN_DURATION_FACTOR_HV3
PASSIVE_SCAN_DURATION_FACTOR_A2DP
PASSIVE_SCAN_BT_TIME
PASSIVE_SCAN_WLAN_TIME
HV3_MAX_SERVED
DHCP_TIME
Active scan duration factor A2DP        100
TEMP_PARAM_1
TEMP_PARAM_2
TEMP_PARAM_3
TEMP_PARAM_4
TEMP_PARAM_5

}}}

Status:
16oct2010 moved to firmware
}}}
014. Create PLT utility {{{
        20sep2010 17oct2010 

Create utility provides ability for procedures TxBip (calibration) and TxCont.
In addition, ability to create full NVS (NVS + INI) file and option to read
the original INI file from WiLink prj.

Symbian calibration {{{
from ClearCase WiLink6.1_DR_0_Symbian

PltSm() from platforms/os/s60/WVSS/src/wha/TIWha.cpp
Look for macro PLT_TESTER

TIWha::Scan()
#ifdef PLT_TESTER
|-> PltSm(NULL)
|   |-> TIWha::PltSm()
#endif

TEST_CMD_CHANNEL_TUNE w/ channel 7, band 0
TEST_CMD_RX_STAT_RESET
TEST_CMD_RX_STAT_START
TEST_CMD_RX_STAT_GET
TEST_CMD_RX_STAT_STOP
TEST_CMD_FCC
TEST_CMD_STOP_TX
TEST_CMD_TELEC
TEST_CMD_STOP_TX
TEST_CMD_UPDATE_PD_REFERENCE_POINT
TEST_CMD_P2G_CAL
POWER_SAVE_802_11_SUCCESS
}}}
WiLink calibration {{{
        The ioctl SIOCIWFIRSTPRIV comes.
cmdInterpret_convertAndExecute() (platforms/os/linux/src/CmdInterpretWext.c)

generic callback for WEXT cmds
wlanDrvWext_Handler() (platforms/os/linux/src/WlanDrvWext.c)
|-> ...
|-> load INI file
|   wlanDrvIf_LoadFiles()
|-> ...

drvMain_SetDefaults() (stad/src/Ctrl_Interface/DrvMain.c)
|-> osInitTable_IniFile() (platforms/os/linux/src/osRgstry_parser.c)
|   |-> ...
|   |-> regFillInitTable() (platforms/os/common/src/osRgstry.c)
|   |-> ...
|-> TWD_SetDefaults() (TWD/TWDriver/TWDriver.c)
}}}
set_nvs {{{
Utility updates NVS file, show SW/FW/HW versions
WL1271_TM_CMD_NVS_PUSH

Current NVS+INI file has only 2.4GHz. Need to add 2nd band (5GHz).

There is prj called generate_fw which produces 2 files (fw n nvs+ini):
wl1271-fw.bin wl1271-nvs.bin
Open wilink6_nvs.h n add 5GHz params in sections 

set_nvs phy0 set nvs /lib/firmware/wl1271-nvs.bin

set_nvs phy0 set calib tx

build:
make LIBNL=/work/zoom2/1273e CROSS_COMPILE=arm-none-linux-gnueabi-
}}}
Build wlan_cu from WiLink prj {{{
        17oct2010
Download WiLink from MCP_2.x_1

p1273
pushd <WiLink>/CUDK/
make TI_HOST_OS=ANDROID NLCP_SUPPORT=y STATIC_LIB=n BUILD_SUPPL=n

pushd <WiLink>/CUDK/configurationutility
make TI_SUPP_LIB_DIR=wpa_suppl/wpa_supplicant TI_HOST_OS=ANDROID NLCP_SUPPORT=y STATIC_LIB=n BUILD_SUPPL=n
}}}
WiLink cfg utility (wlan_cu) - TxBip {{{

MAC address from /sys/class/net/wlan0/address

--- Get Device status
Console_GetDeviceStatus() (CUDK/configurationutility/src/console.c)
|-> CuCmd_GetDeviceStatus() (CUDK/configurationutility/src/cu_cmd.c)
    |-> CuCommon_GetU32(... , DRIVER_STATUS_PARAM, ...)
        |-> IPC_STA_Private_Send()

--- Set power save mode
CUDK/configurationutility/src/ticon.c
TiCon_Init_Console_Menu()
|-> Console_AddToken(...,"set_Power_mode", CuCmd_SetPowerMode, ...)
    |-> CuCmd_SetPowerMode() (CUDK/configurationutility/src/cu_cmd.c)
        |-> CuCommon_SetBuffer( ..., TIWLN_802_11_POWER_MODE_SET, ...)
            |   CUDK/configurationutility/src/cu_common.c
            |-> IPC_STA_Private_Send()

The flow of Tx Bip procedure for single band:

TiCon_Init_Console_Menu() (CUDK/configurationutility/src/ticon.c)
|-> Console_Start() (CUDK/configurationutility/src/console.c)
    |-> Console_ParseString()

TEST_CMD_CHANNEL_TUNE ( / t r h 0 7 )
CuCmd_RadioDebug_ChannelTune() (CUDK/configurationutility/src/cu_cmd.c)
|-> Check if power mode is active:
|   CuCommon_GetBuffer(..., TIWLN_802_11_POWER_MODE_GET, ...)
|-> CuCommon_Radio_Test()

TEST_CMD_UPDATE_PD_REFERENCE_POINT ( / t b b 375 128 0 )
CuCmd_BIP_BufferCalReferencePoint() (CUDK/configurationutility/src/cu_cmd.c)
|-> CuCommon_Radio_Test()

TEST_CMD_P2G_CAL ( / t b t 1 0 0 0 0 0 0 0 )
CuCmd_BIP_StartBIP()


struct wl1271_cmd_cal_channel_tune          struct TTestCmd
    struct wl1271_cmd_header header;          TestCmdID_e testCmdId;
        __le16 id;                              int8 padding[3];
        __le16 status;                          union testCmd_u
        u8 data[0];                               TTestCmdChannel Channel;
    struct wl1271_cmd_test_header test;             uint8 iBand;
        u8 id;                                      uint8 iChannel;
        u8 padding[3];                              int16 oRadioStatus;
    u8 band;                                      TTestCmdP2GCal P2GCal
    u8 channel;                                     uint32 oNVSVersion;
    __le16 radio_status;                            TNvsStruct oNvsStruct;
struct wl1271_cmd_cal_update_ref_point                uint16 Length;
    struct wl1271_cmd_header header;                  uint8 Buffer[MAX_TLV_LENGTH];
    struct wl1271_cmd_test_header test;               uint8 Type;
    __le32 ref_power;                                 uint8 padding;
    __le32 ref_detector;                            int16 oRadioStatus;
    u8  sub_band;                                   uint8 iSubBandMask;
    u8  padding[3];                                 uint8 Padding;

struct wl1271_cmd_cal_p2g
    struct wl1271_cmd_header header;    
        __le16 id;                      
        __le16 status;                  
        u8 data[0];                     
    struct wl1271_cmd_test_header test; 
        u8 id;                          
        u8 padding[3];                  
    __le16 len;
    u8  buf[MAX_TLV_LENGTH];
    u8  type;
    __le16 radio_status;
    u8  nvs_version[MAX_NVS_VERSION_LENGTH];
    u8  sub_band_mask;
    u8  padding2;
}}}
WiLink cfg utility (wlan_cu) - TxCont {{{

MAC address from /sys/class/net/wlan0/address

--- Get Device status
Console_GetDeviceStatus() (CUDK/configurationutility/src/console.c)
|-> CuCmd_GetDeviceStatus() (CUDK/configurationutility/src/cu_cmd.c)
    |-> CuCommon_GetU32(... , DRIVER_STATUS_PARAM, ...)
        |-> IPC_STA_Private_Send()

TEST_CMD_CHANNEL_TUNE ( / t r h 0 7 )

--- Start Tx continues test (FCC)
TEST_CMD_FCC ( / t r t n 2000 1 100 0 5000 0 3 0 0 0 0 0 1 0 11:22:33:44:55:66 )
delay rate size amount power seed pkt_mode dcf gi preamble type 
                                        scrambler clpc seq_nbr_mode mac
CUDK/configurationutility/src/ticon.c
TiCon_Init_Console_Menu()
|-> Console_AddToken(...,"coNtinues", CuCmd_RadioDebug_StartContinuousTx, ...)
    |-> CuCmd_RadioDebug_StartContinuousTx() 
    |   (CUDK/configurationutility/src/cu_cmd.c)
        |-> read MAC address
        |-> CuCommon_Radio_Test() () - TEST_CMD_FCC
            |-> IPC_STA_Private_Send(..., TWD_RADIO_TEST_PARAM, ...)

--- Stop Tx continues test (FCC)
TEST_CMD_STOP_TX ( / t r t s )


#define MAC_ADDR_LEN  6

struct wl1271_cmd_pkt_params {
        struct wl1271_cmd_header header;

        struct wl1271_cmd_test_header test;

        __le16 radio_status;
        u8 padding[2];
        __le32 delay;
        __le32 rate;
        __le16 size;
        __le16 amount;
        __le32 power;
        __le16 seed;
        u8 pkt_mode;
        u8 dcf_enable;
        u8 g_interval;
        u8 preamble;
        u8 type;
        u8 scramble;
        u8 clpc_enable;
        u8 seq_nbr_mode;
        u8 src_mac[MAC_ADDR_LEN];
        u8 dst_mac[MAC_ADDR_LEN];
} __attribute__((packed));

}}}

Status:

17oct2010
by Ohad to start converting wlan_cu from WiLink prj.
18oct2010
done wlan_cu build of native WiLink prj
27oct2010
found in commit ab2807efcfd2dd646a2ca8d71585e26cda3fc0c1 from 08jul2010 funcs:
static int wl1271_cmd_cal_channel_tune(struct wl1271 *wl)
static int wl1271_cmd_cal_update_ref_point(struct wl1271 *wl)
static int wl1271_cmd_cal_p2g(struct wl1271 *wl)
static int wl1271_cmd_cal(struct wl1271 *wl)
28oct2010
Compilation: 
  1. incompatible pointer type - Done
Code flows:
  1. TEST_CMD_CHANNEL_TUNE - TODO check if active before send cmd
03nov2010
  There is NVS file after TxBip w/o INI part
  Create patch of changes in struct wl1271_cmd_cal_p2g n send to local mailing list
04nov2010
  After further discussion w/ Luca new patch created to remove all unused structures from wl1271_cmd.h
}}}
Support SeaRay - NB72 from CCI {{{
        21oct2010
by Lior Shapira:
The CCI is Taiwan company builds platform for Nokia, based on Qualcomm board 
w/ 1271, single band, TQS. Using MeeGo product.

Status:
21oct2010
        Sangi Shi does upgrade from 2.6.32 to 2.6.35. Wants full kernel src. 
Needs PLT utility till 27oct2010. Send him NVS binary for single.
24oct2010
        Send email to Sangi about Luca's git
01nov2010
        Send PLT utility in current status to Sangi. Accepted as successful.
03nov2010
        Send whole src package of PLT to Yuval.
}}}
015. BringUp Beagleboard + wl1271 {{{

There is daughter card BeagleToy with
1271 TQS S 2.6, PG 2.6

Prepare serial cable {{{

The 1 is red line

1  3  5  7  9
 2  4  6  8

db9 connector           10pin connector
1                       1
2                       6                       
3                       2
4                       7
5                       3
6                       8
7                       4
8                       9
9                       5
}}}

Kernel patch:
./patches/beagleboard/\[PATCH\]\ omap\ \ beagle\ \ add\ support\ for\ wl1271\ on\ the\ board\ file.eml

Uboot env:
console=ttyO2,115200n8

Change in /etc/inittab


Got patch and .config

make distclean
make omap2plus_defconfig (from 2.6.37-rcX)
make menuconfig
make uImage

Rootfs (Ubuntu 10.04)
wget http://rcn-ee.net/deb/rootfs/lucid/ubuntu-10.04.1-r2-minimal-armel.tar.7z
sudo apt-get install p7zip-full 
7za x ubuntu-10.04.1-r2-minimal-armel.tar.7z
tar xf ubuntu-10.04.1-r2-minimal-armel.tar
cd ubuntu-10.04.1-r2-minimal-armel
./setup_sdcard.sh --mmc /dev/sdX --uboot beagle --swap_file 100 --use-default-user

Apply patch from Ido
cp arch/arm/configs/omap2plus_defconfig .config
Config kernel:
REGULATOR_FIXED_VOLTAGE=y
NL80211_TESTMODE=y
WL12XX_MENU=y
CRYPTO_ECB=y
CRYPTO_ARC4=y

}}}
016. Error msgs w/ new NVS file {{{
        07nov2010
There is error message after loading NVS.
wl1271: ERROR Unsupported RX rate from HW: 20 - band (1)
Not happened if NVS Radio params is all 0.

Scanning {{{
struct wl1271_cmd_scan
  struct wl1271_cmd_header
    __le16 id                                   2
    __le16 status                               2
    u8 data[0]                                    -------------- 4
  struct basic_scan_params
    __le32 rx_config_options                    4
    __le32 rx_filter_options                    4
    __le16 scan_options                         2
    u8 n_ch                                     1
    u8 n_probe_reqs                             1
    __le32 tx_rate                              4
    u8 tid_trigger                              1
    u8 ssid_len                                 1
    u8 padding1[2]                              2
    u8 ssid[IW_ESSID_MAX_SIZE]                  32
    u8 band                                     1
    u8 use_ssid_list                            1
    u8 scan_tag                                 1
    u8 padding2                                 1 _____ 56 ----- 60
  struct basic_scan_channel_params
    __le32 min_duration                         4
    __le32 max_duration                         4
    __le32 bssid_lsb                            4
    __le16 bssid_msb                            2
    u8 early_termination                        1
    u8 tx_power_att                             1
    u8 channel                                  1
    u8 dfs_candidate                            1
    u8 activity_detected                        1
    u8 pad                                      1 _____ 20 ----- 80
}}}
Where from error comes? {{{
wl1271_rx()
|-> wl1271_rx_handle_data() (_fx.c)
    |-> wl1271_rx_status() (_rx.c)
        |-> wl1271_rate_to_idx() (_main.c)
}}}
Where from the structure of rates per band gets info? {{{
static const u8 *wl1271_band_rate_to_idx (_main.c)
}}}
struct wl1271_nvs_file (drivers/net/wireless/wl12xx/wl1271_ini.h) {{{
  nvs                                           468B
  struct wl1271_ini_general_params
    u8 ref_clock                                1
    u8 settling_time                            1
    u8 clk_valid_on_wakeup                      1
    u8 dc2dc_mode                               1
    u8 dual_mode_select                         1
    u8 tx_bip_fem_auto_detect                   1
    u8 tx_bip_fem_manufacturer                  1
    u8 general_settings                         1
    u8 sr_state                                 1
    u8 srf1                                     16
    u8 srf2                                     16
    u8 srf3                                     16
  padding                                       1
  struct wl1271_ini_band_params_2
  padding                                       1
  struct wl1271_ini_fem_params_2
  padding
  struct wl1271_ini_fem_params_2
  padding
  struct wl1271_ini_band_params_5
    u8 rx_trace_insertion_loss                  7
    u8 tx_trace_loss                            7
    u8 rx_rssi_process_compens                  15
  padding
  struct wl1271_ini_fem_params_5
    __le16 tx_bip_ref_pd_voltage                14
    u8 tx_bip_ref_power                         7
    u8 tx_bip_ref_offset                        7
    u8 tx_per_rate_pwr_limits_normal            6
    u8 tx_per_rate_pwr_limits_degraded          6
    u8 tx_per_rate_pwr_limits_extreme           6
    u8 tx_per_chan_pwr_limits_ofdm              35
    u8 tx_pd_vs_rate_offsets                    6
    u8 tx_ibias                                 6
    u8 rx_fem_insertion_loss                    7
    u8 degraded_low_to_normal_thr               1
    u8 normal_to_degraded_high_thr              1
  padding
  struct wl1271_ini_fem_params_5
  padding
}}}

Status:
        09nov2010
The scan which done for all 11a range, included Japan channels 183,187,7
The packets arrived as results came with default rate of 2Mb, but it should be
6Mb (11a is OFDM and min rate is 6Mb). Such rate for the 11a non-supported.
Next steps:
1. Need sniffer for Japan in order to get those packets w/ 2Mb and see them
2. May be is there bug, why to scan Japan region at all? Should be registration
w/ CRDA.
Freezed by Ohad decision.
}}}
017. Fix support for 11a {{{
        01dec2010
Checking Luca's git from 28nov2010, the 11a doesn't work.
After the Luca's patch 573c67cf819d52d2e12adf75a9a8cfbd216190a3 there is
wl1271_reg_notifier() which disables channels based on regulatory domain.
Such check happened before the drv gets dual_band flag from NVS.

Status:
        02dec2010 Luca getting into the issue
        03dec2010 by Luca: disable 11a channels when wl->enable_11a is known
}}}
80336 {{{

192.168.1.1 b/g/n 00:25:9c:c9:59:9a
192.168.1.2 n     00:25:9c:57:19:66

test power off, n->g
Took 3sec to reassoc

test power off, g->n

test power off, n->g (w/o fast_reauth)

test power off, n->g (w/o ap_scan, fast_reauth)

Closed.
}}}
80809 {{{
Low RSSI trigget not exists

Bug in Developed state.

Ask Ruthy.
}}}
80766 {{{
RSSI doesn't update.
}}}
018. Build L23 (Poky) {{{
        20dec2010 (3 hrs)
Open account in dirac.dal.design.ti.com
login and run
mkview_linked omapsw_a0387671_test
output {{{
mkview -tag omapsw_a0387671_test -tcomment 'Created by mkview_linked at Mon Dec 20 12:19:53 2010.' -host wtsdccase01.dal.design.ti.com -hpath /clearcase/vw311/a0387671/omapsw/omapsw_a0387671_test.vws -gpath /clearcase/vw311/a0387671/omapsw/omapsw_a0387671_test.vws /clearcase/vw311/a0387671/omapsw/omapsw_a0387671_test.vws
cleartool: Warning: Storage pathname "/clearcase/vw311/a0387671/omapsw" may not reside on host "wtsdccase01.dal.design.ti.com".
Created view.
Host-local path: wtsdccase01.dal.design.ti.com:/clearcase/vw311/a0387671/omapsw/omapsw_a0387671_test.vws
Global path:     /clearcase/vw311/a0387671/omapsw/omapsw_a0387671_test.vws
It has the following rights:
User : a0387671 : rwx
Group: generic  : r-x
Other:          : r-x
}}}
Where is cleartool? /usr/atria/bin/cleartool
run `../meta-texasinstruments/scripts/ccfetch-installer.sh'
output {{{
Installing v2.1.4 ccfetch scripts

But first, I have a couple questions:
  Enter local bin directory (must be in $PATH): [/home/a0387671/bin] 
  Enter remote hostname: [dirac.dal.design.ti.com] 
  Enter remote username: [a0387671] 
  Enter remote viewname: [omapsw_a0387671_poky_temp] omapsw_a0387671_test
  Enter remote home directory path: [/home/a0387671] 
  Enter remote bin directory (must be in $PATH on dirac.dal.design.ti.com): [/home/a0387671/bin] 
  Enter path to cleartool: [] /usr/atria/bin/cleartool
Ok, I've got:
  local bin directory   : /home/a0387671/bin
  remote hostname       : dirac.dal.design.ti.com
  remote username       : a0387671
  remote viewname       : omapsw_a0387671_test
  remote home directory : /home/a0387671
  remote bin directory  : /home/a0387671/bin
  path to cleartool     : /usr/atria/bin/cleartool
Is this correct?
  Y/N> Y
Found identity id_rsa.. should I use this?  (Only say 'Y'es if it has an empty passphrase)
  Y/N> Y
Using existing identity id_rsa

Now I will copy your public key to dirac.dal.design.ti.com.  Enter password for a0387671@dirac.dal.design.ti.com
if prompted:
a0387671@dirac.dal.design.ti.com's password: 
a0387671@dirac.dal.design.ti.com's password: 
a0387671@dirac.dal.design.ti.com's password: 


And now finally, I have some files to install:
 * installing cfetchcc-get.sh
 * installing cfetchdirac.sh
 * generating cfetchcc.conf
 * installing sfetchcc-get.sh remotely
sfetchcc-get.sh                                                                                      100% 4088     4.0KB/s   00:00    
 * installing sfetchcc-mktar.sh remotely
sfetchcc-mktar.sh                                                                                    100% 1151     1.1KB/s   00:00    
 * generating sfetchcc.conf remotely
sfetchcc.conf                                                                                        100% 1262     1.2KB/s   00:00    
Done!
}}}

bitbake -a omap-image-sato 2>&1 | tee omap-image-sato.log

bitbake -a omap-image-minimal 2>&1 | tee omap-image-minimal.log

}}}
019. Recreate PLT utility {{{
        17nov2010
Make PLT utility as standalone, open source tool w/ follow capabilities:
TxBip, TxCont, Rx??? , create NVS w/ Radio param section, reading INI file.

--- TxBip
set_nvs wlan0 plt power_mode <on|off>
set_nvs wlan0 plt tune_channel <band> <channel>
set_nvs wlan0 plt ref_point <voltage> <power> <subband>
set_nvs wlan0 plt calibrate <0|1> * 8

--- TxCont
set_nvs wlan0 plt tune_channel <band> <channel>
set_nvs wlan0 plt tx_cont <delay> <rate> <size> <amount> <power> <seed> \
<pkt mode> <DC on/off> <gi> <preamble> <type> <scramble> <clpc> \
<seq nbr mode> <mac>
( 2000 1 100 0 5000 0 3 0 0 0 0 0 1 0 00:22:33:90:64:31 )
set_nvs wlan0 plt tx_stop

--- RxStat
set_nvs wlan0 plt start_rx_statcs
set_nvs wlan0 plt stop_rx_statcs
set_nvs wlan0 plt reset_rx_statcs
set_nvs wlan0 plt get_rx_statcs

TODO:
- 1. To cancel dependency on the previous NVS file while producing new one
        Currently dependency comming from drv
x 2. Fix src_mac in TxCont  - FW not uses src_mac parameter, but takes MAC
        from 0x305470 - 0x30546c
x 3. Fix AveSNR n AveRSSI in RxStatcs
- 4. Add license - waiting for Oz
x 5. To make RxStat procedure in short way also
  6. Make the utility to read INI file in order to change radio parameters
x 7. Add to README:
        Kernel cfg NL80211_TESTMODE=y
        How to compile
x 8. Run `scripts/checkpatch.pl  -f ' on source
x 9. Send the utility like patches to TI's mlist (06dec2010)
        /work/prjs/scripts/git/add_prj.sh
        mkdir patches
        git format-patch -s -o patches/ -12 --subject-prefix="PATCH" --cover-letter
        git send-email --suppress-cc=self --suppress-cc=sob --annotate --from "Gery Kahn <geryk@ti.com>" --to "<mcs-mac80211@list.ti.com>" ./patches/
        Add to the subject:
                Release of TI's PLT utility based on driver wl12xx
        Add after subject:
        This is release of TI's PLT utility provides solutions for production
        procedures, like create NVS file, get Rx statistics, etc.
        Read README file for the full functionality list,
        how to build the utility and how to use it.
}}}
020. Calibrator INI files {{{
        26dec2010

  a. Same NVS+INI for MCP2.5 and M6?
  b. Same NVS+INI for AP and STA?
  c. Same NVS+INI for 127x n 128x?

--- AP (fw M6)
from \\dilfs14\wlan\WLAN\WiLink 6.2 AP\Firmware\Version_Tree\FW_6.2.0.0.XX
under FW_6.2.0.0.36_EFUSE_PG3.31_REMOVE

INI files WL6 - those are files for trio
RFMD_S_3.5.ini
TQS_D_1.0.ini
TQS_D_1.7.ini
TQS_S_2.5.ini
TQS_S_2.6.ini
INI files WL7 - those are files for quattro
RFMD_S_3.5.ini
TQS_D_1.0.ini
TQS_D_1.7.ini
TQS_S_2.5.ini
TQS_S_2.6.ini

--- STA (fw M6)
from \\dilfs14\wlan\WLAN\WiLink_6.0\Firmware\Version_Tree\FW_6.1.0.XX
under FW_6.1.0.XX\FW_6.1.0.0.343_xxxx
INI files WL6 - those are files for trio
RFMD_S_3.5.ini
TQS_D_1.0.ini
TQS_D_1.7.ini
TQS_S_2.5.ini
TQS_S_2.6.ini

--- STA (fw MCP2.5)
from \\dilfs14\wlan\WLAN\MCP 2.x\Firmware\Version_Tree\FW_7.1.2.0.XX
under FW_7.1.2.0.32_PG_IDENTIFICATION

INI files WL6 - those are files for trio
RFMD_S_3.5.ini
TQS_D_1.0.ini
TQS_D_1.7.ini
TQS_S_2.5.ini
TQS_S_2.6.ini
INI files WL7 - those are files for quattro
RFMD_S_3.5.ini
TQS_D_1.0.ini
TQS_D_1.7.ini
TQS_S_2.5.ini
TQS_S_2.6.ini

Currently delivered 2 firmware binaries: 6.1.0.0.343 and 6.2.0.0.30

Put all ini files in calibrator project:
ini_files\
        access_point\ - files from 6.2.0.0.31 (trio only)
        station\ - files from 6.1.0.0.343 (trio only)
        development - files from 7.1.2.0.32 (both trio and quattro)

Delivered 26dec2010

}}}
021. BringUp BeagleBoard {{{
        09jan2010
flow w building MLO n uboot doesn't work {{{
http://code.google.com/p/beagleboard/wiki/BeagleSoftCompile

git clone http://git.gitorious.org/beagleboard-validation/x-load.git
cd x-load
Make sure in include/configs/omap3530beagle.h
 #define CONFIG_MMC      1
make CROSS_COMPILE=arm-none-linux-gnueabi- distclean
make CROSS_COMPILE=arm-none-linux-gnueabi- omap3530beagle_config
make CROSS_COMPILE=arm-none-linux-gnueabi-
Created file x-load.bin rename to MLO

git clone http://git.gitorious.org/beagleboard-validation/u-boot.git
cd u-boot
Make sure in include/configs/omap3_beagle.h :
#define CONFIG_BOOTCOMMAND "\0"
make CROSS_COMPILE=arm-none-linux-gnueabi- distclean
make CROSS_COMPILE=arm-none-linux-gnueabi- omap3_beagle_config
make CROSS_COMPILE=arm-none-linux-gnueabi-
}}}

download MLO n u-boot.bin from:
http://www.angstrom-distribution.org/demo/beagleboard/

1. Add patch
2. copy bb config
3. compile kernel

--- Change u-boot env:
console=ttyO2,115200n8

12jan2011
Created project at http://git.gitorious.org/beagletoy/beagletoy.git
w/ MLO, uboot, kernel, rootfs, Luca's patches and REAME.
13jan2011
The GIT removed due to legal issues and everything placed at
\\dilfs14\wlan\WLAN\NLCP\...
}}}
022. Overclocking Zoom3 to 1GHz {{{
        12 - 13jan2011
from Documentation/cpu-freq/user-guide.txt
and Documentation/arm/OMAP/omap_pm
--- Kernel config
CONFIG_CPU_FREQ
CONFIG_CPU_FREQ_DEBUG
CONFIG_CPU_FREQ_STAT
CONFIG_CPU_FREQ_STAT_DETAILS
CONFIG_CPU_FREQ_GOV_POWERSAVE
CONFIG_CPU_FREQ_GOV_USERSPACE   
CONFIG_CPU_FREQ_GOV_ONDEMAND
CONFIG_CPU_FREQ_GOV_CONSERVATIVE
CONFIG_CPU_IDLE

CONFIG_PM_ADVANCED_DEBUG

from OMAP ml found Thara Gopinath which delivered DVFS
git clone git://dev.omapzoom.org/pub/scm/thara/omap-dvfs.git

To get omap-dvfs git branch pm-dvfs to my branch pm-dvfs:
git checkout -b pm-dvfs
git reset --hard master (where master is the branch from wl12xx that you want to use)
git remote add omap-dvfs git://dev.omapzoom.org/pub/scm/thara/omap-dvfs.git
git fetch omap-dvfs
git pull omap-dvfs pm-dvfs

To get git omap-dvfs branch pm-improved-dvfs to my branch pm-dvfs:
git pull omap-dvfs pm-improved-dvfs

If there is error:
 error: Untracked working tree file
Do
 git clean -f -d

--- To remove suspend/resume prints
CONFIG_PM_DEBUG
--- To stop suspend/resume availability
CONFIG_SUSPEND

change in arch/arm/mach-omap2/opp3xxx_data.c

/sys/devices/system/cpu/cpu0/cpufreq/

16jan2011 Send as patch to mcs ml.
17jan2011 - Rebuild version based on 
  wl12xx a70937e03fe5e7e6478500426a03677dd25262b1 with 
  DVFS, mcp2.5, 11n, quattro
}}}
023. Make different builds for TCP Rx TP {{{
        23-25jan2011
--- Build w/o PM
Change manualy at .config
CONFIG_PM_RUNTIME is not set

--- Build w/ mcp2.5 DVFS 11n Quattro win_size
for 26MHz and 38.4MHz

--- Build w/ mcp2.5 DVFS 11n Quattro win_size
for 26MHz and 38.4MHz

}}}
024. PLT to support mcp2.5 n Quattro {{{
        18jan2011

1. Fixed bugs
2. Support mcp 2.5

tune_channel 0 7
tx_cont 2000 1 100 0 5000 0 3 0 0 0 0 0 1 0 08:00:28:90:64:31
tx_stop

power_mode <on|off>
tune_channel <band> <channel>
calibrate <0|1> * 8

                        NVS     ini
Create reference         -       +
Calibrate                ?       -
Update NVS               +       +

create_nvs_file()
|-> nvs_fill_nvs_part()
|-> nvs_fill_radio_prms


19jan2011
Open fw bug 86495 for TxCont, fw bug 86517 for RxStat, updated README,
fix buffer size bug, add dump in INI parsing
Send NVS mcp2.5 files to Yaki - waiting for answer

24jan2011
bug 86495 - Shahar P. found that driver doesn't send cmd ACX_MEM_CFG
Found that we doesn't send this cmd. The start of PLT differs from normal
start. Check needed.

26jan Sent patch to local ml
git commit drivers/net/wireless/wl12xx/main.c -m "wl12xx: Fixes pl..."
./scripts/checkpatch.pl ./patches/plt/0001-wl12xx-Fixes-plt-initialization-according-FW-boot-pr.patch
git send-email --suppress-cc=self --suppress-cc=sob --from "Gery Kahn <geryk@ti.com>" --to "<mcs-mac80211@list.ti.com>" patches/plt/0001-wl12xx-Fixes-plt-initialization-acc..

2011-01-31
Release calibrator for MCP2.5
Stop working on Quattro support till Quattro will be supported.
}}}
025. Prepare build for Beagleboard mcp2.5 for sanity {{{
        2011-02-06

git clone git://gitorious.org/beagleboard-validation/scripts.git

--- u-boot
git clone git://git.denx.de/u-boot.git
pushd u-boot
git remote add beagleboard-validation git://gitorious.org/beagleboard-validation/u-boot.git
git remote update
git checkout -b koen-beagle-2010.12 beagleboard-validation/koen/beagle-2010.12
p1273e
make omap3_beagle_config
make

Rebuild libnl, iw, wpa_supplicant, openssl-1

Kernel added: mcp2.5v3, bb, performance series of 2011-02-07

- Sent version to Ilanit for sanity

Apply
a5624323866c06156ca548b8515d9347fdd5188e
bd36cc573efb4cef09daadd7668b430bfda9f2af
02301aa68d8da4fc37ff69afe53083e8ce97fe4c
c3b2ae4726e8d0b7a787f70b538aa2ec636c35d0
5611308de1f0d465fbfca41732b81681b6fe599c

The 1GHz for BeagleBoard based on
http://dominion.thruhere.net/git/cgit.cgi/linux-omap/log/?h=koen/beagle-next
git pull omap-dvfs pm-improved-dvfs
#apply ./patches/dvfs/5d40d42330547a6ef04bab224bcaaca21c79df39.patch
#apply ./patches/dvfs/701930fa4f63e9838b367eca5ff8d8ed49ef1cb6.patch

}}}
026. Calibrator for Quattro (1283) {{{
        2011-02-07
Based on Shahar's patches from 2011-02-06

Fixes in calibrator INI parser.

2011-02-09
Sent build for Ilanit to test.

issues
1. To check why to copy 5GHz params if no support for 11a
        wl128x_cmd_radio_parms() (cmd.c)
2. To check order of plt init
}}}
027. Build sanity test for Quattro {{{
        2011-02-13

wl12xx tag wl12xx-2011-02-08
Apply performance patches (Ido patches/performance/2011-02-13)
Add Quattro patches (Shahar 2011-02-08)
Add PLT patch 

}}}
028. Build R3 for Beagleboard {{{
        2011-02-14
Apply performance patches (Ido patches/performance/2011-02-13)
Add Quattro patches (Shahar 2011-02-08) + fix from Arik
Add PLT patch 
Revert AutoARP
Align-chip-interrupt-pacing-setting
Stop BA event


Add Ido's Fix kernel panic in Tx
Add AP patches

http://dominion.thruhere.net/git/cgit.cgi/linux-omap/?h=koen/beagle-next-wip
git://dominion.thruhere.net/var/cache/git/linux-omap.git

The flow of release:

git checkout -b wl12xx-2011-02-08-R3-bb
git remote add koen-omap git://dominion.thruhere.net/var/cache/git/linux-omap.git
git fetch koen-omap
Create branch to track koen-omap/koen/beagle-next
git branch koen-omap-fork koen-omap/koen/beagle-next
git checkout koen-omap-fork
git format-patch -s -o ./patches/beagleboard/koen.kooi/ 52aefa299da0c025c4e521f2a40a89c01aad5a17..e3948bda11a3a0d938500ffbc7ef43603909cc15
git apply --reject ./patches/beagleboard/koen.kooi/
        0004-omap-Beagle-detect-new-xM
        0005-ARM-OMAP-beagleboard-Add-infrastructure-to-do-fixups.patch
        0006-ARM-OMAP-beagleboard-pre-export-GPIOs-to-userspace-w.patch
        0007-modedb.c-add-proper-720p60-mode.patch
        0008-mmc-don-t-display-single-block-read-console-messages.patch
        0009-MTD-silence-ecc-errors-on-mtdblock0.patch
        0011-ARM-OMAP-add-omap_rev_-macros.patch
        0012-OMAP-DSS2-enable-hsclk-in-dsi_pll_init-for-OMAP36XX.patch
        0013-omap3-beagleboard-add-WIP-support-for-beagleboardtoy.patch
        0014-drivers-net-smsc911x-return-ENODEV-if-device-is-not-.patch
        0015-drivers-input-touchscreen-ads7846-return-ENODEV-if-d.patch
        0016-ASoC-enable-audio-capture-by-default-for-twl4030.patch
        0017-MFD-enable-madc-clock.patch
        0018-MFD-add-twl4030-madc-driver.patch
        0019-ARM-OMAP-Add-twl4030-madc-support-to-Overo.patch
        0020-ARM-OMAP-Add-twl4030-madc-support-to-Beagle.patch
        0021-OMAP-DSS2-Add-support-for-Samsung-LTE430WQ-F0C-panel.patch
        0022-OMAP-DSS2-Add-support-for-LG-Philips-LB035Q02-panel.patch
        0023-OMAP-DSS2-add-bootarg-for-selecting-svideo-or-compos.patch
        0024-ARM-OMAP2-mmc-twl4030-move-clock-input-selection-pri.patch
        0025-RTC-add-support-for-backup-battery-recharge.patch
        0026-ARM-OMAP-automatically-set-musb-mode-in-platform-dat.patch
        0027-OMAP-DSS2-check-for-both-cpu-type-and-revision-rathe.patch
        0028-OMAP-DSS2-Add-DSS2-support-for-Overo.patch
        0029-OMAP3-PM-Adding-T2-enabling-of-smartreflex.patch
        0030-OMAP-CPUfreq-ensure-driver-initializes-after-cpufreq.patch
        0031-OMAP-CPUfreq-ensure-policy-is-fully-initialized.patch
        0032-OMAP3-PM-CPUFreq-driver-for-OMAP3.patch
        0033-OMAP-PM-CPUFREQ-Fix-conditional-compilation.patch
        0034-OMAP-Introduce-a-user-list-for-each-voltage-domain-i.patch
        0035-OMAP-Introduce-API-in-the-OPP-layer-to-find-the-opp-.patch
        0036-OMAP-Introduce-API-to-register-a-device-with-a-volta.patch
        0037-OMAP-Introduce-device-specific-set-rate-and-get-rate.patch
        0038-OMAP-Voltage-layer-changes-to-support-DVFS.patch
        0039-OMAP-Introduce-dependent-voltage-domain-support.patch
        0040-OMAP-Introduce-device-scale.patch
        0041-OMAP-Disable-smartreflex-across-DVFS.patch
        0042-OMAP3-Introduce-custom-set-rate-and-get-rate-APIs-fo.patch
        0043-OMAP3-Update-cpufreq-driver-to-use-the-new-set_rate-.patch
        0044-OMAP3-Introduce-voltage-domain-info-in-the-hwmod-str.patch
        0045-OMAP3-Add-voltage-dependency-table-for-VDD1.patch
        0046-omap3-4-opp-make-omapx_opp_init-non-static.patch
        0047-OMAP3-beagle-xm-enable-upto-1GHz-OPP.patch
        0048-omap3-Add-basic-support-for-720MHz-part.patch
        0049-Add-defines-to-set-config-options-in-GPMC-per-CS-con.patch
        0050-Add-functions-to-dma.c-to-set-address-and-length-for.patch
        0051-usrp-embedded-Add-driver-for-USRP-Embedded-FPGA-inte.patch
        0058-drivers-media-radio-wl128x-FM-Driver-common-header-f.patch
        0059-drivers-media-radio-wl128x-FM-Driver-V4L2-sources.patch
        0060-drivers-media-radio-wl128x-FM-Driver-Common-sources.patch
        0061-drivers-media-radio-wl128x-FM-driver-RX-sources.patch
        0062-drivers-media-radio-wl128x-FM-driver-TX-sources.patch
        0063-drivers-media-radio-wl128x-Kconfig-Makefile-for-wl12.patch
        0064-drivers-media-radio-Update-Kconfig-and-Makefile-for-.patch
        0065-drivers-misc-ti-st-change-protocol-parse-logic.patch
        0066-Bluetooth-btwilink-driver.patch
git mergetool --tool=meld

}}}
029. Build Panda Angstrom {{{
        2011-02-22

git clone git://git.denx.de/u-boot.git
cd u-boot
git remote add omapzoom git://dev.omapzoom.org/pub/scm/bootloader/u-boot.git
git fetch omapzoom
git branch omapzoom-omap4_dev omapzoom/omap4_dev
git checkout omapzoom-omap4_dev
git pull

Change in include/configs/omap4430panda.h
#define CONFIG_BOOTARGS "nfsroot=172.16.1.11:/opt/rootfs/panda rootdelay=2" \
        " console=ttyO2,115200n8 mem=463M ip=172.16.1.8" \
        " init=/sbin/init earlyprintk"
#define CONFIG_BOOTCOMMAND "mmcinit 0 ; fatload mmc 0:1 0x80300000 uImage ; bootm 0x80300000"

make distclean
make omap4430panda_config
make

git clone git://dev.omapzoom.org/pub/scm/bootloader/x-loader.git
cd x-loader
git checkout -b omap4_dev origin/omap4_dev
make omap4430panda_config
make ift
cp x-load.bin.ift MLO

wl12xx kernel - apply patches from 
        ./patches/panda/2.6.38-rc6/
[PATCH v2 1_2] regulator: twl: add clk32kg to twl-regulator
[PATCH v2 2_2] OMAP4: add clk32kg data to omap4panda and blaze board file

[PATCH v2 1_5] OMAP2420: hwmod data: Add HSMMC
[PATCH v2 2_5] OMAP2430: hwmod data: Add HSMMC
[PATCH v2 3_5] OMAP3: hwmod data: Add HSMMC
[PATCH v2 4_5] OMAP4: hwmod data: Add HSMMC
[PATCH v2 5_5] OMAP: devices: Modify HSMMC device to adapt to hwmod framework

[PATCH 1_5] omap: panda: wlan board muxing
[PATCH 2_5] omap: select REGULATOR_FIXED_VOLTAGE by default for panda and sdp4430
[PATCH 3_5] omap: panda: add fixed regulator device for wlan
[PATCH 4_5] omap: panda: add mmc5_wl1271 device support
[PATCH 5_5] OMAP: hsmmc: Enable MMC4 and MMC5 on OMAP4 platforms

Rebase on tag wl12xx-2011-02-23

Main kernel (not used) {{{
git clone git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux-2.6.git
cd linux-2.6
make omap2plus_defconfig
make menuconfig
make uImage modules
cp -f ./arch/arm/boot/uImage /tftpboot/panda/
make modules_install INSTALL_MOD_PATH=${NFSROOT}
}}}
}}}
030. Enable bluetooth on Panda {{{
        2011-02-27

Kernel changes:
To enable the TI_ST driver and the ST_BT driver select the following
        configurations for the kernel:
CONFIG_RFKILL=y (Networking Support -> RF switch subsystem support)
CONFIG_MISC_DEVICES=y (Device Drivers)
CONFIG_TI_ST=m (under Device Drivers->Misc Devices->Texas Instruments shared transport line discipline)
CONFIG_STAGING=y (under Device Drivers)
CONFIG_STAGING_EXCLUDE_BUILD=n (under Device Drivers->Staging drivers)
CONFIG_ST_BT=m (under Device Drivers->Staging drivers->Texas Instruments shared transport line discipline)

Add to arch/arm/mach-omap2/board-omap4panda.c

/* wl127x BT, FM, GPS connectivity chip */
static int gpios[] = {46, -1, -1};
static struct platform_device wl127x_device = {
        .name           = "kim",
        .id             = -1,
        .dev.platform_data = &gpios,
};

static struct platform_device *panda_devices[] __initdata = {
        &leds_gpio,
        &wl127x_device,
};


On boot do follows:

insmod /lib/modules/`uname -r`/kernel/net/bluetooth/bluetooth.ko
./uim /dev/ttyO1 3686400 none 22 &
hciconfig hci0 up

hcitool dev # gives you the device's bd address
hcitool scan # scans for nearby bluetooth devices

}}}
031. Calibrator 1-step procedure {{{
        2011-02-09
To calibrate with INI file and path where to put NVS file at 1-step procedure.
Create ref NVS, copy to proper location, calibrate, create new NVS and copy it
also.
Implementation: make shell script which calls calibrator, rmmod, insmod, etc.
Also to check if NVS already exists, notify and back it up.

}}}
032. Add random valid MAC to calibrated NVS {{{
        2011-02-27
The idea to make NVS with random and valid MAC address, so the
calibrated solution will work out-of-the-box.

Change in script ./go.sh
After calibration, change MAC address in NVS before copy it.

How to do it:
openssl rand -hex 6 | sed 's/\(..\)/\1:/g; s/.$//'

}}}
033. Close bug about calibration for AP mode {{{
        2011-03-02
The bug 88547 : not possible to use NVS w/ AP created w/ STA.

The Ap firmware upgraded to 6.2.0.0.46 which has alignment to use
same NVS INI structure as STA firmware.
}}}
034. Disable external antenna on Panda n BeagleToy {{{
        2011-03-07

Both boards has same LSR package (TiWi R1) w/ external antenna.
The connector of RF cable doesn't switch-off the ext ant.
Have to remove resistor R35 on BeagleToy (R20 on Panda) in order disbale ext
antenna.

}}}
035. Build n boot Android on Blaze {{{
        2011-02-17
Build n prepare rootfs {{{
Build {{{
--- x-loader
Repo   : git://git.omapzoom.org/repo/x-loader.git
Branch : omap4_dev
Config : omap4430sdp_config

git checkout -b omap4_dev origin/omap4_dev
cd x-loader
make omap4430sdp_config
make

from 2011-03-08
git clone git://git.omapzoom.org/repo/x-loader.git x-loader
cd x-loader
git checkout 8de4ac4408224f8cec7aa8493301483fe7aa324c


--- u-boot
Repo   : git://git.omapzoom.org/repo/u-boot.git
Branch : omap4_dev
Config : omap4430sdp_config

git clone git://git.omapzoom.org/repo/u-boot.git
cd u-boot
git checkout -b omap4_dev origin/omap4_dev
make omap4430sdp_config
make

---kernel
Repo   : git://git.omapzoom.org/kernel/omap.git
Branch : p-android-omap-2.6.35
Config : android_4430_defconfig

git clone git://git.omapzoom.org/kernel/omap.git
cd omap
git checkout -b p-android-omap-2.6.35 origin/p-android-omap-2.6.35
make android_4430_defconfig
make -j8

--- rootfs
#repo init -u git://git.omapzoom.org/repo/android/platform/omapmanifest.git -b gingerbread

git clone git://git.omapzoom.org/platform/omapmanifest.git
cd omapmanifest
git reset --hard RLS27-GB-ENG-1_Gingerbread
export MANIFEST=`pwd`
cd ..
mkdir -p L27-GB/mydroid ; cd L27-GB/mydroid
export MYDROID=`pwd`
repo init -u $MANIFEST
repo sync

Building
source build/envsetup.sh
lunch blaze-eng
get following
============================================
PLATFORM_VERSION_CODENAME=REL
PLATFORM_VERSION=2.3.1
TARGET_PRODUCT=blaze
TARGET_BUILD_VARIANT=eng
TARGET_SIMULATOR=false
TARGET_BUILD_TYPE=release
TARGET_BUILD_APPS=
TARGET_ARCH=arm
HOST_ARCH=x86
HOST_OS=linux
HOST_BUILD_TYPE=release
BUILD_ID=GINGERBREAD
============================================

make -j8 2>&1 |tee $MYDROID/logs/android_make.out

from Arik's email (2011-03-03)
download blaze_kpatches_v4.tar.bz2 - kernel patches
untar
cd ~/ti/android/omap
git am ../<path to patches>/*
cp ~/ti/blaze/blaze-0.2/kernel/kernel_config .config
make -j8

Apply patches to projects:
cd L27-GB/mydroid/build
patch -p1 < ../../../../blaze/blaze-0.2/android/patches/build/*.patch
cd L27-GB/mydroid/device/ti/blaze
patch -p1 < ~/ti/blaze/blaze-0.2/android/patches/device.ti.blaze/*.patch
cd L27-GB/mydroid/external/hostapd
patch -p1 < ~/ti/blaze/blaze-0.2/android/patches/external.hostapd/*.patch
cd L27-GB/mydroid/frameworks/base
patch -p1 < ~/ti/blaze/blaze-0.2/android/patches/frameworks.base/*.patch
The 1st patch already applied (2011-03-07)
cd L27-GB/mydroid/hardware/libhardware_legacy
patch -p1 < ~/ti/blaze/blaze-0.2/android/patches/hardware.libhardware_legacy/*.patch
cd L27-GB/mydroid/system/core
patch -p1 < ~/ti/blaze/blaze-0.2/android/patches/system.core/*.patch
cd L27-GB/mydroid/system/netd
patch -p1 < ~/ti/blaze/blaze-0.2/android/patches/system.netd/*.patch

Add userspace apps:
cd L27-GB/mydroid/
tar jxf <path>/blaze-0.2/android/packages/packages.tar.bz2

download http://wizery.com/arik/compat4.tar.bz2 - compat wireless
cd ~/ti/android/L27-GB/mydroid/hardware/wlan/
tar jxf <path>/compat4.tar.bz2
cd ./compat...
Changes in setenv.sh
TOOLCHAIN_PATH=/opt/arm-2010q1/bin
KERNEL_PATH=/home/gxk/ti/android/omap
source setenv.sh
make

Copy fw n NVS files to L27-GB/mydroid/hardware/wlan/fw

Setting proper device:
cd  L27-GB/mydroid/
cp ./device/ti/blaze/buildspec.mk.default buildspec.mk

cd ~/ti/android/L27-GB/mydroid/
make

Add calibrator to Android {{{
cd L27-GB/mydroid/external
git clone ti-utils

}}}
}}}
Prepare rootfs {{{

http://omapedia.org/wiki/L27.INC1.GB-ENG-1_OMAP4_GingerBread_ES2_Release_Notes

The full procedure doesn't work ?????
cd ~/ti/android
mkdir myfs; cd myfs
cp -Rfp ../L27-GB/mydroid/out/target/product/blaze/root/* .
cp -Rfp ../L27-GB/mydroid/out/target/product/blaze/system/ .
cp -Rfp ../L27-GB/mydroid/out/target/product/blaze/data/ .
cp ../L27-GB/mydroid/device/ti/blaze/init.omap4430.rc ./init.rc

The procedure based on Arik's rootfs
Untar Arik's rootfs n copy as is to SD
cd L27-GB/mydroid/
cp ./out/target/product/blaze/system/lib/modules/* <SD>/system/lib/modules/
cp ../../omap/drivers/staging/ti-st/*.ko <SD>/
cp <path_fw>/wl128x-fw*.bin <SD>/system/etc/firmware/


sudo chmod -R 777 /media/rootfs
}}}
}}}
Boot {{{

Console on 3rd port

U-boot env:
setenv bootargs 'console=ttyO2,115200n8 mem=463M root=/dev/mmcblk1p2 rw rootdelay=2 init=/init vram="32M" omapfb.vram="0:24M" no_console_suspend=1 ip=172.16.1.7:172.16.1.11::255.255.255.0::eth0:down'
setenv bootcmd 'mmcinit 0;fatload mmc 0 0x80000000 uimage; bootm 80000000'


echo manual_lock > /sys/power/wake_lock
echo performance > /sys/devices/system/cpu/cpu0/cpufreq/scaling_governor
echo 1 > /sys/devices/system/cpu/cpu1/online
echo performance > /sys/devices/system/cpu/cpu1/cpufreq/scaling_governor

Settings -> Applications -> Development -> Stay awake

}}}
}}}
036. Build Panda with new fs {{{
        2011-03-13

Create build for Panda based wl12xx-2011-03-03 + Guy's patches + Guy's new
filesystem.

Build kernel: {{{
Apply patches from patches/panda/2011-02-23
[PATCH v2 1_2] regulator: twl: add clk32kg to twl-regulator
[PATCH v2 2_2] OMAP4: add clk32kg data to omap4panda and blaze board file

[PATCH v2 1_5] OMAP2420: hwmod data: Add HSMMC
[PATCH v2 2_5] OMAP2430: hwmod data: Add HSMMC
[PATCH v2 3_5] OMAP3: hwmod data: Add HSMMC
[PATCH v2 4_5] OMAP4: hwmod data: Add HSMMC
[PATCH v2 5_5] OMAP: devices: Modify HSMMC device to adapt to hwmod framework

[PATCH 1_5] omap: panda: wlan board muxing
[PATCH 2_5] omap: select REGULATOR_FIXED_VOLTAGE by default for panda and sdp4430
[PATCH 3_5] omap: panda: add fixed regulator device for wlan
[PATCH 4_5] omap: panda: add mmc5_wl1271 device support
[PATCH 5_5] OMAP: hsmmc: Enable MMC4 and MMC5 on OMAP4 platforms

Apply follow patches from Guy's tar 2011-03-08
0001-wl12xx-add-support-for-rx-streaming.patch
0002-wl12xx-add-automatic-rx-streaming-support.patch
0003-wl12xx-add-rx_streaming-debugfs-entry.patch
0004-Revert-wl12xx-disable-auto-arp.patch
0005-wl12xx-update-bet_max_consecutive.patch
0006-Add-support-for-11n-Rx-STBC-one-spatial-stream.patch
0007-mac80211-Stop-BA-session-event-from-device.patch
0008-wl12xx-Stop-BA-session-event-from-device.patch
0012-wl12xx-add-BT-coexistance-for-AP.patch
0013-wl12xx-set-the-actual-tid-instead-of-the-ac.patch
0014-wl12xx-configure-rate_set-when-working-in-ibss-mode.patch
}}}

Build Guy's filesystem: {{{
untar rootfs-zoom3-uber-r3-10mar11.tar.bz2

Changes:
1. Cfg system to not load wl12xx files
Comment follows line in /etc/udev/rules.d/local.rules
SUBSYSTEM=="net", ACTION=="add" RUN+="/etc/udev/scripts/network.sh"
SUBSYSTEM=="net", ACTION=="remove" RUN+="/etc/udev/scripts/network.sh"
ACTION=="add", DEVPATH=="/devices/*", ENV{MODALIAS}=="?*", RUN+="/sbin/modprobe
2. Add iperf
3. Remove link in /etc/rc5.d/ about avahi-deamon
4. comment in etc/udev/rules.d/80-drivers.rules like
DRIVER!="?*", ENV{MODALIAS}=="?*", RUN+="/sbin/modprobe -b $env{MODALIAS}"

Copy from Poky:
mkdir libexec
cp telnetd ./libexec
cp inetd ./libexec
cp etc/inetd.conf ./etc/

Copy bash to bin/bash

2011-03-15
Remove lib/udev/rules.d/75-persistent-net-generator.rules
Remove file etc/udev/rules.d/70-persistent-net.rules
Changed back scripts: start-sta.sh, start-sta-supp.sh, start-supp.sh

}}}

}}}
037. Build Blaze Android {{{
        2011-03-10
Get Arik's compat v5 and apply
Get latest Guy's patches and apply them
Get Arik's filesystem

Change filesystem as required by testing:
from AviBerkovich email:
! copy to / follows: cli.sh, start-sta-supp.sh n chmod 777 them
! mkdir /data/busybox
! copy busybox binary to /system/bin
! copy script mcp_create_busybox_symlink /data/busybox n run it there
in add init.rc
! add "/system/busybox" as the first directory in the PATH export
! change this line: "service console /system/bin/sh" 
    to "service console /system/busybox/sh"
!  service myeth0 /system/bin/ifconfig eth0 20.1.1.20 netmask 255.255.255.0 up
       user root
       oneshot

! service mytelnetd /data/busybox/telnetd -l sh
      user root
      oneshot

! change below 'service console /system/bin/sh'
  user root
  group root
  
! comment out 'mount yaffs2 mtd@system /system ro remount

! comment out 'mount rootfs rootfs / ro remount'

! after 'on property:persist.service.adb.enable=1' add line
  setprop service.adb.tcp.prop 5555


cd MYDROID/hardware/wlan/compat
make

Copy modules from compat:
cp MYDROID/hardware/wlan/compat/compat/*.ko MYDROID/out/target/product/blaze/system/lib/modules/
cp MYDROID/hardware/wlan/compat/drivers/net/wireless/wl12xx/*.ko MYDROID/out/target/product/blaze/system/lib/modules/
cp MYDROID/hardware/wlan/compat/net/mac80211/*.ko MYDROID/out/target/product/blaze/system/lib/modules/

mkdir myfs; cd myfs
cp -Rfp ../L27-GB/mydroid/out/target/product/blaze/root/* .
cp -Rfp ../L27-GB/mydroid/out/target/product/blaze/system/ .
cp -Rfp ../L27-GB/mydroid/out/target/product/blaze/data/ .
cp ../L27-GB/mydroid/device/ti/blaze/init.omap4430.rc ./init.rc

Copy go.sh n calibrator in /

Add CRDA:
cp crda ./sbin
mkdir lib/crda
cp regulatory.bin ./lib/crda
mkdir ./system/etc/wireless-regdb/pubkeys
cp linville.key.pub.pem ./system/etc/wireless-regdb/pubkeys/
ln -s ./system/etc etc

Add FW n NVS:
Copy wl128x-fw.bin to ./system/etc/firmware/
Copy wl1271-nvs.bin ./system/etc/firmware/

}}}
038. Prepare filesystem with userspace apps {{{
        2011-03-17
The reason to prepare wpa_s and others that have to remove my fix roaming patch
from wpa_s.

--- Build apps:
libnl from tarball libnl-2.0
iw commit cc12e895302aa7dc82229f12b21e61c52fba80f6
openssl from tarball openssl-1.0.0d

hostap commit b8fb017272ed4794339978c9fbc0e74571a44728
Add patches to wpa_supplicant
0001-Add-command-to-wpa_cli-to-print-roam-candidates.patch
0002-bgscan_learn-Update-the-initial-value-of-time-interv.patch
0003-crypto-Add-crypto-support-relevant-for-WAPI.patch
0005-common-Add-definitions-for-WAPI-supports.patch
0006-WAPI-functions.patch
0007-drivers-WAPI-support-for-the-nl80211-driver.patch
0008-wpa_supplicant-WAPI-support-in-the-supplicant.patch
0009-wpa_supplicant-WAPI-support-in-the-CLI-and-the-confi.patch
0010-bgscan-fix-print-roam-candidates-command.patch

hostapd

--- Additional changes:
Disable dbus deamon: rm -rf etc/rc5.d/S02dbus-1
Install libnl from offcial libnl-2.0
rm -rf lib/libc.so
Change hostname in etc/hostname to zoom3

--- Testing
Connection w/ wpa_s WPA PSK
}}}
039. Debug AP problem {{{
        2011-03-17
Create kernel log:
./go.sh -b 7
./go.sh -d 408772
echo -n 'module wl12xx +p' > /sys/kernel/debug/dynamic_debug/control
./ap_test ap
}}}
040. Add netlatency to Blaze Android build {{{
        2011-03-21
cd omapmanifest
git reset --hard RLS27-GB-ENG-1_Gingerbread
export MANIFEST=`pwd`
L27-GB/mydroid
export MYDROID=`pwd`
source build/envsetup.sh
mkdir -p ./external/netlatency
cp netlatency.c ./external/netlatency/
Add Android.mk to ./external/netlatency/
make
}}}
041. Build Panda with fix for mmc5 master clock {{{
        2011-03-21

get wl12xx from 2011-03-18
Add Panda patches
Add patch to set MMC5 master clock to 24MHz
patches/panda/fix_mmc5_master_clock/0001-Fix-master-clock-for-MMC3-5-to-48.patch

Tested on Panda w/ RF cable and external antenna

Panda w/o patch to fix mmc5 master clock
UDP Rx/Tx   12.5/27.7
TCP Rx/Tx   10.5/23.9

+ patch to fix mmc5 master clock
UDP Rx/Tx   12.6/33.4
TCP Rx/Tx   13.4/26.5

+ patch - mmc hs sdio capabilites
UDP Rx/Tx   12/32.6
TCP Rx/Tx   11.2/26.3

2011-03-22
Gave SD card to Ariela - Answer: It is 24MHz!!!

}}}
042. Check filesystem package for testing requirements {{{
        2011-03-22
Missing ftp, netlatency

found previously placed Chariot endpoint at /wlan/temp
cp ./netlatency /opt/rootfs/z3e/usr/sbin/
put /bin/ftp
}}}
043. Compare fw 7.1.3.50.55 vs 7.1.3.50.58 {{{
        2011-03-07

diff -pbBwuN --exclude *.cmd --exclude *.1 --exclude *.keep 7.1.3.50.55/src/ 7.1.3.50.58/src > diff-55-58.txt

New cmd: ACX_DISABLE_BROADCASTS - defines whether to enable broadcasts and multicast Rx

}}}
044. Build Blaze Android based release RLS27.11.1 - r3ed3 {{{
        2011-03-22
Build kernel {{{
cd omap
git pull
git checkout -b p-android-omap-2.6.35 origin/p-android-omap-2.6.35
git checkout d4a101815d4957438915193785cefcaf5ea8cd33 - not good
git checkout ff0b9680
git am ../../blaze/blaze-0.3/kernel_new/*
cp ../../blaze/blaze-0.3/kernel/kernel_config
Change config:
Kernel Hacking -> Tracers -> Kernel function tracer
make -j8 uImage modules

cd ~/ti
git clone git://git.kernel.org/pub/scm/linux/kernel/git/luca/wl12xx.git
git clone git://git.kernel.org/pub/scm/linux/kernel/git/mcgrof/compat.git
git clone git://git.kernel.org/pub/scm/linux/kernel/git/mcgrof/compat-wireless-2.6.git
cd compat-wireless-2.6
export GIT_COMPAT_TREE=/home/gxk/ti/compat
export GIT_TREE=/home/gxk/ti/wl12xx

rm -rf ./patches/11-dv-pm-ops.patch
rm -rf ./patches/16-bluetooth.patch
rm -rf ./patches/35-fix-makefile-includes.patch

./script/admin-refresh.sh
./scripts/driver-select wl12xx

Apply patches for release
cd compat-wireless-2.6
cp .gitignore from kernel
git add .
git commit -a -m "Initial"
git am /opt/apps/releases/r3-ed2.2/kernel/*
Skip 3 patches (7, 8, 9), by git am --skip
Apply remove SDIO Ido's patch:
git am ~/ti/blaze/blaze-0.3/0001-...claiming-of-the-SDI.patch

make CONFIG_DEBUG_SECTION_MISMATCH=y KLIB=~/ti/android/omap KLIB_BUILD=~/ti/android/omap
}}}

Build AFS {{{
cd omapmanifest
export MANIFEST=`pwd`
git reset --hard RLS27.11.1_Gingerbread
cd ../ && mkdir -p 27.11.1/mydroid; cd 27.11.1/mydroid
export MYDROID=`pwd`
repo init -u $MANIFEST
repo sync
repo forall -c git checkout -b vanilla
pushd build
git checkout -b wl12xx
git am <path_to_patch>
...

Appply patches from blaze-0.3/android/patches

Add userspace prjs:
cp -r ~/ti/blaze/blaze-0.3/android/packages/external/* ./external/
cp -r ~/ti/blaze/blaze-0.3/android/packages/hardware/* ./hardware/
cd ./external && git clone ti-utils
mkdir -p ./external/netlatency
cp netlatency.c ./external/netlatency/
Add Android.mk to ./external/netlatency/

cp ./device/ti/blaze/buildspec.mk.default buildspec.mk
make clean
make -j8
}}}

Prepare myfs {{{
cd ~/ti/android
mkdir myfs.27.11.1; cd myfs.27.11.1
cp -Rfp ../27.11.1/mydroid/out/target/product/blaze/root/* .
cp -Rfp ../27.11.1/mydroid/out/target/product/blaze/system/ .
cp -Rfp ../27.11.1/mydroid/out/target/product/blaze/data/ .

Copy modules from compat:
mkdir ./system/lib/modules
pushd to compat-wireless-2.6
find . -name "*.ko" -exec cp -f {} MYDROID/system/lib/modules/ \;
popd

Add binaries:
  copy to / follows: cli.sh, start-sta-supp.sh n chmod 777 them
  mkdir /data/busybox
  copy busybox binary to /system/bin
  copy script mcp_create_busybox_symlink /data/busybox n run it there
  mkdir ./bin && cd ./bin && ln -s /system/bin/busybox sh
  cp ../L27-GB/mydroid/device/ti/blaze/init.omap4430.rc ./init.rc
  Copy wl128x-fw.bin to ./system/etc/firmware/
  Copy wl1271-nvs.bin ./system/etc/firmware/
  cp TIInst_10.6.15.bts 
  cp <omap_kernel>/drivers/staging/ti-st/*.ko /
  cp go.sh to /
  cp ./hardware/wlan/initial_regdom/initial_regdom.sh ./system/bin
}}}

u-boot env {{{
bootcmd=mmcinit 0; fatload mmc 0 0x81c00000 uImage; bootm 0x81c00000
bootargs=console=ttyO2,115200n8 root=/dev/mmcblk1p2 rw rootdelay=1 mem=456M@0x80000000 mem=512M@0xA0000000 init=/init vram="10M" omapfb.vram="0:4M" ip=172.16.1.7:172.16.1.254::255.255.255.0::eth0:down
}}}
}}}
045. Calibrator for Android {{{
        2011-03-29

Add NVS path in plt.h with macro ANDROID

adb shell stop
adb shell insmod /system/lib/modules/wl12xx_sdio.ko
adb push /home/gxk/ti/user/ti-utils/ini_files/128x/TQS_D_1.7.ini /system/data/TQS_D_1.7.ini

adb shell rmmod /system/lib/modules/wl12xx_sdio.ko

}}}
046. Build Blaze Android based release - r3ed3.1-rc1 {{{
        2011-03-30
Build kernel {{{
cd omap
git pull
git checkout -b p-android-omap-2.6.35 origin/p-android-omap-2.6.35
git checkout ff0b9680
git am ../../blaze/blaze-0.3/kernel_new/*

patches:
rx streaming v3
new roaming
Ap disable beacon filter
auto-arp security

cp ../../blaze/blaze-0.3/kernel/kernel_config
Change config:
Kernel Hacking -> Tracers -> Kernel function tracer
make -j8 uImage modules

cd ~/ti
git clone git://git.kernel.org/pub/scm/linux/kernel/git/luca/wl12xx.git
(commit id 392d496)
git clone git://git.kernel.org/pub/scm/linux/kernel/git/mcgrof/compat.git
git clone git://git.kernel.org/pub/scm/linux/kernel/git/mcgrof/compat-wireless-2.6.git (commit id f7606f5923e8297)
cd compat-wireless-2.6
export GIT_COMPAT_TREE=/home/gxk/ti/compat
export GIT_TREE=/home/gxk/ti/wl12xx

rm -rf ./patches/11-dv-pm-ops.patch
rm -rf ./patches/16-bluetooth.patch
rm -rf ./patches/35-fix-makefile-includes.patch

./script/admin-refresh.sh
./scripts/driver-select wl12xx

Apply patches for release
cd compat-wireless-2.6
cp .gitignore from kernel
git add .
git commit -a -m "Initial"
git am /opt/apps/releases/r3-ed2.2/kernel/*
Skip 3 patches (7, 8, 9), by git am --skip
Apply remove SDIO Ido's patch:
git am ~/ti/blaze/blaze-0.3/0001-...claiming-of-the-SDI.patch

make CONFIG_DEBUG_SECTION_MISMATCH=y KLIB=~/ti/android/omap KLIB_BUILD=~/ti/android/omap
}}}

Build AFS {{{
cd omapmanifest
export MANIFEST=`pwd`
git reset --hard RLS27.11.1_Gingerbread
cd ../ && mkdir -p 27.11.1/mydroid; cd 27.11.1/mydroid
export MYDROID=`pwd`
repo init -u $MANIFEST
repo sync

Apply patches to user apps from ti/blaze/r3-ed3/android/patches :
repo forall -c git checkout -b vanilla
pushd build
git checkout -b wl12xx
git am <path_to_patch>
...

Appply patches from blaze-0.3/android/patches

Add userspace prjs:
cp -r ~/ti/blaze/blaze-0.3/android/packages/external/* ./external/
cp -r ~/ti/blaze/blaze-0.3/android/packages/hardware/* ./hardware/
cd ./external && git clone ti-utils

cp ./device/ti/blaze/buildspec.mk.default buildspec.mk
make clean
make -j8
}}}

Changes in Arik's packages:
Copy firmware:
mkdir <myfs>/system/etc/firmware/ti-connectivity
copy STA n AP firmwares to <myfs>/system/etc/firmware/ti-connectivity
wl128x-fw.bin, wl128x-fw-ap.bin

Copy ./hardware/wlan/initial_regdom/initial_regdom.sh ./system/bin

Add to exernal/hostap/hostapd.conf follows:
tx_queue_data2_aifs                    = 2
tx_queue_data2_cwmin              = 15
tx_queue_data2_cwmax             = 63
tx_queue_data2_burst                 = 0

Additions for testing:
mkdir -p ./external/netlatency
cp netlatency.c ./external/netlatency/
Add Android.mk to ./external/netlatency/

mkdir -p ./external/iperf

mkdir -p ./external/testcmd

Add busybox binaries:
  copy to / follows: cli.sh, start-sta-supp.sh
  mkdir /data/busybox
  copy busybox binary to /system/bin
  copy script mcp_create_busybox_symlink /data/busybox n run it there
  mkdir ./bin && cd ./bin && ln -s /system/bin/busybox sh

Prepare myfs {{{
cd ~/ti/android
mkdir myfs.r3ed3.1; cd myfs.r3ed3.1
cp -Rfp ../27.11.1/mydroid/out/target/product/blaze/root/* .
cp -Rfp ../27.11.1/mydroid/out/target/product/blaze/system/ .
cp -Rfp ../27.11.1/mydroid/out/target/product/blaze/data/ .

Copy modules from compat:
mkdir ./system/lib/modules
pushd to compat-wireless-2.6
find . -name "*.ko" -exec cp -f {} MYDROID/system/lib/modules/ \;
popd

Copy modules from kernel (fm_drv.ko, gps_drv.ko, st_drv.ko, bt_drv.ko):
cd omap
find ./drivers/staging -name "*.ko" -exec cp -v {} <path to myfs> \;

Copy TQS_D_1.7.ini to /data/

Copy iperf ./system/bin/

Changes in init.rc
cp ../L27-GB/mydroid/device/ti/blaze/init.omap4430.rc ./init.rc

chmod -R 777 ./*

}}}

u-boot env {{{
bootcmd=mmcinit 0; fatload mmc 0 0x81c00000 uImage; bootm 0x81c00000
bootargs=console=ttyO2,115200n8 root=/dev/mmcblk1p2 rw rootdelay=1 mem=456M@0x80000000 mem=512M@0xA0000000 init=/init vram="10M" omapfb.vram="0:4M" ip=172.16.1.7:172.16.1.254::255.255.255.0::eth0:down
}}}
}}}
047. R3ED3.1-RC1 Android - Release notes, build instructions {{{
        2011-04-04
Release notes {{{
Hi All,

This is 1st release of NLCP group for Android on Blaze platform.

- R3ED3.1-RC1 Android -

It based on OMAP Android release 27.11.1 (Gingerbread) with additions for 
TI's wireless driver (wl12xx) and TI's bluetooth.

The release uses firmware version 7.1.4.50.63 (for station) and
7.2.0.0.47 (for AP). The bluetooth solution based on initialization 
script version 10.6.15

Important!!!
The build instructions of the release can be found in document:
"R3ED3.1-RC1 Android build instructions"

Main features supported in the release:
- SoftAp
- Roaming
- ...
 
Known issues in the release:
- All security modes connection needs to be run with wpa_supplicant 
without “-d” option.
- WiFi WMM certification should be run with NLCP ASD
- Auto FEM detection is not used for the NVS preparing
- WiFi WPA2: APUT with mixed mode STAs transmits lower TP than WiFi requires
- Stability: TCP RX traffic failed after 6:40h 2 recovery occur
- 802.11N: Rx TCP sessions with simultaneous VI and BE traffic fails 
  in few seconds
- SG: APUT QuattroL Multicast Tx Traffic Stops right after start sending 
  HV3 in BT

Usefull links:
Release doc
\\dilfs02\wlan\WLAN\NLCP\Driver\Version_Tree\r3-ed3.1-03apr11\docs
Release image
\\dilfs02\wlan\WLAN\NLCP\Driver\Version_Tree\r3-ed3.1-03apr11\images
Patches includes
\\dilfs02\wlan\WLAN\NLCP\Driver\Version_Tree\r3-ed3.1-03apr11\patches
Sanity test
\\dilfs02\wlan\WLAN\NLCP\Driver\Version_Tree\r3-ed3.1-03apr11\test_results

}}}
R3ED3.1-RC1 Android build instructions {{{

--- Prepare the project:
Create directory for the project:
mkdir android-wl12xx && cd android-wl12xx
export WL12XX_PRJ=`pwd`

Download r3ed3.1-rc1.tar.bz2 and follow below instructions:
Open tar file: tar jxf r3ed3.1-rc1.tar.bz2
ls -l ./r3ed3.1-rc1
    android       - collection of patches and packages for Android AFS
    kernel        - collection of patches for kernel
    wl12xx        - collection of patches for wl12xx driver 
                    from compat-wireless-2.6


--- Building kernel:
git clone git://git.omapzoom.org/kernel/omap.git
pushd omap
git checkout ff0b9680
cp ../r3ed3.1-rc1/kernel/kernel_config .config
Apply kernel patches:
git am ../r3ed3.1-rc1/kernel/*patch
make uImage modules
popd

There is kernel image which you can use: ./arch/arm/boot/uImage
Copy it to the SD card boot partition.


--- Building wl12xx driver:
Make sure that your current directory is android-wl12xx 
(see Prepare the project)

git clone git://git.kernel.org/pub/scm/linux/kernel/git/luca/wl12xx.git
pushd wl12xx
git reset --hard 392d496
popd
git clone git://git.kernel.org/pub/scm/linux/kernel/git/mcgrof/compat.git
git clone git://git.kernel.org/pub/scm/linux/kernel/git/mcgrof/compat-wireless-2.6.git
pushd compat-wireless-2.6
git reset --hard f7606f5923e8297
export GIT_COMPAT_TREE=<path>/android-wl12xx/compat
export GIT_TREE=<path>/android-wl12xx/wl12xx
rm -rf ./patches/11-dv-pm-ops.patch
rm -rf ./patches/16-bluetooth.patch
rm -rf ./patches/35-fix-makefile-includes.patch

./script/admin-refresh.sh
./scripts/driver-select wl12xx

cp $WL12XX_PRJ/omap/.gitignore .
git add .
git commit -a -m "Initial"
Apply patches for release
git am ../r3ed3.1-rc1/kernel/wl12xx/*patch
Skip 3 patches (7, 8, 9), by git am --skip

make KLIB=<path>/android-wl12xx/omap KLIB_BUILD=<path>/android-wl12xx/omap


--- Building Android filesystem (AFS)
Make sure that your current directory is android-wl12xx 
(see Prepare the project)

git clone git://git.omapzoom.org/platform/omapmanifest.git
pushd omapmanifest
git reset --hard RLS27.11.1_Gingerbread
export MANIFEST=`pwd`
popd && mkdir -p 27.11.1/mydroid; cd 27.11.1/mydroid
export MYDROID=`pwd`
repo init -u $MANIFEST
repo sync

Apply patches to Android applications:
repo forall -c git checkout -b vanilla
pushd ./build
git am $WL12XX_PRJ/r3ed3.1-rc1/android/patches/build/*
popd
pushd device/ti/blaze
git am $WL12XX_PRJ/r3ed3.1-rc1/android/patches/device.ti.blaze/*
popd
pushd external/hostapd
git am $WL12XX_PRJ/r3ed3.1-rc1/android/patches/external.hostapd/*
popd
pushd external/openssl
git am $WL12XX_PRJ/r3ed3.1-rc1/android/patches/external.openssl/*
popd
pushd external/wpa_supplicant_6
git am $WL12XX_PRJ/r3ed3.1-rc1/android/patches/external.wpa_supplicant_6/*
popd
pushd framework/base
git am $WL12XX_PRJ/r3ed3.1-rc1/android/patches/framework.base/*
popd
pushd hardware/libhardware_legacy
git am $WL12XX_PRJ/r3ed3.1-rc1/android/patches/hardware.libhardware_legacy/*
popd
pushd system/core
git am $WL12XX_PRJ/r3ed3.1-rc1/android/patches/system.core/*
popd
pushd system/netd
git am $WL12XX_PRJ/r3ed3.1-rc1/android/patches/system.netd/*
popd

Copy applications to complete wireless solution:
cp -r $WL12XX_PRJ/r3ed3.1-rc1/android/packages/external/* ./external/
cp -r $WL12XX_PRJ/r3ed3.1-rc1/android/packages/hardware/* ./hardware/

cp ./device/ti/blaze/buildspec.mk.default buildspec.mk
make clean
make

--- Preparing filesystem
Make sure that your current directory is android-wl12xx 
(see Prepare the project)

mkdir myfs; cd myfs
cp -Rfp $WL12XX_PRJ/27.11.1/mydroid/out/target/product/blaze/root/* .
cp -Rfp $WL12XX_PRJ/27.11.1/mydroid/out/target/product/blaze/system/ .
cp -Rfp $WL12XX_PRJ/27.11.1/mydroid/out/target/product/blaze/data/ .

Copy modules from compat:
mkdir ./system/lib/modules
pushd $WL12XX_PRJ/compat-wireless-2.6
find . -name "*.ko" -exec cp -f {}  $WL12XX_PRJ/myfs/system/lib/modules/ \;
popd

Copy modules from kernel (fm_drv.ko, gps_drv.ko, st_drv.ko, bt_drv.ko):
pushd  $WL12XX_PRJ/omap
find ./drivers/staging -name "*.ko" -exec cp -v {} $WL12XX_PRJ/myfs \;
popd

cp $WL12XX_PRJ/r3ed3.1-rc1/TQS_D_1.7.ini to ./data/

Copy iperf ./system/bin/

cp $WL12XX_PRJ/r3ed3.1-rc1/init.rc ./init.rc

chmod -R 777 ./*
}}}
}}}
048. mcp3 alignment {{{
        2011-04-11 2011-04-13
Get patches and fw from Eliad in wl12xx/patches/mcp3
There is also firmware there (wl1271-fw-multirole-roc.bin).
Have to copy firmware it to
    ./lib/firmware/ti-connectivity/wl127x-fw-multirole-roc.bin

commit id 1a51c36

Produced build and SD card for Bella


2011-04-13
Rebuild everything with new patches


git checkout -b mcp3-1a51c36
git reset --hard 1a51c36
git remote add wl12xx-next3 git://gitorious.org:wl12xx-next3/wl12xx-next3.git
git push wl12xx-next3 mcp3-1a51c36

To clone the prj:
git clone git://gitorious.org/wl12xx-next3/wl12xx-next3.git

}}}
049. Build R3-RC2-Android {{{
        2011-04-12
Build filesystem for Native Linux rootfs-2011-04-12-z3.tar.bz2
build hostapd + ap_test.sh

90977 - Missing Country data in AP beacon IE 7
Solution:
Add 2 lines to hostapd.conf or ap_test.sh
country_code=US
ieee80211d=1
Remark:
iw reg set/get works, but no changes in AP beacon

91039 - [Android] not saving wless profile
Solution:
Remove line which copies wpa_supplicant.conf form init.omap4430.rc
Change in patches/device.ti.blaze/0001-build-configure-build-for-wl12xx-driver.patch


R3-RC2 Android

Add hostapd.conf from Arik 2011-04-11 to
    external/hostap/

Add certification files to system/etc/certs


mkdir /data/busybox
Copy busybox binary to /system/bin
Copy script mcp_create_busybox_symlink /data/busybox n run it there
Add to init.rc
service mytelnetd /data/busybox/telnetd -l sh
      user root
      oneshot

Try to add busybox:
Ad as usual.
Remove /data/busybox/{rmmod,insmod,modprobe,dhcprelay,udhcp*, syslogd, swapon, swapoff}

}}}
050. Prepare Beagle to NFS boot n R3-RC2 {{{
        2011-04-13

Make below script:
mkimage -A arm -T script -C none -n "My boot script" -d nfs_bb.script boot.scr

Script:

echo ----------------------
echo U-boot for Beagleboard
echo ----------------------
setenv console 'ttyO2,115200n8'
setenv bootdelay 2
setenv ipaddr 172.16.1.6
setenv serverip 172.16.1.11
setenv loadaddr '0x80300000'
setenv bootfile 'bb/uImage'
setenv netroot '/dev/nfs'
setenv netargs 'setenv bootargs console=${console} root=${netroot} rw nfsroot=${serverip}:/opt/rootfs/beagle,nolock ip=${ipaddr} mpurate=${mpurate} buddy=${buddy} camera=${camera} vram=${vram} omapfb.mode=dvi:${dvimode} omapdss.def_disp=${defaultdisplay}'
setenv bootcmd 'run netargs; mmc init 0 ; fatload mmc 0:1 ${loadaddr} uImage ; bootm ${loadaddr}'
run netargs; mmc init 0 ; fatload mmc 0:1 ${loadaddr} uImage ; bootm ${loadaddr}

Copy it to /media/boot/boot.scr


Kernel patches:
git am ./patches/beagleboard/wl12xx-2011-02-08/0001-Add-Beagleboard-support.patch
git am ./patches/r3/r3-rc2/kernel/*


Run bluetooth:
insmod /lib/modules/`uname -r`/kernel/net/bluetooth/bluetooth.ko

}}}
051. Create rootfs for R3 {{{
        2011-04-26

On wpa_supplicant comit id b8fb017272ed4794339978c9fbc0e74571a44728

Comment in .config at CONFIG_WPS2
Remove WAPI patches, so it will leave only those patches:
0001-Add-command-to-wpa_cli-to-print-roam-candidates.patch
0001-hostapd-fix-interfaces.iface-initialization.patch
0002-bgscan_learn-Update-the-initial-value-of-time-interv.patch
0004-Fix-LowRSSI-roaming.patch
0010-bgscan-fix-print-roam-candidates-command.patch


Released as rootfs-r3.tar.bz2
}}}
052. Prepare build based Luca wl12xx-2011-04-29 {{{
        2011-05-01

Kernel commit eb4fd2bb24343d6d0ffe10c05bf1e7dc01b32f13
iw commit 18e05613cd050d4d72938f1a140b2cd20864290f
hostap commit 0725cc7b7efc434910e89865c42eda7ce61bbf08
calibrator 
}}}
053. Build latest R4 build 5 {{{
        2011-05-01
kernel commit 2cd9da254ac45b26422f5254091a44            2011-04-11
iw commit 18e05613cd050d4d72938f1a140b2cd20864290f      2011-05-01
hostap commit 0725cc7b7efc434910e89865c42eda7ce61bbf08  2011-05-01

based on Eliad patches from ./patches/mcp3/2011-05-01

fw 7.3.0.0.49
wl1271-fw-multirole-roc.bin
wl128x-fw-multirole-roc.bin

No support for 11n - waiting for fw version

}}}
054. Prepare build based Luca wl12xx-2011-04-29-3 {{{
        2011-05-01

Kernel commit 59fb9103cf037dfbc5ae4387edc441415b7eddf1
iw commit 18e05613cd050d4d72938f1a140b2cd20864290f
hostap commit 0725cc7b7efc434910e89865c42eda7ce61bbf08
calibrator 
}}}
055. Fix Beagle NFS for 2.6.39-rcX {{{
        2011-05-04

Fix comes from https://lkml.org/lkml/2011/4/14/45

Created patch at patches/beagleboard/2.6.39-rc5/0001-Beagle-support.patch,
where whole Beagle support included.


}}}
056. Build latest R4 build 7 {{{
        2011-05-04
kernel commit 2cd9da254ac45b26422f5254091a44            2011-04-11

iw commit 18e05613cd050d4d72938f1a140b2cd20864290f      2011-05-01

hostap commit 0725cc7b7efc434910e89865c42eda7ce61bbf08  2011-05-01
0001-nl80211-consider-p2p-when-changing-vif-type.patch
0002-nl80211-change-vif-type-to-P2P_CLI-upon-p2p-authenti.patch

based on Eliad patches from ./patches/mcp3/2011-05-01

fw 7.3.0.0.52
wl1271-fw-multirole-roc.bin
wl128x-fw-multirole-roc.bin

No P2P connection

}}}
057. FW Logger integration {{{
        2011-04-27 2011-05-04

Apply Ido's patches from patches/fw_logger/2011-05-03/

Boot the system. Connect.
Open telnet and run: 
cat /sys/devices/platform/wl1271/fw_crashlog

On console run: testcmd phy phy0 recover

Should be hex dump on telnet terminal.

Works.
Realesed as 7.1.5.50.58
}}}
058. FEM Autodetection {{{
        2011-04-05
    Create NVS file based on 2 INIs to support auto FEM detection.

Both IN files should be the same arch (wl127x or wl128x) and same dual band
mode (single or dual).

Solution: 
New command in go.sh:
go.sh -c2 128x/TQS_S_... 128x/RFMD_S_...
New command in calibrator:
calibrator set ref_nvs2 128x/TQS_S_... 128x/RFMD_S_...
calibrator set nvs_autofem 0|1 [nvs file]

}}}
059. Build R3M1-RC2-Android {{{
        2011-05-15

Added driver patches:

copy STA n AP firmwares to <myfs>/system/etc/firmware/ti-connectivity
wl128x-fw.bin, wl128x-fw-ap.bin
STA: 7.1.5.50.69
AP:  6.2.1.0.54

AFS at myfs.r3:
Take AFS from r3-rc2
}}}
060. Build R3M1-RC4-Android {{{
        2011-05-15

wl12xx commit 9a4c2c1bae3e1c94d4598634c6f68153bf557c58 (tag wl12xx-2011-05-13)
compat commit 3e6f997
compat-wireless-2.6 commit 501c91f

rm ./patches/35-*
rm ./patches/40-*

Add wl12xx patches (based on r3m1-rc2)
0003 upstreamed
0004 u
0005 u
0006 u
0007 u
0008 u
0009 u

0010 rx streaming
0011 rx streaming
0012 rx streaming

0013 u
0014 u
0015 u
0016 u
0017 u
0018 u
-
0037 no need
0039 u
0040 u
0041 u
0042 u
0043 u
0044 u
0045 u
0046 u
0047 u
0048 rx streaming

0049 qos prioritization

0050 fw logger
0051 fw logger


To add:
------
RxStreaming x4
Handle QOS prioritization
Avoid recovery while one is already in progres
Add support for the FW crash log x4
Enable BET in 2.4G
wl12xx: Stop BA session event
mac80211: Stop BA session 


AFS at myfs.r3:
Take AFS from r3-rc2
}}}
061. Prepare R4 on Blaze for 18xx {{{
        2011-05-23

git remote add wizery ssh://geryk@wizery.com/pub/wl1271.git
git checkout --track -b wizery-p2p_roc_11n wizery/p2p_roc_11n

}}}
062. Build R4 RC2 {{{
        2011-04-24
based on commit 278f02e152f84cb47a04d3e54da5e9922b79730c from wizery git

fw: 7.3.0.0.55
}}}
063. Build R3M1-RC5-Android {{{
        2011-05-15

omap kernel commit ff0b9680e4a2eeeb389f584acf8becf989ecb928
compat commit d08656f
compat-wireless-2.6 commit 6f4e670768943ec6f175435177be444f4fa84d6c
wl12xx commit 842de05fe75d07bf4cfe35e5ecd89e57ece65d2c

rm ./patches/03-*
rm ./patches/35-*
rm ./patches/40-*

Create patches for wl12xx:
-------------------------
git remote add wizery ssh://geryk@wizery.com/pub/wl1271.git
git fetch wizery
git checkout --track -b wizery-suspend_android wizery/suspend_android
git format-patch -o patches/r3m1rc5 master
commit c498a81a911e5f857020abdce63fd0d5c729a21f


To add:
------
QOS prioritization  [RFC v2]
Add support for the FW crash [v3]
Stop BA session [v2]


AFS:
Copy certs files from myfs.r3


AFS at myfs.r3: ./system/etc/certs
Take AFS from r3-rc2
}}}
064. Build R4 RC2 Build 3 {{{
        2011-05-30
based on commit 6d67e7681c8bd0ad957a8cadeca694606de8ed9d from wizery git

fw: 7.3.0.0.58
}}}
065. Calibration for R4 (mcp3.x) {{{
        2011-05-29

6d67e7681c8bd0ad957a8cadeca694606de8ed9d

INI files taken from FW_7.1.2.0.XX\7.1.4.0.56

2011-05-30
Created patch to use PLT firmware when doing calibration.
Sent t Eliad, pushed to wizery/p2p-roc-11n
fd2601a881c39
}}}
066. Add TxTone command to calibrator {{{
        2011-05-16
Open bug 92919
New command TxTone which starting transmission of
certain tone type (single tone or carrier feedthrough)


The TxTone transmission procedure:
Get in PLT mode
calibrator wlan0 plt power_mode on

Run TxTone transmission
calibrator set plt_tx_tone <power> <tone type>
Power
Tone type
 1 - Single tone
 2 - Carrier FeedThrough

Stop transmission
calibrator wlan0 plt tx_stop

Get out from PLT mode
calibrator wlan0 plt power_mode off

!!! The power parameter not functional according to bug 78376

2011-05-16 Sent to Yoni to test, cause there is no option to do it localy.

}}}
067. Build R3M1-RC5-Build 3 {{{
        2011-05-15

omap kernel commit ff0b9680e4a2eeeb389f584acf8becf989ecb928
compat commit d08656f
compat-wireless-2.6 commit 6f4e670768943ec6f175435177be444f4fa84d6c
wl12xx commit 842de05fe75d07bf4cfe35e5ecd89e57ece65d2c

rm ./patches/03-*
rm ./patches/35-*
rm ./patches/40-*

Create patches for wl12xx:
-------------------------
git remote add wizery ssh://geryk@wizery.com/pub/wl1271.git
git fetch wizery
git checkout --track -b wizery-suspend_android wizery/suspend_android
git format-patch -o patches/r3m1rc5 master
commit c498a81a911e5f857020abdce63fd0d5c729a21f


Updates:
1. calibrator
2. Eliad patch "Do not drop packet while in resuming"
3. Applied 3rd patch for system.netd

}}}
Build R4-RC1 Android {{{
        2011-06-02
Got email 
{{{
I've put a package up at:
http://wizery.com/arik/blaze-0.5.tar.bz2

basically it contains the following changes from blaze-0.3:
- a service addition to android/patches/device.ti.blaze/
- a new p2p_supplicant package in android/packages/external containing
a (slightly) modified wpa_supplicant 0.8.x
- a new "p2p_supplicant.conf" under packages/hardware/wlan/wifi_conf/
- a new "host scripts" folder in the root

Note the release is console only, no GUI is presented when in p2p mode.

The driver version I'm using is a compat based on the latest R4 code.
It can be found at:
git clone http://wizery.com/arik/git/compat.git -b mcp3

- Use the p2p_start/p2p_stop scripts to toggle p2p mode. The device
name and ip addr can be configured inside "p2p_start".
- Use "p2p_find <x>" to search for devices for <x> seconds. The found
devices are displayed at the end of the search. This command should be
run on both sides for a valid find.
- Use "p2p_connect <mac> pbc" to connect to the remote device in
push-button mode. This command should be run on both sides to create a
connection.
- Use p2p_cmd for more advanced p2p commands. See this URL for more info:
 http://hostap.epitest.fi/gitweb/gitweb.cgi?p=hostap.git;a=blob_plain;f=wpa_supplicant/README-P2P;hb=refs/heads/master
}}}

Compare android/packages between r4rc1 n r3m1rc5:
                                r3m1rc5         r4rc1
------------------------------------------------------
external/crda                   a87eddb         same
external/hostap                 4391c34         same
external/iw                     319fbad         same
external/libnl                  bbcb553         same
external/netlatency             +               -
external/testcmd                +               -
external/ti-utils               +               -
external/p2p_supplicant         -               +

hardware/fw                     +               same (BT fw in separate dir)
hardware/initial_regdom         same            same
hardware/wifi_conf              +               diff (+ p2p_supplicant.conf)
hardware/wpa_supplicant_lib     same            same


Compare android/patches between r4rc1 n r3m1rc5:
                                r3m1rc5         r4rc1
------------------------------------------------------
build                           +               +
device.ti.blaze                 1               3 patches
external.hostapd                same            same
external.openssl                same            same
external.wpa_supplicant_6       same            same
frameworks.base                 same            same
hardware.libhardware_legacy     diff            diff
system.core                     same            same
system.netd                     same            same


Build omap kernel branch r4c1
Build compat-wireless-2.6 from Arik's git (see email above)
Prepare filesystem at ~/ti/android/27.11.1/mydroid-r4

To android/packages/hardware/fw added mcp3 fw binaries and changed Android.mk
7.3.0.0.61

Do not AFS with p2p_supplicant!!! After building AFS, 
pushd external/p2p_supplicant && mm

}}}
068. Build R4 RC2 Build 4 {{{
        2011-05-29

git checkout --track -b wizery-p2p_roc_11n-2011-05-31 wizery/p2p_roc_11n

git fetch wizery
git reset --hard wizery/p2p_roc_11n

based on commit 6762e3fde3d3cfcf2dadc5543eec8daaa3c8b9ac from wizery git

wpa_supplicant and hostapd 
(branch 2011-05-31) ceb34f250af7a7082f18c1e0451dc7fbc0f000f3
CONFIG_WPS2=y for both wpa_supplicant and hostapd

fw: 7.3.0.0.58
}}}
069. Build R4 RC2 Build 5 {{{
        2011-06-05
Create build with fixed AP and deliver the source code for Intel.

git checkout --track -b wizery-p2p_roc_11n-2011-05-31 wizery/p2p_roc_11n
git fetch wizery
git reset --hard wizery/p2p_roc_11n

based on commit 99540c9c84948f01d372ae6f25140eb1101f53d8 from wizery git
The wizery git rebased on Luca 
842de05fe75d07bf4cfe35e5ecd89e57ece65d2c (2011-05-20)

Create all patches since Luca 2011-05-20:
git format-patch -o ./patches/r4/rc2-b5 --subject-prefix="PATCH"  842de05fe75d07bf4cfe35e5ecd89e57ece65d2c

wpa_supplicant and hostapd 
(branch 2011-05-31) ceb34f250af7a7082f18c1e0451dc7fbc0f000f3
CONFIG_WPS2=y for both wpa_supplicant and hostapd

fw: 7.3.0.0.61

Released 2011-06-05
}}}
070. Build R4 RC2 Build 6 {{{
        2011-06-06
Create build with fixed AP and deliver the source code for Intel.

git checkout --track -b wizery-p2p_roc_11n-2011-05-31 wizery/p2p_roc_11n
git fetch wizery
git reset --hard wizery/p2p_roc_11n

based on commit 74be328a07f6a747f470c58cca2fae7e975252b4 from wizery git
The wizery git rebased on Luca 
842de05fe75d07bf4cfe35e5ecd89e57ece65d2c (2011-05-20)

Create all patches since Luca 2011-05-20:
git format-patch -o ./patches/r4/r4-rc2-b6/wl12xx --subject-prefix="PATCH"  842de05fe75d07bf4cfe35e5ecd89e57ece65d2c

wpa_supplicant and hostapd 
(branch 2011-05-31) ceb34f250af7a7082f18c1e0451dc7fbc0f000f3
CONFIG_WPS2=y for both wpa_supplicant and hostapd

fw: 7.3.0.0.61

Released 2011-06-05
}}}
071. Build R3M1-RC5-Build 4 {{{
        2011-06-07
from Ruthy's email {{{
X wl12xx: Add Support for Low Power DRPw (LPD) Mode è Lower Power in AP mode

X [v2] mac80211: leave dynamic PS when receiving data è Solves the 3 WiFi Bugs below
    1. MCS00093061: WiFi TGn: Low TP and no A-MSDU aggregation with Ralink AP using power save.
    2. MCS00093461: : WiFi WPA2: Lower RX multicast TP than WiFi requires with power_save on.
    3. MCS00093330:   WiFi WPA2: Lower RX TP than WiFi requires with power_save on While 2 STAs are associated.

X  mac80211: fix rx->key NULL dereference during mic failure *EXPERIMENTAL*
   1. Solves Bug MCS00093190: WiFi WPA2/TGn: Kernel panic occurred after receiving the first bad mic packet with mix mode security.

X Suspend/Resume patch for 11n ping not waking up the host è Not patch but fix in the e-mail attached here
   1. Solves Bug MCS00090855: Suspend/Resume : 11n ping is is not replied by the host

X 0001-wl12xx-schedule-TX-packets-according-to-FW-occupancy.patch & 0002-wl12xx-Increase-low-high-TX-watermarks-EXPERIMENTAL.patch should solves:
   1. MCS00085607  :WiFi WMM-When the AP defined worse QoS parameters (AIFS) for the VI, the SUT still send VI more than BE
}}}

omap kernel commit ff0b9680e4a2eeeb389f584acf8becf989ecb928
compat commit d08656f
compat-wireless-2.6 commit 6f4e670768943ec6f175435177be444f4fa84d6c
wl12xx commit 842de05fe75d07bf4cfe35e5ecd89e57ece65d2c

rm ./patches/03-*
rm ./patches/35-*
rm ./patches/40-*

Create patches for wl12xx:
-------------------------
git remote add wizery ssh://geryk@wizery.com/pub/wl1271.git
git fetch wizery
git checkout --track -b wizery-suspend_android wizery/suspend_android
git format-patch -o patches/r3m1rc5 master
commit c498a81a911e5f857020abdce63fd0d5c729a21f


To add:
------
Stop BA session [v2]
Add support for the FW logger [v3]
Fix ping while resuming
Fix dynamic PS when receiving [2]
MIC failure
Support for LowPower DRPw [v4]
Tx scheduler by FW occupancy

STA fw 7.1.5.50.72
AP  fw 7.2.1.0.54

Released 2011-06-07

}}}
072. Build R3M1-RC5-Build 5 {{{
        2011-06-07
Same as R3M1-RC5 Build 4 +
wl12xx patch "Temporarily revert "Change claiming of the SDIO bus"
and support for COM6 (didn't check the COM6)

omap kernel commit ff0b9680e4a2eeeb389f584acf8becf989ecb928
compat commit d08656f
compat-wireless-2.6 commit 6f4e670768943ec6f175435177be444f4fa84d6c
wl12xx commit 842de05fe75d07bf4cfe35e5ecd89e57ece65d2c

rm ./patches/03-*
rm ./patches/35-*
rm ./patches/40-*

Create patches for wl12xx:
-------------------------
git remote add wizery ssh://geryk@wizery.com/pub/wl1271.git
git fetch wizery
git checkout --track -b wizery-suspend_android wizery/suspend_android
git format-patch -o patches/r3m1rc5 master
commit c498a81a911e5f857020abdce63fd0d5c729a21f


To add:
------
Stop BA session [v2]
Add support for the FW logger [v3]
Fix ping while resuming
Fix dynamic PS when receiving [2]
MIC failure
Support for LowPower DRPw [v4]
Tx scheduler by FW occupancy

STA fw 7.1.5.50.72
AP  fw 7.2.1.0.54

Released 2011-06-09

}}}
072. Build R3M1-RC5-WAPI Build 1 {{{
        2011-06-07
Based on R3M1-RC5 Build 5

omap kernel commit ff0b9680e4a2eeeb389f584acf8becf989ecb928
compat commit d08656f
compat-wireless-2.6 commit 6f4e670768943ec6f175435177be444f4fa84d6c
wl12xx commit 842de05fe75d07bf4cfe35e5ecd89e57ece65d2c

rm ./patches/03-*
rm ./patches/35-*
rm ./patches/40-*

Create patches for wl12xx:
-------------------------
git remote add wizery ssh://geryk@wizery.com/pub/wl1271.git
git fetch wizery
git checkout --track -b wizery-suspend_android wizery/suspend_android
git format-patch -o patches/r3m1rc5 master
commit c498a81a911e5f857020abdce63fd0d5c729a21f

Added patches to kernel:
- Add WEXT GEM configuration option

Added patch to compat-wireless:
- Added GEM cipher support in wext interface

Added patch to AFS:
- to external/wpa_supplicant_6
- to hardware/wlan

STA fw 7.1.5.50.72
AP  fw 7.2.1.0.54

Released 2011-06-09

}}}
072. Build R3M1-RC5-Build 6 {{{
        2011-06-07
Same as R3M1-RC5 Build 5

omap kernel commit ff0b9680e4a2eeeb389f584acf8becf989ecb928
compat commit d08656f
compat-wireless-2.6 commit 6f4e670768943ec6f175435177be444f4fa84d6c
wl12xx commit 842de05fe75d07bf4cfe35e5ecd89e57ece65d2c

rm ./patches/03-*
rm ./patches/35-*
rm ./patches/40-*

Create patches for wl12xx:
-------------------------
git remote add wizery ssh://geryk@wizery.com/pub/wl1271.git
git fetch wizery
git checkout --track -b wizery-suspend_android wizery/suspend_android
git format-patch -o patches/r3m1rc5 master
commit c498a81a911e5f857020abdce63fd0d5c729a21f


Added new kernel patch:
mmc fix division by zero in MMC core

Added new wl12xx patches:


STA fw 7.1.5.50.72
AP  fw 7.2.1.0.54

Released 2011-06-09

}}}
073. Build R3M1-RC5-Build 7 {{{
        2011-06-13
Same as R3M1-RC5 Build 6

omap kernel commit ff0b9680e4a2eeeb389f584acf8becf989ecb928
compat commit d08656f
compat-wireless-2.6 commit 6f4e670768943ec6f175435177be444f4fa84d6c
wl12xx commit 842de05fe75d07bf4cfe35e5ecd89e57ece65d2c

rm ./patches/03-*
rm ./patches/35-*
rm ./patches/40-*

Create patches for wl12xx:
-------------------------
git remote add wizery ssh://geryk@wizery.com/pub/wl1271.git
git fetch wizery
git checkout --track -b wizery-suspend_android wizery/suspend_android
git format-patch -o patches/r3m1rc5 master
commit c498a81a911e5f857020abdce63fd0d5c729a21f


Added new wl12xx patches:
Change in claim SDIO patch

Suspend/Resume patches:
mac80211: add cancel_hw_scan() callback  [v2]
wl12xx: add stop_scan command
wl12xx: implement cancel_hw_scan() callback [v2]

mac80211: quiesce vif before suspending

STA fw 7.1.5.50.72
AP  fw 7.2.1.0.54

Released 2011-06-14

}}}
074. wl18xx NVS changes {{{
        2011-06-14

1. Disable sending radio params from NVS to firmware
2. Use of new codebase for reg address 0x00810000

Phys addr: 0x00815548 - STA_ADDR_L - sta mac addr reg
Phys addr: 0x00815544 - STA_ADDR_H - sta mac addr reg

NVS structure:
01 6d 54 M5 M4 M3 M2 01 71 54 M1 M0 00 00

wl18xx NVS:
01 44 55 M5 M4 M3 M2 01 48 55 M1 M0 00 00

wl1271_boot() (boot.c)
|-> wl1271_load_firmware()
    |-> wl1271_boot_upload_nvs()
}}}
075. Build R3M1-RC5-Build 8 {{{
        2011-06-15
Same as R3M1-RC5 Build 7

omap kernel commit ff0b9680e4a2eeeb389f584acf8becf989ecb928
compat commit d08656f
compat-wireless-2.6 commit 6f4e670768943ec6f175435177be444f4fa84d6c
wl12xx commit 842de05fe75d07bf4cfe35e5ecd89e57ece65d2c

rm ./patches/03-*
rm ./patches/35-*
rm ./patches/40-*

Create patches for wl12xx:
-------------------------
git remote add wizery ssh://geryk@wizery.com/pub/wl1271.git
git fetch wizery
git checkout --track -b wizery-suspend_android wizery/suspend_android
git format-patch -o patches/r3m1rc5 master
commit c498a81a911e5f857020abdce63fd0d5c729a21f


Got 4 patches:
1 - wl12xx schedule TX packets according to FW occupancy == 0025 build 7
2 - mac80211 send pending Tx packets in a round robin = new
3 - wl12xx increase low high Tx watermark == 0026 build 7
4 - wl12xx implement Tx watermark per AC = new

Changes:
fix mac80211 WMM starvation

Tested:
TCP Tx for 3 min


STA fw 7.1.5.50.72
AP  fw 7.2.1.0.54

Released 2011-06-15
}}}
076. Build R3M1-RC5-Build 9 {{{
        2011-06-16
Same as R3M1-RC5 Build 8

omap kernel commit ff0b9680e4a2eeeb389f584acf8becf989ecb928
compat commit d08656f
compat-wireless-2.6 commit 6f4e670768943ec6f175435177be444f4fa84d6c
wl12xx commit 842de05fe75d07bf4cfe35e5ecd89e57ece65d2c

rm ./patches/03-*
rm ./patches/35-*
rm ./patches/40-*

Create patches for wl12xx:
-------------------------
git remote add wizery ssh://geryk@wizery.com/pub/wl1271.git
git fetch wizery
git checkout --track -b wizery-suspend_android wizery/suspend_android
git format-patch -o patches/r3m1rc5 master
commit c498a81a911e5f857020abdce63fd0d5c729a21f


Changes:
new firmware 7.1.5.50.73

STA fw 7.1.5.50.73
AP  fw 7.2.1.0.54

Released 2011-06-16
}}}
077. wl18xx - Add stuff to debugfs {{{
        2011-06-15

  Here are the list of ini parameters to add for the WL8 project:
  RecoveryEnable          # 0 -Disabled 1- Enabled

! TxAggregationPktsLimit  # Disable Tx pkts aggregation (degrades TP)
! RxAggregationPktsLimit
! TxCompleteThreshold
! RxInterruptThreshold    - 
  BaPolicyTid_0
  SdioBlkSizeShift

Rx
  .packet_detection_threshold - ACX_PD_THRESHOLD
  .irq_pkt_threshold - ACX_RX_CONFIG_OPT - nbr of pkts when to irq
  .irq_timeout       - ACX_RX_CONFIG_OPT - tout when to irq
  .irq_blk_threshold - ACX_RX_CONFIG_OPT - nbr of mem blks when to irq
  .queue_type        - ACX_RX_CONFIG_OPT

Created 3 patches:
0001-wl18xx-Make-Rx-and-Tx-interrupt-pacing-configurable.patch
0001-wl18xx-Add-ability-to-cfg-the-Tx-aggr-pkts-limit.patch
0001-wl18xx-Add-ability-to-cfg-Rx-aggr-pkts-limit.patch

Finished 2011-06-20
}}}
078. Build R3M1-RC5-Build 1x {{{
        2011-06-16
To test WMM tests 5.2.27, 5.2.30, 5.2.32

omap kernel commit ff0b9680e4a2eeeb389f584acf8becf989ecb928
compat commit d08656f
compat-wireless-2.6 commit 6f4e670768943ec6f175435177be444f4fa84d6c
wl12xx commit 842de05fe75d07bf4cfe35e5ecd89e57ece65d2c

rm ./patches/03-*
rm ./patches/35-*
rm ./patches/40-*

Create patches for wl12xx:
-------------------------
git remote add wizery ssh://geryk@wizery.com/pub/wl1271.git
git fetch wizery
git checkout --track -b wizery-suspend_android wizery/suspend_android
git format-patch -o patches/r3m1rc5 master
commit c498a81a911e5f857020abdce63fd0d5c729a21f

--- Build 10 based on build 9 {{{

Removed patches:
FW Logger:
    0020  wl12xx Support routing FW logs to the host
    0021  wl12xx Allow disabling the bus FW Logger
Low Power DRP:
    0024  Add support for Low Power DRPw
SDIO claim:
    0027  Temporary revert Change claiming of the SDIO
    0033  Add claim patch

Changed STA fw to 7.1.4.50.63
AP  fw 7.2.1.0.54

Released 2011-06-16
}}}
--- Build 11 {{{
based on build 10 
Low Power DRP:
    Add support for Low Power DRPw

STA fw to 7.1.4.50.63
AP  fw 7.2.1.0.54

Released 2011-06-16
}}}
--- Build 12 {{{
based on build 11 
Added patches
FW Logger:
    0020  wl12xx Support routing FW logs to the host
    0021  wl12xx Allow disabling the bus FW Logger

Changed STA fw to 7.1.4.50.73
AP  fw 7.2.1.0.54

Released 2011-06-19
}}}
--- Build 13 {{{
        2011-06-19
based on build 12 
Added patches:
Low Power DRP:
    Add support for Low Power DRPw
FW Logger:
    0020  wl12xx Support routing FW logs to the host
    0021  wl12xx Allow disabling the bus FW Logger

Change STA fw to 7.1.4.50.73

AP  fw 7.2.1.0.54

Released 2011-06-19
}}}
--- Build 14 {{{
        2011-06-20
based on build 10 
Changed STA fw to 7.1.4.50.73
AP  fw 7.2.1.0.54

Released 2011-06-20
}}}
--- Build 15 {{{
        2011-06-20
based on b10

Added patches:
Low Power DRP:
    0024 Add support for Low Power DRPw
SDIO claim:
    0027  Temporary revert Change claiming of the SDIO
    0033  Add claim patch

Changed STA fw to 7.1.4.50.73_S
AP  fw 7.2.1.0.54

Released 2011-06-20
}}}

Result table {{{

        5.2.27  5.2.30  5.2.32

b10       v       v       v


b11
1

b12
1,2,4

b13
1,2

b14
4

b15       v       ?       ?
1,3,5

1. LDP patch
2. FW Log
3. Claim SDIO
4. FW 73
5. FW 73_S
}}}

2011-06-21 Found problem at testing setup. Retest of b9 gives pass on all
 tests.
The build 9 released as final.

--- Build 16 {{{
        2011-06-28
based on b9

Added patches:
Added wl12xx Stop BA session (missed in b9)

Changed STA fw to 7.1.5.50.74
AP  fw 7.2.1.0.54

Released 2011-06-28
}}}

2011-06-30 The build 16 is the release. All tests passed.

}}}
079. wl18xx - Change frag_threshold to be configurable {{{
        2011-06-28
To make Tx frag threshold configurable from debugfs

The parameter fragmentation threshold defines for fw how to fragment packets.

The default value is IEEE80211_MAX_FRAG_THRESHOLD, which is
  2352 (include/linux/ieee80211.h)

acx.c
wl1271_acx_frag_threshold()

FW:
ACX_FRAG_CFG

2011-06-29 Patch sent
}}}
080. ti-utils - update firmware and create new branch for r4 {{{
        2011-07-03
Update fw binaries n INI files to 7.1.5.50.74

Create new branch for R4:
git push origin origin:refs/heads/r4-master
git checkout --track -b r4-master origin/r4-master
git push origin r4-master

Updated firmware for R4 to 7.3.1.0.66 and INI files according.

}}}
081. Native Linux on Blaze boot from NFS {{{
        2011-07-05
Native Linux based wl12xx-2011-06-27

--- Kernel

Apply patches from ./patches/blaze/v3.0-rc4
0001-Revert-mfd-Add-omap-usbhs-runtime-PM-support.patch
0002-Fix-omap44xx-i2c-fix.patch
patches/blaze/v3.0-rc4/0003-omap-blaze-add-mmc5-wl1283-device-support.patch

--- U-boot cfgs

setenv ethaddr '08:00:28:01:55:51'
setenv loadaddr 0x80000000
setenv bootargs 'console=ttyO2,115200n8 mem=512M noinitrd root=/dev/nfs rw nfsroot=172.16.1.11:/opt/rootfs/blaze,tcp,rsize=4096,wsize=4096 ip=172.16.1.7:172.16.1.254::255.255.255.0::eth0:down'
setenv mmcboot 'mmcinit 0; fatload mmc 0 ${loadaddr} uImage; bootm ${loadaddr}'
setenv bootfile 'blaze/uImage'
setenv netboot 'tftp ${loadaddr} ${bootfile}; bootm ${loadaddr}'
setenv bootcmd 'run netboot'

Use kernel config .config-v3.0-rc4-blaze


}}}
082. Calibration - To move from MCP to NVS (Sharp) {{{
        2011-07-05
Create procedure to move calibrated NVS from MCP to NVS

Got NVS file from Sharp created on MCP based on muRata radio INI file.
~/ti/support/sharp/nvs1273_0021E87268AE.bin   - calibrarted NVS from MCP
~/ti/support/sharp/muRata_NVS_INI_110705.zip  - the muRata's INI file

Solution:
./calibrator set upd_nvs <path to ini> <path to nvs>
The NVS parameter can point to MCP NVS file (shorter).


2011-07-05 ended
}}}
083. Bug 94641 {{{
        2011-07-11
The firmware crash with TxCont command when 3rd parameter (Size of data field 
in MPDU) is > 1800. Works fine till 1750.

2011-07-11 Sent email to Ilan Z.
Decided that is low priority.
}}}
084. Bug 95539 {{{
        2011-07-11
The power parameter of TxTone command doesn't influences the output.
Also found bugs with same problem: 78376, 58310

2011-07-11 Sent email to Yaki
According to Yaki, Known issue, wont fix.
}}}
085. Rename go.sh to wl12xx-tool.sh {{{
        2011-07-14
There are number of features added to it:
1. Ability to set MAC address in NVS
2. Rework to run under Android with busybox
3. Fix resetting of dynamic debug
4. Start using modprobe

All those changes currently placed in branch r4-master
}}}
088. Support NVS ver 2.1 {{{
        2011-07-11
The NVS ver 2.1 designed for different TxBip sequence.
There is need for new command (TEST_CMD_SET_NVS_VERSION) before the TxBip. Also
the NVS version in the NVS file should be 2.1

Porblem: the command TEST_CMD_SET_NVS_VERSION value depends on arch (127|8x)
Need new way to find which chip arch from user space.
Solution: patch to export chip.id from sysfs 
(/sys/devices/platform/wl1271/chip_id)
Getting HW version and FW version from ioctl {{{

ethtool -i and -d
do_gregs()
|-> cmd = ETHTOOL_GDRVINFO
|-> send_ioctl SIOCETHTOOL and gets drvinfo.regdump_len
|-> cmd = ETHTOOL_GREGSa and len = drvinfo.regdump_len
|-> send_ioctl SIOCETHTOOL

kernel:
ethtool_get_drvinfo() (net/core/ethtool.c)
|-> calls device ops->get_drvinfo which fills struct ethtool_drvinfo info
|   cfg80211_get_drvinfo() (net/wireless/ethtool.c)
|   copy fw_version,driver name, kernel ver, fw version n bus info from 
|   wiphy to struct ethtool_drvinfo
|
|-> calls device ops->get_regs_len and returns to user info.regdump_len
    cfg80211_get_regs_len() (net/wireless/ethtool.c) which always returns 0

ethtool_get_regs() (net/core/ethtool.c)
|-> copy from user struct ethtool_regs regs
|-> ethtool_get_regs() (net/core/ethtool.c) get register length
    |-> cfg80211_get_regs() (net/wireless/ethtool.c)
    allocate mem for registers according to length given by user or
    by cfg80211_get_regs()

wl12xx:
in PLT mode misses to copy hw_version from wiphy to struct ethtool_regs
}}}

2011-07-14 Sent 2 patches
  0001-wl12xx-Fix-for-PG-version-and-sysfs-files.patch
  0002-wl12xx-Export-chip-id-to-sysfs.patch
2011-07-15
  Got comment from Kalle Valo that there is ioctl (from ethtool) which
  brings HW version to userspace already
2011-07-17
  Sent answer that ioctl is heavy broken...
2011-07-18
  Kalle sent fix for ethtool datapath. Send again my 1st patch with additional
  fix - to copy chip id in wipht in PLT mode
  Sent new patch instead of previous 2:
  0001-wl12xx-fixes-for-hw_pg_ver-and-chip-id-reporting.patch
2011-08-01 Sent patch to ti-utils, 1 patch to Eliad's wl12xx and 1 patch
to Ido for Android kernel

}}}
089. Use WL12XX_TUNE n WL12XX_TUNE for tx_cont and tune_channel {{{
        2011-08-11
from Dinesh: repeated call for tx_cont causes firmware crash.

Solution: Update HowtoProduction doc to mandatory use of tx_stop after each
tx_cont.
Also add use of WL12XX_TUNE n WL12XX_TUNE for tx_cont and tune_channel

2011-08-11 Upstreamed to r4-master
}}}

Change NVS filename {{{
        2011-08-14
To change NVS file name from wl1271-nvs.bin to wl127x-nvs.bin and 
wl128x-nvs.bin

Solution: Patch to the driver, change of ti-utils to be able to use new
filenames.

git commit -a -m "Change NVS filename to wl[7|8]x-nvs.bin"
git format-patch -s -1 -o ../patches/ti-utils/ --subject-prefix="PATCH"
../../wl12xx/scripts/checkpatch.pl ../patches/ti-utils/0001-Change-NVS-filename-to-wl-7-8-x-nvs.bin.patch

2011-08-15 Upstream calibrator changes. Sent driver patch to local ml
}}}

0xx. Bug 95319 - get list of candidates for roaming {{{
previous Bug 88549 - Howto get list of candidates {{{

wpa_cli -p /var/run/wpa_supplicant -iwlan0 bgscan print

git send-email --suppress-cc=self --suppress-cc=sob --annotate --from "Gery Kahn <geryk@ti.com>" --to "<hostap@lists.shmoo.com>" --cc "Jouni Malinen <j@w1.fi>" ../../patches/hostap/roaming_2011-03-03/0001-bgscan-Update-the-initial-value-of-time-interval-for.patch

2011-03-06 sent to mcs ml
0001-Add-command-to-wpa_cli-to-print-roam-candidates.patch

 hostap@lists.shmoo.com

}}}

Prepare internal v2:
Introduce new bgscan operation list_candidates()
bgscan.h
bgscan.c
bgscan_learn.c
Add wpa_cli command for list of roaming candidates
wpa_cli.c
ctrl_iface.c


wpa_cli -p /var/run/wpa_supplicant -iwlan0 list_candidates

git commit -a -m "Add wpa_cli command to show roaming candidates"
git format-patch -o ../patches/hostap/print_candidates/ -1 --subject-prefix="PATCH" -s
../../wl12xx/scripts/checkpatch.pl ../patches/hostap/print_candidates/0001-Add-wpa_cli-command-to-show-roaming-candidates.patch


2011-07-26 Sent new patch to internal ml
0001-bgscan_learn-Provide-roaming-candidate-list-with-cli.patch

2011-07-27 Seems not good. The bgscan functionality should be encaosulated
in bgscan code. Rework, to introduce new function list_candidates()
in bgscan_ops.

2011-07-28 Sent 2 patches with re-work to local ml and hostap ml
0000-cover-letter.patch
0001-New-bgscan-operation-for-list-of-candidates.patch
0002-Add-wpa_cli-command-for-list-of-roaming-candidates.patch

2011-08-01 After email from Sam Lefler, rewrite the patch

2011-08-04 New patch sent localy.
Changes:
* Copyright (c) 2011, Texas Instruments
* ssid.h - Remove line
    wpa_dbg(wpa_s, MSG_INFO, "No RSN_IE");
         - Change MSG_INFO to MSG_DEBUG

2011-08-07 Sent patch to hostap ml v2

}}}

0xx. Set RSSI event to type LEVEL at first {{{
        2011-08-09
wl1271_irq() (main.c) - from fw
|-> wl1271_event_handle()
    |-> wl1271_event_process() (event.c)
        |-> wl1271_event_rssi_trigger()

wl1271_op_bss_info_changed() == .bss_info_changed (struct ieee80211_ops)
|-> wl1271_bss_info_changed_sta()
    |-> wl1271_acx_rssi_snr_trigger() (acx.c)

git commit -a -m "Set rssi event to type level only once"
git format-patch -o ./patches/rssi_event/ -1 -s --subject-prefix="PATCH v3"
./scripts/checkpatch.pl patches/rssi_event/0001-Set-rssi-event-to-type-level-only-once.patch
git send-email --suppress-cc=self --suppress-cc=sob --annotate --from "Gery Kahn <geryk@ti.com>" --to "<mcs-mac80211@list.ti.com>" --cc "Luciano Coelho <coelho@ti.com>" patches/rssi_event/0001-Set-rssi-event-to-type-level-only-once.patch

2011-08-09 Sent internal patch
2011-08-10 Sent internal patch v2
2011-08-11 Sent internal v3 - Simplify logic y sending the rssi_type as 
        argumentto wl12xx_acx_rssi_snr_trigger()
2011-08-14 Sent internal v4 - Init the rssi_* at *_alloc_hw() and
        *_op_remove_interface(); add comments; add WARN_ON on fail of trigger
        call.
}}}

0xx. Remove driver in PLT mode {{{
        2011-08-14
Problem output {{{
blazik login: root
root@blazik:~# ./wl12xx-tool.sh -b 7
        ------------         ------------

        ---===<<<((( WELCOME )))>>>===---

        ------------         ------------

+++ Mount the debugfs on /sys/kernel/debug
+++ Reload mac80211 framework
[   98.035095] cfg80211: Calling CRDA to update world regulatory domain
+++ Load wl12xx driver
[  103.625671] cfg80211: World regulatory domain updated:
[  103.631103] cfg80211:     (start_freq - end_freq @ bandwidth), (max_antenna_gain, max_eirp)
[  103.639923] cfg80211:     (2402000 KHz - 2472000 KHz @ 40000 KHz), (300 mBi, 2000 mBm)
[  103.648254] cfg80211:     (2457000 KHz - 2482000 KHz @ 20000 KHz), (300 mBi, 2000 mBm)
[  103.656616] cfg80211:     (2474000 KHz - 2494000 KHz @ 20000 KHz), (300 mBi, 2000 mBm)
[  103.664947] cfg80211:     (5170000 KHz - 5250000 KHz @ 40000 KHz), (300 mBi, 2000 mBm)
[  103.673278] cfg80211:     (5735000 KHz - 5835000 KHz @ 40000 KHz), (300 mBi, 2000 mBm)
[  106.050201] wl1271_sdio mmc2:0001:2: wlan0: Features changed: 0x00004800 -> 0x00004000
[  106.062622] wl1271: loaded
root@blazik:~# [  135.532501] wl1271: power up
[  136.463470] wl1271: firmware booted in PLT mode (PLT 7.3.0.0.77)
[ 3446.048797] wl1271: power down
[ 3446.052154] 
[ 3446.052154] =====================================
[ 3446.058654] [ BUG: bad unlock balance detected! ]
[ 3446.063598] -------------------------------------
[ 3446.068511] rmmod/1206 is trying to release lock (&wl->mutex) at:
[ 3446.075012] [<bf0aa48c>] __wl1271_plt_stop+0x64/0xa0 [wl12xx]
[ 3446.081024] but there are no more locks to release!
[ 3446.086151] 
[ 3446.086151] other info that might help us debug this:
[ 3446.093017] 2 locks held by rmmod/1206:
[ 3446.097045]  #0:  (&__lockdep_no_validate__){+.+.+.}, at: [<c0283ee8>] driver_detach+0x68/0xb4
[ 3446.106109]  #1:  (&__lockdep_no_validate__){+.+.+.}, at: [<c0283ef8>] driver_detach+0x78/0xb4
[ 3446.115173] 
[ 3446.115173] stack backtrace:
[ 3446.119781] [<c0055028>] (unwind_backtrace+0x0/0x120) from [<c00b450c>] (print_unlock_inbalance_bug+0x98/0xc8)
[ 3446.130310] [<c00b450c>] (print_unlock_inbalance_bug+0x98/0xc8) from [<c00b6398>] (lock_release+0x1c4/0x1f8)
[ 3446.140624] [<c00b6398>] (lock_release+0x1c4/0x1f8) from [<c03eaf04>] (__mutex_unlock_slowpath+0xe8/0x160)
[ 3446.150817] [<c03eaf04>] (__mutex_unlock_slowpath+0xe8/0x160) from [<bf0aa48c>] (__wl1271_plt_stop+0x64/0xa0 [wl12xx])
[ 3446.162109] [<bf0aa48c>] (__wl1271_plt_stop+0x64/0xa0 [wl12xx]) from [<bf0ac400>] (wl1271_unregister_hw+0x18/0x38 [wl12xx])
[ 3446.173858] [<bf0ac400>] (wl1271_unregister_hw+0x18/0x38 [wl12xx]) from [<bf0e55b8>] (wl1271_remove+0x30/0x70 [wl12xx_sdio])
[ 3446.185638] [<bf0e55b8>] (wl1271_remove+0x30/0x70 [wl12xx_sdio]) from [<c0321ccc>] (sdio_bus_remove+0x40/0x124)
[ 3446.196258] [<c0321ccc>] (sdio_bus_remove+0x40/0x124) from [<c0283e34>] (__device_release_driver+0x84/0xd0)
[ 3446.206512] [<c0283e34>] (__device_release_driver+0x84/0xd0) from [<c0283f0c>] (driver_detach+0x8c/0xb4)
[ 3446.216461] [<c0283f0c>] (driver_detach+0x8c/0xb4) from [<c02830d0>] (bus_remove_driver+0xb4/0xe4)
[ 3446.225891] [<c02830d0>] (bus_remove_driver+0xb4/0xe4) from [<c00bdd50>] (sys_delete_module+0x1d8/0x250)
[ 3446.235839] [<c00bdd50>] (sys_delete_module+0x1d8/0x250) from [<c004e740>] (ret_fast_syscall+0x0/0x3c)

}}}

Solution:
Change wl1271_unregister_hw() to 

        if (wl->state == WL1271_STATE_PLT) {
                mutex_lock(&wl->mutex);
                __wl1271_plt_stop(wl);
                mutex_unlock(&wl->mutex);
        }

2011-08-15 Sent patch to internal ml
}}}

Power on the device to read chip id {{{
        2011-08-15

2011-08-15 Sent RFC to internal ml

git commit -a -m "Power on the device on probe"
git format-patch -o ./patches/power_on/ -1 -s --subject-prefix="RFC"
./scripts/checkpatch.pl patches/power_on/0001-Power-on-the-device-on-probe.patch

}}}

ieee80211_authenticate()
|-> ieee80211_disassoc_only() - set diassoc w/o sending pkt


.assoc = ieee80211_assoc() (struct cfg80211_ops)
|_> ieee80211_mgd_assoc() (net/mac80211/mlme.c)
    |_> ieee80211_add_work()
        |_> ieee80211_queue_work()

ieee80211_associate()
|-> ieee80211_send_assoc()



Roaming {{{
        08nov2010 2011-07-06

Introduction {{{

Roaming is reconnecting to another AP with the same ESS and the same
security type.


The bgscan is wpa_supplicant feature to execute scanning to ...
The parametes of bgscan algorithm are provided by configuration.

The bgscan initialized while wpa_supplicant gets association event 
(wpa_supplicant_event_assoc()), based on parameters from wpa_supplicant
config file. It deinitialized if disassociation event arrives.

There is bgscan update, while wpa_supplicant event EVENT_SIGNAL_CHANGE. The
event informs if the RSSI above the threshold.
If signal is below the threshold set the system to do scanning with shorter
interval. If last scan happened less then 1 sec before do immediate scan.
If signal is above the threshold set the system to do scanning with longer
interval.

     | below | above |    A. Set interval to short and if was scanned more
---------------------|       then 1 sec before, immediate scan
short|  C    |  B    |    B. Set interval to long
---------------------|
long |  A    |       |    C. If was scanned more then 10 sec before,
---------------------/       immediate scan

It initiates scanning every timeout, which value depends on signal strength.

--- Bgscan algos
Current (15dec2010) there are 2 types of bgscan algos: simple and learn.
Only 1 kind of bgscan can be used, based on wpa_supplicant configuration.
The default hyst for both algos is 4.

Simple (bgscan_simple)
Has 3 parameters: short time interval, signal threshold, and long time interval
(from conf file: simple:30:-45:300).
While signal strength is below the threshold - to do scanning with short time
interval. While signal strength is above the threshold - to do scanning with
long time interval.

Learn (bgscan_learn)
Has 4 parameters: short time interval, signal threshold, long time interval
and file name.

}}}
BGSCAN {{{

--- Initialization
Initialization of bgscan happened while the state of wpa_supplicant changed 
to WPA_COMPLETED.

wpa_supplicant_set_state() (wpa_supplicant/wpa_supplicant.c)
|-? WPA_COMPLETED
    wpa_supplicant_start_bgscan()
    |-? wpa_s->current_ssid->bgscan

In opposite, the deinitialization of bgscan happened while the state of 
wpa_supplicant changed from WPA_COMPLETED to another.

wpa_supplicant_set_state() (wpa_supplicant/wpa_supplicant.c)
|-? !WPA_COMPLETED
    wpa_supplicant_stop_bgscan()
    |-> bgscan_deinit()

The init step calls for ini func of bgscan module. Which modules to use defined
in config file parameter named bgscan. 
Desribing of bgscan_learn module.

Get configuration parameters - short n long interval, signal threshold.
Load previously collected list of candidates.
Collect supported freqs.
Set timeout with handler

--- Init of bgscan at association (init)

wpa_supplicant :
process_event() (hostap/src/drivers/driver_nl80211.c)
|-? mlme_event() - if NL80211_CMD_ASSOCIATE
|   |-> mlme_event_assoc()
|       |-> wpa_supplicant_event() - on event EVENT_ASSOC
|           |-> wpa_supplicant_event_assoc() (hostap/wpa_supplicant/events.c)
|               |-> wpa_supplicant_set_state() on WPA_COMPLETED
|               |   (wpa_supplicant/wpa_supplicant.c)
|                   |-> bgscan_learn_deinit()
|                   |-> bgscan_learn_init()
|                       |-> .signal_monitor = nl80211_signal_monitor()
|                       |   (src/drivers/driver_nl80211.c)
|                           |-> send to drv NL80211_CMD_SET_CQM
|-? mlme_event_connect() - NL80211_CMD_CONNECT
|   |-> wpa_supplicant_event() - on event EVENT_ASSOC
|-? mlme_event_join_ibss() - NL80211_CMD_JOIN_IBSS
|   |-> wpa_supplicant_event() - on event EVENT_ASSOC

--- Scanning results (notify_scan):

wpa_driver_nl80211_scan_timeout()
or
process_event() NL80211_CMD_NEW_SCAN_RESULTS or NL80211_CMD_SCAN_ABORTED
|-> send_scan_event()
calls
|-> wpa_supplicant_event(EVENT_SCAN_RESULTS)
|   |-> mlme_event_assoc()
|       |-> wpa_supplicant_event() - on event EVENT_SCAN_RESULTS
|           (hostap/wpa_supplicant/events.c)
|           |-> wpa_supplicant_event_scan_results()
|               |-> _wpa_supplicant_event_scan_results()
|                   |-> wpa_supplicant_notify_scanning()
|                   |-> wpa_supplicant_get_scan_results()
|                   |   |-> wpa_drv_get_scan_results2()
|                   |   |-> wpa_bss_update_start()
|                   |   |-> wpa_bss_update_scan_res()
|                   |   |   Add or update bss list entry with scan res info
|                   |   |_> wpa_bss_update_end()
|                   |-> bgscan_notify_scan()
     ROAMING
|                   |-> wpa_supplicant_pick_network()
|                   |   select 1st bss from known network which
|                   |   |-> wpa_supplicant_select_bss()
|                   |   |   |-> wpa_scan_res_match()
|                   |   |   |   find most prior network for scanned bss
|                   |   |   |_> wpa_bss_get()
|                   |   |       find bss from bss list by ssid, bssid
|                   |-> wpa_supplicant_need_to_roam()
|                   |   if connected AP not in scan_res => roam to selected bss
|                   |   if selected bss is the configured one => roam to it
|                   |   compare selected bss vs connected and roam
|      start        |-> wpa_supplicant_connect() (events.c)
|                   |   |-> wpa_supplicant_associate()
|                   |       |-> sme_authenticate()
|                   |   |->...
|                   |-> wpa_supplicant_rsn_preauth_scan_results()

--- Signal change (notify_signal_change)

process_event() (src/drivers/driver_nl80211.c) on NL80211_CMD_NOTIFY_CQM
|-> nl80211_cqm_event()
    |-> wpa_supplicant_event() EVENT_SIGNAL_CHANGE (wpa_supplicant/events.c)
        |-> bgscan_notify_signal_change()
            |-? if short==long or signal_thld==0 return
            |-> depends on signal change, reset timer to short or long interval

--- Beacon loss - N/A

--- Roaming flow
Started by calling wpa_supplicant_connect()
|-> wpa_supplicant_associate()
    |-> sme_authenticate() (wpa_supplicant/sme.c)
        |-> wpa_drv_authenticate()
            |-> wpa_driver_nl80211_authenticate()
                |-> ...

wpa_supplicant_event(EVENT_AUTH)
|-> sme_event_auth( )
    |-> sme_associate()
        |-> ...
        |-> wpa_drv_associate()
            |-> wpa_driver_nl80211_associate()


--- wpa_supplicant eloops

eloop_cancel_timeout()

eloop_register_timeout()

}}}

--- Compilation {{{
The bgscan can be used if wpa_supplicant compiled with the options
NEED_BGSCAN
CONFIG_BGSCAN_LEARN
}}}
--- Usage n configuration {{{
The wpa_supplicant.conf prms:
bgscan=<module>:<module param>
Simple
bgscan="simple:30:-45:300"
Learn
bgscan="learn:30:-45:300:/etc/bgscan_learn.txt"

wpa_cli -p /var/run/wpa_supplicant -iwlan0 scan_results
}}}

--- Load drv, fw, app {{{

DRV :
wl1271_op_add_interface()
|-> wl1271_hw_init()
    |   |-> ...
    |-> wl1271_acx_rssi_snr_avg_weights()
    |   ACX_RSSI_SNR_WEIGHTS - rssi beacon, rssi data, snr beacon, snr data

FW :
WriteInfoEle() (infoele.c)
|-> RoamingTriggersSetTriggerWeights() (roaming_trigger.c)

wpa_supplicant :

}}}
--- Connection {{{
DRV :
mac80211_config_ops = {
.assoc = ieee80211_assoc() (net/mac80211/cfg.c)
ieee80211_mgd_assoc() (net/mac80211/mlme.c)
ieee80211_assoc_done()
|-> ieee80211_assoc_success()
    |-> ieee80211_set_associated()
        |-> ieee80211_bss_info_change_notify() - BSS_CHANGED_CQM
            |-> drv_bss_info_changed()
                |-> bss_info_changed = wl1271_op_bss_info_changed()
                |   (drivers/net/wireless/wl12xx/main.c)
                |   
                |   |-> wl1271_acx_rssi_snr_trigger()
                        | (drivers/net/wireless/wl12xx/acx.c)
                        | idx=0, dir=bidi, pacing
                        | metric=rssi_bcn, type=edge
                        |->
wpa_supplicant :
process_event() (hostap/src/drivers/driver_nl80211.c)
|-? mlme_event() - if NL80211_CMD_ASSOCIATE
|   |-> mlme_event_assoc()
|       |-> wpa_supplicant_event() - on event EVENT_ASSOC
|           |-> wpa_supplicant_event_assoc() (hostap/wpa_supplicant/events.c)
|               |-> bgscan_learn_deinit()
|               |-> bgscan_learn_init()
|                   |-> .signal_monitor = nl80211_signal_monitor()
|                   |   (src/drivers/driver_nl80211.c)
|                       |-> send to drv NL80211_CMD_SET_CQM
|-? mlme_event_connect() - NL80211_CMD_CONNECT
|   |-> wpa_supplicant_event() - on event EVENT_ASSOC
|-? mlme_event_join_ibss() - NL80211_CMD_JOIN_IBSS
|   |-> wpa_supplicant_event() - on event EVENT_ASSOC

DRV: see configuration mac802.11 layer

FW:
there is struct RssiSnrTriggerCfg_t updated by cmd ACX_RSSI_SNR_TRIGGER.
The cmd can set a rule (up to 8) for fw. Fields of struct:
threshold - 
pacing - delay (0-60000ms) between triggers
metric - Look for Beacon|Data whre RSSI|SNR - obly 1 option
type - edge (one time) or level (every time)
direction - low, high, bidi
hystersis - range (0-255dB) around thold
index - rule nbr (0-7)
enable - activate the rule (1-act,2-dis)
u2 p[2] - padding

}}}
--- Configuration {{{

Set RSSI thold n hyst from iw (iw dev xxx cqm rssi <thold|off> [hyst]):
(4exam - (set thold -90 +-2) - iw wlan0 cqm rssi -90 2
cqm - connection quality monitor

        send NL80211_CMD_SET_CQM

iw_cqm_rssi() (iw/cqm.c)

mac802.11 :
struct genl_ops nl80211_ops[] (net/wireless/nl80211.c)
    .cmd = NL80211_CMD_SET_CQM,
    .doit = nl80211_set_cqm
nl80211_set_cqm()
|-> nl80211_set_cqm_rssi()
    |-> ieee80211_set_cqm_rssi_config() == set_cqm_rssi_config 
    |   (net/mac80211/cfg.c)
        |-? ieee80211_bss_info_change_notify() - if not assoc
        |   (net/mac80211/main.c)
        |   |  called w/ BSS_CHANGED_CQM
            |-> ...    
            |_> drv_bss_info_changed() (net/mac80211/driver-ops.h)
wl12xx :        |-> bss_info_changed() == wl1271_op_bss_info_changed()
                    |   (drivers/net/wireless/wl12xx/main.c)
                    |-> wl1271_acx_rssi_snr_trigger()
                        | (drivers/net/wireless/wl12xx/acx.c)
                        | idx=0, dir=bidi, pacing
                        | metric=rssi_bcn, type=edge
                        |->

wpa_supplicant_deauthenticate() (wpa_supplicant/wpa_supplicant.c)
sme_event_assoc_reject() (wpa_supplicant/sme.c)
sme_event_disassoc()
|-> wpa_drv_deauthenticate()
wpa_driver_nl80211_ops =
.deauthenticate = wpa_driver_nl80211_deauthenticate()
|-> wpa_driver_nl80211_mlme()
|   (...,NL80211_CMD_DEAUTHENTICATE,...)
DRV :
nl80211_deauthenticate
cfg80211_mlme_deauth()
__cfg80211_mlme_deauth()
}}}

BSS loss {{{
        Driver gets event (BSS_LOSE_EVENT_ID) from fw and       

FW: After missinig nbr of beacons (configurable threshold) from AP, set timer
(configured by drv at assoc). Send prob-req w PS disabled. If timeout and no
resp, event BSS_LOSE_EVENT_ID to drv.

Drv:
(cfg)driver cfg the fw by cmd (ACX_CONN_MONIT_PARAMS) w 2 params thold n
timeout.
It does cfg at boot (wl1271_plt_init()|wl1271_op_add_interface()) w disable
values (0xffffffff). Also if associated status changed. If become disassoc,
cfg w disable params or if become assoc cfg w thold=10 and timeout=100.
(run)Gets event BSS_LOSE_EVENT_ID and does connection loss flow (send multicast
deauth).


FW Code:
TSFOutOfSyncSendProbeReq()

Set BSS Loss, TSF sync params:
SetConnectionMonitoringParams()

Drv code:
                                                wl1271_op_add_interface()
                                                        |
wl1271_op_bss_info_changed()   wl1271_plt_init()   wl1271_hw_init()
|-> wl1271_acx_conn_monit_params()
    |-> wl1271_cmd_configure(..., ACX_CONN_MONIT_PARAMS,...)

}}}
}}}
Bug 96122 {{{
        2011-07-11
Roaming: SUT sends unnecessary Null Data packets while roaming to another AP

Measure trace for roaming datapath

from Luca
first you need to unset CONFIG_OMAP_32K_TIMER in your .config (otherwise the timer is not accurate enough) then, install trace-cmd (not entirely necessary, but it's much easier to use) then this is what I was using to trace some functions (those in -l "") while pinging:
trace-cmd record  -p function_graph -l "ieee80211_subif_start_xmit" -l "wl1271_tx_work" -l "wl1271_tx_complete" -l "ieee80211_tx_status" -o ~/trace.dat ping 192.168.0.1 -c 1 -s 1432 ; trace-cmd report

wl1271_cmd_role_enable
wl1271_cmd_role_disable
wl1271_cmd_role_start_dev
wl1271_cmd_role_stop_dev
wl1271_cmd_role_start_sta
wl1271_cmd_role_stop_sta

trace-cmd record -p function_graph -l "wl1271_cmd_role_enable" -l "wl1271_cmd_role_disable" -l "wl1271_cmd_role_start_dev" -l "wl1271_cmd_role_stop_dev" -l "wl1271_cmd_role_start_sta" -l "wl1271_cmd_role_stop_sta" -o /tmp/trace.dat

}}}
Bug 88512 {{{
        2011-03-09
Before sent BSSLoss event fw sends 10 prob/req to disconnected AP and >200
NullData pkts to the AP.


Setup:
ifconfig wlan0 up
iw wlan0 connect abcd11
Switch radio off on the connected AP.

Sniffer shows:
1 ProbReq to the AP + 9 retries
1 NullData to the Ap + >200 retries
1 Action to the AP + 9 retries

Description:
The ProbeReqs send because of timeout period 


On MCP side:

currBss_registerBssLossEvent() (stad/src/Sta_Management/currBss.c)
|-> currBSS_BssLossThresholdCrossed()
    |-> EvHandlerSendEvent() - call to userspace
    |_> currBSS_reportRoamingEvent()
        |_> sme_Restart() (stad/src/Connection_Managment/sme.c)
            |_> sme_SmEvent( SME_SM_EVENT_DISCONNECT, )

}}}


TODO: {{{

 Patches:
d wl12xx: fixes for hw_pg_ver and chip id reporting
  2011-07-18 sent upstream. applied.
  
  hostap: Get roaming candidates from cli
  2011-07-28 sent upstream

  r4 wl12xx: force to fetch firmware after change mode
  2011-07-20 sent internal, accepted in wizery2 3cc9eeee9

  

 Calibrator:
  1. Support new FEMs: SKW and RFMD Dual
  2. Change `echo -e' in `printf' in go.sh
  4. Support NVS version 2.1 ( as you said only for RFMD support)

 Filesystem:
  1. Add CONFIG_WPS2 to wpa_supplicabt for R4
  2. Add hostapd.conf and change ap_test.sh
  3. Create Ubuntu fs
     apt-get install rootstock
     https://wiki.ubuntu.com/ARM/RootfsFromScratch
     apt-get remove --purge network-manager
  2011-03-14 {{{
  sudo rootstock -f panda4me -l nlcp --serial ttyO2 --imagesize 500M
  sudo rootstock -f panda4me -l nlcp -p nlcp --serial ttyO2 --imagesize 1G --dist maverick
  sudo rootstock --fqdn omap --imagesize 2G --dist maverick --serial ttyO2 --login ubuntu --password temppwd --seed btrfs-tools,devmem2,i2c-tools,nano,pastebinit,uboot-envtools,uboot-mkimage,usbutils,wget,wireless-tools,wpasupplicant --script fixup.sh --components "main universe multiverse" --kernel-image http://rcn-ee.net/deb/maverick/v2.6.38-rc7-d3/linux-image-2.6.38-rc7-d3_1.0maverick_armel.deb
}}}

 Bluetooth:
  1. Change file path in  drivers/misc/ti-st/st_kim.c

 Misc:
  1. DFS - read doc, sched meeting
  2. To keep running Nokia's testsuite. 
        New guy is Tuukka Hursti (ext-tuukka.hursti@nokia.com). His manager is
        Petri Karhula
  3. use of MAC address according to PG3+
  4. Check whether tx_compl_threshold needs to be different for each chip
       * The reference driver uses 4 for Trio and 3 for Quattro, but
       this is probably more dependent on the platform than on the chip
       type.

 Roaming:
  1. 88513 - Sends probes before connecting to chosen AP         Danil
  2. 88549 - Howto get list of candidates                        Galina
  3. 88548 - Unexpected behaviour of bgscan                      Galina
  3. Complete Low RSSI roaming solution for Alex to retest & prepare patch 
     for submission (even use Luca time to review with him even if 
     wpa_supplicant patch)
  4. Max Tx Retries Roaming trigger to be based on Low RSSI logic for roaming
  5. bug 86130 - Add get BGSCAN candidates
  6. 80617 - pre-auth for roaming
  7. 802.11r
  8. roaming triggers: RSSI, Tx rertries
     a. RSSI trigger
       a1. Check fail to reauth while roaming
       a2. check if triggered w/o bgscan
       a3. how to get RSSI high at the beginning
       a4. Which Signal dBm comes w/ RSSI event
  9. 85566 - Roaming: wrong Probe Requests after BSS loss
 10. 88521
 11. 88512
 12. 86130 !
 14. 80617 - reauth

}}}

Code flows n theory {{{

Beacon loss event {{{

wl1271_event_process() (event.c)
|-> ...
|_> ieee80211_connection_loss() (net/mac80211/mlme.c)
    |-> ieee80211_beacon_connection_loss_work()
        |-> __ieee80211_connection_loss()
            |-> ieee80211_set_disassoc()
            |-> ieee80211_recalc_idle()
            |_> ieee80211_send_deauth_disassoc( IEEE80211_STYPE_DEAUTH, )
                |-> cfg80211_send_deauth() (net/wireless/mlme.c)
                |   |-> __cfg80211_send_deauth()
                |       |-> nl80211_send_deauth() (net/wireless/nl80211.c)
                |           |-> nl80211_send_mlme_event
                |           |   send NL80211_CMD_DEAUTHENTICATE
                |               |-> nl80211_deauthenticate()
                |                   |-> cfg80211_mlme_deauth()
                |                   |   |-> __cfg80211_mlme_deauth()
                |                           |-> ieee80211_deauth()
                |                               |_> ieee80211_mgd_deauth()
                |                                   (net/mac80211/mlme.c)
                |                                   |-> ieee80211_set_disassoc
                |_> ieee80211_tx_skb()


}}}
--- Scanning from wpa_supplicant {{{

wpa_supplicant:
process_event() (hostap/src/drivers/driver_nl80211.c)
NL80211_CMD_NEW_SCAN_RESULTS
|-> eloop_cancel_timeout()
|-> send_scan_event()
    |-> wpa_supplicant_event() (hostap/wpa_supplicant/events.c)
    |   EVENT_SCAN_RESULTS
    |   |-> wpa_supplicant_event_scan_results()
    |       |-> _wpa_supplicant_event_scan_results()
    |       |   |-> wpa_supplicant_notify_scanning() - DBus API
    |       |   |-> wpa_supplicant_get_scan_results() (wpa_supplicant/scan.c)
    |       |   |   |-> wpa_drv_get_scan_results2()
    |       |   |   |   |-> wpa_driver_nl80211_get_scan_results()
    |       |   |   |   |   |-> nl80211_get_scan_results()
    |       |   |   |   |   |   NL80211_CMD_GET_SCAN
    |       |   |   |   |   |   |-> send_and_recv_msgs()
    |       |   |   |   |   |   |   |-> send_and_recv()
    |       |   |   |   |   |   |   |   call w/ handler bss_info_handler
    |       |   |   |   |   |   |   |   where fill struct nl80211_bss_info_arg
    |       |   |   |-> ...
    |       |   |_? if prev failed - wpa_supplicant_req_new_scan()
    |       |   |_? scan_res_handler() ???
    |       |   |-> wpas_notify_scan_results()
    |       |   |-> wpas_notify_scan_done() - DBus API
    |       |   |-> bgscan_notify_scan()
    |       |   |-> wpa_supplicant_rsn_preauth_scan_results()
    |       |   |-> wpa_supplicant_pick_network()
    |       |   |-? if new AP selected
    |       |   |   |-> wpa_supplicant_need_to_roam
    |       |   |   |-> wpa_supplicant_connect()
    |       |   |   |   |-> wpa_supplicant_associate()
    |       |   |   |   |   (hostap/wpa_supplicant/wpa_supplicant.c)
    |       |   |   |   |   |-> sme_authenticate()
    |       |   |   |   |   |   (hostap/wpa_supplicant/sme.c)
}}}
--- Authentication from wpa_supplicant timeout {{{

process_event() (hostap/src/drivers/driver_nl80211.c)
|   (NL80211_CMD_AUTHENTICATE)
|-> mlme_event() (src/drivers/driver_nl80211.c)
    |-> mlme_timeout_event()
    |       |_> wpa_supplicant_event() (wpa_supplicant/events.c)
    |         (..., EVENT_AUTH_TIMED_OUT, ...)
    |         |_> sme_event_auth_timed_out()
    |             |_> wpas_connection_failed() 
    |                 (wpa_supplicant/wpa_supplicant.c)
    |                 |->
    |                 |_> wpa_supplicant_req_scan()
}}}
--- Deauth from wpa_supplicant {{{

wpa_supplicant_deauthenticate() (hostap/wpa_supplicant/wpa_supplicant.c)
|-> wpa_drv_deauthenticate()
|   |-> wpa_driver_nl80211_deauthenticate()
|   |   |-> wpa_driver_nl80211_mlme()
|   |   |   NL80211_CMD_DEAUTHENTICATE - send w/ callback
|   |   |   |-> send_and_recv_msgs()
|   |   |   |   |-> ...
|   |_> wpa_supplicant_clear_connection()     
|       |-> ...     
|      
|_> wpa_supplicant_clear_connection()

driver gets NL80211_CMD_DEAUTHENTICATE
nl80211_deauthenticate() (net/wireless/nl80211.c)
|-> cfg80211_mlme_deauth() (net/wireless/mlme.c)
    |-> __cfg80211_mlme_deauth()
        |-> call ops->deauth = ieee80211_deauth() (net/mac/cfg.c)
            |-> ieee80211_mgd_deauth()
                |-> ieee80211_send_deauth_disassoc()
                    |-> cfg80211_send_deauth()
                    |   |_> __cfg80211_send_deauth() (net/wireless/mlme.c)
                    |       |-> nl80211_send_deauth() (net/wireless/nl80211.c)
                    |       |    |_> nl80211_send_mlme_event()
                    |       |        NL80211_CMD_DEAUTHENTICATE
                    |       |-> __cfg80211_disconnected()
                    |           |-> nl80211_send_disconnected()
                    |               NL80211_CMD_DISCONNECT
}}}
--- Compare PLT start to add interface {{{
        2011-05-29
        During normal add interface
wl1271_op_add_interface() (main.c)
|-> ...
|-> wl1271_chip_wakeup()
|-> wl1271_boot()
|-> wl1271_hw_init()
    |-> wl1271_cmd_general_parms()
    |-> wl1271_cmd_radio_parms()
    |-> wl1271_chip_specific_init()
    |-> wl1271_sta_hw_init() (init.c)
    |   |-> wl1271_cmd_ext_radio_parms()
    |   |-> wl1271_acx_config_ps()                ???  cfg PS ie
    |   |-> wl1271_sta_init_templates_config()
    |   |-> wl1271_acx_group_address_tbl()        ???  cfg multicast addr
    |   |-> wl1271_acx_conn_monit_params()
    |   |-> wl1271_init_beacon_filter()           ???  here dis beacon fltr
    |   |-> wl1271_acx_fm_coex()
    |   |-> 
    |   |-> wl1271_init_pta() - Bluetooth WLAN coex
    |   |-> wl1271_init_beacon_broadcast()        ???
    |   |-> wl1271_acx_sleep_auth() - cfg PS to ELP
    |   |-> wl1271_acx_rssi_snr_avg_weights()     ???
    |   |-> wl1271_acx_sta_rate_policies()        ???
    |   |_> wl1271_acx_sta_mem_cfg()              ??? Need
    |-> wl1271_acx_init_mem_config()
    |-> wl1271_init_rx_config()                   ???
    |-> wl1271_init_phy_config()
    |-> wl1271_acx_dco_itrim_params()
    |-> wl1271_acx_tx_config_options()            ???
    |-> wl1271_acx_init_rx_interrupt()            ???
    |-> wl1271_init_energy_detection()
    |-> wl1271_acx_frag_threshold()
    |-> wl1271_acx_ac_cfg() - default TID/AC cfg
    |-> wl1271_acx_tid_cfg() - default TID/AC cfg
    |-> wl1271_cmd_data_path()
    |-> wl1271_acx_feature_cfg()                  ???
    |-> wl1271_acx_pm_config() - cfg PM
    |-> wl1271_sta_hw_init_post_mem()             ???
    |_> wl1271_set_ba_policies

        During PLT start
wl1271_tm_cmd_set_plt_mode() (testmode.c)
|-> wl1271_plt_start()
    |-> ...
    |-> wl1271_chip_wakeup()
    |-> wl1271_boot()
    |-> wl1271_plt_init()
     1  |-> wl1271_cmd_general_parms()
     2  |-> wl1271_cmd_radio_parms()
     3  |-> wl1271_cmd_ext_radio_parms()
     4  |-> ACX_CONFIG_PS                                  ???
     5  |-> wl1271_sta_init_templates_config()
     6  |-> DOT11_GROUP_ADDRESS_TBL                        ???
     15 |-> wl1271_acx_init_mem_config()
     17 |-> wl1271_init_phy_config()
     18 |-> wl1271_acx_dco_itrim_params()
     7  |-> wl1271_acx_conn_monit_params()
     8  |-> ACX_BEACON_FILTER_OPT, ACX_BEACON_FILTER_TABLE ???
     9  |-> wl1271_init_pta() - Bluetooth WLAN coex
     10 |-> ACX_BCN_DTIM_OPTIONS                           ???
     12 |-> ACX_RSSI_SNR_WEIGHTS                           ???
     13 |-> ACX_RATE_POLICY                                ???
     14 |-> ACX_MEM_CFG                                    !!!
     16 |-> cfg Rx                                         ???
     21 |-> wl1271_init_energy_detection()
     22 |-> wl1271_acx_frag_threshold()
     23 |-> wl1271_acx_ac_cfg() - default TID/AC cfg
     24 |-> wl1271_acx_tid_cfg() - default TID/AC cfg
     25 |-> wl1271_cmd_data_path()
     11 |-> wl1271_acx_sleep_auth()
     27 |_> wl1271_acx_pm_config()
}}}
How wl12xx loads radio parameters {{{

wl1271_op_add_interface()
|-> wl1271_hw_init()
    |-> wl1271_cmd_general_parms() - TEST_CMD_INI_FILE_GENERAL_PARAM
    |   send struct wl1271_ini_general_params = 9 + 48
    |   send struct wl1271_ini_general_params_wl128x = 13 + 64
    |   and nbr of dbg params = 20
    |   and padding = 3
    |-> wl1271_cmd_radio_parms() - TEST_CMD_INI_FILE_RADIO_PARAM
    |   send struct wl1271_radio_parms_cmd
    |       struct wl1271_ini_band_params_2 = 17
    |       struct wl1271_ini_fem_params_2 =
    |       struct wl1271_ini_band_params_5
    |       struct wl1271_ini_fem_params_5
    |   send struct wl1271_radio_parms_cmd_wl128x
    |       struct wl1271_ini_band_params_2 = 30
    |       struct wl1271_ini_fem_params_2 =
    |       struct wl1271_ini_band_params_5
    |       struct wl1271_ini_fem_params_5
    |       fem_vendor_and_options
    |-> wl1271_sta_hw_init()
Q       |-> wl1271_cmd_ext_radio_parms() - TEST_CMD_INI_FILE_RF_EXTENDED_PARAM
        |   send struct wl1271_ext_radio_parms_cmd = 28
        |       tx_per_channel_power_compensation_2 = 7
        |       tx_per_channel_power_compensation_5 = 18
        |       padding = 3
}}}
--- Rx streaming {{{

The feature supposed to increase tp during TCP Tx in PS-legacy.
While doing TCP Tx 
????
Before entering in PS mode, to set firmware with TID and time interval.

when in ps mode, and @timeout msecs have passed since last tx, it issues
trigger packets (QoS-null/PS-Poll according to the ac type) in const
intervals (in order to reduce rx time).
}}}
power save triggered by BT-Coex event {{{
wl1271_event_process()
|-? SOFT_GEMINI_SENSE_EVENT_ID
    |-? sense value is 1 - ieee80211_disable_dyn_ps()
    |-? otherwise - ieee80211_enable_dyn_ps()
}}}
command join {{{
        2011-02-02

--- The DummyJoin - wl1271_dummy_join()

wl1271_sta_handle_idle()
|-? if not idle => inc session counter and
    wl1271_dummy_join()

wl1271_bss_info_changed_sta()
|-> if status changed to disassociated and
    wl1271_dummy_join()

wl1271_dummy_join() (main.c)
|-> wl1271_configure_filters() - cfg Rx config to accept
|-> set bssid to 0b:ad:de:ad:be:ef
|-> wl1271_cmd_join()

--- The Join - wl1271_join()

wl1271_op_config() (main.c)
|-? 
wl1271_join() (main.c)


wl1271_bss_info_changed_sta()
|-? if it ibss
if changed BSS_CHANGED_BSSID, 

--- The command join - wl1271_cmd_join()

wl1271_op_config()
|-> wl1271_join()
    |-> wl1271_cmd_join()

struct ieee80211_ops wl1271_ops =
.bss_info_changed = wl1271_op_bss_info_changed()
|-> wl1271_bss_info_changed_sta()
    |-? if ibss and BSS_CHANGED_BEACON_INT or BSS_CHANGED_BEACON
    |   BSS_CHANGED_BEACON_ENABLED
        wl1271_dummy_join()
        |-> wl1271_cmd_join()



}}}
Service period {{{

from net/mac80211/ieee80211_i.h in struct ieee80211_local field 
unsigned int uapsd_max_sp_len;
The init for uapsd_max_sp_len to IEEE80211_DEFAULT_MAX_SP_LEN (0) happened in 
ieee80211_alloc_hw() (net/mac80211/main.c)
}}}
wpa_s bgscan learn {{{

--- bgscan Initialization


--- bgscan notification
process_event() event NL80211_CMD_NOTIFY_CQM
|-> nl80211_cqm_event() (hostap/src/drivers/driver_nl80211.c)
    |-> wpa_supplicant_event() event EVENT_SIGNAL_CHANGE
        |-> bgscan_notify_signal_change()


--- bgscan scan results
ieee80211_sta_scan_timer() (hostap/wpa_supplicant/mlme.c)
|-> wpa_supplicant_event() event EVENT_SCAN_RESULTS
    |-> wpa_supplicant_event_scan_results()
        |-> _wpa_supplicant_event_scan_results()
            |-> bgscan_notify_scan()

No one calls it ???
bgscan_notify_beacon_loss()

}}}
blacklisting {{{

wpas_connection_failed()
|-> wpa_blacklist_add()
|-> ...

wpa_supplicant_req_auth_timeout() - sched timeout for athen
|-> eloop_cancel_timeout()
|_> eloop_register_timeout() - 
    |_? wpa_supplicant_timeout() - 
        |-> wpa_blacklist_add()
        |-> ...

}}}
[R4] Loading PLT firmware {{{
        2011-05-30
wl1271_plt_start()
|-> wl1271_chip_wakeup()
|   |-> ...
|   |-> wl1271_fetch_firmware()
|   |-> ...
|-> wl1271_boot()
|-> wl1271_plt_init()
}}}

}}}

Scan {{{
        13oct2010

http://mcsdocs.isr.asp.ti.com:81/WLAN/index.php?dir=MCS_WLAN_Docs/Architecture/WiLink%20Products/Feature%20Specs/&file=Scan%20FS.doc

Theory {{{

Scan types:
There are 2 types of scan: active & passive.
Active while STA sends probes, passive by listening for beacons.

Today (11nov2010) fw accepts 2 types of scanning:
periodic - can be active/passive, when disconnected, does scan after time 
        interval
one shot scan - when connected (split scan, means during traffic - some scan, some traffic), can be
        active/passive

Scan triggers:
Application scan
        Started by app
Connection scan
        ...
Roaming scan:
        Background scan

}}}

Code flow {{{
DRV:
drivers/net/wireless/wl12xx/scan.c
wl1271_scan()
|-> wl1271_scan_stm()
|   |-> wl1271_scan_send()

wl1271_scan_complete_work()

FW:
CommandParser() (commands.c)
|-> CMD_CONNECTION_SCAN_CFG (commands.c)
|   |-> ConnectionScan_ConfigParams() (process_connection_scan.c)
|-> CMD_START_PERIODIC_SCAN (commands.c)
|   |-> PeriodicScan_Start() (periodic_scan.c)
|-> CMD_STOP_PERIODIC_SCAN (commands.c)
|   |-> PeriodicScan_Stop()

Global
ConnectionScanCB_t connectionScanCB;

CMD_SCAN
CMD_STOP_SCAN
CMD_CONNECTION_SCAN_SSID_CFG
CMD_TRIGGER_SCAN_TO

typedef struct {
* uint32        cycleIntervals[CONN_SCAN_MAX_NUM_OF_CYCLES_INTERVALS];      /* Intervals between each scan cycle */
* int8  rssiThreshold;          /* RSSI threshold */
* int8  snrThreshold;           /* SNR threshold */
* uint8 maxNumOfCycles;         /* number of cycles to run */
* uint8 reportThreshold;        /* Report after N results are received */
* uint8 terminateOnReport;      /* Terminate after report */
* uint8 resultsTag;             /* Tag for filtered scan results */
* ScanBssType_e bssType; /* BSS type to filter (0 - Infra, 1 - IBSS, 2 - Any) */
  ScanSsidFilterType_e ssidFilterType; /* SSID filter Type (0 - Any, 1 - specified in command, 2 - use SSID list) */
  uint8  ssidLength; /* SSID Length (if ssidType is specified in command) */
  uint8  ssid[32]; /* SSID (if ssidType is specified in command) */
* uint8  numProbe; /* Number of probe requests to transmit per (hidden) SSID per channel */

  uint8  numOfPassive[CONN_SCAN_MAX_BAND];
  uint8  numOfActive[CONN_SCAN_MAX_BAND];
  uint8  numOfDfs;
  uint8  padding[ 3 ];
  ConnScanChannelInfo_t   channelList[CONN_SCAN_MAX_CHANNELS_ALL_BANDS];
} ConnScanParameters_t;

}}}

Schedule scan {{{
        05jan2011
chat w/ Luca {{{
(22:54:24) Luca256: yes, I've been using the sched scan while disconnected for quite some time now
(22:56:04) Luca256: one other req that would be very important to have, is wildcard SSID support
(22:56:10) Luca256: or prefix SSID
(22:56:22) Luca256: now we can set up 8 SSIDs for auto-scanning and filtering
(22:56:58) Luca256: but in some cases, like hotspot or in the future p2p, we may want to scan all SSIDs that start with a certain string
(22:57:26) Luca256: like "HOTSPOT-" would find "HOTSPOT-1", "HOTSPOT-2", "HOTSPOT-3" and so on
(22:57:51) Luca256: also, it would probably be good to split the filtering from the active scanning
(22:58:21) Luca256: afair, if you want to filter, the firmware will send probe_reqs to those specific SSIDs
(22:58:34) Luca256: they are two different things and should be separated
(22:59:28) Luca256: anyways, I'll send an email stating all these findings I have already and then we can discuss further
(23:06:05) gxk1: and who said "I don't really have any requirements". Cool. So u want schedule passive scan?
(23:07:17) gxk1: this way we can implement wildcard SSID scan support
(23:35:50) gxk1: It was pleasure to talk to you. Hope everything is Ok.
(23:44:18) Luca256: hehe, yeah, I didn't have any reqs, but when I start talking about it, a lot comes to my mind :)
(23:44:54) Luca256: and, about the "passive scan", it's not necessarily a passive scan... it can be broadcast active scans too
}}}
}}}
}}}


Using EEPROM, AutoTxBip and MAC from ROM {{{
        2011-05-23

1. Using EEPROM

        The new command for calibrator to create NVS from EEPROM
        Separate issue: 
                1. To unload testmode for runtime in future
                2. 
2. TxBip

        Driver reads DieID from NVS and check it against DID from chip.
        If different, just send message that have to calibrate.
        The DID exists in every PG.

3. MAC from ROM

        To update NVS file with MAC address from ROM in PLT.

}}}
Support investigation on Panda {{{
        2011-03-14
Qs from Ariela:
1. Can you check the SDIO configuration – SDIO clock, bus width, is DMA enabled?
cat /sys/kernel/debug/mmc0/ios

2. I couldn’t find the interrupt pacing value in the ini file; what’s the default value?
}}}
nVidia {{{
        2011-04-05

http://tegradeveloper.nvidia.com/tegra/downloads

kernel 2.6.34-rc3
git://nv-tegra.nvidia.com/linux-2.6.git
commit id e823580

}}}
Bluetooth script delivery to linux-firmware {{{
        2011-02-27

Create repository in github named linux-firmware

git clone from
        git://git.kernel.org/pub/scm/linux/kernel/git/dwmw2/linux-firmware.git
cd linux-firmware
git remote add gxk  git@github.com:gxk/linux-firmware.git
git push gxk master

Add to WHENCE
+Driver: TI_ST - Texas Instruments bluetooth driver
+
+File: TIInit_7.2.31.bts
+
+Licence: See LICENCE.ti-connectivity for details.
+
+       TIInit_7.2.31.bts version 7.2.31
+
+       In order to use that files copy them to target FS at /lib/firmware/.
Add TI bluetooth fw : ti-connectivity/TIInit_7.2.31.bts
git add ti-connectivity/TIInit_7.2.31.bts
git commit -a -m "linux-firmware: Initial release for Bluetooth init script"
git format-patch -s --binary -o ../ti -1 --subject-prefix="PATCH"
git send-email --suppress-cc=self --suppress-cc=sob --annotate --from "Gery Kahn <geryk@ti.com>" --to "<mcs-mac80211@list.ti.com>" ../ti/0001-linux-firmware-Initial-release-for-Bluetooth-firmwar.patch

2011-02-27 Sent to mcs ml
2011-02-28 Sent to mcs ml - change description, fix patch to not remove
somebody else's file.

2011-03-02 Sent to...
git send-email --suppress-cc=self --suppress-cc=sob --annotate --from "Gery Kahn <geryk@ti.com>" --to "David Woodhouse <dwmw2@infradead.org>" --to "<linux-wireless@vger.kernel.org>" --to "linux-bluetooth@vger.kernel.org" --cc "Luciano Coelho <coelho@ti.com>" ../0001-linux-firmware-Initial-release-for-Bluetooth-init-sc.patch

As a result need to update:
<krnl>/drivers/misc/ti-st/st_kim.c

}}}
Build Panda Android {{{
        2011-01-26 2011-02-09

git remote add rowboat git://gitorious.org/rowboat/frameworks-base.git
git fetch rowboat
git branch -a
git cherry-pick 24117ce3ae32c40798d2d9bda80675814f76730d
git cherry-pick ac82681dffdba3ad0b93ed3558365bac1dacbcd1
git cherry-pick b0f60c6
git cherry-pick afee303
git cherry-pick 64d7c77

- install java 1.5 on ubuntu 10.04
        Add to /etc/apt/sources.list
deb http://us.archive.ubuntu.com/ubuntu/ jaunty multiverse
deb http://us.archive.ubuntu.com/ubuntu/ jaunty-updates multiverse
sudo apt-get update
sudo apt-get install sun-java5-jdk
sudo update-java-alternatives -l
sudo update-java-alternatives -s java-1.5.0-sun

cd $MYDROID
cp -Rfp device/ti/blaze/buildspec.mk.default buildspec.mk
make -j4

cd ..
mkdir myfs
cd myfs
cp -Rfp $MYDROID/out/target/product/blaze/root/* .
cp -Rfp $MYDROID/out/target/product/blaze/system/ .
cp -Rfp $MYDROID/out/target/product/blaze/data/ .
cp -Rfp $MYDROID/device/ti/blaze/init.omap4sdp.rc init.rc
#BT drivers
cp -Rfp $KERNEL_DIR/drivers/staging/ti-st/bt_drv.ko .
cp -Rfp $KERNEL_DIR/drivers/staging/ti-st/st_drv.ko .
#Bluetooth init script - should be taken from https://gforge.ti.com/gf/project/wilink_drivers/frs/?action=FrsReleaseBrowse&frs_package_id=179
cp -Rfp ~/bluetooth/initscripts/TIInit_7.2.31.bts system/etc/firmware

Build Gingerbread on 32bit machine {{{

form http://blog.csdn.net/stevenliyong/archive/2010/12/28/6103382.aspx

I tried and it works http://forum.xda-developers.com/showpost.php?p=9998281&postcount=12

A quick and brutal fix is to:
1) go to gingerbread/prebuilt/linux-x86/toolchain
2) rename arm-eabi-4.4.3 to arm-eabi-4.4.3.old
3) link arm-eabi-4.4.0 to arm-eabi-4.4.3
Code:

cd gingerbread/prebuilt/linux-x86/toolchain
mv arm-eabi-4.4.3 to arm-eabi-4.4.3.old
ln -s arm-eabi-4.4.0  arm-eabi-4.4.3

One more fix needed to build on x86 is to change
Code:

# This forces a 64-bit build for Java6
LOCAL_CFLAGS += -m64
LOCAL_LDFLAGS += -m64

in the Android.mk files of the gingerbread/external/clearsilver/ directory
and subdirectories to:
Code:

# This forces a 64-bit build for Java6
LOCAL_CFLAGS += -m32
LOCAL_LDFLAGS += -m32

This should be fixed in a more elegant way based on the host arch.

Started to compile now....................................Done.
Works so far.

Patch attached to fix build on 32 bit hosts.

Code:

repo diff

project build/
diff --git a/core/main.mk b/core/main.mk
index 6113e52..72e32c8 100644
--- a/core/main.mk
+++ b/core/main.mk
@@ -72,7 +72,8 @@ $(info Checking build tools versions...)

 ifeq ($(BUILD_OS),linux)
 build_arch := $(shell uname -m)
-ifneq (64,$(findstring 64,$(build_arch)))
+#ifneq (64,$(findstring 64,$(build_arch)))
+ifneq (i686,$(findstring i686,$(build_arch)))
 $(warning ************************************************************)
 $(warning You are attempting to build on a 32-bit system.)
 $(warning Only 64-bit build environments are supported beyond froyo/2.2.)

project external/clearsilver/
diff --git a/cgi/Android.mk b/cgi/Android.mk
index 21c534b..2c7bf36 100644
--- a/cgi/Android.mk
+++ b/cgi/Android.mk
@@ -13,8 +13,12 @@ LOCAL_C_INCLUDES := $(LOCAL_PATH)/..
 LOCAL_CFLAGS := -fPIC

 # This forces a 64-bit build for Java6
-LOCAL_CFLAGS += -m64
-LOCAL_LDFLAGS += -m64
+#LOCAL_CFLAGS += -m64
+#LOCAL_LDFLAGS += -m64
+
+# This forces a 64-bit build for Java6
+LOCAL_CFLAGS += -m32
+LOCAL_LDFLAGS += -m32

 LOCAL_NO_DEFAULT_COMPILER_FLAGS := true

diff --git a/cs/Android.mk b/cs/Android.mk
index 9f0e30a..4807b3f 100644
--- a/cs/Android.mk
+++ b/cs/Android.mk
@@ -9,8 +9,10 @@ LOCAL_C_INCLUDES := $(LOCAL_PATH)/..
 LOCAL_CFLAGS := -fPIC

# This forces a 64-bit build for Java6
-LOCAL_CFLAGS += -m64
-LOCAL_LDFLAGS += -m64
+#LOCAL_CFLAGS += -m64
+#LOCAL_LDFLAGS += -m64
+LOCAL_CFLAGS += -m32
+LOCAL_LDFLAGS += -m32

 LOCAL_NO_DEFAULT_COMPILER_FLAGS := true

diff --git a/java-jni/Android.mk b/java-jni/Android.mk
index 21b4fd1..cc6d3ce 100644
--- a/java-jni/Android.mk
+++ b/java-jni/Android.mk
@@ -34,8 +34,10 @@ LOCAL_C_INCLUDES := \
 LOCAL_CFLAGS += -fPIC

 # This forces a 64-bit build for Java6
-LOCAL_CFLAGS += -m64
-LOCAL_LDFLAGS += -m64
+#LOCAL_CFLAGS += -m64
+#LOCAL_LDFLAGS += -m64
+LOCAL_CFLAGS += -m32
+LOCAL_LDFLAGS += -m32

 LOCAL_NO_DEFAULT_COMPILER_FLAGS := true

diff --git a/util/Android.mk b/util/Android.mk
index 386f379..fc27bbf 100644
--- a/util/Android.mk
+++ b/util/Android.mk
@@ -18,8 +18,12 @@ LOCAL_C_INCLUDES := $(LOCAL_PATH)/..
 LOCAL_CFLAGS := -fPIC

 # This forces a 64-bit build for Java6
-LOCAL_CFLAGS += -m64
-LOCAL_LDFLAGS += -m64
+#LOCAL_CFLAGS += -m64
+#LOCAL_LDFLAGS += -m64
+
+# This forces a 64-bit build for Java6
+LOCAL_CFLAGS += -m32
+LOCAL_LDFLAGS += -m32

 LOCAL_NO_DEFAULT_COMPILER_FLAGS := true

另外还需要修改 rename 

opensles/libopensles/IAndroidEffect.c => opensles/libopensles/IAndroidEffect.cpp


diff --git a/opensles/libopensles/Android.mk b/opensles/libopensles/ 
Android.mk 
index 64e9b6f..f965d3e 100644 
--- a/opensles/libopensles/Android.mk 
+++ b/opensles/libopensles/Android.mk 

@@ -56,7 +56,7 @@ LOCAL_SRC_FILES:=                     \ 
         CEngine.c                     \ 
         COutputMix.c                  \ 
         IAndroidConfiguration.c       \ 
-        IAndroidEffect.c              \ 
+        IAndroidEffect.cpp            \ 
         IAndroidEffectCapabilities.c  \ 
         IAndroidEffectSend.c          \ 
         IBassBoost.c
}}}
}}}
Overclocking {{{

http://omapedia.org/wiki/Power_Management_Domain_Wiki


git remote add master-omap git://git.omapzoom.org/kernel/omap.git
git fetch master-omap

git remote add master-omap-2.6 git://git.kernel.org/pub/scm/linux/kernel/git/tmlind/linux-omap-2.6.git
git fetch master-omap-2.6
git pull master-omap-2.6 pm

from git://gitorious.org/linux-omap-nm-sr/linux-omap-sr.git 
branch: dvfs

git remote add omap-nm-sr git://gitorious.org/linux-omap-nm-sr/linux-omap-sr.git
git fetch omap-nm-sr
git pull omap-nm-sr dvfs

change in arch/arm/mach-omap2/opp3xxx_data.c

My Zoom3 is
        OMAP3630-GP rev 2, CPU-OPP2 L3-200MHz

My Beagle is
        OMAP3630/3730-GP ES2.0, CPU-OPP2, L3-165MHz, Max CPU Clock 1 Ghz

OPP - Operating Performance Point layer
ABB - Adaptive Body Biasing

Using CPUfreq:
/sys/devices/system/cpu/cpu0/cpufreq/
}}}
Power Save with BT Coex {{{
        2011-02-03
Juuso's patch to disable PS - f90754c15f47063671aea55268a9dd6a37b51492
http://wireless.kernel.org/en/users/Documentation/dynamic-power-save

To set different modes of ELP:
        short - awake every beacon, long - awake every DTIM,
        auto - to PS when idle, active - no PS

w/ iw utility

}}}
BT Coex {{{
        2011-02-02

There 2 types of BT connection: synchronous and asynch. The sync conn used in
BT voice while send pkts in determined time intervals.
The async connection used in BT audio, when possible to change time when send
pkts.
}}}
Power Consumption enhancement {{{

http://wireless.kernel.org/en/users/Documentation/Power-consumption

}}}

Build 3.0 for Panda {{{
        2011-06-23
Build v3.0-rc4

git remote add wless-test git://git.kernel.org/pub/scm/linux/kernel/git/linville/wireless-testing.git
git checkout --track -b wless-test-master wless-test/master

git revert 7e6502d577106fb5b202bbaac64c5f1b065e6daa
patch -p1 < patches/panda/v3.0-rc4/Omap44xx-i2c-fix.patch

make ARCH=arm omap2plus_defconfig

}}}
Boot Panda from u-boot tftp {{{
                2011-06-27

git checkout git://git.denx.de/u-boot.git
git reset --hard dc4970b299b1877f21f99ed4894f360ec955782b
git am ./patches/panda/tftp_boot/*
v8 4/4
3/3

Add to  include/configs/omap4_panda.h
#define CONFIG_CMD_USB 1
#define CONFIG_USB_STORAGE 1
#define CONFIG_USB_HOST_ETHER 1
#define CONFIG_USB_EHCI                 1
#define CONFIG_USB_EHCI_OMAP4 1
#define CONFIG_USB_HOST                1
#define CONFIG_USB_ETHER_SMSC95XX 1


make omap4_panda_config
make

}}}

Build ICS for Blaze {{{
        2011-07-06

git remote add omapzoom git://git.omapzoom.org/kernel/omap.git
git fetch omapzoom
git checkout --track -b omapzoom-p-android-omap-2.6.39 omapzoom/p-android-omap-2.6.39
make -j8 blaze_defconfig

}}}

Build GB for Blaze {{{
        2011-07-06

--- Kernel

git remote add omapzoom git://git.omapzoom.org/kernel/omap.git
git fetch omapzoom
git checkout --track -b omapzoom-p-android-omap-2.6.35 omapzoom/p-android-omap-2.6.35
git reset --hard c2573e171d3991810ebe7d933f5646eaaaf019c7

}}}

Add support of wusb600n v2 for Ubuntu 10.04 {{{
        2011-01-26

I have a WUSB600N v2 and it is working great for me. Here is all you have to do.

Go here and download the RT3572USB driver
http://www.ralinktech.com/support.php?s=2

The file you download is called 2009_1222_RT3572_LinuxSTA_V2[1].3.0.0.tar.bz2
expand it with the command
"tar xjf 2009_1222_RT3572_LinuxSTA_V2[1].3.0.0.tar.bz2"
open the file os/linux/config.mk and edit the following lines:
Change HAS_WPA_SUPPLICANT=n
to HAS_WPA_SUPPLICANT=y
and
Change HAS_NATIVE_WPA_SUPPLICANT_SUPPORT=n
to HAS_NATIVE_WPA_SUPPLICANT_SUPPORT=y

Next edit the file common/rtusb_dev_id.c and add the USB ID of the card to it.

{USB_DEVICE(0x1737,0x0079)}, /* WUSB600Nv2 */

sudo make

sudo make install

reboot and your done.

If you have added the USB device to any other drivers following other threads you will want to either remove that line and recompile those drivers OR black list those drivers. After doing the above this NIC is working great for me in Ubuntu 9.10 and getting N speeds.


sudo ifconfig ra0 up
sudo iwconfig ra0 mode monitor

}}}

DFS design {{{
from http://wireless.kernel.org/en/developers/DFS
Chat w Oz (22dec2010) {{{
ok. good. so it will be good for you to pull in anyone from the architecture, like Yossi Peery so they can be in the details while you conduct the discussion for TI
bottom line, good deal for you to be the one bringing the knowledge into TI
even before 3.4
and maybe we'll gain a lot of time due to that...
}}}

}}}

Firmware interface {{{

11nov2010 by Michal AlPeri

packet ram exists frames, devided by mem blocks 256B in linked list

host_slave_manager.c

--- Tx

descriptors per each frame, placed at descr pool

fw status structure, which is not statistics. has 4 cntrs of free mem blocks per access category

cmd header 16B, 1st field is size, 2nd how much extra mem blocks needed for the frame

host in charge of size of mem block list

structure tx result for each send frame, send irq to drv while tx send.
possible to config when to get irq - per nbr of 

--- Rx
fw sends irq when frame ready

irq pacing - to config when to irq, by nbr of frames or blocks or time (same as Tx)

Internal generated frames take mem blocks from other link list, which is not as common link list of Rx/Tx

Wl8 Rx alignment - 

--- Event mbox
fw prepare buffer, send irq to drv. drv read event and send irq back to fw.
while no irq from drv, prepare 2nd buffer. this is double buffer implementation.

Send vector where each bit is type of event and super structure w/ data per event, drv reads in SDIO transaction whole data.

--- cmd mbox
drv wr cmd and sends irq

cmd complete is just ...


----------------------------

----------------------------

frame max is 1500B
SDIO block

}}}

Setting MAC address {{{

Need to set MAC addr sooner than after NVS load.

There is option to read MAC from the chip right after power on. 

See email from Assaf Carmeli

}}}

Prepare user utilities {{{
        06oct2010

libnl {{{

Development:
http://www.kernel.org/pub/scm/libs/netlink/libnl.git
git://git.kernel.org/pub/scm/libs/netlink/libnl.git
Stable:
http://www.kernel.org/pub/scm/libs/netlink/libnl-stable.git
git://git.kernel.org/pub/scm/libs/netlink/libnl-stable.git

./autogen.sh
./configure --prefix=${NFSROOT} CC=arm-none-linux-gnueabi-gcc --host=arm-linux LD=arm-none-linux-gnueabi-ld
make && make install
}}}
iw {{{
git clone http://git.sipsolutions.net/iw.git 

export PKG_CONFIG_PATH=${NFSROOT}/lib/pkgconfig
export PKG_CONFIG=pkg-config                    ??? no need 2011-03-16
Not support libnl-2.1 - so 
mv ./lib/pkgconfig/libnl-2.1.pc ./lib/pkgconfig/libnl-2.0.pc
make PREFIX=${NFSROOT}
make install PREFIX=${NFSROOT}/usr
}}}
openssl {{{
untar openssl-1.0.0a
export CROSS_COMPILE=
./Configure --openssldir=${NFSROOT} shared os/compiler:arm-none-linux-gnueabi-
make
make install
}}}
hostap {{{

git clone git://w1.fi/srv/git/hostap.git

--- wpa_supplicant
cd hostap/wpa_supplicant

.config
CC=arm-none-linux-gnueabi-gcc
CFLAGS += -I/work/zoom2/1273/include -DCONFIG_LIBNL20
CPPFLAGS += -DCONFIG_LIBNL20
LIBS += -L/work/zoom2/1273/lib -lnl-genl
LIBS_p += -L/work/zoom2/1273/lib
LIBDIR = /work/zoom2/1273/lib
BINDIR = /work/zoom2/1273/usr/sbin
CONFIG_DRIVER_WEXT=y
CONFIG_DRIVER_NL80211=y
...
CONFIG_CTRL_IFACE=y

}}}
iperf {{{
git clone http://sourceforge.net/projects/iperf/
http://sourceforge.net/projects/iperf/files/iperf-2.0.5.tar.gz/download

export ac_cv_func_malloc_0_nonnull=yes
./configure --host=arm-none-linux-gnueabi CXX=arm-none-linux-gnueabi-g++ CC=arm-none-linux-gnueabi-gcc CFLAGS=-static CXXFLAGS=-static --prefix=/opt/rootfs/beagle/usr
make CXX=arm-none-linux-gnueabi-g++ CC=arm-none-linux-gnueabi-gcc
make install

}}}
git clone git://git.sv.gnu.org/inetutils.git {{{
cd inetutils
remove `man' from SUBDIRS in Makefile.am
./bootstrap
./configure --prefix=/work/zoom2/1273 --host=arm-none-linux-gnueabi CROSS_COMPILE=arm-none-linux-gnueabi- --disable-logger --disable-syslogd --disable-whois --disable-ifconfig --disable-hostname --with-path-procnet-dev=/proc/net/dev
make && make install

Create /work/zoom2/1273e/etc/inetd.conf as follows:
echo     stream  tcp    nowait  root    internal
echo     dgram   udp    wait    root    internal
daytime  stream  tcp    nowait  root    internal
daytime  dgram   udp    wait    root    internal
time     stream  tcp    nowait  root    internal
time     dgram   udp    wait    root    internal
#ftp    stream  tcp     nowait  root    /usr/sbin/tcpd  in.ftpd
telnet  stream  tcp     nowait  root    /libexec/telnetd        telnetd --exec-login=/bin/login

On target run:
inetd /etc/inetd.conf &
}}}
top {{{
http://www.unixtop.org/

top-3.8beta1

cd top-3.8beta1
./configure --prefix=/work/zoom2/1273 --host=arm-none-linux-gnueabi CROSS_COMPILE=arm-none-linux-gnueabi-

}}}
wireless-tools (iwconfig) {{{
download http://www.hpl.hp.com/personal/Jean_Tourrilhes/Linux/Tools.html

tar zxf wireless_tools.30.pre9.tar.gz
pushd wireless_tools.30
Change in Makefile:
CC ?= gcc
AR ?= ar
RANLIB ?= ranlib

make PREFIX=${NFSROOT} CC=arm-none-linux-gnueabi-gcc AR=arm-none-linux-gnueabi-ar RANLIB=arm-none-linux-gnueabi-ranlib
make PREFIX=${NFSROOT} CC=arm-none-linux-gnueabi-gcc AR=arm-none-linux-gnueabi-ar RANLIB=arm-none-linux-gnueabi-ranlib install

}}}
eth3tool {{{
from http://sourceforge.net/projects/gkernel/files/ethtool/

untar ethtool-2.6.36
configure --prefix=${NFSROOT} --host=arm-linux
make && make install
}}}

git clone git://git.sipsolutions.net/hwsim.git

http://www.intellinuxwireless.org/repos/wifi-test.git

trace-cmd {{{
git://git.kernel.org/pub/scm/linux/kernel/git/rostedt/trace-cmd.git

fix Makefile by changing
INCLUDES = -I. -I$(prefix)/usr/local/include $(CONFIG_INCLUDES)

export CROCC_COMPILE
make prefix=${NFSROOT}
make prefix=${NFSROOT} install

}}}
}}}

-------------------------------------------------------------------------------
----------------------------------- iVirtus -----------------------------------
-------------------------------------------------------------------------------
{{{
01. Enable ethernet over USB (wristwatch) {{{
    17aug2009
On target:
Load module g_ether, which creates device usb0
modprobe g_ether
ifconfig usb0 10.0.0.3
On host:
modprobe usbnet g_ether cdc_ether
ifconfig usb0 10.0.0.5
}}}
02. To set source management system {{{
    20aug2009

1. To purchase the computer

IBM tower x3400
4GB
4 disks x 500GB - Raid + hot spare + 4th for backups
DVD writer

Adrian - 0544821798

2. To install & configure the system
Running ServerRaid (Ctrl+A) while booting
Create array w/ 2 disks
Push Ctrl+S to create hotspare, add 3rd disk to it
Create

3. Install & config Subversion & Trac
yum install mysql mysql-devel mod_python python-setuptool
download tarball from http://sourceforge.net/projects/mysql-python
untar MySQL-python-1.2.3c1.tar.gz
cd MySQL-python-1.2.3c1
python setup.py build && python setup.py install
yum install neon neon-devel python-devel swig
--- install clearsilver
Add Dag repositiry: http://dag.wieers.com
rpm -Uvh rpmforge-release-0.3.6-1.el5.rf.i386.rpm
yum install clearsilver python-clearsilver
--- install trac
download from http://trac.edgewall.org/wiki/TracDownload
untar Trac-0.11.5.tar.gz && cd Trac-0.11.5
python ./setup.py install
--- Config
mkdir /srv/svn
svnadmin create --fs-type fsfs /srv/svn/<project>
mkdir /srv/trac
trac-admin /srv/trac/<project> initenv
Answer to all questions default, except path to repo which is
    /srv/svn/<project>
chown -R apache.apache /srv/svn/first
chown -R apache.apache /srv/trac/first
Add to /etc/httpd/conf.d/subversion.conf follows:
<Location /svn/<project>>
    DAV svn
    SVNPath /srv/svn/<project>
    AuthType Basic
    AuthName "<project> Repository"
    AuthzSVNAccessFile /srv/svn/svn-acl-conf
    AuthUserFile /srv/svn/<project>.htpasswd
    Require valid-user
</Location>

touch /srv/svn/<project>.htpasswd
htpasswd -m /srv/svn/<project>.htpasswd <username>
add to /srv/svn/svn-acl-conf follows:
[<project>:/]
<username> =  rw

Add to /etc/httpd/conf.d/trac.conf follows:
<Location /trac/<project>>
    SetHandler mod_python
    PythonHandler trac.web.modpython_frontend
    PythonOption TracEnv /srv/trac/<project>
    PythonOption TracUriRoot /trac/<project>
</Location>
<Location "/trac/<project>/login">
    AuthType Basic
    AuthName "trac"
    AuthUserFile /srv/trac/<project>.htpasswd
    Require valid-user
</Location>

touch /srv/trac/<project>.htpasswd
htpasswd -m /srv/trac/<project>.htpasswd <username>
trac-admin /srv/trac/<project> permission add <username> TRAC_ADMIN
service httpd restart

http://192.168.1.61/svn/first
http://192.168.1.61/trac/first

}}}
03. BringUp tmx320dm365 {{{
    14sep2009

Install follows packages:

mvl_5_0_demo_sys_setuplinux.bin - MontaVista toolchain
    14sep2009 - mvl_5_0_0801921_demo_sys_setuplinux.bin

mvl_5_0_0_demo_lsp_setuplinux_02_10_00_14.bin - kernel source tree with the TI modifications (LSP - Linux Support Package)

psp_02_10_00_14.bin - documentation and examples for the LSP (UBL, U-boot, NAND utils)
xdctools_setuplinux_3_15_01_59.bin - XDC tools package

dvsdk_dm365_setuplinux_2_10_01_18.bin - DVSDK itself
LPTB-02.03.00.02-beta.bin - Linux Performance Test Bench
TI-C6x-CGT-v6.0.21.1.bin

sudo mkdir /opt./mv_pro_5.0
chmod 777 /opt/apps/tmx320dm365/mvl_5_0_*
pushd /opt/apps/tmx320dm65/
sudo ./mvl_5_0_0801921_demo_sys_setuplinux.bin
sudo ./mvl_5_0_0_demo_lsp_setuplinux_02_10_00_14.bin
pushd /opt/mv_pro_5.0/
sudo tar zxf ./mvltools5_0_0801921_update.tar.gz
sudo tar zxf ./DaVinciLSP_02_10_00_14.tar.gz
chmod 777 /opt/apps/tmx320dm365/dvsdk_dm365_setuplinux_2_10_01_18.bin
chmod 777 /opt/apps/tmx320dm365/xdctools_setuplinux_3_15_01_59.bin
cd /opt/apps/tmx320dm365
./dvsdk_dm365_setuplinux_2_10_01_18.bin
./xdctools_setuplinux_3_15_01_59.bin (change install directory to the previous dvsdk)

sudo cp -r /opt/mv_pro_5.0/montavista/pro/devkit/arm/v5t_le/target/* /opt/tmx320dm65/rootfs
sudo chown -R gxk:gxk /opt/tmx320dm65/rootfs/*

add to ~/.bashrc
PATH="/opt/mv_pro_5.0/montavista/pro/devkit/arm/v5t_le/bin:/opt/mv_pro_5.0/montavista/pro/bin:/opt/mv_pro_5.0/montavista/common/bin:$PATH"
mkdir ~/ivirtus/tmx320dm65
cp -r /opt/mv_pro_5.0/montavista/pro/devkit/lsp/ti-davinci/linux-2.6.18_pro500 ~/ivirtus/tmx320dm65
pushd ivirtus/tmx320dm365/linux-2.6.18_pro500/
make ARCH=arm CROSS_COMPILE=arm_v5t_le- davinci_dm365_defconfig
make ARCH=arm CROSS_COMPILE=arm_v5t_le- checksetconfig
make ARCH=arm CROSS_COMPILE=arm_v5t_le- uImage
make ARCH=arm CROSS_COMPILE=arm_v5t_le- modules
make ARCH=arm CROSS_COMPILE=arm_v5t_le- INSTALL_MOD_PATH=/opt/tmx320dm65/rootfs/ modules_install

cd <dvsdk>
modify Rules.mak
make && make install

--- Reduced rootfs
Under <dvsdk source>/PSP_02_10_00_14/bin/target-reduced-dm365.tar

--- Make nfs
on host add to /etc/exports
/opt/tmx320dm65  192.168.1.0/24(rw,no_root_squash,async,no_subtree_check)
sudo /etc/init.d/nfs-kernel-server restart
on target:
mount -o nolock,tcp 192.168.1.41:/opt/tmx320dm65 /mnt/usb/

--- U-boot srcs
Under <dvsdk source>/PSP_02_10_00_14/board_utilities/u-boot

Uboot message w/ NAND bad blocks: {{{
NAND:  NAND device: Manufacturer ID: 0x2c, Chip ID: 0xd3 (Micron NAND 1GiB 3,3V 8-bit)
Bad block table not found for chip 0
Bad block table not found for chip 0
Bad block table written to 0x3ffe0000, version 0x01
Bad block table written to 0x3ffc0000, version 0x01
NAND device: Manufacturer ID: 0x2c, Chip ID: 0xd3 (Micron NAND 1GiB 3,3V 8-bit)
Bad block table not found for chip 0
Bad block table not found for chip 0
Bad block table written to 0x3ffe0000, version 0x01
Bad block table written to 0x3ffc0000, version 0x01
}}}

}}}
04. Add MV kernel 2.6.18 for all prjs {{{
    11oct2009
Take kernel w/ new patch from TI for YAFFS (Yuri)
Insert it to the subversion:
svn import linux-2.6.18_pro500 http://192.168.1.61/first/vendors/kernel/linux-2.6.18_pro500 -m "Init MontaVista kernel src"

How to work w/ solution:
Set 2 env variables: IVIRTUS_PRJ_NAME, IVIRTUS_PRJ_SOURCE
Checkout 2 directories:
    svn co http://192.168.1.61/first/vendors
    svn co http://192.168.1.61/first/ibuild
Add to PATH full path to ibuild directory.
Run ./ibuild/ibuild.sh

}}}
05. To run kernel from TI's git {{{
    15sep2009
http://wiki.davincidsp.com/index.php/DaVinci_GIT_Linux_Kernel
git://git.kernel.org/pub/scm/linux/kernel/git/khilman/linux-davinci.git
http://git.kernel.org/?p=linux/kernel/git/khilman/linux-davinci.git;a=summary

--- Get kernel src
git clone  git://git.kernel.org/pub/scm/linux/kernel/git/khilman/linux-davinci.git

--- Prepare build env
install toolchain from arm-2007q3-51-arm-none-linux-gnueabi.bin
Add to PATH follows: /opt/codesourcery/bin

2. To build the kernel

make distclean
make ARCH=arm CROSS_COMPILE=arm-none-linux-gnueabi- davinci_all_defconfig
make make ARCH=arm CROSS_COMPILE=arm-none-linux-gnueabi- uImage
make make ARCH=arm CROSS_COMPILE=arm-none-linux-gnueabi- modules
make ARCH=arm CROSS_COMPILE=arm-none-linux-gnueabi- INSTALL_MOD_PATH=/opt/dm365/rootfs modules_install

}}}
06. Watch> project environment {{{
    20oct2009

Got 4 tarballs from Ilan:
    ffmpeg_ver1_5oct09.tar.gz
    ltib_ver1_5oct09.tar.gz
    wristwatchdrv_ver1_5oct09.tar.gz
    wristwatch_ver1_5oct09.tar.gz
    live-arm
    dm365_live
Untar the ltib_ver1_5oct09.tar.gz get dirs: bin, config, dist, doc and also 
perl script ltib.

}}}
07. Watch> Set main charger at early state {{{
    29oct2009

The charger can be set to work from battery. Currently done at application 
level, if USB pluged-in.
Moved to the redboot in order to start charging at earlier.

vibrate() from redboot/current/src/main.c 

}}}
08. Watch> sometimes the card doesn't startup {{{
    01nov2009

Results from jtag commands {{{

=== Normal boot

The `st' command
----------------
J-Link>st
VTarget=0.000V
ITarget=1mA
TCK=1 TDI=0 TDO=1 TMS=0 TRES=1 TRST=1
Supported JTAG speeds:
 - 48 MHz/n, (n>=4). => 12000kHz, 9600kHz, 8000kHz, ...
 - Adaptive clocking

The `hwinfo' command
--------------------
J-Link>hwinfo
HWInfo[00] = Target power is enabled
HWInfo[02] = 19mA       (ITarget)
HWInfo[03] = 25mA       (ITargetPeak)
HWInfo[04] = 25mA       (ITargetPeakOperation)
HWInfo[10] = 0ms        (ITargetMaxTime0)
HWInfo[11] = 0ms        (ITargetMaxTime1)
HWInfo[12] = 0ms        (ITargetMaxTime2)

The `regs' command
----------------
J-Link>regs
Info: TotalIRLen = 8, IRPrint = 0x0011
Info: CP15.0.0: 0x41069264: ARM, Architecure 5TEJ
Info: CP15.0.1: 0x1D152152: ICache: 16kB (4*128*32), DCache: 16kB (4*128*32)
Info: Cache type: Separate, Write-back, Format C (WT supported)
PC: (R15) = 0000000C, CPSR = 800000D7 (ABORT mode, ARM FIQ dis. IRQ dis.)
R0 = D1041C45, R1 = 00000E80, R2 = D1041C43, R3 = 00003FFC
R4 = FFFFFFFE, R5 = 00000043, R6 = E1530000, R7 = 21A03000
USR: R8 =E0844003, R9 =E1520004, R10=02811008, R11 =FFFFFFFF, R12 =00000002
     R13=D3424BB0, R14=5E145060
FIQ: R8 =ABDA42E0, R9 =A36A9834, R10=B78E75CA, R11 =CEF9ED8E, R12 =F9E16B5E
     R13=6B78493B, R14=601FF18F, SPSR=00000010
SVC: R13=FFFFFFFF, R14=0000C004, SPSR=00000010
ABT: R13=5543133A, R14=1ECFA2FE, SPSR=800000F7
IRQ: R13=6A59570A, R14=CDF4F7BF, SPSR=00000010
UND: R13=280547C9, R14=20155180, SPSR=00000010

=== Badly booted

The `st' command
----------------
J-Link>st
VTarget=2.653V
ITarget=1mA
TCK=1 TDI=0 TDO=1 TMS=0 TRES=1 TRST=1
Supported JTAG speeds:
 - 48 MHz/n, (n>=4). => 12000kHz, 9600kHz, 8000kHz,
 - Adaptive clocking

The `hwinfo' command
--------------------
J-Link>hwinfo
HWInfo[00] = Target power is enabled
HWInfo[02] = 12mA       (ITarget)
HWInfo[03] = 32mA       (ITargetPeak)
HWInfo[04] = 32mA       (ITargetPeakOperation)
HWInfo[10] = 0ms        (ITargetMaxTime0)
HWInfo[11] = 0ms        (ITargetMaxTime1)
HWInfo[12] = 0ms        (ITargetMaxTime2)

The `regs' command
----------------

J-Link>regs

WARNING: Target system has been power-cycled
Info: TotalIRLen = 8, IRPrint = 0x0011
Info: CP15.0.0: 0x41069264: ARM, Architecure 5TEJ
Info: CP15.0.1: 0x1D152152: ICache: 16kB (4*128*32), DCache: 16kB (4*128*32)
Info: Cache type: Separate, Write-back, Format C (WT supported)
PC: (R15) = 0000000C, CPSR = 800000D7 (ABORT mode, ARM FIQ dis. IRQ dis.)
R0 = FFFF4410, R1 = 00000E80, R2 = D1041C43, R3 = 00003FFC
R4 = FFFFFFFF, R5 = 00004AD0, R6 = E1530000, R7 = 00000006
USR: R8 =E0844003, R9 =E1520004, R10=02811008, R11 =FFFFFFFF, R12 =00000002
     R13=D3424BB4, R14=5E145060
FIQ: R8 =EB9A42E0, R9 =A36A9834, R10=B78C25CA, R11 =CEF9ED8E, R12 =F9E16B4E
     R13=6978493B, R14=621FD18F, SPSR=00000010
SVC: R13=FFFFFFFF, R14=0000C004, SPSR=00000010
ABT: R13=55431312, R14=9ECFA2FC, SPSR=800000F7
IRQ: R13=6A595F0A, R14=CDF4F3AF, SPSR=00000010
UND: R13=91024D92, R14=20155180, SPSR=00000010

}}}

    Redboot boot flow:

  from devs/spi/arm/mxc/current/src/mxc_spi.c
mxc_pmic_init() - "PMIC ID: 0x0000089d [Rev: 3.5]"
  from hal/arm/mx27/ads/current/src/board_misc.c
display_board_type() - "Board Type: EVB [rev A] (external UART doesn't work)"
display_clock_src() - "Clock input: 26MHz"
  from devs/flash/arm/mxc/current/src/mxcflash_wrapper.c
RedBoot_init(mxc_flash_print_info, RedBoot_INIT_LAST)
|-> mxc_flash_print_info() - "Booting from [NAND flash]"

}}}
09. Set env for Altair solution {{{
    18nov2009
download http://linux.omap.com/pub/toolchain/obsolete-gcc-3.3.2.tar.bz2
download http://linux.omap.com/pub/kernel/osk/2.6.8-rc3_080804.tar.bz2
cd /
sudo tar jxf obsolete-gcc-3.3.2.tar.bz2
mkdir ~/ivirtus/cofdm/altair_prj
cd ~/ivirtus/cofdm/altair_prj
tar jxf 2.6.8-rc3_080804.tar.bz2
export PATH=/usr/local/arm/3.3.2/bin:$PATH
tar xf ../iVirtus_Release_0_1-05nov2009/AltLink.tar.gz
export DRIVER_DEV_ROOT=/home/gxk/ivirtus/cofdm/altair_prj/
export SYS_DEV_ROOT=/home/gxk/ivirtus/cofdm/altair_prj/
At file Automation/Build/MakePlatform.mak change lines 12 n 13 to:
  export CROSS:=arm-linux-
  export KPATH:=/home/gxk/ivirtus/altair_prj/2.6.8-rc3/
pushd Automation/Build
(if Ubuntu: sudo ln -s /usr/bin/make /usr/bin/gmake)
clear; make -f MakePlatform.mak PLATFORM=omap clean all
popd

cd ~/ivirtus/cofdm/altair_prj
mkdir ./OS && cd ./OS
tar zxf SDIO_AltLink.tar.gz

}}}
10. Watch> Support syslogd {{{
    07dec2009

Add sysklogd project to subversion
Update ibuild.sh to build sysklogd
make project ilog

To do on/off option

}}}
11. Watch> To forbid upgrade when battery in 43% capaciy {{{
    28dec2009

New parameter added to system.ini called noupgrade_percent w/ default value 43.

The ioctl WRISTCMD_GET_CURRENT brings values like:
975 - 
796 - 4.2v
755 - 4.1v
485 - 3.5v = 41.91%
}}}
12. Watch> Create battery status file when plugin USB {{{
    29dec2009
Create status.log with battery status percentage value
}}}
13. Watch> To detect USB plugin while > 4V {{{

Found that while voltage >4V the CCCVS

Tests before changes {{{
---=== 3.9v

Reg | StUp w/o USB | plugin USB | plugout USB| StUp w/ USB | Reset w/ USB |
-------------------|------------|------------|-------------|--------------|
 0  | 0x00000000   | 0x00808000 | 0x00808000 | 0x00000000  | 0x00000000   |
 1  | 0x00e1fff0   | 0x00E1FFF0 | 0x00E1FFF0 | 0x00000000  | 0x00000000   |
 2  | 0x0008D800   | 0x000FDC40 | 0x000ED040 | 0x00000000  | 0x00000000   |

---=== 3.7v

Reg | StUp w/o USB | plugin USB | plugout USB| StUp w/ USB | Reset w/ USB |
-------------------|------------|------------|-------------|--------------|
 0  | 0x00000000   | 0x00808000 | 0x00000000 | 0x00000000  | 0x00000000   |
 1  | 0x00E1FFF0   | 0x00E1FFF0 | 0x00E1FFF0 | 0x00000000  | 0x00000000   |
 2  | 0x0008D800   | 0x000FDC40 | 0x000ED040 | 0x00000000  | 0x00000000   |

---=== 3.6v

Reg | StUp w/o USB | plugin USB | plugout USB| StUp w/ USB | Reset w/ USB |
-------------------|------------|------------|-------------|--------------|
 0  | 0x00000000   | 0x00808000 | 0x00000000 | 0x00000000  | 0x00000000   |
 1  | 0x00E1FFF0   | 0x00E1FFF0 | 0x00E1FFF0 | 0x00000000  | 0x00000000   |
 2  | 0x0008D800   | 0x000FDC40 | 0x0008D800 | 0x00000000  | 0x00000000   |

---=== 3.5v

Reg | StUp w/o USB | plugin USB | plugout USB| StUp w/ USB | Reset w/ USB |
-------------------|------------|------------|-------------|--------------|
 0  | 0x00000000   | 0x00808000 | 0x00000000 | 0x00000000  | 0x00000000   |
 1  | 0x00E1FFF0   | 0x00E1FFF0 | 0x00E1FFF0 | 0x00000000  | 0x00000000   |
 2  | 0x0008D800   | 0x000FDC40 | 0x0008D800 | 0x00000000  | 0x00000000   |
                     0x000FD840
}}}

   | Reg 0  | Reg 1   |Reg 2   |      |
   | intrr  | intr m  |intr sen|      |
---------------------------------------
0  |        |         |        | 0    |
1  |        |         |        | 0    |
2  |        |         |        | 0    |
3  |        |         |        | 0    |
---------------------------------------
4  |        |         |        | 0    |
5  |        |         |        | 0    |
6  |CHGDETI |         |CHGDETS | 1    |
7  |        |         |        | 0    |
---------------------------------------
8  |        |         |        | 0    |
9  |        |         |        | 0    |
10 |CCCVI   |         |CCCVS   | 1    | !!!
11 |CHGCURRI|         |CHGCURRS| 1    |
---------------------------------------
12 |        |         |        | 1    |
13 |        |         |        | 0    |
14 |        |         |        | 1    |
15 |        |         |        | 1    |
---------------------------------------
16 |USBI    |         |USB4V4S | 1    |
17 |        |         |USB2V0S | 1    |
18 |        |         |USB0V8S | 1    |
19 |IDI     |         |IDFLOATS| 1    |
---------------------------------------
20 |        |         |        | 0    |
21 |        |         |        | 0    |
22 |        |         |        | 0    |
23 |UDMI    |         |UDMS    | 0    |

Tests after change {{{

---=== 4.1v

Reg | StUp w/o USB | plugin USB | plugout USB| StUp w/ USB | Reset w/ USB |
-------------------|------------|------------|-------------|--------------|
 0  | 0x00000000   | 0x00808000 | 0x00000000 | 0x00000000  | 0x00000000   |
 1  | 0x00e1fff0   | 0x00E1FFF0 | 0x00E1FFF0 | 0x00000000  | 0x00000000   |
 2  | 0x000ED040   | 0x000FDC40 | 0x000ED040 | 0x00000000  | 0x00000000   |

---=== 3.7v

Reg | StUp w/o USB | plugin USB | plugout USB| StUp w/ USB | Reset w/ USB |
-------------------|------------|------------|-------------|--------------|
 0  | 0x00000000   | 0x00808000 | 0x00000000 | 0x00000000  | 0x00000000   |
 1  | 0x00E1FFF0   | 0x00E1FFF0 | 0x00E1FFF0 | 0x00000000  | 0x00000000   |
 2  | 0x0008D800   | 0x000FDC40 | 0x000ED040 | 0x00000000  | 0x00000000   |

---=== 3.5v - 41% - 480

Reg | StUp w/o USB | plugin USB | plugout USB| StUp w/ USB | Reset w/ USB |
-------------------|------------|------------|-------------|--------------|
 0  | 0x00000000   | 0x00808000 | 0x00000000 | 0x00000000  | 0x00000000   |
 1  | 0x00E1FFF0   | 0x00E1FFF0 | 0x00E1FFF0 | 0x00000000  | 0x00000000   |
 2  | 0x0008D800   | 0x000FDC40 | 0x0008D800 | 0x00000000  | 0x00000000   |

---=== 3.47v - 40% - 469 (version 1.17a may vibrate every 30sec and less)

Reg | StUp w/o USB | plugin USB | plugout USB| StUp w/ USB | Reset w/ USB |
-------------------|------------|------------|-------------|--------------|
 0  | 0x00000000   | 0x00808000 | 0x00000000 | 0x00000000  | 0x00000000   |
 1  | 0x00E1FFF0   | 0x00E1FFF0 | 0x00E1FFF0 | 0x00000000  | 0x00000000   |
 2  | 0x0008D800   | 0x000FDC40 | 0x0008D800 | 0x00000000  | 0x00000000   |

}}}

}}}
14. Watch> USB detection procedure {{{
    05jan2010

USB detection testing {{{
                                    4.1V
Start the target board w/o application
and w/o USB pluggedin       0x000000        0xE0FFF0        0x0ED040        0x000001
Plugin USB                  0x808400        0xE0FFF0        0x0FDC40        0x000001
Plugout USB                 0x000800        0xE0FFF0        0x0ED440        0x000001
                            0x000C00        0xE0FFF0        0x0ED040        0x000001

and w/ USB pluggedin        0x808000        0xE0FFF0        0x0FDC40        0x000001
Plugout USB                 0x000C00        0xE0FFF0        0x0ED040        0x000001

Start the target board w/ application
and w/o USB pluggedin       0x000000        0xE1FFF0        0x0ED040        0x000000
Plugin USB                  0x808000        0xE1FFF0        0x0FDC40        0x000001
Plugout USB                 0x000000        0xE1FFF0        0x0ED040        0x000000

and w/ USB pluggedin        0x808000        0xE1FFF0        0x0FDC40        0x000001
Plugout USB                 0x000000        0xE1FFF0        0x0ED440        0x000000
                            0x000400        0xE1FFF0        0x0ED040        0x000000
                            0x000000        0xE1FFF0        0x0ED040        0x000000

                                    3.7V
Start the target board w/ application
and w/o USB pluggedin       0x000000        0xE1FFF0        0x08D800        0x000001
Plugin USB                  0x808000        0xE1FFF0        0x0FDC40        0x000001
Plugout USB                 0x000400        0xE1FFF0        0x0ED040        0x000001
                            0x000000        0xE1FFF0        0x0ED040        0x000001

and w/ USB pluggedin        
Plugout USB                 

                                    3.5V
Start the target board w/ application
and w/o USB pluggedin      0x000000        0xE1FFF0        0x08D800 
Plugin USB                 0x808000        0xE1FFF0        0x0FDC40
Plugout USB                0x818C40        0xE1FFF0        0x0CD800
                           0x000000        0xE1FFF0        0x08D800
                           0x000000        0xE1FFF0        0x08D800 
                            

and w/ USB pluggedin        
Plugout USB                 

                           | Reg 0          | Reg 1         | Reg 2        
                           | interrupt      | interrupt mask| interrupt sense     
                      -------------------------------------------------------
                      0    |                |               |             
                      1    |                |               |             
                      2    |                |               |             
                      3    |                |               |             
                      -------------------------------------------------------
                      4    |                |               |             
                      5    |                |               |             
                      6    | CHGDETI        |               | CHGDETS      
                      7    |                |               |             
                      ------------------------------------------------------
                      8    |                |               |             
                      9    |                |               |             
                      10   | CCCVI          |               | CCCVS        !!!
                      11   | CHGCURRI       |               | CHGCURRS     
                      --------------------------------------------------- 
                      12   |                |               |             
                      13   |                |               |             
                      14   |                |               |             
                      15   |                |               |             
                      --------------------------------------------------- 
                      16   | USBI           |               | USB4V4S      
                      17   |                |               | USB2V0S      
                      18   |                |               | USB0V8S      
                      19   | IDI            |               | IDFLOATS     
                      --------------------------------------------------- 
                      20   |                |               |             
                      21   |                |               |             
                      22   |                |               |             
                      23   | UDMI           |               | UDMS         
}}}

The detection no based only on bit 16 in reg 2 of PMIC, which is USB4V4S

}}}
15. Watch> Change battery capacity calculation {{{
    30dec2009

Current: There are values
[battery_low]
    mvolt_max = 270
    mvolt_min = 450
    hwunits_max = 957
    hwunits_min = 144
[battery_low]
    full_percent = 82
    notify_percent = 40
    stop_percent = 35
    notify_interval = 1200

The old calculations are
    The 82% from range of 975 - 144 = 813, which is 666.7 hw units.
    The 40% is 325 units and 35% - 284.6 units.

--- Measures:
3.71v- 568.4 - 40%
3.67v- 549.6 - 35%
3.6v - 519   - 26%
3.5v - 472   - 12.8%
Found that 4.5v is 925 units, which is 27 units less.    

New settings calculations:

The 4.18v (units 782) is full battery, which is 100%
The 3.4v (units 426) is empty battery, which is 0%
    The range is 0.78v (356). So 40% = 3.71v (568.4) and 35% = 3.67v (549.6)
The new notification level is 
    3.6v (568.4) which is 26% (0.02v (142.4) from range 0.78v)
and the new stop level is 3.5v (549.6) which is 12.8%

Final: notify - 13% 3.5v (549.6)
       stop - 0%

New configuration values:
[battery_low]
    mvolt_max = 418
    mvolt_min = 340
    hwunits_max = 782
    hwunits_min = 426
[battery_low]
    full_percent = 100
    notify_percent = 13
    stop_percent = 0
    notify_interval = 1200
    upgrade_limit = 13
    
}}}
16. Watch> Fix AVI file {{{
    24jan2010
Fix corrupted AVI files at app startup.

Find bytes 4 - 7, if those are 0, so should right the real file size.
}}}
17. Watch> Fix kernel panic in sleep/standby mode {{{
    23feb2010
The STOP mode while while all power is off and clock down to 32KHz.
When getting out of the mode the kernel panic happened.

The start of the mode begins in app which calls ioctl WRISTCMD_POWER_OFF, which
handled in wristwatchdrv in stop_mode() (file main.c)
The entry to the STOP mode is in mxc_pm_lowpower() (arch/arm/mach-mx27/mxc_pm.c)

Changes:
    in mxc_pm_lowpower() - while getting out from stop mode, to read CSCR value
and switch on bits 0 n 1. Also to do it before enable irqs. Cancel calling
gpio suspend and gpio resume functions (mxc_suspend(), mxc_gpio_resume()). 
    in stop_mode() - cancel unmasking CCTV interrupt, cancel setting switches
SWA1 n SWB1, etc...
}}}
18. Watch> Change stop recording button push {{{
    03feb2010 27apr2010

To move keyboard related code to separate files: keyboard.[c,h]
Follow functions are moved:
    int KbdState1(KbdTrackHandle_t *KbdTrack);
    int KbdState2(KbdTrackHandle_t *KbdTrack);
    int KbdTrackHandler(Button_t Button, ButtonState_t ButtonState,
        unsigned int mdifftime);
    int CreateKbdTask(void);    
    int KillKbdTask(void);

Added short vibration, while short button push during recording.
In KbdTrackHandler(), when state is StateMode_Record:
added when any of buttons in state released and diff time <= 500
call  Device_SendEvent(OPEVENT_RECORD_ALIVE);

Added new event OPEVENT_RECORD_ALIVE in WristWatchControler() which does
call Device_DoVibration(VibratorType_RecordAlive);

Added new vibration type VibratorType_RecordAlive which does
1 vibration for 300 ms.

}}}
19. Watch> Configuration params {{{
    02may2010

Device_Init()
|-> Device_ReadConfig() (wristwatch/devicehandler.c)
|   |-> read_params() (inifile/params.c)
|   |-? set_syslog_on() (ilog/il.h)
|   |-? set_syslog_off() (ilog/il.h)
|   |_> set_redboot_version()


Device_DoUSBPlugin()
|-> ...
|-> Device_updateConfig()
|   |-> update_params() (inifile/params.c)
|   |-> read_params() (inifile/params.c)
|   |-? restore_default_params() (inifile/params.c)
|   |-? Device_ReadConfig()
|   |-? set_syslog_on() (ilog/il.h)
|   |_? set_syslog_off() (ilog/il.h)
|->

The project inifile moved under dir wristwatch. Makefiles changed. ibuild.sh also changed to
build inifile as part of wristywatch application.

}}}
20. Watch> create libutils {{{
    16may2010

svn add utils --non-recursive
svn commit utils -m "add dir utils"
svn move http://192.168.1.61/first/watch/trunk/wristwatch/utils.c http://192.168.1.61/first/watch/trunk/wristwatch/utils/utils.c -m "move to dir utils"
svn move http://192.168.1.61/first/watch/trunk/wristwatch/utils.h http://192.168.1.61/first/watch/trunk/wristwatch/utils/utils.h -m "move to dir utils"
svn move http://192.168.1.61/first/watch/trunk/wristwatch/utils_file.h http://192.168.1.61/first/watch/trunk/wristwatch/utils/utils_file.h -m "move to dir utils"
svn move http://192.168.1.61/first/watch/trunk/wristwatch/utils_file.c http://192.168.1.61/first/watch/trunk/wristwatch/utils/utils_file.c -m "move to dir utils"
svn add utils/Makefile
svn commit utils/Makefile -m "add makefile"
Change ffmpeg/Makefile

}}}

Watch> Bug #124> Can't record audio < 20sec {{{
    16may2010

av_encode() (ffmpeg/ffmpeg.c)
|->
|-> ...
|-> av_read_frame() (ffmpeg/libavformat/utils.c)
|-> ...
|-> output_packet()
|   |-> write_frame()
|   |   |-> 


file_write() (ffmpeg/libavdevice/sahara.c)
|-> ...
|->fifowrite() (ffmpeg/libavdevice/sahara.c)

}}}

dm365> BringUp new software {{{
    06may2010

download {{{

PSP   3.01
DVSDK 3.10.00.12

from http://software-dl.ti.com/dsps/dsps_public_sw/sdo_sb/targetcontent/dvsdk/DVSDK_3_10/latest/index_FDS.html
   5128505 2010-05-06 14:46 arago-2009.11-armv5te-linux-gnueabi-sdk.tar.gz - GIT PSP SDK
  12308572 2010-05-06 14:48 arago-demo-image-dm365-evm.tar.gz - 
  92281902 2010-05-06 14:50 data_dm365.tar.gz
     52575 2010-05-06 14:39 DaVinci_PSP_03.01_Beta_Release_Notes
   3136981 2010-05-06 14:46 dvsdk_3_10_00_12_overlay_dm365.tar.gz -
    213229 2010-05-06 14:28 dvsdk_3_10_00_12_releasenotes.pdf
 342593245 2010-05-06 14:46 dvsdk_3_10_00_12_Setup.bin - DVSDK software installer
    108455 2010-05-06 14:28 dvsdk_3_10_00_12_swmanifest.pdf
  84299315 2010-05-06 14:45 linux-davinci-staging.tar.gz - GIT Linux PSP kernel source
    151124 2010-05-06 14:47 u-boot-dm365-evm.bin
   2106420 2010-05-06 14:47 uImage-dm365-evm.bin

Toolchain downloads:
 134403647 2010-05-06 15:14 arm-2009q1-203-arm-none-linux-gnueabi.bin
  77413954 2010-05-06 16:02 arm-2009q1-203-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2
   1627657 2010-05-06 14:53 as.pdf
    369751 2010-05-06 14:53 binutils.pdf
    466369 2010-05-06 15:03 cpp.pdf
   2652658 2010-05-06 14:58 gcc.pdf
   2158421 2010-05-06 14:58 gdb.pdf
    353895 2010-05-06 15:02 getting-started.pdf
    240471 2010-05-06 15:02 gprof.pdf
      2568 2010-05-06 15:03 HDD_ReadMe.html
    662428 2010-05-06 15:03 ld.pdf
   5046061 2010-05-06 15:00 libc.pdf
     11398 2010-05-06 15:03 release858.htm
}}}
Toolchain installation {{{

If Using Ubuntu 8.x and above do follows:
sudo dpkg-reconfigure -plow dash
answer - No

mkdir /opt/codesourcery
cd /opt/codesourcery
tar jxf arm-2009q1-203-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2
The toolchain will be under /opt/codesourcery/arm-2009q1

Add follows line to .bashrc
alias setdm365='PATH=/opt/codesourcery/arm-2009q1/bin:/usr/local/bin:/usr/local/sbin:/bin:/sbin:/usr/bin:/usr/sbin:/usr/bin/X11:/usr/X11R6/bin'
run: setdm365
}}}

    * Try compiling with -fpromote-loop-indices in addition to your usual optimization options. This experimental option significantly improves performance on some benchmarks. It is not yet enabled by default with -O3 because of its experimental nature.
    * Try adding -funroll-loops to your optimization flags. Code size will increase, but you may get better performance.

Software installation (SDK, PSP, DVSDK) {{{
chmod 777 /opt
mkdir /opt/dm365
cd /opt/dm365
tar zxf arago-2009.11-armv5te-linux-gnueabi-sdk.tar.gz
mv ./opt/arago-2009.11 .
Now, there is SDK under /opt/dm365/arago-2009.11

cd /opt/dm365
tar zxf ~/ivirtus/dm365/download-06may2010/linux-davinci-staging.tar.gz
Now, there is PSP (means kernel) under /opt/dm365/git

chmod a+x dvsdk_3_10_00_12_Setup.bin
cd /opt/dm365
run: ./dvsdk_3_10_00_12_Setup.bin, change path during installation as follow
Destination folder: /opt/dm365
CodeSourcery tool dir: /opt/codesourcery/arm-2009q1
Linux kernel: $(DVSDK_INSTALL_DIR)/../git
Linux libs: $(DVSDK_INSTALL_DIR)/../arago-2009.11/arm-none-linux-gnueabi/usr
Install dir: /opt/dm365/rootfs
Now, there is DVSDK under /opt/dm365/dvsdk

Create rootfs-demo
mkdir /opt/dm365/rootfs-demo && cd /opt/dm365/rootfs-demo
sudo tar zxf arago-demo-image-dm365-evm.tar.gz
chmod 777 -R /opt/dm365/rootfs-demo

Prepare NFS rootfs. Add follow lines to /etc/exports
/opt/dm365/rootfs       *(rw,no_root_squash,no_all_squash,sync)
/opt/dm365/rootfs-demo  *(rw,no_root_squash,no_all_squash,sync)
sudo /usr/sbin/exportfs -av
sudo /etc/init.d/nfs-kernel-server restart

Build kernel
sudo apt-get install uboot-mkimage
cd /opt/dm365/dvsdk_3_10_00_12
make linux_clean
make linux
cp /opt/dm365/dvsdk_3_10_00_12/../git/arch/arm/boot/uImage /tftpboot/dm365/

Build u-boot from git
git clone -n git://arago-project.org/git/projects/u-boot-davinci.git
cd u-boot-davinci
git checkout DEV.DaVinciPSP.03.XX.00.35


}}}

Set env n build (arago - DEV.DaVinciPSP.03.XX.00.35) {{{
    12may2010
cd ivirtus/dm365/dev-arago
git clone -n git://arago-project.org/git/arago.git
cd arago
git checkout DEV.DaVinciPSP.03.XX.00.35
cd ivirtus/dm365/dev-arago
git clone -n git://arago-project.org/git/arago-oe-dev.git
cd arago-oe-dev
git checkout DEV.DaVinciPSP.03.XX.00.35
cd ivirtus/dm365/dev-arago
git clone -n git://arago-project.org/git/arago-bitbake.git
cd arago-bitbake
git checkout DEV.DaVinciPSP.03.01.00.28

cd ivirtus/dm365/dev-arago
cp arago/setenv.sample arago/setenv
cp arago/conf/local.conf.sample arago/conf/local.conf
Chnages in arago/setenv
export OEBASE=$HOME/ivirtus/dm365/dev-arago
export SCRATCH=/opt/dm365/scratch

. arago/setenv

Make sure CodeSourcery toolchain installed and exists in PATH

    Build arago base filesystem
MACHINE=dm365-evm bitbake arago-base-image
    Build u-boot and arago demo filesystem
MACHINE=<machine> bitbake board-set arago-demo-image
    Build kernel w/ linked modules
MACHINE=<machine> bitbake linux-davinci-staging-static

}}}

Config Uboot {{{

bring kernel image by tftp
--------------------------
setenv serverip 192.168.1.137
setenv ipaddr 192.168.1.138
tftp 80700000 dm365/uImage
bootm 80700000

nfs
---
setenv bootargs 'mem=64M console=ttyS0,115200n8 root=/dev/nfs rw nfsroot=$(nfshost):$(rootpath),nolock ip=dhcp video=davincifb:vid0=OFF:vid1=OFF:osd0=720x576x16,2025K dm365_imp.oper_mode=0'
setenv baudrate 115200
setenv serverip 192.168.1.137
setenv nfshost 192.168.1.137
setenv rootpath /opt/dm365/rootfs-demo
saveenv


setenv boot_console 'console=ttyS0,115200'


setenv loads_echo=1
setenv baudrate 115200
setenv bootdelay 3
setenv ethaddr 00:0e:99:02:ca:7e
setenv netboot 'tftp 3800000 pMulti; bootm 3800000'
setenv ipaddr 192.168.1.138
setenv serverip 192.168.1.137
setenv loadip 192.168.1.137
setenv gatewayip 192.168.1.1
setenv netmask 255.255.255.0
setenv hostname gxk_dm365
setenv netdev eth0
setenv use_dhcp off
setenv bootargs_base console=ttyS0,115200 root=/dev/ram rw
setenv addip 'setenv bootargs ${bootargs_base} ip=${loadip}:${serverip}:${gatewayip}:${netmask}:${hostname}:${netdev}:${use_dhcp}'
setenv bootcmd 'run addip; run netboot'
saveenv

setenv bootcmd 'run addip; bootm b0900000'


setenv bootfile uImage-dm####-evm.bin
setenv gateway  <ip address of the gateway>
Set per platform U-Boot parameters described as above
saveenv
boot

}}}
}}}

Watch> Redesign Vibrator {{{
    21apr2010
To make vibration more deterministic.
Create Vibration runner, which is separate thread waiting blocked on 
message queue. Getting message, 
}}}
Watch> new USB detection {{{
    27jan2010
from Atlas_(MC13783)_User_Guide_Rev_3 5.pdf section 8.3.3:
    If the Charger is removed while the Charge Path regulator is enabled, the
software removal detection of the charger can be determined by a combination of
CHRGCURRS, CHGDETS, and USB4V4S.

So the USB detection set in Device_GetPluginState() as

CHGCURRS bit 11
CHGDETS  bit 6
USB4V4S  bit 16
}}}
Watch> newest USB detection {{{
    07feb2010

There are claims that current USB detection not works everytime.

Solution: To base USB detection on std Linux USB gadget mass storage driver
which mostly??? works.

After reset, starts USB enumarating by calling device setup API for device
descriptor.
from drivers/usb/gadget/file_storage.c standard_setup_req()
case USB_DT_DEVICE:
}}}
Watch> format ubifs partitions {{{
    14feb2010
umount /mnt/appfs
ubidetach /dev/ubi_ctrl -m 5
ubiformat /dev/mtd/5 -O 2048 -s 2048

ubiattach /dev/ubi_ctrl -m 5 -O 2048
ubimkvol /dev/ubi0 -N appfs  -m
mount -t ubifs ubi0:appfs /mnt/appfs
}}}
Wifi> Build bluetooth solution {{{
    21dec2009
cd expat-2.0.1
CC=arm-none-linux-gnueabi-gcc ./configure --host=arm --prefix=${IVIRTUS_PRJ_ROOTFS}
make && make install

cd dbus-1.2.1
CC=arm-none-linux-gnueabi-gcc CPPFLAGS="-I${IVIRTUS_PRJ_ROOTFS}/include"  LDFLAGS="-L${IVIRTUS_PRJ_ROOTFS}/lib"  ./configure --host=arm-linux --prefix=${IVIRTUS_PRJ_ROOTFS} ac_cv_have_abstract_sockets=${ac_cv_have_abstract_sockets=no} --without-x --with-xml=expat
make && make install

cd bluez-libs-3.36
CC=arm-none-linux-gnueabi-gcc CPPFLAGS="-I${IVIRTUS_PRJ_ROOTFS}/include"  LDFLAGS="-L${IVIRTUS_PRJ_ROOTFS}/lib"  ./configure --host=arm-linux --prefix=${IVIRTUS_PRJ_ROOTFS}
make && make install

cd bluez-utils-3.36
PKG_CONFIG_PATH="${IVIRTUS_PRJ_ROOTFS}/lib/pkgconfig" CC=arm-none-linux-gnueabi-gcc CPPFLAGS="-I${IVIRTUS_PRJ_ROOTFS}/include"  LDFLAGS="-L${IVIRTUS_PRJ_ROOTFS}/lib"  ./configure --host=arm-linux --prefix=${IVIRTUS_PRJ_ROOTFS} --enable-tools --enable-test --disable-glib --disable-usb

}}}
Watch> Testing {{{

--- Acceptance tests ---

1. USB mode (connectivity only, w/o streaming)
    Purpose: Ability to open the product as mass storage device on the Windows PC.
        1. Plug-in USB cable and open mass storage device on Windows PC.
        2. Check that exist param.ini and system.ini
        3. Open param.ini and verify the version number
        4. Wait for 1 min in the mode, while doing nothing, in order to see 
            that no switch to power safe
2. Power management
    Purpose: ability to save power and to charge a battery
        1. Plug-in USB cable, open system.ini file and change value of the 
            enable (power_save section) to true. Close the file and plug-out
            USB cable. Wait for 1 min, the system should switch to the power
            save mode. 
        2. Check the ability to get out from power save to the normal mode and 
            try whole sequence again.
        3. While battery low, ability of the system to start charging while USB plugged in.
3. Configurability:
    Purpose: ability to configure the parameters that changes the system behavior
4. Upgrade
    Purpose: ability to upgrade the full system.
5. Video recording
    Purpose: ability to make 2 video recordings at least 20 and 10 minutes long.
6. Audio recording
    Purpose: ability to make audio recording.
7. Snapshot
    Purpose: ability to make still pictures
8. Changes of the version
}}}
Watch> Boot analyzes {{{
    14jan2010
from redboot/hal/arm/mx27/ads/current/include/hal_platform_setup.h

.macro _platform_setup1

}}}

Boot the sting3g {{{
    08mar2010

--- Check sources
svn co http://192.168.1.61/first/sting-3g/trunk .

Follows files in dvsdk (dvsdk_2_10_01_18) changed:
dmai_1_21_00_10/packages/ti/sdo/dmai/ce/Venc1.[c|h]

--- Building

ibuild.sh bootloader
ibuild.sh kernel
ibuild.sh modules
cd <dvsdk>
make
make install

ibuild.sh live-arm
ibuild.sh dm365_live
ibuild.sh ffmpeg
ibuild.sh app
ibuild.sh rootfs

--- Set NFS exports in /etc/exports
/opt/sting3g/rootfs     192.168.1.0/24(rw,sync,no_root_squash,no_all_squash)

sudo chown -R gxk:gxk /opt

-- U-boot env (evm)
setenv ipaddr 192.168.1.177
setenv serverip 192.168.1.137
setenv bootargs 'console=ttyS0,115200n8 root=/dev/nfs nfsroot=192.168.1.137:/opt/sting3g/rootfs rw noinitrd mem=80M video=davincifb:vid0=OFF:vid1=OFF:osd0=OFF:osd1=OFF dm365_imp.oper_mode=0 davinci_capture.device_type=4 ip=192.168.1.177'
setenv bootcmd 'tftp 80700000 sting3g/uImage; bootm'

-- U-boot env (sting3g)
setenv bootargs 'console=ttyS0,115200n8 root=/dev/ram0 rw initrd=0x82000000,8M mem=80M video=davincifb:vid0=OFF:vid1=OFF:osd0=OFF:osd1=OFF dm365_imp.oper_mode=0'
setenv bootcmd 'nand read 0x82000000 0x20800000 0x780000; nboot 0x80700000 0x400000; bootm'

--- Flash
    base addr 0x2000000, blks 0x1000 pages/blk 0x40 bytes/page 0x1000 
    blk size 262.144 (0x40000) 
    media size 1.073.741.824 (0x40000000)

                        address                     block
    
    BBT                 0x000000    - 0x03ffff      0
    UBL                 0x040000    - 0x07ffff      1
    u-boot              0x080000    - 0x0cffff      2
    u-boot params       0x3c0000    - 0x3fffff      15
    kernel              0x400000    - 0xffffff      16-63
    initrd              0x1000000   - 0x1fffffff    64-0x7ff
    rootfs              0x20000000  - 0x3fffffff    0x800-0xfff

<kernel>/arch/arm/mach-davinci/board-dm365-evm.c  line 204
0x00000000-0x003c0000 : "bootloader"
0x003c0000-0x00400000 : "params"
0x00400000-0x00800000 : "kernel"
0x00800000-0x1f800000 : "initrd"
0x1f800000-0x80000000 : "rootfs"

to erase rootfs partition:
nand erase 0x1f800000 0x1e00000

--- 3G
Should be same company SIM in modem and computer.

--- Install Sting3G through serial
on host:
cp /opt/mv_pro_5.0/dvsdk_2_10_01_18/PSP_02_10_00_14/bin/ramdisk.gz /tftpboot/

on host:
create ~/.kermrc w/ follow
set line /dev/ttyUSB0
set speed 115200
set carrier-watch off
set handshake none
set flow-control none
robust
set file type bin
set file name lit
set rec pack 1000
set send pack 1000
set window 5

run: kermit -c
push enter to get target prompt
setenv bootargs 'console=ttyS0,115200n8 root=/dev/ram0 rw initrd=0x82000000,3M mem=80M ip=off video=davincifb:vid0=OFF:vid1=OFF:osd0=OFF'
setenv bootcmd 'nand read 0x82000000 0x800000 0x400000; nboot 0x80700000 0 0x400000; bootm'
//setenv bootcmd 'nand read 0x82000000 0x1000000 0x400000; nboot 0x80700000 0 0x400000; bootm'
saveenv
--- burning kernel
loadb 0x80700000
push from right Ctrl+Alt+\ C and get to kermit prompt: C-Kermit>
run: send /bin /tftpboot/sting3g/uImage
when finished run: connect
get target prompt and run
nand erase 0x400000 0x200000
nand write 0x80700000 0x400000 0x200000
--- burning ramdisk
loadb 0x82000000
push from right Ctrl+Alt+\ C and get to kermit prompt: C-Kermit>
run: send /bin /tftpboot/sting3g/ramdisk.gz
when finished run: connect
get target prompt and run
nand erase 0x800000 0x300000
nand write 0x82000000 0x800000 0x300000

nand erase 0x1f800000 0x1e00000

boot

--- Burn rootfs
Prepare SD card w/ rootfs ???
Insert card
mkdir /mnt/mmc
mkdir /mnt/tmp
mount /dev/mmcblk0p1 /mnt/mmc
mount -t yaffs2 /dev/mtdblock4 /mnt/tmp
cd /mnt/tmp
tar xf /mnt/mmc/rootfs-sting3g.tar
cd /
umount /mnt/tmp
umount /mnt/mmc
reboot and get u-boot prompt
setenv bootargs0 'console=ttyS0,115200n8 root=/dev/mtdblock4 rw rootfstype=yaffs2 noinitrd mem=80M ip=off video=davincifb:vid0=OFF:vid1=OFF:osd0=OFF'
setenv bootargs1 'dm365_imp.oper_mode=0 davinci_capture.device_type=4 davinci_enc_mngr.ch0_output=COMPOSITE davinci_enc_mngr.ch0_mode=ntsc'
setenv bootargs ${bootargs0} ${bootargs1}

--- create ttyUSB0 device
mknod /dev/ttyUSB0 c 188 0

from Yoram 15mar2010
{{{
Creating 5 MTD partitions on "nand_davinci.0":
0x00000000-0x00400000 : "bootloader"
0x00400000-0x00800000 : "kernel"
0x00800000-0x01800000 : "initrd"
0x01800000-0x03600000 : "rootfs3"
0x03600000-0x05600000 : "rootfs4"

erase rootfs3
nand erase 0x1800000 0x2000000

setenv mtdargs 'mtdparts=nand_davinci.0:4M(bootloader)ro,4M@4M(kernel),16M@8M(initrd),30M@24M(rootfs3),32M@54M(rootfs4)-(rootfs)'
16M@8M - size 16MB, offset 8M
setenv bootargs ${bootargs0} ${bootargs1} ${mtdargs}
}}}

--- How to change Uboot env !!!
setenv bootargs_base console=ttyS0,115200 root=/dev/ram rw
setenv addip 'setenv bootargs ${bootargs_base} ip=${loadip}:${serverip}:${gatewayip}:${netmask}:${hostname}:${netdev}:${use_dhcp}'
setenv bootcmd 'run addip; run netboot'

}}}

05. To learn Altair sdio code {{{

Contacts {{{
Moshe (proj mngr)
    09-7403045(246)
    054-4221691
Ran (sw team lead)
}}}

--- DAPI (from doc DC-E2150-08 rev B)
The DAPI is user space API (static library) for kernel drivers

from to doc DC-E2150-07 rev B:

from Release_10_06_2009_15_08_52/Src/Driver/Readme.txt
    Common -    contains common files of the driver modules.
    WiMax -     contains the modules which are implments the WiMax spec.
    Tools -     contains the tools needed to build the driver.
    OS -    contains the OS modules (OSAL, linux, Windows)
    DriverCore -    contains non protocol dependent driver code
    Infrastructure -    contains common infrastructure for all driver modules
    HWDependent -   contains bus driver abstraction and chip abstraction

Altair Software Package {{{

from (Release_10_06_2009_15_08_52/Src/OS/Linux/Drivers/SDIO/sdio/Include/...)
{{{
--- host.h (osal.h sdiodrv.h)
struct io_req
struct hc_dma
struct sdiodrv_host
void sdiodrv_command(struct io_req *req);
void sdiodrv_deinit_host(struct sdiodrv_host *sh);
void sdiodrv_init_host(struct sdiodrv_host *sh);
void sdiodrv_irq(void *arg);
//needed for init card
void sdiodrv_host_ext_timeout(int on);
void sdiodrv_host_bus_width(int _4bit);
void sdiodrv_host_abort_xfer(void);
void sdiodrv_poll_card(void *arg);
//debug
void dump_sdio_regs(uint16 op);
--- card.h (host.h)
extern int sdiodrv_config_card(struct sdiodrv_host *sh);
extern int sdiodrv_set_block_size(struct sdiodrv_host *sh, int fn, int block_size);
extern int sdiodrv_reset_card(struct sdiodrv_host *sh);
extern int sdiodrv_card_present(void);
--- os.h
extern int dma_threshold;
extern int data_timeout;
extern int cmd_timeout;
extern int clock_div;
extern int bus_width;
extern int fifo_threshold;
extern int single_mode_dma;
extern int polling_mode_threshold;
extern void MicroDelay(int Microseconds);
--- omap-defs.h
--- omap-dma.h
struct io_req;
int sdiodrv_init_dma(void);
int sdiodrv_start_dma(struct io_req *req);
int sdiodrv_abort_dma(struct io_req *req);
void sdiodrv_get_dma_irq_counter(SdioCounters_t * sdioCounters);
--- proto.h (sdiodrv.h)
}}}

from (Release_10_06_2009_15_08_52/Src/OS/Linux/Drivers/SDIO/Include/...)
{{{
--- osal.h
#include <linux/kernel.h>
#include <linux/module.h>
#include <linux/interrupt.h>
#include <asm/io.h>
#include <asm/hardware/clock.h>
#include <linux/interrupt.h>
#include <linux/spinlock.h>
#include <linux/time.h>
typedef spinlock_t atomic_lock_t;
typedef struct completion completion_sema_t;
typedef struct tasklet_struct os_callback_task_struct;
void adapterCallbackTask(void *data);
static inline void sdio_os_callback_task_schedule(os_callback_task_struct* tsk)
{ tasklet_schedule((struct tasklet_struct*) tsk); }
static inline void sdio_os_callback_task_init(void (*func)(void *arg), void *arg, os_callback_task_struct* tsk)
{ tasklet_init((struct tasklet_struct*)tsk, (void (*)(unsigned long))func, (uint32)arg); }
static inline void sdio_os_callback_task_destroy(os_callback_task_struct* tsk)
{ tasklet_kill((struct tasklet_struct*) tsk); }
void osal_schedule_card_poll(void *arg, int delay, void (cb)(void*));

--- sdiodrv.h ( osal.h, bus_adapter.h)
typedef void (*sdio_trans_done_cb)(errcode_e status, void *context);
extern errcode_e sdiodrv_register(card_change_cb callback, void *context, uint32 *handle);
extern void sdiodrv_deregister(uint32 handle);
extern errcode_e sdiodrv_cmd52_atomic(uint32 handle, int func, xfer_dir dir, uint32 addr,
             uint8 *val);
extern errcode_e sdiodrv_cmd52_async(uint32 handle, int func, xfer_dir dir, uint32 addr,
            uint8 *val, sdio_trans_done_cb cb, void *priv);
extern errcode_e sdiodrv_cmd53_atomic(uint32 handle, int func, xfer_dir dir, uint32 addr,
             uint8 *buffer, int length, int incr);
extern void sdiodrv_cmd53_async(uint32 handle, int func, xfer_dir dir, uint32 addr,
                 uint8 *buffer, int length, int incr,
                 sdio_trans_done_cb cb, void *priv);
extern errcode_e sdiodrv_abort_reset(uint32 handle);
extern errcode_e sdiodrv_get_card_id(uint32 handle, uint32 *vendorID, uint32 *productID);
extern errcode_e sdiodrv_cmd53_atomic_sg(uint32 handle, int func, xfer_dir dir, uint32 addr,
                     sg_node *sg, int length, int incr);
extern void sdiodrv_cmd53_async_sg(uint32 handle, int func, xfer_dir dir, uint32 addr,
                 sg_node *sg, int length, int incr,
                    sdio_trans_done_cb cb, void *priv);
extern int sdiodrv_dma_threshold;
extern errcode_e sdiodrv_get_counters(SdioCounters_t * sdioCounters);

--- bus_adapter.h (osal.h)
...
}}}

--- Adapter (from Release_10_06_2009_15_08_52/Src/OS/Linux/Drivers/SDIO/adapter/...)
{{{
sdio_adapter_init() (Src/os.c) - module init
|_> sdio_os_callback_task_init() (Include/osal.h)
    |_> tasklet_init(adapterCallbackTask())
sdio_adapter_exit() (Src/os.c) - module exit
|-> sdio_os_callback_task_destroy()
    |_> tasklet_kill()

adapterCallbackTask() (Src/adapter.c)
|-> release_adapter_lock()
|_? s_req.callback()

bus_register_client() (Src/adapter.c)
|_> sdiodrv_register() (sdio/Src/os.c) {{{
    |-> kmalloc
    |-> memset
    |-> initDevice() (sdio/Src/os.c)
    |   |-> memset()
    |   |_> driver_data=NULL, coherent_dma_mask=0xffffffff
    |-> sdiodrv_init_platform() (sdio/Src/os.c)
    |   |-> MAP_PHYS_ADDR (Include/osal.h) = ioremap()
    |   |-> WRITE_REG16 (Include/osal.h) = __raw_writew()
    |   |-> WRITE_REG16 (Include/osal.h) = __raw_writew()
    |   |-> WRITE_REG16 (Include/osal.h) = __raw_writew()
    |   |-> UNMAP_PHYS_ADDR (Include/osal.h) = iounmap()
    |   |-> clk_get()
    |   |-> MAP_PHYS_ADDR
    |-> sdiodrv_init_host() (sdio/Src/host.c)
    |-> request_irq()
    |_> osal_schedule_card_poll() }}}
bus_deregister_client()
|_> sdiodrv_deregister() (sdio/Src/os.c)
bus_read_reg_bus_space()
bus_read_reg()
bus_read_mem()
bus_write_reg_bus_space()
bus_write_reg()
bus_write_mem()
bus_abort_reset()
bus_get_card_id()
bus_get_counters()
bus_get_max_trans_size()

--- SDIO driver (from Release_10_06_2009_15_08_52/Src/OS/Linux/Drivers/SDIO/sdio/...)
sdiodrv_init() 
sdiodrv_exit()

}}}


--- sdio drv (from iVirtus_Release_0_1-05nov2009)
Source starts from altair_prj/OS
sdiodrv_init() (sdio/Src/os.c)
|-> alloc host struct (struct sdiodrv_host - sdio/Include/host.h)
|-> alloc device struct
|-> initDevice() (sdio/Src/os.c)
|   |-> set coherent_dma_mask = OMAP_DMA_MASK, which is 0xffffffff
|-> set bus width (default is 4)
|-> set card state (default is gone)
|-> sdiodrv_init_platform() (sdio/Src/os.c)
|   |-> ...
|   |-> clk_get()
|   |-> clk_enable()
|   |_> set host mmc_base
|-> sdiodrv_init_host()
}}}
}}}
Live streamer (live555.com) status {{{
    20aug2009

http://live555.com/ - The RTP/RTCP/RTSP/SIP multimedia streaming solution.
download from http://live555.com/liveMedia/public/

Works for Sting WiFi from taken version 02jun2009 or 20apr2009
Added patch (from mailing list) to support h264.

--- From which version originaly taken? (Yoram - 02jun2009)

}}}
Wireless {{{
    24dec2009

git clone git://arago-project.org/git/people/sneha/linux-davinci-staging.git
cd linux-davinci-staging
git reset --hard v2.6.31-davinci1


}}}
Project WristWatch/Lighter {{{
    15sep2009, 22sep2009, 29sep2009

Testing
 -----------------------------------------
|           Bootup time (secs)            |
|-----------------------------------------|
| Version\Product |   Watch   |   Lighter |
|-----------------------------------------|
|  1.2x           |           |           |
|  1.25           |    40     |           |
|  1.26           |    40     |     30    |
|_________________________________________|

Theory {{{

--- Power managemenmt
  Used Freescale - mc13783 (Atlas_(MC13783)_User_Guide_Rev_3 5.pdf). It has
    - Power control logic
    - 32kHz RTC coincell
    - Dual SPI control bus, etc.

Main functionality
1. Audio
    Has microphone amplifiers, speaker amplifiers, voice CODEC and stereo DAC.
2. Switches & Regulators
    Has 4 downconverters n 1 up converter.
3. Battery management
    The single path scheme is while the phone is always supplied from battery and
therefore always has to be present and valid.
In serial path charging scheme the phone can operate directly from the charger
while the battery is removed or deeply discharged.
4. Logic
    It fully programmable via SPI.
5. Misc


    64 regs of 24b each
    battery changing interface for wall charging and USB charging
    10b ADC for battery monioring

--- NAND flash
    04nov2009
Used MCP (Multi Chip Package) from Numonyx NANDDBR4N5A which contents
NAND chip and DDR chip together.
datasheet: 208407_NANDRAM_LargePage_FBGAonly_Updated.pdf
The NAND chip is NAND08G-R4B2-C, datasheet:  NAND04G-B2D_NAND08G-BxC.pdf
Communication w/ flash begins by AHB host initiating read from NAND NFC (NAND
Flash Controller).
The flash has 2KB page
This is done by configuring NFC and waiting for interrupt from flash device.


Post-Processor {{{

    The PP performs deblock, dering, image resize n color space conversion 
(CSC). Those funcs provide needs to meet various RGB n YUV formats.
Input format  - YUV 4:2:0 (planar)
Output format - YUV 4:2:2, RGB (444, 565, 666, 888)
}}}

CMOS Sensor Interface (CSI) {{{
    from MCIMX27RM.pdf (chapter 39)

The CSI is common interface to direct connection w/ external CMOS sensor.
Available nbr of modes: Gated, Non-gated, CCIR656 interlaced, CCIR656
progressive.

    Gated mode:
Using VSYNC, HSYNC and PIXCLK signals. A frame starts w/ rising edge on VSYNC,
then HSYNC goes to HIGH and holds for the entire line.
The Pixel clock is valid as long as HSYNC is HIGH. Data is latched at the 
rising edge of the valid pixel clocks. HSYNC goes to LOW at the end of line.
Pixel clocks then become invalid and CSI stops receiving data from the stream.
For the next line the HSYNC timing repeats. For the next frame the VSYNC timing
repeats.

    Registers:

CSICR1 - r/w -CSI Control Reg 1
CSICR2 - r/w -CSI Control Reg 2
CSICR3 - r/w -CSI Control Reg 3
CSISR  - r/w -CSI Status Reg
CSISTATFIFO - r   -CSI Statistic FIFO Reg
CSIRFIFO    - r   -CSI RX FIFO Reg
CSIRXCNT    - r/w -CSI RX Count Reg

CSISR - (x80000008) shows interface status n kind of interrupt is being generated.
25 (SF_OR_INT) - STATFIFO OverRun Interrupt status - 1 is STATINFO has overflowed.
24 (RF_OR_INT) - RXFIFO OverRun Interrupt status - 1 is RXFIFO has overflowed.
21 (STATFF_INT) - STATFIFO Full Interrupt status - 
18 (RxFF_INT) - 
17 (EOF_INT) -
16 (SOF_INT) -
15 (F2_INT) -
14 (F1_INT) -
13 (COF_INT) -
1  (ECC_INT) -
0  (DRDY) -
}}}

HAB - High Assurance Boot
CSI - CMOS Sensor Interface

Video resolution:
720x480@30fps
720x576@25fps

}}}

Boot {{{
    21dec2009
RAM: 0x00000000-0x07f00000, [0x00025260-0x07ed1000] available
FLASH: 0x00000000 - 0x1000000, 128 blocks of 0x00020000 bytes each.
== Executing boot script in 1.000 seconds - enter ^C to abort
RedBoot> fis load ramdisk
Image loaded from 0x00380000, to RAM 0x02000000, len 0xA00000
RedBoot> fis load linux
Image loaded from 0x00080000, to RAM 0x00100000, len 0x300000
RedBoot> exec
entry=0xa0008000, target=0xa0008000
Using base address 0x00100000 and length 0x00300000
}}}

App code flow {{{

Main
|-> open_ilog()
|-> Init_WirstWatchApp()
|   |-> signal() - set sighandler sigterm_handler() for SIGQUIT,SIGINT,SIGTERM,SIGQUIT,SIGKILL
|   |-> Device_Init()
|   |_> OS_TaskCreate() - create task SystemMonitorTask 
|-> if m_forever - sleep(1)
|-> Device_Term()
|_> close_ilog()

Device_Init() {{{
|-> InitLock()
|-> OS_GetClock()
|-> OS_FifoInit()
|-> ...
|-> open wristwatch drv device (/dev/wristwatchdrv)
|-> read PMIC reg 15
|-> set PMIC reg 15 follow bits: 1, 4, 5
|-> Device_MountFileSystem()
|   |-> losetup -o 4096 /dev/loop/0 /mnt/usrfs/fat32
|   |_> mount /dev/loop/0 -t vfat  /mnt/vfat
|-> Device_ReadConfig()
|   |-> ...
|   |->
|-> Device_GetPluginState() - check if USB connected and more
|   |-> Lock()
|   |-> at 1st time - 
|   |   Set USBM to 1 (mask USB interrupt) - write to PMIC reg 1 value where bit16 is 1
|   |   Write 1 to UDPI and UDMI - write to PMIC reg 0
|   |   Read PMIC reg 0
|   |_> if CCCVS or USB4V4S is 1, so device connected
|
|-> Device_DoUSBPlugin()
|   |-> if USB connected
|   |   |-> copy log file to /mnt/vfat/log.log
|   |   |-> Device_UnmountFileSystem()
|   |   |-> Device_LedEnable() - led on
|   |   |_> ioctl WRISTCMD_BAT_SET_CHARGER w/ charger=0, fcurrent=e, voltage=4
|   |_> if USB disconnected
|       |-> Device_MountFileSystem()
|       |-> Device_LedEnable() - led off
|       |-> upgrade_components()
|       |-> Device_updateConfig()
|       |_> Device_HandleTime()
|-> create RPC task
|-> create Event task
|-> create Kbd task
|-> OS_AllocSemaphore()
|-> OS_AllocSignal()
|-> create Vibrator task
|-> Device_DoVibration()
|_> create Debug task
}}}
RPCtask {{{
-------
|-> set thread name to iRpcTask
|_> while not finished
    |-> Socket_UDPServer(port is 10332) (ffmpeg/ffmpeg.c)
    |   |-> socket()
    |   |-> bind() - bind socket to any addr
    |   |_> setsockopt() - set SO_BROADCAST 
    |-> RPCHandler() (wristwatch/devicehandler.c) wait for client in endless loop
    |   |-> Socket_ReceiveFrom() (ffmpeg/ffmpeg.c)
    |   |   |_> recvfrom() - in blocked mode
    |   |   Receives commands (ffmpeg/rpccmd.h) of type rpccmd_t
    |   |   with feilds: uchar func, uchar mode and paramstr[254]
    |   |-> cmd RPCCMD_EXIT
    |   |-> cmd RPCCMD_PING
    |   |-> cmd RPCCMD_SET_TIME
    |   |-> cmd RPCCMD_GET_TIME
    |   |-> cmd ...
    |   |-> cmd RPCCMD_EVENT
    |   |   |-> event OPEVENT_CHARGER
    |   |   |-> event OPEVENT_USB
    |   |   |-> event OPEVENT_POWERUP
    |   |   |-> event OPEVENT_POWERDOWN
    |   |   |_> Device_SendEvent()
    |   |-> cmd RPCCMD_SERVER_START
    |   |-> cmd RPCCMD_SERVER_TERM
    |   |-> cmd ...
    |   |-> cmd ...
    |   |_? mode==RPCCMD_MODE_REPLAY
    |       |_> RPCSend() (wristwatch/devicehandler.c)
    |           |-> Lock()
    |           |-> Socket_SendTo() (ffmpeg/ffmpeg.c) - port 10333, addr 0
    |           |   |_> sendto()
    |           |-> sleep for 1ms
    |           |_> Unlock()
    |_> Socket_Close() == close()
}}}
EventTask {{{
---------
|-> set name iEventTask
|-> OS_FifoCreate() - create fifo named EventTaskFifo
|-> while !m_EventTaskFinish
|   |-> OS_FifoGet() - hope blocked ???
|   |_? if msg of type EventFifo_Notify
|       |_> WirstWatchControler() (wristwatch/wristwatchapp.c)
|           |-> OPEVENT_POWERUP
|           |-> ...
|           |-> OPEVENT_SELECT_MOVIE_RECORD
|           |   |-> if state == StateMode_Sleep
|           |   |-> if state == StateMode_Record
|           |   |-> if state == StateMode_Idle
|           |   |   |-> Device_Notify(NotifyEvent_StartButton,"Start")
|           |   |   |_> Device_StartRecord()
|           |   |       |-> create task RecordTask (see RecordTask) ...
|           |   |_> Device_Notify (NotifyEvent_RecordMode, "Movie")
|           |-> OPEVENT_SELECT_AUDIO_RECORD
|           |-> OPEVENT_SELECT_SNAPSHOT_RECORD
|           |   |-> if state == StateMode_Sleep
|           |   |_> if state == StateMode_Record
|           |   |-> if state == StateMode_Idle
|           |   |_> Device_Notify (NotifyEvent_RecordMode, "Movie")
|           |-> ...
|           |-> OPEVENT_USB
|           |   |-> Device_GetPluginState()
|           |   |-> Device_DoUSBPlugin() (wristwatch/devicehandler.c)
|           |   |_? if state
|           |       |-> StateMode_Record
|           |       |-> StateMode_Idle
|           |       |-> StateMode_USB
|           |       |-> StateMode_Streaming
|           |       |_> StateMode_Sleep
|           |-> OPEVENT_GO2SLEEP
|           |   |-> if state == StateMode_Record
|           |   |   |->Device_StopRecord() (wristwatch/devicehandler.c)
|           |   |   |   |->
|           |   |   |-> !!! no break keep running in StateMode_Idle
|           |   |-> if state == StateMode_Idle
|           |   |-> if state == StateMode_USB
|           |   |_> if state == StateMode_Streaming
|           |_> OPEVENT_WAKEUP
|
|_> OS_FifoDelete()
}}}
KbdTask (wristwatch/devicehandler.c) {{{
-------
|-> set name iKbdTask
|_> while !m_KbdTaskFinish
    |-> keep previous state of Kbd
    |-> if state == 0
    |   |-> Clean to 0 - KeyTrack old_keystate, KeyTrack handlekdbflag, KeyTrack StartTrackEvent, pollflag
    |   |-> ioctl WRISTCMD_READ_KEY
    |   |-> get event time
    |   |_? keystate is 0, so KeyTrack state=1
    |-> if KeyTrack state == 1
    |   |_> KbdState1()
    |       |-> set pollflag to 1
    |       |-> ioctl WRISTCMD_READ_KEY
    |       |-> get event time
    |       |-> set keystate
    |       |-? keystate not changed
    |       |   |-? keystate is 0
    |       |       |_> set state = 0
    |       |   |_> return
    |       |-> set KeyTrack state = 3, KeyTrack handlekdbflag = 0 
    |       |-> set KeyTrack keystate = keystate | (old_keystate << 2)
    |       |-> ...
    |       |-> ...
    |       |-> KbdTrackHandler()
    |       |   |-> GetState()
    |       |   |-> if state == StateMode_Idle
    |       |   |   |-> ...
    |       |   |   |-> Device_SendEvent OPEVENT_SELECT_SNAPSHOT_RECORD
    |       |   |   |-> Device_SendEvent OPEVENT_SELECT_AUDIO_RECORD
    |       |   |   |-> Device_SendEvent OPEVENT_SELECT_MOVIE_RECORD
    |       |   |   |-> ...
    |       |   |-> if state == StateMode_Record
    |       |   |   |->
    |       |   |-> if state == StateMode_USB
    |       |   |   |->
    |       |   |_> if state == StateMode_Streaming
    |       |   |   |->
    |       |-> ...
    |-> if state == 2
    |   |_> KbdState2()
    |       |-> ...
    |-> if state == 3
    |   |-> set poll flag to 1
    |   |-> ioctl WRISTCMD_READ_KEY
    |   |-> set eventtime
    |   |_> if state != 0 - sleep for 50ms
    |->
    |->
    |->
}}}
VibratorTask {{{
------------
VibratorTask() (wristwatch/devicehandler.c)
|-> set thread name to iVibratorTask
|_>

}}}
SystemMonitorTask (wristwatch/wristwatchapp.c) {{{
-----------------
|-> set thread name iSysMonTask
|-> Device_GetUserConfig()
|-> Device_GetPluginState() (see Device_Init())
|-? Device_SendEvent(OPEVENT_USB) - if connected (see EventTask)
|-> SetStartIdleTimer()
|-> while !m_SystemMonitorTaskFinish
|       |-> sleep for 1 sec
|       |-> GetState() - if StateMode_Streaming next loop iteration
|       |-> Device_GetPluginState() (see Device_Init()) - check if connected USB cable
|       |-? if connected
|       |   |->
|       |-> GetState()
|       |-> if StateMode_USB
|       |   |-> ...
|       |-> if StateMode_Idle
|       |   |-> ...
|       |   |_> ...
|       |-> Device_GetButteryInfo() (wristwatch/devicehandler.c) - get battery status
|       |   |-> Lock()
|       |   |-> ioctl (WRISTCMD_GET_CURRENT)
|       |   |-> set status
|       |   |-> set mvolts
|       |   |_> Unlock()
|       |-> if BTRY_OK
|       |   |_? status < notify_percent
|       |       |-> OS_GetSystemTime()
|       |       |-> Device_SendEvent(OPEVENT_BUTTERY_LOW)
|       |       |_> set m_ButteryLowState = BTRY_LOW
|       |-> if BTRY_LOW
|       |   |-> ...
|       |   |_> ...
|       |-> ...
|       |->
}}}

RecordTask (wristwatch/devicehandler.c) {{{
|-> time()
|-> GetpartitionInfo()
|-> ...
|-> create unique file
|->
|->
|_>
}}}

ffmpeg {{{
    16may2010
}}}

Device configuration {{{

Device_Init()
|-> ...
|-> Device_ReadConfig() - get cfg values into m_config
|   |-> read_params() (wristwatch/inifile/params.c)
|   |   |-> set_defaults()
|   |   |-? if restore defaults
|   |   |   remove /mnt/appfs/param.ini n /mnt/appfs/system.ini
|   |   |-> set_user_common()
|   |   |-> read_user_ini() - read from /mnt/appfs/param.ini
|   |   |-> sync_inifile() - copy /mnt/appfs/param.ini to /mnt/vfat/param.ini
|   |   |-> set_system_version()
|   |   |-> read_system_ini() - read from /mnt/appfs/system.ini
|   |   |   |-> open /mnt/appfs/system.ini
|   |   |   |-> read file in loop
|   |   |   |-> 
|   |   |   |->
|   |   |   |->
|   |   |_> sync_inifile() - copy /mnt/appfs/system.ini to /mnt/vfat/param/system.ini
|   |-> set_syslog_on/off()
|   |_> set_redboot_version()
|-> ...

Device_DoUSBPlugin() - while USB disconnect
|-> ...
|-> Device_updateConfig() - upd values in m_config
|   |-> update_params()
|   |   |-> copy m_config to local dest_config
|   |   |-> read_user_ini() - read from /mnt/vfat/param.ini to dest_config
|   |   |-> update_user_ini()
|   |   |-> ...
|   |-> read_params() - upd values of m_config from /mnt/vfat/param.ini
|   |   |-> 
|   |   |->
|   |   |->
|   |   |->
|   |   |-> ...
|   |_? if restore defaults
|       restore_default_params()
|       Device_ReadConfig()
|-> ...

}}}
}}}

PMIC (mc13783) registers {{{

   |Reg 0 |Reg 1 |Reg 2   |      |Reg 15
   |intr  |intr m|intr sen|      |
----------------------------------------
0  |      |      |        |      |      |
1  |      |      |        |      |      |
2  |      |      |        |      |      |
3  |      |      |        |      |      |
----------------------------------------
4  |      |      |        |      |      |
5  |      |      |        |      |      |
6  |      |      |CHGDETS |      |      |
7  |      |      |        |      |      |
----------------------------------------
8  |      |      |        |      |      |
9  |      |      |        |      |      |
10 |      |      |CCCVS   |      |      |
11 |      |      |CHGCURRS|      |      |
----------------------------------------
12 |      |      |        |      |  -   |
13 |      |      |        |      |  -   |
14 |      |      |        |      |  -   |
15 |      |      |        |      |  -   |
----------------------------------------
16 |      |      |USB4V4S |      |  -   |
17 |      |      |USB2V0S |      |  -   |
18 |      |      |USB0V8S |      |  -   |
19 |      |      |IDFLOATS|      |  -   |
---------------------------------------
20 |      |      |        |      |  -   |
21 |      |      |        |      |  -   |
22 |      |      |        |      |  -   |
23 |UDMI  |      |UDMS    |      |  -   |



reg 0  |
reg 1  |
reg 2  |
reg 15 |----|----|----|0000|0011|0010| 0x000032


}}}

Battery status table {{{
    18jan2010
4.20v  =   798
4.18v  =   787
4.15v  =   777
4.10v  =   750
4.05v  =   727
4.00v  =   700
3.90v  =   663
3.85v  =   639
3.80v  =   610
3.70v  =   569
3.65v  =   546
3.60v  =   524
3.55v  =   502
3.50v  =   482
3.45v  =   455
3.40v  =   430
3.35v  =   407

Range in units          and in Volts
    798 - 407 = 391     4.2 - 3.35 = 0.85

 50% = 602.5 = 3.775v
 40% = 563.4 = 3.69v
 30% =       = 3.605v
 20% =       = 3.52v
 15% =       = 3.478v
 10% =       = 3.435v
  5% =       = 3.39v

}}}

Architecture {{{
    02may2010

    -----------
    | KbdTask |
    -----------
        |
        | Device_SendEvent()
        | write
        |
        |    --------------
         --> | Event Fifo |
             --------------

}}}

Install linux-2.6.28 ltib imx27 on Ubuntu 9.10 {{{
    24feb2010

??? sudo apt-get install bison libncurses5-dev build-essential rpm tcl8.5 libghc8-zlib-dev cscope

rm -rf ~/.ccache

./L2.6.28_4.5.1_SDK_Aug2009_source/install

download  http://www.freescale.com/files/community_files/MCUCOMM/2864_mconf.zip
unzip and copy mconf to /opt/freescale/ltib/usr/bin/

download  http://www.freescale.com/files/community_files/MCUCOMM/2869_ltib.patch
install patch: 
    cd ltib
    patch -t ltib.patch

cd L2.6.28_4.5.1_SDK/ltib
vi dist/lfs-5.1/bison/bison.spec
change in Build section from make to `make CFLAGS=-O0'
./ltib
}}}

--- address mapping

Flash 0xd8000000
RAM   0xa0000000

            usb                 -------
           _|_|_               |   *A  |-Sensor
          / 12  \=> A          |       |
         |       |             |       |
         |9    3 |             |       |
         |       |             |*R  *V |
   StBy<= \__6__/=> V          |_______|
             |                    | |
           Sensor                 usb

 Modes    | Start | Stop  |
-----------------------------------
Video Rec |   V l |  V|A  |
Audio Rec |   A l |  V|A  |
StandBy   | idle  |A|V|USB| not rebooting
Streaming |   V   |  A+V  |
Still pic |   A s |       |
Sleep     | A + V |  USB  | rebooting

Vibration
---------
1. StartRec, PowerUp = 1s, Go2Sleep=0.5s=StartSnapshot
2. StopSnapshot=0.5
3. StopRec=0.5s
4. DiskSpace, RecFail, PowerDown = 0.5s
5. BatteryLow

--- StartUp script
/etc/rc.d/rc.local

--- Config kernel params to set console
from Redboot prompt
fconfig
fis load ramdisk
fis load linux
exec -c "root=/dev/ram rw ramdisk_size=40000 initrd=0xa2000000,25440256 init=linuxrc console=ttymxc0,115200"

Burn redboot w/ JTAG {{{
    27oct2009
Connect JTAG to the board
Get Redboot prompt on target and run:
    nand erase -f 0x0 -l 0x40000 -o
Reboot the target
Run JLink app on Windows and get prompt.
Run follow: {{{
  // Reset
  r
  speed 1000
  // AHB-Lite IP Interface
  w4 0x10000000,0x20040304
  w4 0x10020000,0x00000000
  w4 0x10000004,0xDFFBFCFB
  w4 0x10020004,0xFFFFFFFF
  // Peripheral clk gating init
  w4 0x10027020,0x00000000 
  w4 0x10027024,0x00580780 
  w4 0x10027018,0x20083403 
  w4 0x1002701C,0x03030303
  w4 0x10027000,0x33F30307 
  // CLKO Select (For testing only)
  // CCSR (Set CLKO_SEL = CLK32)
  //-Bit 4-0 CLKO_SEL 0:CLK32, 2:26MCLK 5:MPLL, 6:SPLL, 7:FCLK, 8:HCLK, A:PERCLK1, 11:MSHC_CLK
  w4 0x10027028,0x00000300
  // Disable CLKO & Set divider = 8
  w4 0x10027018,0x01c8f403
  // Configure WEIM WCR REGISTER
  // Bit 12 (AUS4) : 1/0 = Address unshifted / Address shifted with port size
  // This bit affected the address access of CPLD
  w4 0xd8002060,0x00000000
  // Configure CPLD on CS4 
  w4 0xd8002040,0x0000DCF6
  w4 0xd8002044,0x444A4541
  w4 0xd8002048,0x44443302
  // Configure PSRAM on CS5
  w4 0xd8002050,0x0000dcf6
  w4 0xd8002054,0x444a4541
  w4 0xd8002058,0x44443302
  // Configure 16 bit NorFlash on CS0
  w4 0xd8002000,0x0000CC03
  w4 0xd8002004,0xa0330D01
  w4 0xd8002008,0x00220800
  // DDR RAM initialization
  // DDR 4x16Mx16 x 2
  // Row Address = 14
  // Col Address = 10
  // ESDMISC: enable DDR mode
  w4 0xD8001010,0x00000004
  // ESDCFG0: timing config
  w4 0xD8001004,0x006AC73A
  // ESDCTL0: Precharge Mode
  w4 0xD8001000,0x92100000
  // issue Precharge All command
  w4 0xA0000400,0x00000000
  // ESDCTL0: AutoRefresh Mode
  w4 0xD8001000,0xA2100000
  // issue Autorefresh command
  w4 0xA0000000,0x00000000
  w4 0xA0000000,0x00000000
  // ESDCTL0: Load Mode register Mode
  w4 0xD8001000,0xB2100000
  // issue Load Mode Register command
  w1 0xA0000033,0x00
  w1 0xA1000000,0x00
  // ESDCTL0: Normal Mode
  // Row Address  = 13
  // Col Address  = 10
  // Data width   = 32-bit
  // Refresh Rate = 8192/64ms 
  // Burst Length = 8
  // /- 2 : 32 bit mode
  // /- 1 : 16 bit - D[15:00]  
  // /- 0 : 16 bit - D[31:16]
  w4 0xD8001000,0x82226080
  // issue normal access
  w4 0xA0000000,0x00000000
  // ESDMISC: Reset Delay Line Measurement
  w4 0xD8001010,0x0000000C
  loadbin "redboot.bin" 0xa0000000
  //loadbin "E:\apps\redboot.bin"  0xa0000000
  //loadbin "C:\ivirtus\downloads\wristwatch\zImage_ilan1GB" 0xa0040000
  //loadbin "C:\ivirtus\downloads\wristwatch\rootfs.ext2.gz_ilan1GB" 0xa0240000
  setpc   0xa0000000
  go
}}}
Get Redboot prompt and run
    factive nand
Get Redboot prompt and run
    romupdate
}}}

ltib {{{
    from http://www.bitshrine.org/autodocs/LtibFaq.html

ltib --help

--- Run interactive config
ltib -c 

--- Get list of installed packages
ltib --mode listpkgs

--- Create ramdisk
ltib -D

--- Start platform config w/o continue to build it after
ltib -m config

--- Get shell ready to build from ltib
ltib -m shell

--- To list the installed packages
 ./ltib -m listpkgs | grep ' y '

--- Configure the kernel
ltib --configure
Check option: Configure the kernel

--- Rebuild only kernel
ltib -p kernel -m scbuild

}}}

Build kernel
setwatch
make ARCH=arm CROSS_COMPILE=arm-none-linux-gnueabi- 'HOSTCC=/usr/bin/gcc -B/usr/bin//' zImage

make ARCH=arm CROSS_COMPILE=arm-none-linux-gnueabi- 'HOSTCC=/usr/bin/gcc -B/usr/bin//' menuconfig

Upgrade {{{
plugin USB
cp zImage to the USB conected as zImage.upgrade
same for the root.ext2.gz
same for wristwatch.exe (copy as wristwatch.exe.upgrade)
plug out USB cable

1. For now we are not using commandline to starting up the linux, but if you want to do so, use the RedBoot “exec”command
RedBoot> help exec
Execute an image - with MMU off
   exec [-w timeout] [-b <load addr> [-l <length>]]
        [-r <ramdisk addr> [-s <ramdisk length>]]
        [-c "kernel command line"] [-t <target> ] [<entry_point>]
RedBoot>

2. In order to program the kernel / ramdisk use the following commands, in this case the 192.168.1.47 is your tftp-server:

burn redboot
============
load -v -r -b 0x100000 redboot.bin
nand erase -f 0x0 -l 0x40000 -o
nand write -f 0x0 -b 0x100000 -l 0x40000

burn zImage/ kernel image (linux):
============================
load -v -r -b 0x100000 -h 192.168.1.137 watch/zImage.no_crc
fis create -f 0x80000 -r 0x100000 -l 0x300000 -e 0x100000 -b 0x100000 linux

burn rootfs.ext2.gz (ramdisk):
========================
load -v -r -b 0x2000000 -h 192.168.1.137 watch/rootfs.ext2.gz.no_crc
fis create -f 0x380000 -r 0x2000000 -l 0xA00000 -e 0x2000000 -b 0x2000000 ramdisk

--- Set local ip
ip_address -l 192.168.1.155

--- Set tftp server ip
ip_address -h 192.168.1.137

--- load kernel via modem
load -r -b 0x100000 -m xmodem  - (~1.6MB takes 7min or if send 1Kxmodem - 1.6MB takes 3min)
load -r -b 0x100000 -m ymodem

}}}
Bootstrep {{{
--- Update ramdisk

nand erase -f 0x0 -l 0x40000 -o
1) connect the JTAG to the board
2) run the following script in the JLink.exe windows: 
        \\server\R&D\Running Projects\264-Watch\SW\Scripts\JLink_Burn_Redboot.txt
3) factive nand
4) fis create -f 0x380000 -r 0x2000000 -l 0xA00000 -e 0x2000000 -b 0x0240000 ramdisk
5) romupdate
6) Power Off

--- Update kernel

nand erase -f 0x0 -l 0x40000 -o
1) connect the JTAG to the board
2) run the following script in the JLink.exe windows: 
        \\server\R&D\Running Projects\264-Watch\SW\Scripts\JLink_Burn_Redboot.txt
3) factive nand
4) fis create -f 0x80000 -r 0x100000 -l 0x300000 -e 0x100000 -b 0x0040000 linux
5) romupdate
6) Power Off

--- Update everything

1) connect the JTAG to the board
2) At prompt of the Redboot run: nand erase -f 0x0 -l 0x40000 -o
3) power off/on
3) run the following script in the JLink.exe windows: 
        \\server\R&D\Running Projects\264-Watch\SW\Scripts\JLink_Burn_Redboot.txt
4) must press ctrl c
5) factive nand
6) must press ctrl c 
7) fis create -f 0x80000 -r 0x100000 -l 0x300000 -e 0x100000 -b 0x0040000 linux
8) fis create -f 0x380000 -r 0x2000000 -l 0xA00000 -e 0x2000000 -b 0x0240000 ramdisk
9) romupdate
10) Power Off

--- Vanila card

1) connect the JTAG to the board
2) run the following script in the JLink.exe windows: 
        \\server\R&D\Running Projects\264-Watch\SW\Scripts\JLink_Burn_Redboot.txt
3) factive nand
4) fis init
5) fis create -f 0x80000 -r 0x100000 -l 0x300000 -e 0x100000 -b 0x0040000 linux
6) fis create -f 0x380000 -r 0x2000000 -l 0xA00000 -e 0x2000000 -b 0x0240000 ramdisk
7) romupdate
8) fconfig
On "Run script at boot:" - insert "true", enter
fis load ramdisk
fis load linux
exec

On "Boot script timeout:" - insert "1", enter
On "Use BOOTP for network configuration:" - insert "false"
Push ENTER until 
"Update RedBoot non-volatile configuration - continue (y/n)?" - "y"

10)Power Off

after the linux is up, prepare the UBI:
=======================================

1) flash_eraseall /dev/mtd/3
2) ubidetach /dev/ubi_ctrl -m 3
3) ubiformat /dev/mtd/3 -O 2048 -s 2048
4) ubiattach /dev/ubi_ctrl -m 3 -O 2048
5) ubimkvol /dev/ubi0 -N appfs  -m 
6) mount -t ubifs ubi0:appfs /mnt/appfs

7) flash_eraseall /dev/mtd/4
8) ubidetach /dev/ubi_ctrl -m 4
9) ubiformat /dev/mtd/4 -O 2048 -s 2048
10)ubiattach /dev/ubi_ctrl -m 4 -O 2048
11)ubimkvol /dev/ubi1 -N usrfs  -m 
12)mount -t ubifs ubi1:usrfs /mnt/usrfs

13)dd if=/dev/zero of=/mnt/usrfs/fat32 bs=1M count=800
14)fdisk -C 12800  -H 16 -S 8 /mnt/usrfs/fat32

In fdisk you need to type: n 
Then type: p
Then: 1
Then type: <enter>
Then type: <enter>
Then type: t
Then type: b
Then type: w 
(??? modprobe g_file_storage  file=/mnt/usrfs/fat32)

15)connect the board to the PC using USB cable, then Quick-format for File-System FAT32


-------------------------------------------------------------------------------
2. In order to program the kernel / ramdisk use the following commands, in this case the 192.168.1.47 is your tftp-server:

burn redboot
============
load -v -r -b 0x100000 redboot.bin
nand erase -f 0x0 -l 0x40000 -o
nand write -f 0x0 -b 0x100000 -l 0x40000

burn zImage/ kernel image (linux):
============================
load -v -r -b 0x100000 -h 192.168.1.41 zImage
fis create -f 0x80000 -r 0x100000 -l 0x300000 -e 0x100000 -b 0x100000 linux

burn rootfs.ext2.gz (ramdisk):
========================
load -v -r -b 0x2000000 -h 192.168.1.41 rootfs.ext2.gz
fis create -f 0x380000 -r 0x2000000 -l 0xA00000 -e 0x2000000 -b 0x2000000 ramdisk

--- Set local ip
ip_address -l 192.168.1.133
ubide   
--- Set tftp server ip
ip_address -h 192.168.1.41

--- load kernel via modem
load -r -b 0x100000 -m xmodem  - (~1.6MB takes 7min or if send 1Kxmodem - 1.6MB takes 3min)
load -r -b 0x100000 -m ymodem

--- exchange partition
fis delete redboot.version
fis create -f 0x60000 -r 0x200000 -l 0x20000 -e 0x200000 -b 0x200000 exchange

-------------------------------------------------------------------------------

---===<<< Starts from version 1.14 >>>===---

-------------------------------------------------------------------------------
wwwwwwwwwwwwwwwwwwwwwwwwwwwwwww
appfs:          ()
======
flash_eraseall /dev/mtd/5
ubidetach /dev/ubi_ctrl -m 5
ubiformat /dev/mtd/5 -O 2048 -s 2048
ubiattach /dev/ubi_ctrl -m 5 -O 2048
ubimkvol /dev/ubi0 -N appfs  -m 
#mkdir /mnt/appfs
mount -t ubifs ubi0:appfs /mnt/appfs




usrfs:          ()
======
flash_eraseall /dev/mtd/6
ubidetach /dev/ubi_ctrl -m 6
ubiformat /dev/mtd/6 -O 2048 -s 2048 
ubiattach /dev/ubi_ctrl -m 6 -O 2048
ubimkvol /dev/ubi1 -N usrfs  -m 
mount -t ubifs ubi1:usrfs /mnt/usrfs

(for 2 GB flash)
        dd if=/dev/zero of=/mnt/usrfs/fat32 bs=1M count=1700
(or)
        dd if=/dev/zero of=/mnt/usrfs/fat32 bs=1M count=800

(for 2 GB flash)
        fdisk -C 27200  -H 16 -S 8 /mnt/usrfs/fat32
(or)
        fdisk -C 12800  -H 16 -S 8 /mnt/usrfs/fat32

In fdisk you need to type: n 
Then type: p
Then: 1
Then type: <enter>
Then type: <enter>
Then type: t
Then type: b
Then type: w 
modprobe g_file_storage  file=/mnt/usrfs/fat32


-------------------------------------------------------------------------------

---===<<< Lighter from version 1.14 >>>===---

-------------------------------------------------------------------------------
1. Making sure there is debug card connected to the target

2. run the following script in the JLink.exe windows to burn only Redboot
  \\server\R&D\Running Projects\264-Watch\SW\Scripts\JLink_Burn_Redboot.txt
3. factive nand
4. fis init
5. romupdate
6. fconfig
On "Run script at boot:" - insert "true", enter
fis load ramdisk
fis load linux
exec

On "Boot script timeout:" - insert "1", enter
On "Use BOOTP for network configuration:" - insert "false"
Push ENTER until 
"Update RedBoot non-volatile configuration - continue (y/n)?" - "y"

7. Power off

8. Power on the card and get Redboot prompt
9. Set ip address of the target: ip_address -l 192.168.1.133
10. Set IP address of the TFTP server machine: ip_address -h 192.168.1.41
11. Load Kernel and burn the flash
  load -v -r -b 0x100000 -h 192.168.1.137 zImage
  fis create -f 0x80000 -r 0x100000 -l 0x300000 -e 0x100000 -b 0x100000 linux
12. Load rootfs and burn the flash:
  load -v -r -b 0x2000000 -h 192.168.1.137 rootfs.ext2.gz
  fis create -f 0x380000 -r 0x2000000 -l 0xA00000 -e 0x2000000 -b 0x2000000 ramdisk

burn redboot
============
load -v -r -b 0x100000 -h 192.168.1.137 redboot.bin.upgrade
nand erase -f 0x0 -l 0x40000 -o
nand write -f 0x0 -b 0x100000 -l 0x40000
}}}
}}}
Project Sting HD {{{
    20aug2009

Current state: evl board works, saving media file on flash

Open issues:
1. A/V sync in written file
2. To start working on evl board buttons
3. To add timestamp in video frame
4. To add encryption of video file
5. To add CRC check per frame
6. To add WiFi functionality from subcontractor
7. To integrate Live application

Closed issues:
1. Save video (h264) in file (avi container)
2. Save audio (mp2) in file (avi container)
3. 

1. EVM boot sequence from MMC
2. Playback during recording
3. To fix audio output
4. To use EVM RC
5. A/V sync problem during streaming & recording> to change recording to TS file.
}}}
}}}
-------------------------------------------------------------------------------
----------------------------------- Harmonic-----------------------------------
-------------------------------------------------------------------------------
{{{
001. MasterClock - FrontEnd feature {{{
    03may2009
    The DVBS STNIM-SAT2 card has internak clock generator, configured by 
setting demod (stv0288) register PLLCTRL (0x40). This generator can change
master clock, which corresponds to sampling frequency.
The master clock can be 100 or 135(default) MHz.

Solution:
    The master clock parameter is part of common port config params 
(fe_config_t). The CLI command change the parameter and calls InitPort()
to re-init a port.

}}}
002. Acquisition mode - FrontEnd feature {{{
    03may2009
    
}}}
003. Input Frequency Range - FrontEnd feature {{{
    27apr2009

Add LO_type, LO_freq, FreqRange

LNB Local Oscillator type - universl, wide band, Ku_band, C_band
LNB Local Oscillator freq - 
Freq range - L_band, C_band, Ku_band

--- Set LNB LO type

--- Set LNB LO freq

--- Set Freq Range ( value )
if value==Ku_band && LO_type==C_band
    LO_type=Ku_band
    LO_freq=


}}}
004. Drift compensation - FrontEnd feature {{{
    27apr2009

Add ability to compensate 

}}}
005. Frequency scanning {{{
    03may2009
from IRD2900 {{{
    The freq scan algo searches for available lock in given freq range.
    The freq scan starts by CLI command.
}}}

}}}
006. DVBS2 Dejitter w/o PCR {{{
    19may2009
    Start to de-jitter w/o PCR
Current code flow {{{
    19may2009

--- StartUp
FeEcc3100Tuner::PowerUpInitParam()
|-> ...
|-> Set port sym rate
|   |-> CalcBitRateFromSR()
|-> Set port modulation
|   |-> CalcBitRateFromSR()
|-> Set port stream ID
|   |-> CalcBitRateFromSR()
|-> ...
|-> Get dejitter revision (2nd byte)
|-> if rev==0x03, set FeDVBS2FPGA03_DDS=1, otherwise FeDVBS2FPGA03_DDS=0

--- Running
CFePortSKYPHY::CheckPort()
|-> CFePortSKYPHY::Optimize_lock()
|   |-> ...
|   |-> CalcBitRateFromPCR() - when staying in lock, every 100ms
|   |   
|   |-> ...
|   |-> ...
|-> get_ReceiverStatus()
|   |-> ...
|   |-> part 8. If locked, update bit rate from received params
|   |   |-> CalcBitRateFromSignalStatus()
|   |   |-? SetBitRate2_DDS() - set rate according RF params
|   |   |-? SetBitRate2_DDS() - set rate according to ISSY
|->
|->

--- Set parameters
|-> Set param
|-> RestartLockOptimize()
    \_> CalcBitRateFromSR() - calc bitrate from sym rate
        |-> see below

CalcBitRateFromSR() code flow {{{
    gets; RS_value, modulation, FastOutputRate, boolean
|-> calc output bit rate from 
|-? FastOutputRate
|   Enable_DDS() - disable DDS
|   SetBitRate2_DDS()
|   |->
|   Enable_DDS() - enable DDS
|_> SetBitRate2_ECC()
    |->
}}}

}}}

The CFePortSKYPHY::get_ReceiverStatus(), if FE locked, does update bitrate,
according to RF params (part 8.1).
But with pre-calculated error of -1000ppm, because of future bit rate update
from PCR will fill the gap.

Solution:
In order to stop using bit rate update from PCR, also needs to stop use of this
pre-calculated error of -1000ppm.
The time to gain good PCR w/o jitter ~2min (on IRD also).
}}}
007. Analyze of the DVBS/S2 EFS doc {{{
    17may2009 25may2009
    There are additional action items from Merav 18may2009

--- General {{{
d   1. A (efs-10) To display FE card info, stored in EEPROM (waits for HW) 
        HW revision & version, serial nbr, card part nbr
d   2. B (efs-11) Hardware monitoring (tempeature & voltage) (waits for HW)
d   3. A (efs-12) To display FE card firmware: ECC & Dejitter versions.
d   4. A (efs-13) Upgrade Dejitter FPGA (waits for HW)
d   5. A (efs-14) Ability to switch on 27MHz clock source local/host
d   6. A (efs-15) The FE card (any card) registration procedure (waits for Arik)
}}}
--- Performance {{{
d   1. A (efs-21) Sensitivity ??? (what)
d   2. A (efs-22) Input return loss ??? (what)
d   3. A (efs-23) Noise figure at max gain ??? (what)
d   4. A (efs-24) Error performance (appendix A) ??? (no info)
d   5. A (efs-25) Phase noise ???
    6. A (efs-26) 
        26.1. Change to DVBS2 de-jitter w/o PCR
        26.3. Check w/ ETR-290 ???
        26.4. Ignore ISSY ??? (to check how it deals w/ ISSY)
    7. A (efs-27) Time to lock - 20sec (if not???)
        27.1 Preconfigured in acquisition mode immediate - 5 sec
    8. A (efs-28) Lock in VCM mode w/ changed params: MODCOD, pilots, frame size
        28.1 change MODCOD
        28.2 change pilots
        28.3 change frame size
}}}
--- Configuration {{{
d   1. A (efs-41) How to Enable/disable port? (waits for Spartan)
        Ability from main board spartan to close streaming 
            toward MUX (Merav 19may2009)
*   2. A (efs-42) LNB params
        Check ranges, default values and step sizes
        default = eFeLnbBandLow, eFeLnbPolarNotApplic
*   3. A (efs-43) Set freq
D       default = 1000000
        Check ranges, step size
+   4. A (efs-44) drift comp
D       default = on
d       44.4 B Keep the result offset in db?
*   5. A (efs-45) Acquisition mode
D       default = timing
D       45.2 Wide search - +-25% of symbol rate
    6. A (efs-46) Freq scan
        46.1 A Scan & Lock
        46.2 A Separate meeting for InBand scanning (see below)
    7. A (efs-47) Set sym rate to check:
       default values (27500000)
       range (1000000 - 45000000)
       step size (10sym from Merav 19may2009)
d   8. A (efs-48) Add automatic spectral inversion in DVBS
d   9. A (efs-49) (Defined for EMS)
       Set modulation std (DVBS or DVBS2) w/o framesize & FEC
       To change setup values while mode changes?
           (rolloff, pilots, frame size, etc)
   10. A (efs-50) Set rolloff
       Check default value for DVBS2 (0.20)
d  11. A (efs-51) (Defined for EMS)
        Set MODCOD together?
        To check if MOD has proper FEC?
d  12. A (efs-52) Set frame size (Defined for EMS)
   13. A (efs-53) Check that pilots default param is on (DVBS2)
        53.2 B In VCM can't change the param
   14. A (efs-54) Check scramble seed default value & range
   15. A (efs-55) The default value for master clock is 100MHz
}}}
--- Status {{{
    1. A (efs-71) Enable status when port enabled
        71.1 B Disbale status when disabled port
    2. A (efs-72) Status
        Provides: Carrier, Demod
        Check if no Carrier lock, so Demod is also unlocked
    3. A (efs-73) Params to show in status
        C/N
        Eb/No
        Link margin
        BER
        PER
        freq
        offset
        spectral inv
        modulation
        FEC
        pilots
        frame size
}}}
--- Alarms {{{
    1. (efs-80) Card HW failure alarm
    2. (efs-81) Temperature exceeds limit alarm
    3. (efs-82) Voltage error alarm
    4. (efs-83) Input bitrate exceeded limit alarm
    5. (efs-??) Carrier not detected alarm
    6. (efs-84) Demodulation failure alarm
    7. (efs-85) BER too high alarm
    8. (efs-86) Link margin too low
}}}

Common system tasks, derived from above
1. To investigate FrontPanel abilities
2. To redesign IRP hardware registration procedure
3. The alarms implemetation waits for additional doc
4.

Summary from meeting on frequency scanning (InBand) {{{
    18may2009
    1. The CLI command starts scanning
    2. FE manager clean local buffer for scanning results
    3. Calls to stop receiving NIT
    4. Locks on certain freq
    5. Calls to start receiving NIT
    6. Polling each sec (for 12secs) for new NIT
    7. Keeps all data in table w/ index (look efs-46)
    8. The CLI cmd to stop the scanning
    9. The CLI cmd to get current status of scanning
   10. The CLI cmd to get current status (w/ index) of scanning
}}}
}}}
008. Frequency scanning & Acquisition mode {{{
    01jun2009

w/o Scanning, only Acquisition

1. Limited (Scan&Lock) scanning

}}}
009. Get params per parameter {{{
    21jun2009
Ability to get each config param by separate call from CLI.
Demand of EMS.
}}}
010. To define FrontEnd web interface parameters {{{
    24jun2009

 wget --no-proxy -t 1 -O req.txt http://192.168.0.10/request.esp\?req=CFG_ATTR_SET_FE_CONFIG_FRAMESIZE\&cnt=1\&p0=0 && cat ./req.txt

http://192.168.0.10/request.esp?req=CFG_ATTR_GET_FE_CONFIG_FREQUENCY&cnt=1&p0=1

Getting setup parameters

CFG_ATTR_GET_FE_CONFIG_FREQUENCY
CFG_ATTR_GET_FE_CONFIG_SYMRATE
CFG_ATTR_GET_FE_CONFIG_FECRATE
CFG_ATTR_GET_FE_CONFIG_SPECTRINV
CFG_ATTR_GET_FE_CONFIG_DRIFTCOMP
CFG_ATTR_GET_FE_CONFIG_LNBPOLARITY
CFG_ATTR_GET_FE_CONFIG_LNBBAND
CFG_ATTR_GET_FE_CONFIG_DVBMODE
CFG_ATTR_GET_FE_CONFIG_ROLLOFF
CFG_ATTR_GET_FE_CONFIG_PILOTS
CFG_ATTR_GET_FE_CONFIG_SCRSEED
CFG_ATTR_GET_FE_CONFIG_LNBLOTYPE
CFG_ATTR_GET_FE_CONFIG_LNBLOFREQ
CFG_ATTR_GET_FE_CONFIG_FREQRANGE
CFG_ATTR_GET_FE_CONFIG_ACQUISITION
CFG_ATTR_GET_FE_CONFIG_MASTERCLOCK
}}}
011. To define get/set MODCOD {{{
    29jun2009
        QPSK  | 8PSK  | 16APSK
----------------------|----------
1/2     x s   |       | 
2/3     x s   | x     | x 
3/4     x s   | x     | x
5/6     x s   | x     | x
7/8     x s   |       | 
1/4     x     |       | 
1/3     x     |       | 
2/5     x     |       | 
3/5     x     | x     | 
4/5     x     |       | x
8/9     x     | x     | x
9/10    x     | x     | x

wget --no-proxy -t 1 -O req.txt http://192.168.0.10/request.esp\?req=CFG_ATTR_GET_FE_CONFIG_SPECTRINV\&cnt=1\&p0=1

}}}
012. Syslog stops output on console {{{
    15jul2009
If start to print lots of log messages syslog stops to log output to console.

Checked syslog configured w/ redirection to 2 ip and console. In heavy load, stops output to console, but
keep sending to remote machines.
Conslusion: the problem in /dev/console, which stops to send to serial driver.
During the work change syslogd to new version 1.5


}}}
013. Setup ability to produce coredump {{{
    16jul2009
To add in /etc/profile folows line:
ulimit -c unlimited
Add follow to /etc/init.d/rcS
echo 1 > /proc/sys/kernel/core_uses_pid
echo /mnt/flash/corefiles/core-%e-%p > /proc/sys/kernel/core_pattern

It will create coredump files of pattern /mnt/flash/corefiles/core-<name>-,pid>
}}}
014. Using remote debugging {{{
    16jul2009
Run irpd.elf and take pid of FePriThread
run on the target:
gdbserver 192.168.0.1:7000 --attach 1059
where 192.168.0.1 is addr to accept from and 7000 is port
run on pc:
./linux-add-ons/scripts/gdb.sh /opt/ppc405/irp10/irpd.elf 192.168.0.10
where 192.168.0.10 is addr to connect
Get gdb prompt and push "n". this will bring to attached thread

}}}
015. User management {{{
    26jul2009

--- 01. To create 3 predefined users 

uname       passwd      user level
----------------------------------
harmonic    tpi2s4u     0   root
configure   configure   123 configure
minitor     monitor     153 monitor

--- 02. User harmonic the only one has access to cli and ftp.

--- 03. Ability to change user password from CLI & web

/config/unit/user/change <username> <password>
http://192.168.0.10/request.esp?req=CFG_ATTR_USER_CHG_PSSWD&cnt=2&str_cnt=1&s0=harmonicscopus&p0=8&p1=6

--- 04. Cli & web option to set default passwords for users configure & monitor

/config/unit/user/set2def
http://192.168.0.10/request.esp?req=CFG_ATTR_USER_SET2DEF&cnt=0

--- 05. User authentication from Cli & web

/config/unit/user/change <username> <password> <userlevel>
http://192.168.0.10/request.esp?req=CFG_ATTR_USER_AUTHEN&cnt=3&str_cnt=1&s0=harmonicscopusroot&p0=8&p1=6&p2=4

02aug2009
Using of old password in user password change API
/config/unit/user/change <username> <old_password> <new_password>
http://192.168.0.10/request.esp?req=CFG_ATTR_USER_CHG_PSSWD&cnt=3&str_cnt=1&s0=harmonicscopusasdf&p0=8&p1=6&p2=4

Password encryption

Using project GnuPG (1.4.9):
./configure CC=ppc_405-gcc --host=ppc-linux --build=i386-linux --enable-minimal --disable-asm

}}}
Using profiler {{{
    28jul2009
gprof, callgrind, oprofile

gprof - not support multithreaded application

Full irpd - 54460kB
No FE     - 52400kB
}}}
Telnet client problems {{{
    02aug2009
The connection between IRP telnet client and Hadas problematic, because telnet
client has "local echo" and "line editing". The backspace should be not Ctl-H

Add file /etc/telnetrc with follows:
DEFAULT
    set echo off
    mode character

}}}

dvbs2 testing {{{
    26may2009

Startup output {{{
    16jun2009
[~]$ Jun 16 19:55:03 (none) IRP: MUX: /RT_THRD/198/0 main rt_thrd clk_diff(6) > (+/-5).                                                      
Jun 16 19:55:04 (none) IRP: UnitMngr: Detected 0 CAM slots, but motherboard has 2 CAM slots                                                  
Jun 16 19:55:04 (none) IRP: LcMngr: Licensed feaures set: FFFFFFFFFFFFFFFF                                                                   
Jun 16 19:55:04 (none) IRP: MUX: /RT_THRD/198/0 main rt_thrd clk_diff(10) > (+/-5).                                                          
Jun 16 19:55:05 (none) IRP: MUX: /RT_THRD/198/0 main rt_thrd clk_diff(6) > (+/-5).                                                           
Jun 16 19:55:05 (none) IRP: FeMngr: Start the manager                                                                                        
param: 1                                                                                                                                     
Jun 16 19:55:06 (none) IRP: FeMngr: IRP FrontEnd input cfg: 1                                                                                
Jun 16 19:55:07 (none) IRP: EvntMngr: DB: Cannot read alarm configuration for alarm: Ethernet Port Link Down on GbE Port 3, error: Data not f
ound                                                                                                                                         
Jun 16 19:55:08 (none) IRP: MUX: /RT_THRD/198/0 main rt_thrd clk_diff(10) > (+/-5).                                                          
Jun 16 19:55:08 (none) IRP: FeMngr: virtual bool CFeDVBS2_ECC::Init()>                                                                       
Jun 16 19:55:08 (none) IRP: FeMngr: 1 1527000 27500000 1 0 1 0 2 1 0 0 11 1 0 0 0 0 0                                                        
Jun 16 19:55:08 (none) IRP: FeMngr: SetActivePort> Set active port to 1                                                                      
Jun 16 19:55:08 (none) IRP: FeMngr: virtual int CFePortSKYPHY::InitPort()>                                                                   
Jun 16 19:55:08 (none) IRP: FeMngr: Init>                                                                                                    
Jun 16 19:55:08 (none) IRP: FeMngr: Init> TUNER soft reset                                                                                   
Jun 16 19:55:08 (none) IRP: FeMngr: Init> TUNER reg (12-13) = F02A                                                                           
Jun 16 19:55:08 (none) IRP: FeMngr: Init> TUNER set all regs                                                                                 
Jun 16 19:55:08 (none) IRP: FeMngr: Init> TUNER reg (02-03) = 04B3                                                                           
Jun 16 19:55:08 (none) IRP: FeMngr: Init> TUNER reg (04-05) = 816D                                                                           
Jun 16 19:55:08 (none) IRP: FeMngr: Init> TUNER reg (06-07) = C020                                                                           
Jun 16 19:55:08 (none) IRP: FeMngr: Init> TUNER reg (08-09) = D730                                                                           
Jun 16 19:55:08 (none) IRP: FeMngr: Init> TUNER reg (10-11) = E36B                                                                           
Jun 16 19:55:08 (none) IRP: FeMngr: Init> TUNER reg (12-13) = F028                                                                           
Jun 16 19:55:08 (none) IRP: FeMngr: Init> TUNER set LO window to unlock                                                                      
Jun 16 19:55:08 (none) IRP: FeMngr: Init> TUNER reg (10-11) = E3F9                                                                           
Jun 16 19:55:08 (none) IRP: FeMngr: Ecc3100_LoadLUTs>                                                                                        
Jun 16 19:55:08 (none) IRP: FeMngr: Demodulator Configuration LUT W...                                                                       
Jun 16 19:55:09 (none) IRP: FeMngr: Decoder 8PSK LLR LUT W...                                                                                
Jun 16 19:55:13 (none) IRP: FeMngr: Decoder 16PSK LLR LUT W...                                                                               
Jun 16 19:55:18 (none) IRP: FeMngr: Decoder LDPC LLR LUT W...                                                                                
Jun 16 19:55:27 (none) IRP: FeMngr: Ecc3100_InitRegs>                                                                                        
Jun 16 19:55:27 (none) IRP: FeMngr: Ecc3100_InitTransProcRegs>                                                                               
Jun 16 19:55:27 (none) IRP: FeMngr: virtual int CFePortSKYPHY::SetPortFreq(long unsigned int)>                                               
Jun 16 19:55:27 (none) IRP: FeMngr: virtual int CFePortSKYPHY::SetPortFreq()> Freq setup 1527000                                             
Jun 16 19:55:27 (none) IRP: FeMngr: set_Frequency> TUNER FREQ (kHz): W 1527000 P 12216 T 1527000.000000                                      
Jun 16 19:55:27 (none) IRP: FeMngr: int CFePortSKYPHY::SetPortSymRate()>                                                                     
Jun 16 19:55:27 (none) IRP: FeMngr: Sym rate setup 27500000                                                                                  
Jun 16 19:55:27 (none) IRP: FeMngr:   SymRate PRMS: WSymRt = 27500000 (baud), PSymRt = 27499999 (baud), DSymRt = 27499.999000 (Kbaud), NCO_St
ep = 003425ED
Jun 16 19:55:27 (none) IRP: FeMngr:   SYM_ACQ_CONFIG2 (0C28) = 003425ED                                                                      
Jun 16 19:55:27 (none) IRP: FeMngr:   EQ_CONFIG1 (0C00) = 1000210F                                                                           
Jun 16 19:55:27 (none) IRP: FeMngr:   F_CTRL_CONFIG6 (0C1C) = 00000684                                                                       
Jun 16 19:55:27 (none) IRP: FeMngr:   F_CTRL_CONFIG7 (0C20) = 0029B7F0                                                                       
Jun 16 19:55:27 (none) IRP: FeMngr:   HDR_PROC_CONFIG2 (0C38) = 00800080                                                                     
Jun 16 19:55:27 (none) IRP: FeMngr: set_TunerBandwidth> TUNER_BandWidth: 23203 (Kbaud)                                                       
Jun 16 19:55:27 (none) IRP: FeMngr: set_TunerBandwidth> BF =    50                                                                           
Jun 16 19:55:27 (none) IRP: FeMngr: set_TunerBandwidth> ZIF REG(06-07) = C064                                                                
Jun 16 19:55:27 (none) IRP: FeMngr: set_TunerBandwidth> BR =    17                                                                           
Jun 16 19:55:27 (none) IRP: FeMngr: set_TunerBandwidth> ZIF REG(12-13) = F044                                                                
Jun 16 19:55:27 (none) IRP: FeMngr: set_TunerBandwidth> ZIF REG(06-07) = C864                                                                
Jun 16 19:55:27 (none) IRP: FeMngr: End SR settings                                                                                          
Jun 16 19:55:27 (none) IRP: FeMngr: CalcBitRateFromSR> bit rate 72000000 sym rate    27499.999000                                            
Jun 16 19:55:27 (none) IRP: FeMngr:   DJXLX_DDS_FREQ: DISABLE                                                                                
Jun 16 19:55:27 (none) IRP: FeMngr:   New SR-Restart DJXLX_DDS_FREQ: Request=72000000.000000, N=0003, R=000000 -> Rate=72000000.000000       
Jun 16 19:55:27 (none) IRP: FeMngr:   DJXLX_DDS_FREQ: ENABLE                                                                                 
Jun 16 19:55:27 (none) IRP: FeMngr: SetBitRate2_ECC> ECC_CCM_FREQ: 72000000                                                                  
Jun 16 19:55:27 (none) IRP: FeMngr: SetBitRate2_ECC> CCM_FREQ (412C) = 44444444                                                              
Jun 16 19:55:27 (none) IRP: FeMngr: int CFePortSKYPHY::SetPortSpectrInv()>                                                                   
Jun 16 19:55:27 (none) IRP: FeMngr: int CFePortSKYPHY::SetPortRollOff()>                                                                     
Jun 16 19:55:27 (none) IRP: FeMngr: SetPortRollOff> RollOff setup 0.35                                                                       
Jun 16 19:55:27 (none) IRP: FeMngr: SetPortRollOff> SYM_ACQ_CONFIG_1 (0C24) = 7F1F0001                                                       
Jun 16 19:55:27 (none) IRP: FeMngr: int CFePortSKYPHY::SetPortFecRate()>                                                                     
Jun 16 19:55:27 (none) IRP: FeMngr: SetPortFecRate> FEC setup 2/3                                                                            
Jun 16 19:55:27 (none) IRP: FeMngr: SetPortFecRate> HDR_PROC_CONFIG1 (0C34) = 00001601                                                       
Jun 16 19:55:27 (none) IRP: FeMngr: int CFePortSKYPHY::SetPortModulation()>                                                                  
Jun 16 19:55:27 (none) IRP: FeMngr: Mode setup SetPortModulation                                                                             
Jun 16 19:55:27 (none) IRP: FeMngr: SetPortModulation> HDR_PROC_CONFIG1 (0C34) = 00001601                                                    
Jun 16 19:55:27 (none) IRP: FeMngr: CalcBitRateFromSR> bit rate 72000000 sym rate    27499.999000                                            
Jun 16 19:55:27 (none) IRP: FeMngr:   DJXLX_DDS_FREQ: DISABLE                                                                                
Jun 16 19:55:27 (none) IRP: FeMngr:   New SR-Restart DJXLX_DDS_FREQ: Request=72000000.000000, N=0003, R=000001 -> Rate=71999997.600000       
Jun 16 19:55:27 (none) IRP: FeMngr:   DJXLX_DDS_FREQ: ENABLE                                                                                 
Jun 16 19:55:27 (none) IRP: FeMngr: SetBitRate2_ECC> ECC_CCM_FREQ: 72000000                                                                  
Jun 16 19:55:27 (none) IRP: FeMngr: SetBitRate2_ECC> CCM_FREQ (412C) = 44444444                                                              
Jun 16 19:55:27 (none) IRP: FeMngr: int CFePortSKYPHY::SetPortPilots()>                                                                      
Jun 16 19:55:27 (none) IRP: FeMngr: SetPortPilots> Pilots setup OFF                                                                          
Jun 16 19:55:27 (none) IRP: FeMngr: SetPortPilots> HDR_PROC_CONFIG1 (0C34) = 00001601                                                        
Jun 16 19:55:27 (none) IRP: FeMngr: int CFePortSKYPHY::SetPortScrSeed()>                                                                     
Jun 16 19:55:28 (none) IRP: FeMngr: SetPortScrSeed> Scrambling seed setup 0                                                                  
Jun 16 19:55:28 (none) IRP: FeMngr: SetPortScrSeed> Rn: XR0 = 00001, YR0 = 00001, XR1 = 08050, YR1 = 0FF60                                   
Jun 16 19:55:28 (none) IRP: FeMngr: ifFeDrvCtl> addr 0x74 values 0x10 00 00 03                                                               
Jun 16 19:55:28 (none) IRP: FeMngr: Dejitter firmware revision 00 00                                                                         
Jun 16 19:55:28 (none) IRP: FeMngr: virtual int CFePortSKYPHY::InitPort()> inited                                                            
Jun 16 19:55:28 (none) IRP: FeMngr: int CFeDVBS2_ECC::InitSetLnb() 596>                                                                      
Jun 16 19:55:28 (none) IRP: FeMngr: virtual int CFePortSTNIM_SAT2::InitPort()>                                                               
Jun 16 19:55:28 (none) IRP: FeMngr: stv0288 SAMPLING FREQUENCY = 135 MHz
Jun 16 19:55:28 (none) IRP: FeMngr: void set_LNB_mode(FeLnbPolarization_E, FeLnbBand_E)>                                                     
Jun 16 19:55:28 (none) IRP: FeMngr: virtual int CFePortSTNIM_SAT2::SetPortSymRate(long unsigned int)>                                        
Jun 16 19:55:30 (none) IRP: FeMngr: virtual int CFePortSTNIM_SAT2::SetPortFreq(long unsigned int)>                                           
Jun 16 19:55:30 (none) IRP: FeMngr: virtual int CFePortSTNIM_SAT2::InitPort()> inited                                                        
Jun 16 19:55:30 (none) IRP: FeMngr: virtual int CFePortSTNIM_SAT2::SetLnb() 542>                                                             
Jun 16 19:55:30 (none) IRP: FeMngr: int CFeDVBS2_ECC::SetLnb()>                                                                              
Jun 16 19:55:31 (none) IRP: FeMngr: FeMngrPrimaryThread> FE card initialized                                                                 
Jun 16 19:55:31 (none) IRP: MUX: /RT_THRD/198/0 main rt_thrd clk_diff(11) > (+/-5).                                                          
Jun 16 19:55:31 (none) IRP: MUX: /MUX/2819/0 Mux cycle_tm mili(22.76) (227.62 %) (6828486/3000000) max(227.62 %).                            
Jun 16 19:55:31 (none) IRP: MUX: /RT_THRD/198/0 main rt_thrd clk_diff(9) > (+/-5).                                                           
Jun 16 19:55:31 (none) IRP: FeMngr: FrontEnd - Search Algorithm is LOCK                                                                      
Jun 16 19:55:31 (none) IRP: FeMngr:   Signal (Start-1000ppm) Parameters DJXLX_DDS_FREQ: Request=54413494.000000, N=0003, R=93F324 -> Rate=544
13493.579057                                                                                                                                 
Jun 16 19:55:44 (none) IRP: CONT_MNGR: in contMngrTableNitReceived for 5
Jun 16 19:55:57 (none) IRP: FeMngr:   PCR (-10ppm) Monitor DJXLX_DDS_FREQ: Request=54466954.000000, N=0003, R=935AF1 -> Rate=54466954.734657
}}}
Monitor DDS output {{{
    16jun2009

}}}

DVBS2,8psk,2/3,1527000 (Ku 12127) 27.5, 35%, off, ver, low

    1. Change freq to unlock n after to lock, wait 5sec n check status
    2. Change sym rate to unlock n after to lock, wait 5sec n check status
    3. Change 

Frequency scanning & Acquisition mode {{{

Acq mode range gives +/- 25% of sym rate to freq
Example:
    sym rate 15000000 / 12 = 1250000 Hz
    freq 1100000 kHz + 1250 kHz = 1101250 kHz

The Acq mode range on sym rate 15Msps gives +/-5MHz for zig-zag algo
The Acq mode range on sym rate 5Msps gives +/-1.25MHz for zig-zag algo


Enc Ellipse 1000, ver 2.7.0.1, DVBS2, 8psk, 5/6, 35%, pilots on, frame normal:
(freqs 1101000, 1100500 and 1100200), (LNB power (dBm) -30,-50), (Sym rate (Msps) 15)
--------- -------------------------- --------------------------
         |  IRD(1.92.3) - 1095000   | IRP(03jun2009) - 1095000 |
---------------------------------------------------------------
Acq      |     range   |    timing  |     range   |    timing  |
         |-------------|------------|-------------|------------|
Scan     |  no   | yes |  no  | yes |  no   | yes |  no  | yes |
         |       |     |      |     |       |     |      |     |
Locking  |       |     |      |     |       |     |      |     |
 Range   |  no   | no  |  no  | no  |  no   | no  |  no  |  no |
--------- -------------------------- --------------------------

Enc Ellipse 1000, ver 2.7.0.1, DVBS2, 8psk, 5/6, 35%, pilots on, frame normal:
(freqs 1100200), (LNB power (dBm) -50), (Sym rate (Msps) 5)
--------- -------------------------- --------------------------
         |  IRD(1.92.3) - 1095000   | IRP(03jun2009) - 1095000 |
---------------------------------------------------------------
Acq      |     range   |    timing  |     range   |    timing  |
         |-------------|------------|-------------|------------|
Scan     |  no   | yes |  no  | yes |  no   | yes |  no  | yes |
         |       |     |      |     |       |     |      |     |
Locking  |       |     |      |     |       |     |      |     |
 Range   |  no   | no  |  no  | no  |  no   | no  |  no  |  no |
--------- -------------------------- --------------------------

Enc Ellipse 1000, ver 2.7.0.1, DVBS2, 8psk, 5/6, 35%, pilots on, frame normal:
(freqs 1097000), (LNB power (dBm) -50), (Sym rate (Msps) 5)
--------- -------------------------- --------------------------
         |  IRD(1.92.3) - 1095000   | IRP(03jun2009) - 1095000 |
---------------------------------------------------------------
Acq      |     range   |    timing  |     range   |    timing  |
         |-------------|------------|-------------|------------|
Scan     |  no   | yes |  no  | yes |  no   | yes |  no  | yes |
         |       |     |      |     |       |     |      |     |
Locking  |       |     |      |     |       |     |      |     |
 Range   |  no   | no  |  no  | no  |  no   | no  |  no  |  no |
--------- -------------------------- --------------------------
Expected results: range 
}}}
}}}
Freq Scan entire band {{{
    05jul2009
According to efs-46.2

While found freq to lock, follow parameters will be saved :
    Freq(Lband) , Network name, MODCOD, frame size, pilots

}}}
6. Add 2nd flash chip {{{
Follows kernel boot messages
    xilinx_iic.0 #0 at 0x80080000 mapped to 0xCB0A0000, irq=1
    xilinx_iic.1 #1 at 0x80090000 mapped to 0xCB0C0000, irq=7
    xilinx_iic.2 #2 at 0x800A0000 mapped to 0xCB0E0000, irq=8
    redwood: flash mapping: 8000000 at b0000000
    IBM Redwood: Found 1 x16 devices at 0x0 in 16-bit bank
     Amd/Fujitsu Extended Query Table at 0x0040
    IBM Redwood: CFI does not contain boot bank location. Assuming top.
    number of CFI chips: 1
    cfi_cmdset_0002: Disabling erase-suspend-program due to code brokenness.
    Creating 9 MTD partitions on "IBM Redwood":
    0x00000000-0x00040000 : "Spartan"
    0x00040000-0x002e0000 : "FpgaGold"
    0x002e0000-0x00580000 : "FpgaNorm"
    0x00800000-0x00900000 : "Bootloader"
    0x00920000-0x01d20000 : "Kernel"
    0x01d40000-0x04540000 : "USR"
    0x04560000-0x04f60000 : "EMS"
    0x04f80000-0x06380000 : "JRE"
    0x08000000-0x0a800000 : "UPGRADE"

The line nbr 5 happened at drivers/mtd/chips/cfi_probe.c
cfi_chip_setup
cfi_probe_chip

}}}
4xDVBS2 (Ayecka) {{{

P:\RnD\IRD\Avi\DVBS2\Ayecka\

}}}
}}}
-------------------------------------------------------------------------------
----------------------------------- Scopus ------------------------------------
-------------------------------------------------------------------------------
{{{
001. PSI table parser and generator {{{
    20may2007
Build libdvbpsi
svn checkout svn://svn.videolan.org/libdvbpsi/trunk 25may2007
cd 25may2007
./bootstrap && make && make install
Table parser comparison {{{
1. Supported tables
2. Supported descriptors
3. SET-like interface w/ DB
4. Recieves section
5. Table validation
6. Code portability
7. Table builder code
8. Modularity

(1)
                        | IVG | DVBPSI | IRD | MUX |
                --------------------------------------------------------
                  PAT   |  x  |   x    |  x  |  x  | 
                  PMT   |  x  |   x    |  x  |  x  |
                  SDT   |  x A|   x    |  x  |  x  |
                  EIT   |  -  |   x    |  -  |  x  |
                  NIT   |  x A|   x    |  x  |  -  |
                  CAT   |  x  |   -    |  x  |  x  |
                  ECM   |  -  |   -    |  x  |  -  |
                  TDT   |  -  |   -    |  x  |  -  |
                  TOT   |  -  |   -    |  x  |  -  |

A - near future release (~2 month)

(2)
                        | IVG | DVBPSI | IRD | MUX | remarks
-----------------------------------------------------------------------------
VideoStream             |  -  |   x    |  -  |     | MPEG
AudioStream             |  -  |   x    |  -  |     | MPEG
Hierarchy               |  -  |   x    |  -  |     | MPEG
Registration            |  -  |   x    |  x  |     | MPEG
TargetBackgroundGrid    |  -  |   x    |  -  |     | MPEG
VideoWindow             |  -  |   x    |  -  |     | MPEG
ConditionalAccess       |  - A|   x    |  x  |     | MPEG
ISO639Language          |  - A|   x    |  x  |     | MPEG
SystemClock             |  -  |   x    |  -  |     | MPEG
MultiplexBuffUtilization|  -  |   x    |  -  |     | MPEG
Copyright               |  -  |   x    |  -  |     | MPEG
MaximumBitrate          |  -  |   x    |  -  |     | MPEG
PrivateDataIndicator    |  -  |   x    |  x  |     | MPEG
STD                     |  - A|   -    |  x  |     | MPEG
Stuffing                |  -  |   x    |  -  |     | DVB
BouquetName             |  -  |   x    |  -  |     | DVB
Service                 |  - A|   x    |  x  |     | DVB
ShortEvent              |  -  |   x    |  -  |     | DVB
ExtendedEvent           |  -  |   x    |  -  |     | DVB
StreamIdentifier        |  -  |   x    |  -  |     | DVB
ParentalRating          |  -  |   x    |  -  |     | DVB
Teletext                |  -  |   x    |  x  |     | DVB
Subtitling              |  -  |   x    |  x  |     | DVB
NetworkName             |  - A|   -    |  x  |     | DVB
SatelliteDeliverySystem |  - A|   -    |  x  |     | DVB
CableDeliverySystem     |  - A|   -    |  -  |     | DVB
TerrestrialDeliverySys  |  - A|   -    |  -  |     | DVB
PrivateDataSpecifier    |  -  |   -    |  x  |     | DVB
DataBroadcast           |  -  |   -    |  x  |     | DVB
DataBroadcastId         |  -  |   -    |  x  |     | DVB
VBIData                 |  -  |   -    |  x  |     | DVB
VBITeletext             |  -  |   -    |  x  |     | DVB
FrequencyList           |  - A|   -    |  -  |     | DVB
LocalTimeOffsetList     |  - A|   -    |  -  |     | DVB
IrdSwdl                 |  -  |   -    |  x  |     | Scopus
Ac3                     |  -  |   -    |  x  |     | ATSC
AtscAc3                 |  -  |   -    |  x  |     | ATSC

A - copies descriptor with ability to read its tag.

(3), (4), (5), (6), (7), (8) 
                        | IVG | DVBPSI | IRD | MUX | 
-----------------------------------------------------------------------------
 SET-like interface     |  -  |    -   |  x  |  -  |
 Recieve sections       |  x C|    -  D|  x  |  - E|
 Validation             |  x  |    x   |  x  |  x  |
 Portability            |  x  |    x   |  x A|  - F| 
 Table generator        |  x  |    x   |  -  |  -  |
 Modularity             |  - B|    x   |  - B|  -  |

A - usage of vxworks api, demuxer specialized filter
B - no modules, but sorted source code
C - exist additional module, which aggregates packets
D - packets
E - assemble section if needed
F - usage of assembler code

Additional points to consider:
* Future updates from IVG projects
* The IVG solution contains built-in features, like to inform routing engine
  about each ECM added or dropped.
* Approval for usage code w/ GPLv2 license in case of DVBPSI

}}}
Conclusion: The solution will done in MUX code by Micha.
}}}
002. IRP env changes {{{
    06jun2007
To introduce 2 variables IRP_SRC and IRP_TOOLS, point to local copy of IRP
source and Montavista tools.

Changelist = 26666,26670,26679
Changed files in order to add IRP_SRC and IRP_TOOLS:
linux-add-ons/scripts/buboot.sh
linux-add-ons/scripts/env-pro-ppc-405
linux-add-ons/scripts/kernelscripts/kernelb.sh
linux-add-ons/scripts/kernelscripts/kernelm.sh
montavista/devrocket2.0/dev/ml405-bsp/Makefile"
linux-add-ons/scripts/kernelapp.sh
linux-add-ons/scripts/kernelapp/webserver.sh
linux-add-ons/scripts/kernelapp/openrdate.sh
linux-add-ons/scripts/kernelapp/snmp.sh
linux-add-ons/scripts/kernelapp/ftp.sh
linux-add-ons/scripts/irpsys.sh
linux-add-ons/scripts/kernelscripts/kernelc.sh
linux-add-ons/scripts/mvram.sh
linux-add-ons/scripts/libs.sh

linux-add-ons/scripts/libs/sqlite.sh
linux-add-ons/scripts/libs/readline.sh
linux-add-ons/scripts/libs/cli_engine.sh

dev/sw/scripts/b.sh
dev/sw/app/app.mak
dev/sw/scripts/irpapp.mak
dev/sw/scripts/irplib.mak
dev/sw/cli/cli.mak
dev/sw/cfgmgr/cfgmgr.mak
dev/sw/db/db.mak
dev/sw/common/common.mak
dev/sw/osutils/osutils.mak
dev/sw/ts_processor/ts_processor.mak
dev/sw/mux/mux.mak
dev/sw/pcTools/libXmlBuild.sh
dev/sw/pcTools/cliXmlBuild.sh
linux-add-ons/scripts/ramdisk.sh

added 26jun2007 (changelist 27058)
dev/sw/eeprom/eeprom.mak
}}}
003. IRP build w/o root permissions {{{
    02jul2007
Current flow:
kernelapps - webserver, openrdate, snmpd, ftp

Changed files
add p4-env.src, log.sh, string.sh
irpsys.sh, env-pro-ppc-405
released 04jul2007
}}}
004. IRP application start up process {{{
        16sep2007
The application start up process (ASP) is part of IRP boot sequence, trigerred
at final stage of OS booting. ASP ends while IRP inserted control loop.

HighLevel flow for application start up process:
1. Main application init (MAI) - init of the main control modules
2. Database init (DBI)
3. Hardware init (probing, checking and insering to db) (HWI)
4. License authentication (LAU)
5. Application modules init (AMI)

3. Hardware init {{{

The list of devices/buses to discover
- ASI (in and out)
- GBE
- FE
- CI
-
}}}
5. Application modules init (AMI) {{{

List of the app modules

Main Control modules
- Launcher
- Configuration manager
- Hardware manager
- Dynamic Data manager
- Database manager
- Event manager
Security modules
- License authentication module
- User permissions module
Datapath (data processing) modules
- Transport Stream (TS) processor
- FrontEnd manager
- Descryption manager
- Table parser
Management modules
- CLI
- SNMP
- EMS
- Front Panel
}}}
SNMP-like db {{{
    18oct

Documents:
    dev/documents/Software/SNMP/IrpHwStructEntityMib.doc

The list of tables to prepare for:
    entPhysicalTable (Entity MIB v2) 1.3.6.1.2.1.47.1.1.1
    ifTable (IF MIB v2)
    ifStackTable (IF MIB v2) 1.3.6.1.2.1.31.1.2
    entAliasMappingTable (Entity MIB v2) 1.3.6.1.2.1.47.1.3.2
    
}}}
Status: (start 20sep2007)               Dday
x   1. Launcher init                    4
x   2. Database init                    4       26sep
x   3. CfgMngr init                             -
x   4. Hardware Mngr init               3    7oct
x   5. Data validation                  4   10oct
i   6. Security group                   5   21oct
i   7. SNMP-like db                             10  28oct (18oct)
x   8. Data path group                  1   11nov
x   9. Management group                 1   12nov

     SEP         OCT                     NOV
א         16   =23   =30   = 7   x14   =21   =28   = 4   =11
ב         17   =24   = 1   = 8   x15   =22   =29   = 5   =12
ג         18   =25   = 2   = 9   =16   =23   =30   = 6   =13
ד         19   -26   - 3   =10   =17   =24   =31   = 7   =14
ה        =20    27     4   x11   =18   =25   = 1   = 8   =15
ו         21    28     5    12    19    26     2     9    16
ש         22    29     6    13    20    27     3    10    17

}}}
005. irp versioning{{{
    08nov2007
The idea is to place versions into binary file, which can be read by utility 
(running on windows) in order to display versions.

Create ver.h with macro to init structure and display the data. The structure 
has attribute which place it in special section ".version" in order to have
reader able to read this data from executable on Linux|Windows.
{{{
struct ver_info {
    const char *description;
    const char *version;
    const char *creation_date;
    const char *creation_time;
} __attribute__ ((aligned(1)));

#define INIT_VER( var, desc, mj, mn, pt)        \
volatile struct ver_info var __attribute__      \
((section(".version"))) = { #desc, mj"."mn"."pt, __DATE__, __TIME__ }

#define DUMP_VER(name)          \
    printf("%s\n\tVersion:\t%s\n\tCreation Date:\t%s\n\tCreation Time:\t%s\n", \
    name.description, name.version, name.creation_date, name.creation_time)
}}}

Better solution.
Because linker will store in .version section only pointers to strings while
those will be placed at .rodata section - the new solution will force them to 
be in .version section.
solution {{{
struct ver_info {
    char *description;
    char *major_version;
    char *minor_version;
    char *patch_version;
    char *creation_date;
    char *creation_time;
} __attribute__ ((aligned(1)));

#define INIT_VER( var, desc, mj, mn, pt)        \
static char description[] __attribute__ ((section(".version"))) = #desc; \
static char mj_ver[] __attribute__ ((section(".version"))) = "major_version - "mj; \
static char mn_ver[] __attribute__ ((section(".version"))) = "minor_version - "mn; \
static char pt_ver[] __attribute__ ((section(".version"))) = "patch level - "pt;   \
static char cre_date[] __attribute__ ((section(".version"))) = "creation-date - " __DATE__; \
static char cre_time[] __attribute__ ((section(".version"))) = "creation-time - " __TIME__; \
struct ver_info var __attribute__ \
((section(".version"))) = { description, mj_ver, mn_ver, pt_ver, cre_date, cre_time }
}}}
In order to read the section data, just do
objdump -j .version -d <obj file name>
}}}
006. Fix building of external projects {{{
    2d - done (27dec2007)
linux-ftpd webserver sqlite net-snmp openrdate
dvb-apps libxml2 readline

cli-engine
}}} 
007. Make build process modular {{{
    1-2d - done (27dec2007)
}}}
008. Build process logging {{{
    1d - done (30dec2007)
}}}
009. IRP hardrware recognition {{{
    01jan2008
1. List of hw devices for recognition

AHWC - actual hw config (found by HwMan)
EHWC - expected hw config (written in Db)

Detachable:
    Frontend
    Option card (Fe, Decr, ASI, etc.)

Fixed:
    ASI (4+2)
    CIMAX+CAM (2)
    Ethernet mng (2)
    Serial (con) (1)
    GPIO (1)
    GBE (2)

2. Recognition policies

    The AHWC comming from idprom and EHWC from current db status.

                    NoLic     Lic
fixed       A < E   scratch   scratch
            A > E   scratch   scratch
detach      A < E   block cfg block cfg
            A > E   ignore    ignore

status: 10dec2008

TODO: validator should mark certain card to ignore or to block cfg.
added new field CardStatus in HardwareCard_s, which would the status.
Should we keep it also in db?
Each manager should check it (for now FeMan only)?
How to do ignorance of new device? or more accurate how to keep out from
logical input/output creation?
}}}
010. Decr Manager {{{
    20nov2007
Question:
--- CAM parameter defines which ES supported?

Assumptions:
--- Each CAM may work w/ only 1 TS.

CAM - Conditional Access Module
CI - Common Interface (EN 50221 CI Specifications)

DVB CI manages CAM, which gets scrambled TS and puts decrypted TS. 
Any TS can be decrypted by 2 CAMs, connected in parallel or sequential.

User configuration, based on program number or ES PID. While have to decrypt
whole program the new list of ES will be created.
When ES mode selected during the run, user configuration can't be change even
if program's PMT changed.
 
The decrypted TS provides changed scrambing status on program or ES level. If 
the status not changed, the alarm raised for user.

The DVB CI standard provide control of CAM. Number of application resources 
should be created: Resource Manager, Application Information, MMI, CA, date
and time.
Application Info
CA Info
MMI
...

CAM state should be provided:
    NONE        - CAM missing
    IN_RESET    - CAM after reset but still not ready
    OK          - OK
    BAD         - CAM missing or malfunctioning

Ability to CAM reset.

Advanced configuration.
Follows configuration parameters have access via CLI:
DisableCAMPresenceSensing - 
CAMPresenceSensingTimeout -
ResetWhenLastServiceDeleted - 

Ability to upgrade CAM firmware.

Manage and sync of PMT list. Able to use `update', `add', `only', `first', and
`more', `last' commands.

Implementation

There are 3 tables which can start/stop decryption, depends on there values:
    tbl_decr_slot_inp_map, tbl_decr_slot_prog_map n PMT table
1. NewPMT(program,input) - new/update entry in PMT table

2. NewProgram(slot,prog,mode) - user wants to add new program 
3. RemoveProgram(slot,program) - user wants to delete program
4. RemoveAllPrograms(slot) - user wants to delete all programs of certain slot

5. NewInput(slot,input) - new slot and input for DecrSlotInputMap
6. RemoveSlot(slot) - delete the slot from DecrSlotInputMap
7. RemoveAllSlots(void) - delete all slots from SlotInputMap table = clear table

Used db tables {{{
1+  DecrDrvMap table (non-persistent)
        (slot_indx, adapter, ca_dev, slot_nbr)
    To add follow API: Clear, Add, Get, GetNext

2   PMT

3   SlotInputMap table (tbl_decr_slot_inp_map)
        (slot_idx, input_num)
    This is persistent table, maps inputs to decryption slots. Filled by user.
    To add follow API: Clear, Add, Get, GetNext

4   Program table (tbl_decr_slot_prog_map)
        (slot_idx, prog_num, decr_mode)
    This is persistent table, maps programs to inputs. Filled by user.

5   DecrCAInfo table (tbl_decr_ca_info)
        (slot_idx, sys_id)
    This is non-persistent table, describes CAInfo data(sys-id) per CAM device.
    Filled by DecrMngr.

6   DecrAppInfo table (tbl_decr_app_info)
        (slot_idx, type, manuf, code, menu_str)
    This is non-persistent table, describes internal CAM application data. 
    Filled by DecrMngr.

7   DecrCAMstatus table (tbl_decr_cam_status).
        (slot_idx, status)
    This is non-persistent table, describes status per CAM device. 
    Filled by DecrMngr.
}}}
Add CLI cmd {{{
add cmd to dev/sw/cli/xml/gjobs.xml
add option in dev/sw/cli/inc/params_order.h
add case to dev/sw/cfgmgr/src/req_map.cpp
}}}

workplan
+   1. DM framework + queue for messages
+   2. Add HwMngr filling DecrDrvMap table
+   3. Add SlotInputMap table and api for it (done 02dec2007)
+   4. Add Program table and api for it (done 02dec2007) 
+   5. Add CAInfo  and AppInfo tables (done 03dec2007)
+   6. Add CAM status table (done 03dec2007)
+   7. Processing NewPMT from EventMngr (done 05dec2007)
+   8. Processing Remove from ConfigMngr (done 05dec2007)
+   9. Processing Status/Info from low-level (done 05dec2007)
+  10. Change table names to decr like (done 10dec2007)
+  11. Change Select from tbl_decr_slot_prog_map w/ new index for NewPMT (10dec2007)
+  12. Add validation for DecrSlotInputMap n DecrSlotProgramMap tables (11dec2007)
+  13. Add events: RemoveAllSlots, NewProgram (11dec2007)
+  14. Add events: RemoveProgram (12dec2007)
+  15. Add events: RemoveAllPrograms, NewInput, RemoveSlot (12dec2007)
+  16. Add callback member and call it at the end of any event (12dec2007)
+  17. Add event-if-fail in NewPMT (17dec2007)
+  18. CLI support debug DB api (17dec2007)

   18. Add MMI support

   19. CLI support set slot+prog+decr mode
   20. CLI support remove slot+prog
   22. CLI support remove slot (all progs)
   23. CLI support set/remove slot+input
   24. CLI support get CAM status, App info n CA info
   25. CLI support reset slot

   26. CLI: problem to add AppInfo record, because of string

}}}
011. FrontPanel manager {{{
    12feb2007
It contents keypad and LCD display.
LCD display (OPTO0152CSL) + 2 chips of S1D15600

Code flow (by Zeev)

CFrontPanelEngine::CFrontPanelEngine()
CFrontPanelEngine::Init() - creates thread w/ frontPanelTask()
frontPanelTask()
|_> CFrontPanelEngine::MainTaskEntery()
    |-> CFrontPanelInterface::CFrontPanelInterface()
    |-> CFrontPanelInterface::Open()
    |   |-> frontPanelDriver::frontPanelDriver()
    |   |-> frontPanelDriver::Init()
    |   |   |_> open(FRONT_PANEL_DRIVER)
    |   |_> frontPanelDriver::lcdSetContrast() - ioctl FRNTPNL_IOLCD_LCDSETCONTRAST
    |-> CFrontPanelInterface::SetTimeOut(600ms)
    |-> CFrontPanelSession::CFrontPanelSession()
    |   |-> CFrontPanelMenuRoot::CFrontPanelMenuRoot()
    |   |   |-> CFrontPanelMenuConfiguration....
    |   |   |-> CFrontPanelMenuStatus....
    |   |   |-> 
    |   |-> MainRoot->SetId(FRONT_PANEL_MENU_ROOT_ID);
    |   |-> MainRoot->SetObjectType(FRONT_PANEL_MENU_TYPE_STR);:
    |_> CFrontPanelSession::StartParsingNormalProc() - MAIN LOOP
        |-> frontPanelDriver::ReadChar() - blocking func for time period

kernel crash {{{
/root>Oops: kernel access of bad area, sig: 11 [#1]
PREEMPT 
NIP: C7031510 LR: C70314D4 SP: C4D5BF50 REGS: c4d5bea0 TRAP: 0300    Tainted: P     
MSR: 00029030 EE: 1 PR: 0 FP: 0 ME: 1 IR/DR: 11
DAR: 6C617374, DSISR: 00800000
TASK = c5329a90[873] 'IRQ 6' THREAD: c4d5a000
Last syscall: -1 
GPR00: 00000000 C4D5BF50 C5329A90 00000001 C5EE4000 00000000 00000000 00000000 
GPR08: 00000080 54855163 6C617374 61745F65 00089109 FE00C440 05FFFD00 FFFFFFFF 
GPR16: 00000001 00000000 00000000 05FF94D0 05ED0BC0 00000002 C01F0000 C01F0000 
GPR24: 00000000 00000006 00000000 00000000 C4D592E0 C4D5A000 00000000 C5EE4000 
NIP [c7031510] fpKeyIntrptHndlr+0x5c/0xdc [frntpnlmod]
LR [c70314d4] fpKeyIntrptHndlr+0x20/0xdc [frntpnlmod]
Call trace:
 [c0037d64] handle_IRQ_event+0x84/0x13c
 [c00385bc] do_irqd+0x1e0/0x214
 [c002f2f4] kthread+0xf4/0x130
 [c0005454] kernel_thread+0x44/0x60
---------------------------
| preempt count: 00000002 ]
| 2-level deep critical section nesting:
----------------------------------------
.. [<c00036ec>] .... die+0x48/0xc8
.....[<00000000>] ..   ( <= 0x0)
.. [<c00329ac>] .... print_traces+0x1c/0x11c
.....[<00000000>] ..   ( <= 0x0)

prev->state: 2 != TASK_RUNNING??
Badness in __schedule at kernel/sched.c:2906
Call trace:
 [c0003a1c] check_bug_trap+0x98/0xdc
 [c0003b90] ProgramCheckException+0x130/0x2d0
 [c0003284] ret_from_except_full+0x0/0x4c
 [c01de2b8] __schedule+0x5a4/0x730
 [c0018ee0] do_exit+0x9e4/0xc98
 [c0003760] die+0xbc/0xc8
 [c000a280] bad_page_fault+0x58/0x5c
 [c0003128] handle_page_fault+0x7c/0x80
 [00000002] 0x2
 [c0037d64] handle_IRQ_event+0x84/0x13c
 [c00385bc] do_irqd+0x1e0/0x214
 [c002f2f4] kthread+0xf4/0x130
 [c0005454] kernel_thread+0x44/0x60
---------------------------
| preempt count: 00000003 ]
| 3-level deep critical section nesting:
----------------------------------------
.. [<c01ddd64>] .... __schedule+0x50/0x730
.....[<00000000>] ..   ( <= 0x0)
.. [<c01dde00>] .... __schedule+0xec/0x730
.....[<00000000>] ..   ( <= 0x0)
.. [<c00329ac>] .... print_traces+0x1c/0x11c
.....[<00000000>] ..   ( <= 0x0)
}}}
}}}
012. Management port {{{
    19feb2008
To show/set ip, netmask, gateway and MAC(show only) from CLI or Fp.

Testcases (To do follow from CLI and Fp)

                | Change to       | Change to       |
                |   valid         | not valid       |
----------------------------------|-----------------|
IP              | 10.2.1.115      |                 |
10.2.1.111      | 10.2.1.197      | 192.168.1.1     |
----------------------------------|-----------------|
Netmask         | 255.255.0.0     |                 |
255.255.252.0   | 255.255.250.0   | 255.255.255.0   |
----------------------------------------------------|
GW              | 10.2.0.4        |                 |
10.2.0.1        | 10.2.0.2        | 192.168.0.1     |
-----------------------------------------------------
}}}
013. Hardware monitoring {{{
    09mar2008


}}}
014. IRP upgrade - design {{{
    08jan2008

1. Why to upgrade? (introduction)

    It's all starts with idea to bring new release to a customer. The reasons
may be version with bug fix or new feature or even previous operation failure.

2.  IRP system in close-up (system overview)

    The firmware of spartan and virtex, bootloader (u-boot) for the OS, kernel,
system apps (busybox, etc), IRP app package (irp, snmpd, db, web, etc.) and
EMS.
    The IRP's flash memory is devided on several parts, where each represents 
separate image. Spartan and Virtex firmwares, OS bootloader and OS kernel.

   ------------------------------------------------------------
  | Spartan  |  Virtex  | Boot  | Kernel | Root | Config | EMS |
  | firmware | firmware | loder |        |  fs  |   fs   | fs  |
  |          |          |       |        |      |        |     |
   ------------------------------------------------------------
  |    150   |   2625   |  535  |  1285  | 8777 | ~5000  |35000|
  |          |          |       |        |      |        |     |
   ------------------------------------------------------------   ~~55MB

The root filesystem, which is readonly. It is contents system apps and IRP app
package. The config filesystem is writeable one, where all system configs, IRP
configs and IRP's db. The final is EMS filesystem, which is readonly and 
contents whole EMS package.

3.  Which parts are upgradeable? (upgrade definitions)

    The spartan firmware must be located at flash memory at address 0x0, so it
is non-upgradeable.
    The virtex firmware is upgradeable.
    The OS bootloader (u-boot) is upgradeable. It is contents boot algorithm,
which need upgrade at least in dev stage. The IRP don't have to upgrade bootl.
    OS kernel, root filesystem, config filesystem and EMS filesystem are
upgradeable.

     ------------------------------------------------------------
    | Spartan  |  Virtex  | Boot  | Kernel | Root | Config | EMS |
    | firmware | firmware | loader|        |  fs  |   fs   | fs  |
     ------------------------------------------------------------

    |          |    U     |   U   |   U    |  U   |   U    |  U  |

4.  Sorting things up (types of upgrade)

    The previous picture brings the list of upgrade types, where each one 
defines URP part goes for upgraded.
The firmware upgrade is actual upgrade of virtex firmware.
The system upgrade is process dealing w/ os kernel and root filesystem.
The config upgrade have the config filesystem as a subject. It is separate from
system upgrade, because of db upgrade complexity. It have to upgrade db structure
together with keeping user configurations.
The EMS filesystem upgrade is dealing w/ EMS and it is separated, because of 
lack.
    To make things easier:
The software upgrade is system, config and EMS upgrades together.
The full upgrade is firmware and software upgrades.

5.  What to deliver? (Packaging and versioning)

    There are number of images to prepare. In case the full upgrade wanted, 
which means upgrade for whole system, follows list of images that can be put
together in 1 tarball (file created by tar and archiver utilities).
firmware.image
kernel.image
rootfs.image
cfgfs.image
emsfs.image
    Each tarball goes with own version, written in filename, like:
                upgrade-0.1.1.tar.bz2
    How to check version compatibility between firmware and software or option
card firmware and mainboard firmware, etc.?

    A. The final tarball of upgrade images has own version tag and upgrade app
does the process without any dependency check. All checks done by app which 
prepares upgrade tarball.
    B. Prepare everytime tarball with most high version of everything. It means
allways full upgrade.
    C. Prepare tarball with info about internal versions of images (additional
file or filenames w/ ver). Enforce dependecy rules for upgrade app.
For example, if decided to 4 different parts, each has own version -
mainboard firmware (mbfw), mainboard software (mbsw), option card firmware
(ocfw) and option card software (ocsw), which version system like Maj.Min.Pat,
so the rule may be that each major version should be equal :)

                mbsw    mbfw    ocfw    ocsw    ocfw-2  ocsw-2
    basic IRP   1.1.1   1.2.3

    IRP w/ ASI  1.1.1   1.2.3   1.3.4   1.9.0
        card

    IRP w/ 2    1.1.1   1.2.3   1.3.4   1.9.0   1.5.2   1.6.3
        cards

6.  How it starts? (upgrade initiation)

    The main rule is that IRP can not initiate upgrade, it is always from 
outside. The process may start while IRP gets certain command (SNMP-like) or 
the download of upgrade image may do it.

7.  Moving step-by-step (common upgrade procedure)

    In most cases common behaviour of upgrade process can be defined. It is 
startes with external command to do upgrade and never by internal decision.
Download upgrade image, which is archived tarbal. 
Verify image with MD5 checksum or any other, if any (oq-3).
Now time to open tarball and check dependecies, if any (oq-10), (oq-11).
Begin to burn images on flash, start with mainboard firmware, mainboard 
software,option card firmware and option card software.
Each burning step finalizes with write down addresses of the images. Mainboard
spartan needs option card firmware image address, mainboard virtex needs OS
bootloader address and the last one needs kernel image address.
In addition to compatibility between option card and mainboard. The
next step is to bring upgrade image to the system.

8.  How it looks like on flash?  (flash memory picture)

    Follow sizes of upgrade images per type:
The firmware upgrade image ~3000KB
The system upgrade image ~15000KB
The software upgrade image ~50000KB
    So in case of full upgrade (firmware+software) needed ~~55000KB ramdisk.

         Non upgradable    UPGRADABLE Non upg          UPGRADABLE        |
    |---------------------|----------|-------|---------------------------|
    | Spartan  | Virtex A | Virtex B |       |                           |
    | firmware | firmware | firmware | Boot  |                           |
    |----------|----------|----------| loader|         SOFTWARE          |
    |    150   |   2625   |   2625   |       |                           |
    |--------------------------------------------------------------------|
                                5400 |        

                       |                     UPGRADABLE                  |
    |----------|-------|--------|------|-----|--------|------|-----|-----|
    |          | Boot  | Kernel | Root | Cfg | Kernel | Root | Cfg | EMS |
    | FIRMWARE | loader|        |  fs  |  fs |        | fs   | fs  | fs  |
    |----------|-------|--------|------|-----|--------|------|-----|-----|
    |   5400   |  535  |  1300  | 9000 | 5000| 1300   | 9000 | 5000|35000|
    |------------------|-------------------------------------------------|
                       |                                   32000   |     |

9.  Choosing how to upgrade?

    A. 2 equal systems

 |            |    Upg   |   Upg    |
 |------------|----------|----------|
 | Bootloader | System A | System B |
 |------------|----------|----------|
 |            |  ver N-1 |  ver N   |

    B. main and upgrade systems

 |            |   Non-Upg    |   Upg      |
 |------------|--------------|------------|
 | Bootloader | BackupSystem | MainSystem |
 |------------|--------------|------------|
 |            |   ver 1.x    |  ver N     |

   Footprint    almost the same (TFTP,FTP,"air") -db

   Simplicity   B is more simple than A

   Responsiveness    A is beter (full set of apps to control)

   Stability    equal stability

    Dynamic addressing

    Dynamic address resolution is feature which solves situation where upgrade 
process changes start address of certain image on flash memory.
In case of such address is hardcoded, it is demanding to rebuild new image and 
upgrade afterwhile. 
For example, address of os bootloader image on flash memory if hardcoded can
cause to rebuild of virtex A and B systems. In other hands, if saved on eeprom
can be updated by upgrade procedure without any influence on virtex images. 

    Mainboard firmware upgrade.

There are 2 firmware images - one for spartan fpga and another for virtex. Only
virtex firmware possible to upgrade.
The gold version method will be used for firmware upgrade algorithm. There
are virtex firmwares, A which is minimized and non-upgradeable and B always 
new one. 
The algorithm is always to upgrade virtex B firmware. The spartan always 
loading virtex B and virtex A can be used in case of failure of B, so system 
could be functional at least to do upgrade.
It is possible to upgrade virtex B, which it is running.

Spartan  firmware    150KB   address 0x0
Virtex A firmware   2625KB  address +150KB
Virtex B firmware   2625KB  address +150KB +2625KB

The spartan cannot read from eerpom, so address of virtex A firmware must be
hardcoded and as drawback the spartan firmware together with virtex A firmware
are non upgradeable.

    Firmware start-up logic

The spartan always trying to load the virtex B firmware, only if that failes,
the virtex A would be used.
The watchdog method can used to aware the spartan of virtex failer while loads.


    Final flash memory picture.

 |    Non upgradable  |UPGRADABLE|Non upg|            UPGRADABLE        |

  ------------------------------------------------------------------------------------------------
 | Spartan | Virtex A | Virtex B | Boot  | Kernel | Root | Config | Kernel | Root | Config | EMS |
 | firm    | firmware | firmware |loader |        |  fs  |   fs   |        |  fs  |   fs   | fs  |
 |   ware  |          |          |       |   A    |  A   |   A    |   B    |  B   |   B    |     |
  ------------------------------------------------------------------------------------------------
 |    150  |   2625   |   2625   |  535  |  1285  | 8777 |  2000  |  1285  | 8777 |  2000  |35000|
  ------------------------------------------------------------------------------------------------

                             5400 |      |                 ~20000 |                 ~20000 |     |

    The final calculations:
        whole firmware takes around 5.5MB;
        whole system takes around 20MB and to add another 20MB for backup system;
        firmware upgrade image takes 3MB;
        system upgrade image takes ~20MB;
        ems upgrade image takes ~35MB

    The eeprom device data picture

    The eeprom device is most stable place, consider power failures in the 
system.

    Hardware revison
    Device serial number
    License
    User options
    Configuration flags
    Upgrade flags

    IRP bootup procedure

    The upgrade process have certain influence on the subject. 

A   Upgrade flags

    FFU - Force Firmware Upgrade

B   Open questions

x   1. Firmware upgrade: image size
x   2. Software upgrade: image size
    3. To use MD5 checksum or other check if any?
    4. System fallback, while new software failure (watchdog)
    5. Upgrade protocol/definitions between mainboard and option card
    6. Uboot file format. Change uboot image format from srec to bin. will save
       ~355KB (current 08jan2008 535KB)
    7. Upgrade control measures
        a. Initiation, by SNMP or FTP/TFP/air
        b. Failure upgrade message (cli,front panel, snmp alert)
    8. Option card upgrade images
x       a. ASI: firmware size 278KB
        b. Decoder:
        c.
    9. Option card failover
        a. ASI: fpga (spartan 3e500) have signal up while finishs to load. 
            It have support in mb spartan?
        b. Decoder:
        c.
   10. Any version check dependecies on box side?
   11. Place for images from tarball. How much place need?

15jan2008 (meeting w/ Yaniv Sibony)
1. Delivery protocols FTP,air,CLI (Akiva wants TFTP)
2. No need for SNMP-like initiation
3. Versioning still oq (ver for IRP, ver for Opt card)
4. No use of MD5 checksum
5. All types of customers
}}}
015. Load kernel from flash {{{
    17mar2008

2. Reconfigure kernel (file drivers/mtd/maps/mtd405.c)
The flash starts from 0xb0000000

offset        size              name            start addr         end addr
------------|----------------|---------------|---------------|-------------
0x0000 0000   0x00900000        bootloader      0xb000 0000     0xb090 0000
0x0092 0000   0x01400000 20M    kernel          0xb092 0000     0xb1d2 0000
0x01d4 0000   0x01400000 20M    user            0xb1d4 0000     0xb314 0000

writing from Uboot prompt:

    Kernel burn                     Uboot burn
erase 0xb092 0000 +a00000         0xb080 0000 +100000
tftp  0x0380 0000 pMulti          0x0380 0000 u-boot.srec
cp    0x3800 0000 0xb0920000      0x0380 0000 0xb0800000

    Virtex burn
tftp 0x3800000 virtex.bin
erase 0xb0040000 +320000
cp 0x3800000 0xb0040000 280f50
}}}
016. Minimal upgrade {{{
    18mar2008 - 31mar2008


}}}
017. Mainboard FPGA (Virtex) upgrade {{{
    01apr2008
define new mtd partition for Fpga virtex (drivers/mtd/maps/mtd405.c)

offset        size              name            start addr         end addr
------------|----------------|---------------|---------------|-------------
0x0004 0000   0x00320000        fpga            0xb004 0000     0xb036 0000
0x0080 0000   0x00100000        bootloader      0xb000 0000     0xb090 0000
0x0092 0000   0x01400000 20M    kernel          0xb092 0000     0xb1d2 0000
0x01d4 0000   0x01400000 20M    user            0xb1d4 0000     0xb314 0000

tar -C /mnt/flash/ftp/abc/ -xf upgrade.tar pMulti*

tar cvf upgrade.tar pMulti virtex.bin upgrade.txt

tar xf upgrade.tar upgrade.txt

tar tvf upgrade.tar

Collect all needed images: virtex.bin, u-boot.srec and pMulti and create 
tarball:
tar cvf upgrade.tar virtex.bin u-boot.srec pMulti

}}}
018. Boot image on front panel {{{
    13apr2008
1. Implement front panel driver in uboot

front panel driver {{{

files: 
    frntPnlDrvc.c
    frntpnlmod.mod.c
    frntHwInt.c
    frntLcdUtil.c
}}}
}}}
019. Add new partition for EMS {{{
    18may2008
Add follows
    { name: "EMS",        offset: 0x04560000, size:   0x2800000}
at file drivers/mtd/maps/mtd405.c

Get uboot prompt and erase this partition:
    erase 0xb4560000 +2800000
}}}
020. Ability to add/del users from cli {{{
    finished 21may2008
    Create ability to add/del IRP user. A user should have telnet w/ IRP's cli
may or may not able to ftp. Only one user admin could add/del others.

    Solution based on regular linux passwd file. The add command inserts new
user with follows params:
    zxc:guAciU5brCVEo:0:15:zxc:/home/user:/irp/cli.elf
Such user able to have telnet w/ IRP's cli and ftp. In order to create an user
w/o ftp permissions, other file /etc/ftpusers edited.
It seems that users found in the file forbidden to access ftp. Ability to check
if a user able to add/del others, checks in CLI.

}}}
021. Identification of Ofek card (Horizon) {{{
    27may2008
    Story 691 {{{
OFEK card has an I2C IDPROM that should contain some structure with the following fields:
hw_revision       -- will be set to a char string "503526"
hw_options        -- 4-bytes integer set to 0
serial number   --  4-bytes integer number
 
The IRP application should have a CLI command to present for each option card slot:
-- presence
-- hw_revision
-- serial number
 
If an OFEK card not present, any downconverter configuration operation performed at the card causes an error to be returned to the user. 
}}}

    The Ofek card has eeprom chip connected to IRP's mainboard by i2c bus.
It is m24c01 ST chip. It is address is 0x56 and capacity 128 B. In order to
switch it to write enable, other device should be checked - called 
i2c expander (Philips PCA9538). Need to set config register (3) to value 0xdf
and in output register (1) set bit 5 to 0. The i2c address of expander is 0x73.
write 0x73 3 0xdf
read  0x73 1 val
write 0x73 1 val&0xdf

--- The flow of recognition.

The recognition starts from reading presense bit from Virtex, which provides
info if opt card present. The xilinx DCR reg 48, where bit 21 for bottom card 
and 22 - top.
Try to read eeprom of a card. Follows parameters should be found:
hw_rev,  serial_num and user_opt. 


CLI commands to show the data:
status-decoder->list                displays nbr of cards

Opens:
1. Ability to read presence bit. Waiting for Sharon. Virtex from 28may2008.
2. 

Status:
    10jun2008 - wait for Eugene to complete.
    29jun2008 - i2c address for bottom card - pca is 0x72, eeprom is 0x56
                                top card - pca is 0x73, eeprom is 0x57

}}}
022. EMS upgrade {{{
    22jun2008

x   1. Create new partitions ems-10MB and jre-20MB
x   2. Create utility to create jffs2 image
x   3. Change package.sh utility to support new images
x    4. Ability upgrade ems and jre partitions

flash_eraseall -j /dev/mtd/4
flashcp ems.jffs2 /dev/mtd/4
}}}
023. 8VSB solution {{{
    22may2008

Intro {{{
Add driver and the rest of functionality for new IRP card. It is 8VSB one.
The card based on 8VSB NIM called TDVS-H081P. It contents demodulator
lgdt3304 (the LG 6th generation ATSC chip) and tuner (Infineon Technologies'
Taifun TUA 6039 bipolar/CMOS tuner integrates the RF and IF functions).
NIM datasheet - TDVS-H081P_Datasheet.pdf
Demod datasheet - LGDT3304_ds1_01_for_DITOCOM.pdf

Taifun TUA6039 is a Tuner IC incorporating a mixer-oscillator function and an 
IF AGC amplifier with a digitally programmable phase locked loop (PLL). Both 
analog and digital standards for all terrestrial and cable applications are 
supported. With the high level of system integration and use of Bipolar 
technology, this IC provides cost effective and good performance solution to 
Tuner module and NIM (Network Interface Module) manufacturers.

Check locking.
Carrier lock

Have 2 source codes:
Source code - the original LG code
33046039_sfotreset - working code from DITOCOM

Theory
The 8VSB is RF modulation used for ATSC.

}}}

Open questions:
- 1. is there need to support antenna control interface (EIA/CEA-909)? NO
- 2. which tuner is used in the NIM? Datasheet? Infineon TUA 6039
- 3. does AGC external or internal? (Avi said internal)
- 4. control AGC periodicaly?   YES
  5. how often to check for lock?

Analyze of source code {{{
--------- The original LG code:
{{{
MenuRun() // main.cpp
|_> LgdtRun(mode = LGDT_VSB, freq) {{{
    |-> LgdtTunerInit() // init of tuner LGDT3304API.cpp
    |   |-> LgdtTunerInitAFC(freq)  // init AFC, set global var gFreqCur and zero to gCountAFC
    |   |-> LgdtTunerFreq()  // tuner setup func
    |   |   |-> TunerALPS_TDQU(freq,mode)    // Tuner.cpp
    |   |   |   |_> Lgdt_I2C_Write()    // LGDT_Util.cpp, send 6B : 0-0xc2, 1-val, 2-val, 3-8B, 4-val, 5-0xf6
    |   |   |       |_? I2C_Sends() // LGDT_I2C.cpp, send data to i2c slave (LPT)
    |   |   |       |_? LG_IIC_WriteType2HS()   // LG_IIC_Interface.h, send data to i2c slave (USB)
    |   |   |-> LgdtRepeaterI2C(OFF)    // disable I2C repeater
    |   |   |   |-> LgdtCheckRegi(0x0001)
    |   |   |   |_> LgdtAlterRegi(0x0001)
    |   |   |_> LgdtResetFAT()    // reset demod after tuner setting
    |   |       |-> LgdtCheckRegi(0x0002)
    |   |       |-> LgdtAlterRegi(0x0002)
    |   |       |-> LgdtDelay(20)   // reset delay
    |   |       |_> LgdtAlterRegi(0x0002)
    |   |
    |   |_> LgdtInitDelay()
    |       |-> LgdtCheckRegi(0x0422)       // Init: delay auto off
    |       |-> LgdtAlterRegi(0x0422)       //           =
    |       |-> LgdtCheckRegi(0x0423)       // Setting 0x0423
    |       |_> LgdtAlterRegi(0x0423)       //           =
    |
    |_> LgdtInitFAT()   // LGDT3304API.cpp, init of demod
        |-> LgdtInitVSB()   // 
        |   |-> LgdtCheckRegi(0x0000)       // OPERMODE[1:0] <-- '11'b
        |   |-> LgdtAlterRegi(0x0000)       //            =
        |   |-> LgdtAlterRegi(0x000D, 0x02) // enable SAW filter
        |   |-> LgdtAlterRegi(0x000E, 0x02) // sync confidential counter register
        |   |-> LgdtAlterRegi(0x0012, 0x32) // DAGCREF[15:0] <-- 0x32C4
        |   |-> LgdtAlterRegi(0x0013, 0xC4) //          =
        |   |-> LgdtCheckRegi(0x0112        // EPHNTH[3:0] <-- '0111'b
        |   |-> LgdtAlterRegi(0x0112,       //          =
        |   |-> LgdtCheckRegi(0x0113        // GCONTH1[2:0] <-- '101'b
        |   |-> LgdtAlterRegi(0x0113        //          =
        |   |-> LgdtCheckRegi(0x0114        // GCONTH2[0] <-- '0'b
        |   |-> LgdtAlterRegi(0x0114        //          =
        |   |-> LgdtAlterRegi(0x0115, 0xFF) // GCONTH3[7:0] <-- 0xFF
        |   |-> LgdtCheckRegi(0x0116, &pData) // DMSELOWTH[2:0] <-- '100'b
        |   |-> LgdtAlterRegi(0x0116          //            =
        |   |-> LgdtCheckRegi(0x0214        // GSAUTOSL[1:0] <-- '01'b : Actually, 0x0214[3:2]
        |   |-> LgdtAlterRegi(0x0214        //                      =
        |   |-> LgdtAlterRegi(0x0424, 0x8D) // CST_THD[15:8] <-- "0x8D"
        |   |-> LgdtAlterRegi(0x0427, 0x12) // EQCON_THD[15:0] <-- "0x124F"
        |   |-> LgdtAlterRegi(0x0428, 0x4F)
        |   |-> LgdtAlterRegi(0x0308, 0x80) // IFBW[15:0] <-- "0x8000"
        |   |-> LgdtAlterRegi(0x0309, 0x00) //            =
        |   |-> 
        |   |->
        |   |->
        |_> LgdtResetFAT()
}}}

MenuStatusCheck() // main.cpp
|-> ... {{{
|-> LgdtIsLockSync()
|-> LgdtIsLockCR()
|-> LgdtCheckPacketErr() // LGDT3304API_CHECK.cpp
|   |-> LgdtCheckRegi(0x050C, data)
|   |-> ndata << 8
|   |-> LgdtCheckRegi(0x050D, data)
|   |_> ndata |= data;
|-> LgdtCheckSnrFAT() // LGDT3304API_CHECK.cpp
|   |-> LgdtCheckOperMode()
|   |_> LgdtCheckSnrVSB()
|       |-> LgdtCheckRegi(0x0417, data)
|       |-> int ndata = data & 0x0f
|       |-> ndata << 16
|       |-> LgdtCheckRegi(0x0418, data)
|       |-> ndata |= (data << 8)
|       |-> LgdtCheckRegi(0x0419, data)
|       |-> ndata |= data
|       |-> 10 * log10((double)(25*32*32)/ndata)
|-> LgdtCheckSignalCondition()
|-> LgdtCheckOperMode()

}}}

}}}
--------- The example from DITOCOM:
{{{

New_01_33046039_sfotreset\ColorStaticST.cpp"
New_01_33046039_sfotreset\i2c.cpp"
New_01_33046039_sfotreset\LGDT3304.cpp"
New_01_33046039_sfotreset\LGDT3304Dlg.cpp"
New_01_33046039_sfotreset\lgtuner.cpp"

CLGDT3304Dlg::OnMpegout0()  // LGDT3304Dlg.cpp
CLGDT3304Dlg::OnMpegclk0()
CLGDT3304Dlg::OnMpegval0()

LGDT3304Dlg::OnRunButton2()  // LGDT3304Dlg.cpp
|->RunPLL()
|->Run3304()
|_> set timer

CLGDT3304Dlg::RunPLL()  // LGDT3304Dlg.cpp
|_> TunerWrite(rf,44,62.5,0xc2,0x86,0x02,5)    // lgtuner.cpp 1-RF,2-IF,3-step,4-addr,5-ctl1,6-ctl2,7-agc
    |-> I2cReadWrite(WRITE,TunerB[1],&TunerB[2],4) // i2c.cpp 1-mode,2-chip addr,3-&data,4-bytes
    |_> I2cReadWrite(WRITE,TunerB[1],&TunerB[6],2)

LGDT3304Dlg::Run3304()  // LGDT3304Dlg.cpp
|-> RegSetOneRegister(0x0002, RegGetOneRegister(0x0002)&0xFE)   // reset FAT
|-> Sleep(20)                                                   //     =
|-> RegSetOneRegister(0x0002, RegGetOneRegister(0x0002)|0x01)   //     =
|-> RegSetOneRegister(0x001, RegGetOneRegister(0x001)|0x20)     // i2c repeater off
|-> lgdt3304Mpegclk()   // mpeg setup parallel
|-> lgdt3304Mpegval()   // mpeg setup gated
|-> lgdt3304Mpegout()   // mpeg setup high
|-> lgdt3304Init()  // init demod
|   |-> RegSetOneRegister(0x000A, (RegGetOneRegister(0x000A)&0xEF)|0x10)
|   |-> RegSetOneRegister(0x000B, (RegGetOneRegister(0x000B)&0xEF)|0x10)
|   |-> RegSetOneRegister(0x0000, (RegGetOneRegister(0x0000)&0xFC)|0x3) // VSB mode
|   |-> RegSetOneRegister(0x000d, 0x63)     // Digital SAW filter
|   |-> RegSetOneRegister(0x000e, 0x02)     // sync confidential counter register
|   |-> RegSetOneRegister(0x0012, 0x32)     // DAGCREF[15:0] <-- 0x32C4
|   |-> RegSetOneRegister(0x0013, 0xc4)     //          =
|   |-> RegSetOneRegister(0x0112)           // EPHNTH[3:0] <-- '0111'b
|   |-> RegSetOneRegister(0x0113)
|   |-> RegSetOneRegister(0x0114)
|   |-> RegSetOneRegister(0x0115)
|   |-> RegSetOneRegister(0x0116)
|   |-> RegSetOneRegister(0x0214)
|   |-> RegSetOneRegister(0x0424,0x8d)
|   |-> RegSetOneRegister(0x0427,0x12)
|   |-> RegSetOneRegister(0x0428,0x4f)
|   |-> RegSetOneRegister(0x0308, 0x80)     // AGC
|   |-> RegSetOneRegister(0x0309, 0x00)     //  =
|   |-> RegGetOneRegister(0x030d)           //  =
|   |-> RegSetOneRegister(0x030d)           //  =
|   |-> RegGetOneRegister(0x030e)           //  =
|   |-> RegSetOneRegister(0x030e)           //  =
|   |-> RegSetOneRegister(0x0314)           //  =
|   |-> RegGetOneRegister(0x0002)                                 // soft reset
|   |-> RegSetOneRegister(0x0002, rdData&0xFE)                    //    =
|   |-> Sleep(20)                                                 //    =
|   |-> RegSetOneRegister(0x0002, RegGetOneRegister(0x0002)|0x01) //    =
|   |-> 
|   |-> 
|   |-> 
|-> RegSetOneRegister(0x0002, RegGetOneRegister(0x0002)&0xFE)   // reset FAT
|-> Sleep(20)                                                   //     =
|-> RegSetOneRegister(0x0002, RegGetOneRegister(0x0002)|0x01)   //     =

CLGDT3304Dlg::OnTimer   // LGDT3304Dlg.cpp
|-> lock_check()
|   |-> lgdt3304Carriercheck()
|   |-> lgdt3304inlockcheck()
|   |-> lgdt3304Errorcheck()
|   |-> lgdt3304trlockcheck()
|   |-> lgdt3304_SignalStatus()
|   |-> 
|   |->
|   |->
|_> CDialog::OnTimer()

}}}
}}}

Scopus 8vsb card {{{
The card has 4 NIMs of TDVS-H081P w/ demodulator LGDT3304 and tuner TUA6039
The i2c expander (pca9535) should be configured to reach certain nim on the 
board.
to reach nim #1 set reg 6 of i2c expander to 0xfc and reg 2 to 
0xfc+<nim nbr> (1,2,3,4).
LEDs: 
when i2 expander config to MIM 1 (reg 0x2 val 0xfc) there are LES:
LED2 - on, yellow
LED3 - on, green
when i2 expander config to MIM 2 (reg 0x2 val 0xfd) there are LES:
LED2 - off
LED3 - on, green
when i2 expander config to MIM 3 (reg 0x2 val 0xfe) there are LES:
LED2 - on, yellow
LED3 - off
when i2 expander config to MIM 4 (reg 0x2 val 0xff) there are LES:
LED2 - off
LED3 - off
}}}

8VSB
ATSC - 
DTV - Digital TV

8VSB Reception feature

Intro
8VSB is the 8-level vestigial sideband modulation method adopted for 
terrestrial broadcast of the ATSC digital television standard in the 
United States, Canada, and other countries.

}}}
024. Implement control of syslogd {{{
    17aug2008
story 1227
IRP outputs its log messages via Syslog.
IRP application should be able to configure via the CLI logging to 3 different destinations:
1) To console; parameters: enabled/disabled, minimal severity
2) To file; parameters: enabled/disabled, minimal severity, file name
3) To "network"; parameters: enabled/disabled, minimal severity, IP address
 
Only one network logging destination will be supported.
It will be great to limit the logfile size.

Solution:
The config file, placed at /etc/syslog.conf ca have 3 different config lines.
To redirect output to network `*.* @10.2.1.41', to console `*.* /dev/console',
to file `*.* <file path>'
The `*.*' is `<facility>.<priority>' Sometimes priority, called severity. The 
facility is the source of logging, like mail server, etc. The priority can be:
debug, info, notice, warning, err, crit, alert, emerg|panic.
While `debug' priority, all options available, if `crit' - only `crit', `alert'
and `emerg'.

}}}
025. Additional control for 8VSB {{{
    07sep2008
x   1. Set Demodulator low threshold (DMSELOWTH[2:0])
x   2. Read Carrier recovery frequency offset (CRFREQO[23:0])
x   3. Ability to change Gated/Fixed mode of Transport Clock Mode (0x050e)
x   4. Read SNR level status (SNRGOOD 0x0003[0])
x   5. set control err flag (TPERRINS 0x050e[1])
?   6. Set Tuner by freq, not equals to channel
    done 09sep2008
}}}
026. Upgrade of mainboard Spartan + common upgrade changes {{{
    10sep2008
x   1. Ability to upgrade MB Spartan
x   2. Check for available space before untar
x   3. Make 'upgrade' user's home dir '/opt/ftp'
x   4. Disable anonymous ftp
x   5. No delete for upgrade user
    6. Add MD5 checksum
x   7. CLI switch to permit Spartan upgrade
}}}
027. Reset PHY of eth0 at boot {{{
    18sep2008
Problem: no ping at temp -20C
Solution: to add phy reset, like at u-boot
from u-boot src emac_adapter.c
XEmac_Initialize()
irpResetPhy()
|-> XEmac_PhyReset
|                   Autonegotiation
|-> XEmac_PhyRead 
|-> XEmac_PhyWrite
|                   Statua

from kernel
xemac_probe()   (from drivers/net/xilinx_emac/adapter.c)
|-> ...
|-> XEmac_CfgInitialize()
|   |-> ...
|   |-> XEmac_Reset()
|-> ...
|-> dm9161Init()
|   |-> ADDED follows
|   |   printk(KERN_INFO "PHY RESET\r\n");
|   |   XEmac_PhyReset(&lpIn->Emac);
|   |   mdelay(3000);

}}}
028. Ability to set Ofek env with number of options {{{
    18sep2008
Added to greader as command line option "--ofek_append"
}}}
029. Load IRP w/ 8 inputs {{{
    07oct2008
Gets Spartan aa27 and Virtex 8-10-2-1 from 27oct2008

Issues:
x   1. While running irpd.elf , lots of i2c errors.
    Fixed - the register where optional cards discovered changed.

Change HwMngr to recognise optional cards from new register 57, where
bit 30 for bottom card and 31 - top.

}}}
030. Adding cold reset to IRP w/ 8inputs {{{
    29oct2008
Here, reset which forces the Spartan to reread Virtex code from flash after
reboot.
The cold reset could be done if to write 0x4567 to address 0x9020000e.
Solution:
Changes in gutildrv module to accept ioctl which can cause the writing.
Ability of greader to send the ioctl.

the oroginal call to cold reset placed at arch/ppc/syslib/ppc4xx_setup.c
func ppc4xx_restart()

}}}
031. Add gold version for FPGA and Uboot {{{
    1. Need changed FPGA, because u-boot address is hardcoded there.
    2. How fpga knows which u-boot to start
    3. How spartan knows which virtex to start

--- Changes
        Firmware
new spartan.bin-B029
        Apps
//irp/dev/sw/cfgmgr/src/req_map_misc.cpp#62
//irp/dev/sw/cli/xml/gjobs.xml#217
//irp/dev/sw/common/inc/config_attr_data.h#260
//irp/dev/sw/upg_mngr/inc/upg_mngr.h#20
//irp/dev/sw/upg_mngr/src/upg_mngr.cpp#27
//irp/dev/sw/upg_mngr/src/upg_mngr_msgs.cpp#1
        Kernel
//irp/montavista/devrocket2.0/dev/irp-bsp.1/drivers/mtd/maps/mtd405.c#8
        U-Boot
//irp/linux-add-ons/scripts/buboot.sh#9
//irp/u-boot/dev/board/xilinx_irp/front_panel/fp_adapter.c#2
//irp/u-boot/dev/board/xilinx_irp/front_panel/fp_adapter.h#1
//irp/u-boot/dev/board/xilinx_irp/ml405/config.mk#2
//irp/u-boot/dev/board/xilinx_irp/ml405/Makefile#2
//irp/u-boot/dev/board/xilinx_irp/xilinx_enet/emac_adapter.c#4
//irp/u-boot/dev/common/devices.c#2
//irp/u-boot/dev/common/main.c#1
//irp/u-boot/dev/include/version.h#3
//irp/u-boot/dev/lib_ppc/board.c#5
    Packaging & scripts
//irp/app-examples/u-boot/burn_gold.script#1
//irp/linux-add-ons/scripts/package.sh#4
//irp/linux-add-ons/scripts/irpsys.sh#63
//irp/linux-add-ons/target-scripts/etc/init.d/rcS#42
}}}
032. RESET redesign {{{
    12nov2008
Solution:
    The ConfigMngr gets request to reset and sends event to EventMngr. The 
CnfgMngr waits for answer after which call API to IRP suicide and set some 
member (m_Options) to remember.
The Launch after gets out from main loop, asks CnfgMngr for this option. At the
end if the option has reset such should be done.

17nov2008
Reset kills app, but doesn't reset OS.
Solution: Not to suicide IRP, but to go out from main loop.
Released changelist 40515 w/ fix.

}}}
033. Support Watchdog {{{
    20nov2008
Ability to stop/start and reset IRP watchdog.
Start wd:  write 1 to 0x90200006 bit 11
Stop wd:   write 0 to 0x90200006 bit 11
Feed wd:   write any to 0x9020002a

To check wd from uboot:
--- read addr
md 0x9020000c
--- disable wd (switch 11 bit on)
mw 0x90200006 0xf3ffabcd
--- enable wd (switch 11 bit on)
mw 0x90200006 0xfbffabcd
--- feed wd
mw 0x9020002a 0x1

Solution:

The kernel watchdog which is kernel timer for 30secs. Works till the app stops
it. The app level watchdog, simply thread with sleep for 30secs.

Added new kernel modules wd which using kernel timer w/ timeout 30sec. All
commands from procfs file /proc/wd/ctl

Flows:
--- System started w/o watchdog.
Enable wd `echo 1 > /proc/wd/ctl`. This is wd w/o kwd support, so if the
app not runs - will be reset.
Enable wd `echo 1 > /proc/wd/ctl` and enable kwd `echo 4 > /proc/wd/ctl` will
keep the system running, because kwd will work every 30sec. To disable kwd
`echo 5 > /proc/wd/ctl` will reset the system max after 30secs.
If kwd enabled and app starts - it's stops kwd and keep feeding alone.

Changed files:
//irp/dev/sw/unit_mngr/inc/unit_mngr.h#23 - edit default change (text)
//irp/dev/sw/unit_mngr/src/unit_mngr.cpp#46 - edit default change (text)
//irp/linux-add-ons/drivers/gutildrv/gutilmod.c#24 - edit default change (text)
//irp/linux-add-ons/drivers/gutildrv/gutilmod.h#18 - edit default change (text)
//irp/linux-add-ons/target-scripts/etc/init.d/rcS#44 - edit default change (text)
//irp/linux-add-ons/target-scripts/irp/start.sh#13 - edit default change (xtext)
//irp/montavista/devrocket2.0/dev/irp-bsp.1/.config-dev#14 - edit default change (text)
//irp/montavista/devrocket2.0/dev/irp-bsp.1/drivers/scopus/Kconfig#4 - edit default change (text)
//irp/montavista/devrocket2.0/dev/irp-bsp.1/drivers/scopus/Makefile#4 - edit default change (text+w)
//irp/montavista/devrocket2.0/dev/irp-bsp.1/drivers/scopus/watchdog/Makefile#1 - add default change (text+w)
//irp/montavista/devrocket2.0/dev/irp-bsp.1/drivers/scopus/watchdog/wd.h#1 - add default change (text)
//irp/montavista/devrocket2.0/dev/irp-bsp.1/drivers/scopus/watchdog/wd_drv.c#1 - add default change (text)

}}}
034. Create Network manager {{{
    10dec2008

Create network manager controls all 4 IRPs network devices from PHY to socket
level.

New files placed at net_mngr

}}}
035. Merge of HwMngr and UnitMngr {{{
    10dec2008
    All HwMngr apis moved to UnitMngr, except management port and phy control -
moved to NetMngr.
Decided (Akiva 11dec2008) not to use queue and messaging of UnitMngr.

}}}

Frontend to support DVBS_STM card {{{
    05jun2007 23dec2007 15sep2008 16nov2008

    FE recognition
The Spartan register (0x6 for write; 0xc for read) bit 10 tells if 4 streams
goes to mainboard or only 1.
4 streams:  write 0 to 0x90200006 bit 10
1 stream:   write 1 to 0x90200006 bit 10


DVB-S STM (qpsl29b) card {{{

    To support DVBS_STM card wit STB6000+STV0288+LNBP21.

i2c addrs:
0x08    LNB
0x60    Tuner
0x68    Demod

--- STB6000 {{{
from "STB600 datasheet.pdf"
STB6000 is direct conversion tuner, which includes LNA, downconverting mixer, 
baseband low pass filter, gain control (AGC), on-chip VCO and low noise PLL. It
is suited for low symbol rate applications.
Input range 950 - 2150 MHz
i2c addr 0x60
registers:
    There are 11 regs rw (sub-addr 0x01 - 0x0b). Another 3 ro regs (0x00, 0x0c,
0x0d).

Reg     Addr MSB  Control byte                         LSB
-------------------------------------------------------------
LD      0x00 -    - - - - - -                          LD
VCO     0x01 OSCH OCK1 OCK0 ODIV OSM3 OSM2 OSM1        OSM0
N       0x02 N8   N7 N6 N5 N4 N3 N2                    N1
A       0x03 N0   1 1 A4 A3 A2 A1                      A0
K_R     0x04 K1   K0 R5 R4 R3 R2 R1                    R0
G       0x05 0    0 0 0 G3 G2 G1                       G0
F       0x06 1    0 0 F4 F3 F2 F1                      F0
FCL     0x07 1    1 DLB2 DLB1 DLB0 FCL2 FCL1           FCL0
Test1   0x08 1    1 0 1 0 0 0                          0
Test2   0x09 0    1 0 1 0 0 0                          0
LPEN    0x0a 1    PD0 PD1 LPEN 1 0 1                   1
XOG     0x0b XOG  XOGV 0 0 1 PD2 PD3                   1

reg LD
    if LSB bit os 1 - PLL locked, otherwise not locked

reg VCO

}}}
--- STV0288 {{{
from "288 datasheet.pdf"
STV0288 has analog to digital converter, QPSK demodulator, forward error
correction (FEC).
}}}
--- LNB21P {{{
from "LNBP21ver2_2.pdf"
LNBP21 is monolitic voltage regulator, designed to provide power 13/18V and 22KHz
tone signalling to the LNB downconverter.
Downconvert C or Ku bands to L band.
}}}

The PLL provides sample clock for both Analog-to-Digital converters. The values
are 135MHz (def) or 100MHz.
The are 2 equal input ports on the card.
}}}

from IRD2900 {{{
FrontEnd flows {{{
Initialization (FeNIMSAT2Tuner::FeNIMSAT2Tuner()) {{{
>   Prepare to set PLLCTRL to 0x86/0x33 depend on Mlck 135/100
>   Prepare n set board parameters (FeNIMSAT2Tuner::PowerUpInitParam())
        Select input port
        Hardware reset
        Prepare to set board type parametrs (FeNIMSAT2Tuner::set_PUValues())
            Calculate master clock freq (Hz) and derotator clock freq, which is 
                master clock / 65536
            Prepare to set LNB mode (FeNIMSAT2Tuner::set_LNB_mode())
                The LNB must be set power-off and after power-on after every reset
            Prepare to set Viterbi rate (FeNIMSAT2Tuner::set_VITERBI_mode())
            Prepare to set spectral mode (FeNIMSAT2Tuner::set_SPECTRAL_mode())
            Prepare to set symbol rate
            Prepare to set tuner freq
        Set LNB registers (call FeSTQpskDrv::ifFeDrvControl(eLnbWriteReg,...))
        Set symbol rate (FeNIMSAT2Tuner::ifSetFeSymRate())
            set SFRH, SFRM and SFRL (FeNIMSAT2Tuner::set_SymbolRate())
            ...
        Init all stv289 regs (call FeSTQpskDrv::ifFeDrvControl(eWriteReg,...))
        Prepare and set tuner freq (FeNIMSAT2Tuner::ifSetFeFrequency() ->
            FeNIMSAT2Tuner::set_Frequency())
            ... (see below - Set tuner freq)
        Because some unknown reason after front-end reset the LNB must
            be set power off and after set on.
        Start SCP-SAT optimize lock algorithm
        Set no locked mode.
-------- }}}

DVBS_STM write to tuner
open i2c bus file
enable i2c to tuner
write
disable i2c to tuner

}}}
IRD FrontEnd code flow {{{

Types (app_sys/public/rtdb_fe_x.h):
{{{
FrontEndAppInit_S - app structure
FrontEndAppRunTimeParam_S - app structure for configuration
FrontEndRunTimeStatus_S - app structure for status
STRUCT_SatelliteEntry - rtdb structure for configuration
STRUCT_SatelliteStatusEntry - rtdb structure for status
InternalRunTimeData_S (app_fe/include/fe_stqpsk_p.h) - member of class FeNIM1278Tuner
SearchParam_S (app_fe/include/fe_stqpsk_p.h) - member of class FeNIM1278Tuner
}}}
build/usrAppInit.c
app_sys/main/ird_main.c
app_sys/main/ird_app_init.cpp
StreamControllerlInit() (app_extmdl/stream_cntrl/stream_main_cntrl.cpp)
FrontEndInterfaceInit() (app_fe/fe_main.cpp)
FrontEnd::getInstance()
FrontEnd::FrontEnd() (from fe_main.cpp)
|-> rtdbiGetFrontEndAppInitParam() (app_fe/fe_rtdb.cpp)
|   |_> gets hw params
|-> semMCreate() - create semaphore between front-end and main execution tasks
|-> CMsgDispatcherApplet::CMsgDispatcherApplet() (msg_dispatcher.cpp)
|   |_> execmoRegisterAppletObj()
|-> FrontEndCreator_ECC3100() (app_fe/ecc3100/fe_ecc3100_creator.cpp)
|   |-> CFeTunerEcc3100Module::CFeTunerEcc3100Module() (app_fe/ecc3100/fe_ecc3100_module.cpp)
|   |   |   {{{
|   |   |-> get FrontEnd app init params (FrontEndAppInit_S)
|   |   |-> reset MAIN_RESET
|   |   |-> FrontEndDrvInit(FeType_E, FrontEndGenericDrv) (drv_ird/frnt_end/fe_drv.cpp)
|   |   |   |   {{{
|   |   |   |-> new_FeEcc3100Drv() (drv_ird/frnt_end/fe_ecc3100_drv.cpp)
|   |   |   |   |-> FeEcc3100Drv::FeEcc3100Drv() (drv_ird/frnt_end/fe_ecc3100_drv.cpp)
|   |   |   |       |_> FeEcc3100Drv::PowerUpInit()
|   |   |   |           |_> set init state for GPIO - ifFeDrvControl(eGPOInit, NULL)
|   |   |   |   }}}
|   |   |-> FeEcc3100Tuner::FeEcc3100Tuner() (app_fe/ecc3100/fe_ecc3100_tuner.cpp)
|   |   |   |   {{{
|   |   |   |-> FeEcc3100Tuner::PowerUpInitParam() (app_fe/ecc3100/fe_ecc3100_tuner.cpp)
|   |   |   |   |   {{{
|   |   |   |   |-? FeNIMSAT2Tuner::PowerUpInitParam() (app_fe/stqpsk/fe_nimsat2_high.cpp)
|   |   |   |   |   |-> ... 
|   |   |   |   |-> CFeTunerEcc3100Module::Reset() (app_fe/ecc3100/fe_ecc3100_module.cpp)
|   |   |   |   |   |-> fFeDrvControl(eGPOResetDvbS2)
|   |   |   |   |   |-> delay 50msec
|   |   |   |   |   |-> fFeDrvControl(eGPORunDvbS2)
|   |   |   |   |   |_> delay 20msec
|   |   |   |   |   reset dvbs2 (eGPOResetDvbS2, eGPORunDvbS2)
|   |   |   |   |   reset dvbs2 (eGPOResetDvbS2, eGPORunDvbS2)
|   |   |   |   |-> FeEcc3100Tuner::write_zif_PUValues() - init dvbs2 tuner
|   |   |   |   |   |_> using ZIFCE5038_SetValue[][] and write to zif
|   |   |   |   |       ifFeDrvControl(eZifS2WriteReg, ...)
|   |   |   |   |-> ifFeDrvControl (eGPOEnI2CDVBS2) - dvbs2 powerup
|   |   |   |   |-> load SKY LUT
|   |   |   |   |-> init SKY demod
|   |   |   |   |-> load SKY transport regs
|   |   |   |   |-> fFeDrvControl(eGPODisI2CDVBS2) - disable DVBS2
|   |   |   |   |-> ifSetFeFrequency() (app_fe/ecc3100/fe_ecc3100_tuner.cpp)
|   |   |   |   |   |-> get FrontEndAppRunTimeParam_S from rtdb
|   |   |   |   |   |-> set DVBS tuner freq
|   |   |   |   |   |-> set_Frequency() (app_fe/ecc3100/fe_ecc3100_low.cpp)
|   |   |   |   |   |-> ...
|   |   |   |   |
|   |   |   |   |
|   |   |   |   |   }}}
|   |   |   |-> FeNIMSAT2Tuner::FeNIMSAT2Tuner() (app_fe/stqpsk/fe_nimsat2_high.cpp)
|   |   |   |   |   {{{
|   |   |   |   |-> FeNIMSAT2Tuner::PowerUpInitParam()
|   |   |   |   |-> ...
|   |   |   |       }}}
|   |   |   |_> save status (FrontEndRunTimeStatus_S)
|   |   |       rsber, signal level n signal corel level
|   |   |       }}}
|   |   |_> create FE LNB app (app_fe/lnb/lnb_app.cpp)
|   |   |   FrontEndGenericLnb::FrontEndGenericLnb() 
|   |   |   |-> ...
|   |   |   }}}
|   |_> CMsgDispatcherApplet::Attach() (msg_dispatcher.cpp)
|       |_> see common flows
|
|-> FrontEndCreator_STQpsk() (app_fe/stqpsk/fe_stqpsk_creator.cpp)
|   |->CFeTunerSTQpskModule::CFeTunerSTQpskModule() (stqpsk/fe_stqpsk_module.cpp)
|   |  | {{{
|   |  |-> get FrontEnd App init params - rtdbiGetFrontEndAppInitParam()
|   |  |-> FrontEndDrvInit(FeType_E, FrontEndGenericDrv) (drv_ird/frnt_end/fe_drv.cpp)
|   |  |   |   {{{
|   |  |   |-> new_FeSTQpskDrv() (fe_stqpsk_drv.cpp)
|   |  |   |   |_> FeSTQpskDrv::FeSTQpskDrv() (fe_stqpsk_drv.cpp)
|   |  |   |       |_> FeSTQpskDrv::PowerUpInit() - do nothing
|   |  |   |_> ... }}}
|   |  |-> FeNIMSAT2Tuner::FeNIMSAT2Tuner() (fe_nimsat2_high.cpp)
|   |  |   |   {{{
|   |  |   |-> hwcfgGetIrdHwConfig() (app_sys/hw_cntrl/hwcfg.cpp)
|   |  |   |-> set PLL to generate master clock for sampling freq (100/135MHz),
|   |  |   |   stv288 reg PLLCTRL=0x86 for 135 and PLLCTRL=0x63 for 100MHz
|   |  |   |-> set runtime status (FrontEnd_status) for
|   |  |   |   modulation=QPSK, rolloff=35 and pilots=off
|   |  |   |   
|   |  |   |_> FeNIMSAT2Tuner::PowerUpInitParam() (fe_nimsat2_high.cpp)
|   |  |       |-> rtdbiGetSatelliteAppRunTimeParam()
|   |  |       |-> lock
|   |  |       |-> hwReadXlnx1()
|   |  |       |-> hwWriteXlnx1() - set input port
|   |  |       |-> intUnlock()
|   |  |       |-> CFeGenericModule::Reset
|   |  |       |   |   {{{
|   |  |       |   |-> hwResetControl() (drv_ird/hw/hwreset.cpp)
|   |  |       |   |   |_> FrontEndResetControl() (drv_ird/hw/hwreset.cpp)
|   |  |       |   |       |-> GPOSetMode()
|   |  |       |   |       |-> GPOSetInputOutput()
|   |  |       |   |       |_> GPOWrite()
|   |  |       |   |-> taskDelay(50ms)
|   |  |       |   |-> hwResetControl()
|   |  |       |   |_> taskDelay(20ms) }}}
|   |  |       |-> set_PUValues() - set board type parameters (fe_nimsat2_high.cpp)
|   |  |       |   |   {{{
|   |  |       |   |-> calc_MasterClkFrequency() (fe_nimsat2_low.cpp) - set master clock
|   |  |       |   |-> rtdbiGetSatelliteAppRunTimeParam()
|   |  |       |   |-> FeNIMSAT2Tuner::set_LNB_mode() (fe_nimsat2_low.cpp) - set polarity
|   |  |       |   |   and power-off-on, hi/low band
|   |  |       |   |-> set_VITERBI_mode() - viterbi rate
|   |  |       |   |-> set_SPECTRAL_mode() - spectral inversion rate
|   |  |       |   |-> symbol rate
|   |  |       |   |_> cmSetSatelliteFrequency() - tuner frequency 
|   |  |       |       (app_sys/cnfg_mngr/conf_mngr.cpp)
|   |  |       |       |-> rtdbFeGetSatelliteEntry()
|   |  |       |       |-? CFeTunerUtil::feGetLbandFrequency()
|   |  |       |       |-> rtdbFeSetSatelliteEntry()
|   |  |       |       |-> CFeTunerUtil::feRestartTunerNewFreq()
|   |  |       |       |   |_> CFeTunerUtil::feRestartTunerNewParam()
|   |  |       |       |       |_> execmGenerateNewSystemEvent(eSetTunerFrequency)
|   |  |       |       |_? CFeTunerUtil::feRestartTunerNewLnbBand()
|   |  |       |           |_> CFeTunerUtil::feRestartTunerNewParam()
|   |  |       |               |_> execmGenerateNewSystemEvent(eSetTunerLnbBand)
|   |  |       |       }}}
|   |  |       |-> ifSetFeSymRate() (app_fe/stqpsk/fe_nimsat2_high.cpp)
|   |  |       |-> set all demod regs (STV0288_Register)
|   |  |       |   FeSTQpskDrv::ifFeDrvControl() (drv_ird/frnt_end/fe_stqpsk_drv.cpp)
|   |  |       |-> ifSetFeFrequency() (app_fe/stqpsk/fe_nimsat2_high.cpp)
|   |  |       |-> reset LNB
|   |  |       |   ifFeDrvControl (eLnbWriteReg, LNBP21_Register);
|   |  |       |-> task delay for 10msec
|   |  |       |-> request_SetOptimize()
|   |  |       |-> request_WrOptimize()
|   |  |       |_> number of funcs calls xilinx fpga
|   |  |       }}}
|   |  |_> FrontEndGenericLnb::FrontEndGenericLnb() (app_fe/lnb/lnb_app.cpp)
|   |      |   {{{
|   |      |-> set FrontEnd App init (FrontEndAppInit_S) for LNB type
|   |      |-? GenericDiSeqC::GenericDiSeqC() (diseqc_gen_app.cpp) - do nothing
|   |      |-? DiSeqC1::DiSeqC1() (diseqc1_app.cpp) - do-nothing
|   |      |_? DiSeqC2::DiSeqC2() (diseqc2_app.cpp) - do nothing }}}
|   |    }}}
|   |_> CMsgDispatcherApplet::Attach() (msg_dispatcher.cpp)
|       |_> see common flows
|_> taskSpawn()
    |   |-> FrontEndTaskCarrier() (fe_main.cpp)
    |-> CModuleBIT_FE::CModuleBIT_FE() (fe_main.cpp)
    |_> CFeTunerSTQpskModule::FePeriodicTaskHndlr() (fe_stqpsk_module.cpp)
        |   {{{
        |-> self suspend
        |-> task delay for 50ms
        |-> FeNIMSAT2Tuner::ifExecLnbCmnd() (fe_nimsat2_high.cpp)
        |   |   {{{
        |   |-> rtdbiGetSatelliteAppRunTimeParam() (rtdb_fe.cpp)
        |   |   |-> rtdbFeGetSatelliteEntry() (app_sys/rtdb/rtdb_fe.cpp)
        |   |   |   freq, symrate, lnbpolarity, lnbband, lnbtoneMod, fecRate,  
        |   |   |   SpectrInv, LnbDiSeqCType, DriftComp, MdltType, RollOffFactor,
        |   |   |   Pilots, InputPort, OutputStreamID
        |   |   |_> rtdbGetInputStreamIdentifier()
        |   |-> FeSTQpskDrv::ifFeDrvControl() (drv_ird/frnt_end/fe_stqpsk_drv.cpp)
        |   |   set LNB polarity
        |   |_> FeSTQpskDrv::ifFeDrvControl() (drv_ird/frnt_end/fe_stqpsk_drv.cpp) 
        |       set LNB band (high/low)  }}}
        |-> FrontEndGenericLnb::ifExecLnbCmnd() (lnb_app.cpp)
        |   |   {{{
        |   |-> rtdbiGetSatelliteAppRunTimeParam()
        |   |_? FeSTQpskDrv::ifFeDrvControl() - set polarity and band
        |       |follow events (eLnbPowerOff, eLnbPowerOn, eLnbHiBand,
        |       |eLnbLowBand, eLnbVerticalPolar, eLnbHorizPolar) call for
                |       |eLnbWriteReg. Also event eLnbReadReg.
        |       |-> open()
        |       |-> ioctl()
        |       |-> ioctl()
        |       |-> write()
        |       |_> close() }}}
        |-> task delay for 50ms
        |-> busyloop - take sem
        |-> FeNIMSAT2Tuner::ifOptimFeLockPeriodicProc() (fe_nimsat2_high.cpp)
        |   |   {{{
        |   |-> FeNIMSAT2Tuner::Optimize_lock() (fe_nimsat2_low.cpp)
        |   |   |-> ...
        |   |   |-> search_stateMachine()
        |   |-> FeNIMSAT2Tuner::get_ReceiverStatus (fe_nimsat2_low.cpp)
        |   |   |-> get FE app runtime params
        |   |   |-> FeNIMSAT2Tuner::ReadVSTATUS() (app_fe/stqpsk/fe_nimsat2_low.cpp)
        |   |   |   |_> ifFeDrvControl() - read demod reg VSTATUS
        |   |   |-> update fec_rate for (FrontEndRunTimeStatus_S FrontEnd_status)
        |   |   |-> ...
        |   |   |-> ...
        |   |_> FeNIMSAT2Tuner::Frequency_search() (fe_nimsat2_low.cpp)
        |       |_> ... }}}
        |_> release sem }}}
    |_> CFeTunerEcc3100Module::FePeriodicTaskHndlr() (app_fe/ecc3100/fe_ecc3100_module.cpp)
        |   {{{
        |-> self suspend
        |-> delay 1 sec
        |-> FeEcc3100Tuner::ifExecLnbCmnd()
        |-> FrontEndGenericLnb::ifExecLnbCmnd()
        |-> delay 100msec
        |-> busyloop - take sem
        |-> FeEcc3100Tuner::ifOptimFeLockPeriodicProc() (app_fe/ecc3100/fe_ecc3100_tuner.cpp)
        |   |-> get FE app runtime params
        |   |-> if QPSK call FeNIMSAT2Tuner::ifOptimFeLockPeriodicProc()
        |   |-> else
        |   |--> Optimize_lock()
        |   |--> get_ReceiverStatus()
        |   |--> Frequency_search()
        |_> release sem }}} 

ExecMngrTask() (app_sys/exec_mngr/execmo.cpp)
|   {{{
|-> ...
|->>msgQReceive()
|_>>pMessagePars()==RunTimeProcess()
    |-> ...
    |-> AppletObj[][]->AppletProcFunc() (app_fe/msg_dispatcher.cpp)
    |   |-> eventFltrEventGroup()
    |   |-> CMsgDispatcherApplet::Notify()
        |       |       |-> semTake() for 2sec
        |       |       |-> finds pair w/ appropriate event and call pair's Update()
    |   |   |   DVBS_STM
    |   |   |   | {{{
        |       |       |   CFeTunerSTQpskModule::mtSetFrequency() (app_fe/stqpsk/fe_stqpsk_module.cpp)
    |   |   |   |   {{{
    |   |       |       |-> CFEGenericTuner::ifSetStreamSourceDisable()
    |   |       |       |   |_> execmGenerateNewSystemEvent(eEventFrontEndStreamStatusChanged)
    |   |       |       |               (app_fe/fe_tuner.cpp)
        |       |       |       |-> FeNIMSAT2Tuner::ifSetFeFrequency()
    |   |   |   |   |   {{{
        |       |       |       |   |-> rtdbiGetSatelliteAppRunTimeParam() for Frequency
        |       |       |       |       |_> FeNIMSAT2Tuner::set_Frequency() (fe_nimsat2_low.cpp)
        |       |       |       |               |-> FeNIMSAT2Tuner::write_zif_registers() (fe_nimsat2_low.cpp)
        |       |       |       |               |_> ... }}}
        |       |       |       |_> eNIMSAT2Tuner::ifRestartLockOptimize(eRestartNoFreq) (fe_nimsat2_high.cpp)
    |   |   |       |   {{{
        |       |       |        |-? FeNIMSAT2Tuner::set_Frequency() (fe_nimsat2_low.cpp)
        |       |       |               |-> FeNIMSAT2Tuner::request_SetOptimize() (fe_nimsat2_low.cpp)
        |       |       |               |_> FeNIMSAT2Tuner::request_WrOptimize()
        |       |       |                       |-> FeNIMSAT2Tuner::SetERROR_CONTROL()
        |       |       |                       |-> FeNIMSAT2Tuner::calc_SearchTimeConstants()
        |       |       |                       |-> FeNIMSAT2Tuner::set_SymbolRate()
        |       |       |                       |_> STAMP() set OPTLock_Delay and OPTtrack_stamp
    |   |   |               |_> tickGet()  }}}  }}}
    |   |       |       CFeTunerSTQpskModule::mtSetSymbolRate()
    |   |   |   |   {{{
    |   |   |   |_> ... }}}
    |   |       |       CFeTunerSTQpskModule::mtSetFecRate()
    |   |   |   |   {{{
    |   |   |   |-> CFEGenericTuner::ifSetStreamSourceDisable()
    |   |   |   |-> FeNIMSAT2Tuner::ifSetFeFecRate()
    |   |   |   |_> FeNIMSAT2Tuner::ifRestartLockOptimize(eRestartAll) }}}
    |   |       |       CFeTunerSTQpskModule::mtSetSpectralInvers()
    |   |   |   |   {{{
    |   |   |   |_> ... }}}
    |   |       |       CFeTunerSTQpskModule::mtSetInputPort()
    |   |   |   |   {{{
    |   |   |   |_> ... }}}
    |   |       |       CFeTunerSTQpskModule::mtSetFreqScan()
    |   |   |   |   {{{
    |   |   |   |_> ... }}}
    |   |       |       CFeTunerSTQpskModule::mtSetLnbPolar()
    |   |   |   |   {{{
    |   |   |   |-> CFEGenericTuner::ifSetStreamSourceDisable
    |   |   |   |-> FeEcc3100Tuner::ifExecLnbCmnd() (app_fe/ecc3100/fe_ecc3100_tuner.cpp)
    |   |   |   |   |-> get satellite app runtime params (FrontEndAppRunTimeParam_S)
    |   |   |   |   |_> FeNIMSAT2Tuner::ifExecLnbCmnd() - call DVBS tuner
    |   |   |   |-> FrontEndGenericLnb::ifExecLnbCmnd() (app_fe/lnb/lnb_app.cpp)
    |   |   |   |   |-? FeEcc3100Drv::ifFeDrvControl() - set LNB polarity
    |   |   |   |   |_? FeEcc3100Drv::ifFeDrvControl() - set LNB band (low/high)
    |   |   |   |_> ifRestartLockOptimize(eRestartAll) }}}
    |   |       |       CFeTunerSTQpskModule::mtSetLnbBand()
    |   |   |   |   {{{
    |   |   |   |_> ... }}}
    |   |       |       CFeTunerSTQpskModule::mtSetDiSeqCProtocol()
    |   |   |   |   {{{
    |   |   |   |_> ifSetLnbDiSEqCInterfaceType() }}}
    |   |   |   }}}
    |   |   |   DVBS2_ECC
    |   |   |   |   {{{
    |   |   |   |-> CFeTunerEcc3100Module::mtSetFrequency()
    |   |   |   |   |-> CFEGenericTuner::ifSetStreamSourceDisable()
    |   |   |   |   |-> FeEcc3100Tuner::ifSetFeFrequency() (app_fe/ecc3100/fe_ecc3100_tuner.cpp)
    |   |   |   |   |_> FeEcc3100Tuner::ifRestartLockOptimize() (app_fe/ecc3100/fe_ecc3100_tuner.cpp)
    |   |   |   |-> CFeTunerEcc3100Module::mtSetSymbolRate
    |   |   |   |-> CFeTunerEcc3100Module::mtSetFecRate
    |   |   |   |-> CFeTunerEcc3100Module::mtSetSpectralInvers
    |   |   |   |-> CFeTunerEcc3100Module::mtSetInputPort
    |   |   |   |-> CFeTunerEcc3100Module::mtSetFreqScan
    |   |   |   |-> CFeTunerEcc3100Module::mtSetModulation
    |   |   |   |-> CFeTunerEcc3100Module::mtSetRollOff
    |   |   |   |-> CFeTunerEcc3100Module::mtSetPilots
    |   |   |   |-> CFeTunerEcc3100Module::mtScrambleSeed
    |   |   |   |-> CFeTunerEcc3100Module::mtSetLnbPolar
    |   |   |   |-> CFeTunerEcc3100Module::mtSetLnbBand
    |   |   |   |-> CFeTunerEcc3100Module::mtSetDiSeqCProtocol
    |   |   |   |_> ... }}}
        |       |       |_> semGive
        }}}

--- Common flows
CMsgDispatcherApplet::Attach() (msg_dispatcher.cpp)
|      {{{ add to observer pairs
|      eRunControlProcFe, COpenHandler::COpenHandler()
|      eStopControlProcFe, CCloseHandler::CCloseHandler()
|      eRunControlProcAsi, CCloseHandler::CCloseHandler()
|      eRunControlProcRs422, CCloseHandler::CCloseHandler()
|      eRenewTrnspStrmSrcAsi, CCloseHandler::CCloseHandler()
|      eRenewTrnspStrmSrcRs422, CCloseHandler::CCloseHandler()
|      eStopControlProcAsi, CCloseHandler::CCloseHandler()
|      eStopControlProcRs422, CCloseHandler::CCloseHandler()
|   
|      eSetTunerFrequency, CSetFrequencyHandler::CSetFrequencyHandler()
|      |_> CFeTunerSTQpskModule::mtSetFrequency()
|      eSetTunerSymRate, CSetSymbolRateHandler::CSetSymbolRateHandler()
|      |_> CFeTunerSTQpskModule::mtSetSymbolRate()
|      eSetTunerVitrbiRate, CSetVitrbiHandler::CSetVitrbiHandler()
|      |_> CFeTunerSTQpskModule::mtSetFecRate()
|      eSetTunerSpctrlInv, CSetSpectralInversHandler::CSetSpectralInversHandler()
|      |_> CFeTunerSTQpskModule::mtSetSpectralInvers()
|      eSetFrontEndInput, CSetSetInputPortHandler::CSetSetInputPortHandler()
|      |_> CFeTunerSTQpskModule::mtSetInputPort()
|      eSetTunerFrequencyScanBand, CSetFreqScanBandHandler::CSetFreqScanBandHandler()
|      |_> CFeTunerSTQpskModule::mtSetFreqScan(1)
|      eSetTunerFrequencyScan6MHz, CSetFreqScan6MHzHandler::CSetFreqScan6MHzHandler()
|      |_> CFeTunerSTQpskModule::mtSetFreqScan(2)
|   
|      eSetTunerLnbPolar, CSetLnbPolarHandler::CSetLnbPolarHandler()
|      |_> CFeTunerSTQpskModule::mtSetLnbPolar()
|      eSetTunerLnbBand, CSetLnbBandHandler::CSetLnbBandHandler()
|      |_> CFeTunerSTQpskModule::mtSetLnbBand()
|      eSetTunerLnbDiSeqCProtocol, CSetDiSeqCProtocolHandler::CSetDiSeqCProtocolHandler()
|      |_> CFeTunerSTQpskModule::mtSetDiSeqCProtocol()
|       }}}

Calculate Lband freq

}}}
applications/  {{{
    fe_main.cpp {{{
                CModuleBIT_FE::CModuleBIT_FE()
                CModuleBIT_FE::ModuleCheckStatus()
                FrontEndTaskCarrier()
                CFeGenericModule::Reset()
                FrontEnd::FrontEnd()
                FrontEnd::~FrontEnd() - do nothing
                FrontEnd::getInstance()
                FrontEndInterfaceInit()
        }}}
    fe_tuner.cpp {{{
                CFEGenericTuner::CFEGenericTuner()
                CFEGenericTuner::ifSetStreamSourceEnable()
                CFEGenericTuner::ifSetStreamSourceDisable()
                CFEGenericTuner::ifRestartLockOptimize() - do nothing
                CFEGenericTuner::ifRunFeStreamControlProc()
                CFEGenericTuner::ifStopFeStreamControlProc() - do nothing
                CFEGenericTuner::ifOptimFeLockPeriodicProc() - do nothing
                CFEGenericTuner::ifSetFeFrequency() - do nothing
                CFEGenericTuner::ifSetFeFrequency() - do nothing
                CFEGenericTuner::ifSetFeSymRate() - do nothing
                CFEGenericTuner::ifSetFeFecRate() - do nothing
                CFEGenericTuner::ifSetFeSpectrInvType() - do nothing
                CFEGenericTuner::ifSetFeInputPort() - do nothing
                CFEGenericTuner::ifExecLnbCmnd() - do nothing
                CFEGenericTuner::ifSetFeFrequencyScan()
                CFEGenericTuner::Frequency_search()
                CFEGenericTuner::ifSetFeModulationType() - do nothing
                CFEGenericTuner::ifSetFeRollOffMode() - do nothing
                CFEGenericTuner::ifSetFePilots() - do nothing
                CFEGenericTuner::ifSetFeOutputStreamID() - do nothing
                CFEGenericTuner::ifSetFeQamType() - do nothing
        }}}
    fe_tuner_util.cpp {{{
                CFeTunerUtil::feGetLbandFrequency()
                CFeTunerUtil::feGetSatelliteFrequency()
                CFeTunerUtil::feRestartTunerNewParam()
                CFeTunerUtil::feRestartTunerNewFreq()
                CFeTunerUtil::feRestartTunerNewSymRate()
                CFeTunerUtil::feRestartTunerNewVitrbRate()
                CFeTunerUtil::feRestartTunerNewSpctrlInv()
                CFeTunerUtil::feRestartTunerNewMdltType()
                CFeTunerUtil::feRestartTunerNewRollOff()
                CFeTunerUtil::feRestartTunerNewPilots()
                CFeTunerUtil::feRestartTunerNewLnbPolar()
                CFeTunerUtil::feRestartTunerNewLnbBand()
                CFeTunerUtil::feRestartTunerNewInput()
                CFeTunerUtil::feRestartTunerFrequencyScan()
        }}}
    msg_dispatcher.cpp {{{
                CMsgDispatcherApplet::CMsgDispatcherApplet()
                CMsgDispatcherApplet::AppletProcFunc()
                CMsgDispatcherApplet::Attach()
                CMsgDispatcherApplet::Detach() - do nothing
                CMsgDispatcherApplet::Notify()
        }}}
    app_fe/
                include/
                        fe_if_p.h {{{
                                GenericDiSeqC (diseqc_gen_app.cpp)
                                        GenericDiSeqC()
                                        ~GenericDiSeqC()
                                        ifExecDiSeqCCmnd()
                                        ifSetDiSeqCInterfaceType()
                                FrontEndGenericLnb (lnb_app.cpp)
                                        FrontEndGenericLnb()
                                        ifExecLnbPowerUp()
                                        ifExecLnbCmnd()
                                        ifExecLnbDiSeqCCmnd()
                                        ifSetLnbDiSEqCInterfaceType()
                                        GetCurrentDiSeqCObjPtr()
                                        friend DiSEqCTask() (diseqc_task_app.cpp)
                                CFEGenericTuner
                                    PowerUpInitParam()
                                        request_WrOptimize()
                                        request_SetOptimize()
                                        request_StopOptimize()
                                        ifSetStreamSourceEnable()
                                        ifSetStreamSourceDisable()
                                        ifRestartLockOptimize()
                                        ifRunFeStreamControlProc()
                                        ifStopFeStreamControlProc()
                                        ifOptimFeLockPeriodicProc()
                                        ifSetFeFrequency()
                                        ifSetFeFrequency()
                                        ifSetFeSymRate()
                                        ifSetFeFecRate()
                                        ifSetFeSpectrInvType()
                                        ifSetFeInputPort()
                                        ifExecLnbCmnd()
                                        ifSetFeFrequencyScan()
                                        ifSetFeModulationType()
                                        ifSetFeRollOffMode()
                                        ifSetFePilots()
                                        ifSetFeOutputStreamID()
                                        ifSetFeQamType()
                                }}}
                        diseqc_p.h {{{
                                DiSeqC1 > GenericDiSeqC (diseqc1_app.cpp)
                                DiSeqC2 > DiSeqC1 (diseqc2_app.cpp)
                                }}}
                        device_observer.h {{{
                                CObserver
                                }}}
                        fe_main_p.h {{{
                                CModuleBIT_FE : CModuleBIT
                                        CModuleBIT_FE() (fe_main.cpp)
                                        ~CModuleBIT_FE()
                                        ModuleRepair()
                                        ModuleErrPolicy()
                                        getModuleName()
                                        ModuleCheckStatus() (fe_main.cpp)
                                        SetTaskState()
                                CFeGenericModule
                                        CFeGenericModule()
                                        FePeriodicTaskHndlr()
                                        Open()=0
                                        Close()=0
                                        Reset()=0
                                }}}
                        fe_tuner_p.h {{{
                                CFeTunerModule : CFeGenericModule
                                        CFeTunerModule()
                                        Update()=0
                                        mtSetFrequency()=0
                                        mtSetSymbolRate()=0
                                        mtSetFecRate()=0
                                        mtSetSpectralInvers()=0
                                        mtSetInputPort()=0
                                        mtSetFreqScan()=0
                                        mtSetModulation()
                                        mtSetRollOff()
                                }}}
                        fe_stqpsk_p.h {{{
                                FeNIMSAT2Tuner
                                CFeTunerSTQpskModule : CFeTunerModule
                                        CFeTunerSTQpskModule()
                                        virtual ~CFeTunerSTQpskModule()
                                        Update()
                                        FePeriodicTaskHndlr()
                                        Open
                                        Close
                                        mtSetFrequency
                                        mtSetSymbolRate
                                        mtSetFecRate
                                        mtSetSpectralInvers
                                        mtSetInputPort
                                        mtSetFreqScan
                                        mtSetLnbPolar
                                        mtSetLnbBand
                                        mtSetDiSeqCProtocol
                                }}}
                        port_dispatcher.h {{{
                                CMsgDispatcherApplet : Applet
                                -   map <SystemEvent_E, CObserver*> _observers
                                -   AppletProcFunc(SystemEvent_E event,const void* data)
                                -   SEM_ID ProtectSem
                                +       CMsgDispatcherApplet()
                                +       ~CMsgDispatcherApplet()
                                +       AppletGetName()
                                +       Notify()
                                +       Attach()
                                +       Detach()
                                }}}
            stqpsk/
                        fe_nimsat2_p.h {{{
                                only macros
                        }}}
                        fe_stqpsk_creator.cpp {{{
                                FrontEndCreator_STQpsk()
                                }}}
                        fe_stqpsk_module.cpp {{{
                                CFeTunerSTQpskModule::CFeTunerSTQpskModule()
                                CFeTunerSTQpskModule::~CFeTunerSTQpskModule()
                                CFeTunerSTQpskModule::Update()
                                CFeTunerSTQpskModule::FePeriodicTaskHndlr()
                                CFeTunerSTQpskModule::Open()
                                CFeTunerSTQpskModule::Close()
                                CFeTunerSTQpskModule::mtSetFrequency()
                                CFeTunerSTQpskModule::mtSetSymbolRate()
                                CFeTunerSTQpskModule::mtSetFecRate()
                                CFeTunerSTQpskModule::mtSetSpectralInvers()
                                CFeTunerSTQpskModule::mtSetInputPort()
                                CFeTunerSTQpskModule::mtSetFreqScan()
                                CFeTunerSTQpskModule::mtSetLnbPolar()
                                CFeTunerSTQpskModule::mtSetLnbBand()
                                CFeTunerSTQpskModule::mtSetDiSeqCProtocol()
                                }}}
                        fe_nimsat2_high.cpp {{{
                                FeNIMSAT2Tuner::FeNIMSAT2Tuner()
                                FeNIMSAT2Tuner::ifRunFeStreamControlProc()
                                FeNIMSAT2Tuner::ifStopFeStreamControlProc()
                                FeNIMSAT2Tuner::ifSetFeFrequency()
                                FeNIMSAT2Tuner::ifSetFeSymRate()
                                FeNIMSAT2Tuner::ifSetFeSpectrInvType()
                                FeNIMSAT2Tuner::ifSetFeFecRate()
                                FeNIMSAT2Tuner::ifSetFeInputPort()
                                FeNIMSAT2Tuner::ifExecLnbCmnd()
                                FeNIMSAT2Tuner::ifOptimFeLockPeriodicProc()
                                FeNIMSAT2Tuner::ifRestartLockOptimize()
                                FeNIMSAT2Tuner::set_PUValues()
                                FeNIMSAT2Tuner::PowerUpInitParam() - fpga register usage
                        }}}
                        fe_nimsat2_low.cpp {{{
                FeNIMSAT2Tuner::write_zif_registers()
                FeNIMSAT2Tuner::read_zif_registers()
                FeNIMSAT2Tuner::set_Frequency()
                FeNIMSAT2Tuner::set_TunerBandwidth()
                FeNIMSAT2Tuner::set_SymbolRate()
                FeNIMSAT2Tuner::calc_MasterClkFrequency()
                FeNIMSAT2Tuner::calc_SearchTimeConstants()
                FeNIMSAT2Tuner::ReadSymbolRate()
                FeNIMSAT2Tuner::ReadVSTATUS()
                FeNIMSAT2Tuner::ReadERRCNT()
                FeNIMSAT2Tuner::ReadNIRH_L()
                FeNIMSAT2Tuner::ReadAGC1()
                FeNIMSAT2Tuner::ReadSI()
                FeNIMSAT2Tuner::ReadDEROTATOR()
                FeNIMSAT2Tuner::DoDerot_Correction()
                FeNIMSAT2Tuner::SetERROR_CONTROL()
                FeNIMSAT2Tuner::vber_count_avarge()
                FeNIMSAT2Tuner::restart_DerotatorMachine()
                FeNIMSAT2Tuner::restart_CoarseMachine()
                FeNIMSAT2Tuner::restart_FineMachine()
                FeNIMSAT2Tuner::restart_AutoCenterMachine()
                FeNIMSAT2Tuner::lock_unlock_state()
                FeNIMSAT2Tuner::acquisition_state()
                FeNIMSAT2Tuner::coarse_carrier_position_state()
                FeNIMSAT2Tuner::check_coarse_carrier_state()
                FeNIMSAT2Tuner::check_carrier_fine_state()
                FeNIMSAT2Tuner::carrier_center_state()
                FeNIMSAT2Tuner::carrier_center_again_state()
                FeNIMSAT2Tuner::timing_center_state()
                FeNIMSAT2Tuner::data_state()
                FeNIMSAT2Tuner::tracking_state()
                FeNIMSAT2Tuner::search_stateMachine()
                FeNIMSAT2Tuner::Optimize_lock()
                FeNIMSAT2Tuner::request_WrOptimize()
                FeNIMSAT2Tuner::request_SetOptimize()
                FeNIMSAT2Tuner::request_StopOptimize()
                FeNIMSAT2Tuner::set_LNB_mode()
                FeNIMSAT2Tuner::set_VITERBI_mode()
                FeNIMSAT2Tuner::set_SPECTRAL_mode()
                        }}}
                lnb/
                        lnb_app.cpp {{{
                                FrontEndGenericLnb::FrontEndGenericLnb()
                                FrontEndGenericLnb::ifExecLnbPowerUp()
                                FrontEndGenericLnb::ifExecLnbCmnd()
                                FrontEndGenericLnb::ifExecLnbDiSeqCCmnd()
                                FrontEndGenericLnb::ifSetLnbDiSEqCInterfaceType()
                                FrontEndGenericLnb::GetCurrentDiSeqCObjPtr()
                                }}}
                        diseqc_gen_app.cpp {{{
                            GenericDiSeqC::GenericDiSeqC()
                                GenericDiSeqC::~GenericDiSeqC()
                                GenericDiSeqC::ifExecDiSeqCCmnd()
                                GenericDiSeqC::ifSetDiSeqCInterfaceType()
                                }}}
                        diseqc_task_app.cpp {{{
                            DiSEqCTask()
                                lnbSendMsg2DiSeqCTask()
                                lnbParseMsg2DiSeqCTask() - empty
                                CreateDiSeqCProc() - call to it commented at FrontEndGenericLnb()
                                }}}
                        diseqc1_app.cpp {{{
                            DiSeqC1::DiSeqC1() - empty 
                                DiSeqC1::~DiSeqC1() - empty 
                                DiSeqC1::ifExecDiSeqCCmnd()
                                DiSeqC1::ifSetDiSeqCInterfaceType() - empty
                                }}}
                        diseqc2_app.cpp {{{
                            DiSeqC2::DiSeqC2() - empty
                                DiSeqC2::~DiSeqC2() - empty
                                DiSeqC2::ifExecDiSeqCCmnd()
                                DiSeqC2::ifSetDiSeqCInterfaceType() - empty
                                }}}
                public/
                        fe_app_x.h {{{
                                FrontEnd (fe_main.cpp)
                                        FrontEnd()
                                        ~FrontEnd()
                                        getInstance()
                                CFeTunerUtil (fe_tuner_util.cpp)
                                -   feRestartTunerNewParam()
                                        |_> execmGenerateNewSystemEvent() (from app_sys/exec_mngr/event_util.cpp)
                                                |-> execmFillEventMessageData()
                                                |_> MSG_Q_SEND()
                                +   feGetLbandFrequency() - returns Lband freq
                                +   feGetSatelliteFrequency() - returns Ku|Cband freq
                                +   feRestartTunerNewFreq() -> feRestartTunerNewParam()
                                +   feRestartTunerNewSymRate() -> feRestartTunerNewParam()
                                +   feRestartTunerNewVitrbRate() -> feRestartTunerNewParam()
                                +   feRestartTunerNewSpctrlInv() -> feRestartTunerNewParam()
                                +   feRestartTunerNewInput() -> feRestartTunerNewParam()
                                +   feRestartTunerFrequencyScan() -> feRestartTunerNewParam()
                                +   feRestartTunerNewMdltType() -> feRestartTunerNewParam()
                                +   feRestartTunerNewRollOff() -> feRestartTunerNewParam()
                                +   feRestartTunerNewPilots() -> feRestartTunerNewParam()
                                +   feRestartTunerNewLnbPolar() -> feRestartTunerNewParam()
                                +   feRestartTunerNewLnbBand() -> feRestartTunerNewParam()
                        }}}
                        fe_ip_x.h {{{
                                empty
                        }}}
        drv_ird/
                frnt_end/
                        fe_stqpsk_drv.cpp {{{
                                FrontEndGenericDrv* new_FeSTQpskDrv()
                                FeSTQpskDrv::FeSTQpskDrv()
                                FeSTQpskDrv::ifFeDrvControl()
                                        eZifS1WriteReg eZifS1ReadStatOnly eZifS1ReadStatWithSubAdrs
                                        
                                FeSTQpskDrv::PowerUpInit()
                        }}}
                public/
                        fe_tuner_x.h {{{
                                FrontEndGenericDrv()
                                ifFeDrvControl()
                        }}}
                        fe_sqpsk_x.h {{{
                                FeSTQpskDrv : FrontEndGenericDrv
                                        FeSTQpskDrv()
                                        PowerUpInit() - do nothing
                                        ifFeDrvControl()
                        }}}
                        diseqc.h {{{
                        }}}
        app_sys/
                rtdb/
                        rtdb_fe.cpp {{{
                                rtdbiGetSatelliteAppRunTimeParam()
                                rtdbFeGetSatelliteEntry()
                                ...
                        }}}
}}}
Parameters to deal w/ {{{

LNB
        write reg
        read reg
        power on/off
        hi/low band
        v/h polarity
Tuner (zifi=zero IF)
        write reg
        read status
Demodulator
        write reg
        read reg

|ini name       |description                |possible values |units  |
|--------------------------------------------------------------------|
|frequency      |Transponder/ L Band        |L Band:         |KHz    |
|               |frequency.                 |950000 - 2150000|       |
|               |Sets the satellite         |                |       |
|               |frequency. This frequency  |Ku Band:        |       |
|               |controls the range of      |10700000 -      |       |
|               |frequency transmission     |12750000        |       |
|               |received from              |C Band:         |       |
|               |the satellite.             |3200000 -       |       |
|               |                           |4200000         |       |
|symbol rate    |Expected symbol rate of    |1000000 –       |Baud   |
|               |stream.                    |45000000        |       |
|fec rate       |Forward error correction   |0 - 1/2,        |Enum   |
|               |rate.                      |1-  2/3,        |       |
|               |                           |2 - 3/4,        |       |
|               |                           |3 - 4/5,        |       |
|               |                           |4 - 5/6,        |       |
|               |                           |5 - 6/7,        |       |
|               |                           |6 - 7/8,        |       |
|               |                           |7 - 8/9,        |       |
|               |                           |8 - Auto        |       |
|spectral       |Inversion of a spectrum    |0 - Auto,       |Enum   |
|inversion      |                           |1 - Inverted,   |       |
|               |                           |2 - Normal      |       |
|lnb power      |Polarity of a low-noise    |0 - Vertical 13V|Enum   |
|supply         |block converter.           |1 - Horizontal –|       |
|               |                           |18V             |       |
|               |                           |2 - Off         |       |
|lnb 22khz      |Use of LNB 22Khz           |0 - Low – 22Khz |Enum   |
|               |                           |off             |       |
|               |                           |1 -  High –     |       |
|               |                           |22Khz on        |       |
|freq drift     |Enable/Disable drift       |0 – Off         |Enum   |
|compansate     |compensation               |1- On           |       |
|lnb lo type    |Defines range for LNB L.O. |0 – DiSEqC      |Enum   |
|               |frequency.                 |1 – universal   |       |
|               |                           |2 -  wide-band  |       |
|               |                           |3 –numeric      |       |
|               |                           |ku-band         |       |
|               |                           |4 – numeric     |       |
|               |                           |c-band          |       |
|lnb lo         |Local oscillator frequency.| LNB L.O. Type =|KHz    |
|frequency      |                           |ku-band :       |       |
|               |                           |9000000         |       |
|               |                           |–20000000       |       |
|               |                           |LNB L.O. Type=  |       |
|               |                           |c-band :        |       |
|               |                           |5000000-6000000 |       |
|frequency range|Defines range for Frequency|0 - l_band      |Enum   |
|               |parameter                  |1 - c_band      |       |
|               |                           |2 - ku_band     |       |
|lnb tone mod   |                           |0 – modulated   |Enum   |
|               |                           |1- unmodulated  |       |
|lnb diseqc type|                           |0 – none        |Enum   |
|               |                           |1- diseqc-1     |       |
|               |                           |2 – diseqc-2    |       |
|modulation type|The Modulation object      |0 – qpsk        |Enum   |
|               |Defines the modulation type|1 – 8psk        |       |
|               |of the receiver, and by    |2 – 16qam       |       |
|               |that sets the amount of    |                |       |
|               |different tones received   |                |       |
|               |through the IRD            |                |       |
|rolloff factor |                           |0 – 25          |Enum   |
|               |                           |1 – 35          |       |
|               |                           |2 - auto        |       |
|pilots         |                           |0 – Off         |Enum   |
|               |                           |1 - On          |       |
|port           |Active input port          |1 - 4           |       |
}}}
}}} # from IRD2900

+   1. Add tbl_fe_drv_map, it's api and HwMngr to fill it (23dec2007)
+   2. Release FE Mngr framework (23dec2007)
+   3. Add FeConfig table and related api (24dec2007)
+   4. Add cli for FeDrvMap table's cli (24dec2007)
+   5. Add reset msg and it's cli (24dec2007)
+   6. FeConfig table api + cli (lnblotype, lnblofreq, freqrange) (25dec2007)
+   7. FeConfig table api + cli (rest of params) (26dec2007)
+   8. Support setting all fe config params (26dec2007)
+   9. FeStatus table + db api (partial) (30dec2007)

}}}

Frontend to support DVBS2_ECC card {{{
    19feb2009

    Dual S/S2 card, where the DVB-S solution - STB6000 tuner, STV0288 
demodulator and the DVB-S2 solution - CE5038 tuner, ESS3100 demod, PCA9534 
(I2Cto8IO)
Card elements: tuner/converter, demodulator, LNB control, I2Cto8IO (only S2)

Initialization {{{
    02feb2009
----                    the cfg_reg=0xff,inp=0xff,out=0xff
set config:         w gpo cfg_reg 0x61
----                    the cfg_reg=0x60,inp=0xff,out=0xff
rst dvbs2:          w gpo out_reg 0xb
                    w gpo out_reg 0x4
----                    the cfg_reg=0x61,inp=0x65,out=0x4
en ecc demod i2c:   w gpo out_reg 0xc
----                    the cfg_reg=0x60,inp=0x6c,out=0xc

greader.elf -w -d 20 -i 3 -v 0x61
greader.elf -w -d 20 -i 1 -v 0xb
greader.elf -w -d 20 -i 1 -v 0x4
greader.elf -w -d 20 -i 1 -v 0xc


}}}
GPIO device (pca9538) {{{

    The device provides i/o config.
There are 4 regs.

Reg 0 - r - input port
Reg 1 - rw - output port
Reg 2 - rw - polarity inv
Reg 3 - rw - config

The config reg (3) should be set according to usage of physical i/o pins. 
Each bit describes if according pin is used for input or output. 
In addition each pin connected to something, so certain functionality 
supported. For example, 4th pin can set dvbs2 demod enable/disable.

7 - O - select dvbs or dvbs2 (1 - dvbs)
6 - I - sync
5 - I - pl (phys layer)
4 - O - en i2c dvbs2 tuner (1 -enable)
3 - O - en i2c dvbs2 demod (1 -enable)
2 - O - reset dvbs2 (1 -en, 0 -dis)
1 - O - reset dvbs (1 -en)
0 - I - reset of dvbs2 demod (1-en, 0-off/rst)

Once the config byte should be written. After that the output should go to 
output reg and otherwise from input reg.
The current status of input can be read from input reg, where output bits give
no information. Same for input status.

IRP default config (22feb2009)
7  6  5  4  3  2  1  0
o  i  i  o  o  o  o  i

}}}
Tuner (CE5038) {{{

Has 1 read reg and 12 write regs.
Read reg:
     7  6   5   4   3   2   1   0
    POR FL SB3 SB2 SB1 SB0 TU1 TU0

POR bit - PowerOnReset - 
FL bit - Freq (& Phase) Lock - `1' if the device is locked
SB[3:0] - VCO Sub-Band
TU[1:0] - Tune unlock state - these bits define tune unlock window
    tu1 tu0
     0   0 - Vvar inside threshold
     0   1 - Vvar above threshold
     1   0 - Vvar below threshold
     1   1 - not used
}}}
LNB functional flow {{{

The 22kHz sends to LNB together w/ 13/18V. So the power out of LNB should be on
to send any signal.
While

LD7 (green)     - polarity - On=no power, Off=Vertic(13V)/Horiz(18V)
LD6 (green)     - lnb power - On=power off
LD5 (green)     - high band - On=low, Off=high(22kHz)
LD4 (red)       - errors

LD3 (green)     - pl (physical layer)
LD2 (green)     - sync
LD1 (green)     - lock

}}}
i2c flows {{{
--- Reset module 2
26 eGPOResetDvbS2
28 eGPORunDvbS2
--- tuner init {{{
14 eZifS2WriteReg
   21 eGPOEnI2CZifS2
   22 eGPODisI2CZifS2
14 eZifS2WriteReg
   21 eGPOEnI2CZifS2
   22 eGPODisI2CZifS2
14 eZifS2WriteReg
   21 eGPOEnI2CZifS2
   22 eGPODisI2CZifS2 }}}
--- dvbs2 power up
23 eGPOEnI2CDVBS2
--- Load LUTs
3  eWriteLongReg
3  eWriteLongReg
...

CFePortSKYPHY::SetPortFreq {{{
| |-CFeTunerCE5038::set_Frequency()
    14 eZifS2WriteReg
      21 eGPOEnI2CZifS2
      22 eGPODisI2CZifS2
    14 eZifS2WriteReg
      21 eGPOEnI2CZifS2
      22 eGPODisI2CZifS2
    15 eZifS2ReadStatOnly
      21 eGPOEnI2CZifS2
      22 eGPODisI2CZifS2
|-CFePortSKYPHY::SetPortSymRate()
  |-ecc3100_set_symbolrate()
    5  eWriteLongRegEnGPO
      23 eGPOEnI2CDVBS2
      24 eGPODisI2CDVBS2
#   6  eReadLongRegEnGPO
      23 eGPOEnI2CDVBS2
      24 eGPODisI2CDVBS2
    5  eWriteLongRegEnGPO
      23 eGPOEnI2CDVBS2
      24 eGPODisI2CDVBS2
    5  eWriteLongRegEnGPO
      23 eGPOEnI2CDVBS2
      24 eGPODisI2CDVBS2
    5  eWriteLongRegEnGPO
      23 eGPOEnI2CDVBS2
      24 eGPODisI2CDVBS2
    5  eWriteLongRegEnGPO
      23 eGPOEnI2CDVBS2
      24 eGPODisI2CDVBS2
    |-CFeTunerCE5038::set_TunerBandwidth()
      14 eZifS2WriteReg
        21 eGPOEnI2CZifS2
        22 eGPODisI2CZifS2
      14 eZifS2WriteReg
        21 eGPOEnI2CZifS2
        22 eGPODisI2CZifS2
      14 eZifS2WriteReg
        21 eGPOEnI2CZifS2
        22 eGPODisI2CZifS2
  |-CalcBitRateFromSR()
    |-SetBitRate2_ECC()
     ?6  eReadLongRegEnGPO
     ?  23 eGPOEnI2CDVBS2
     ?  24 eGPODisI2CDVBS2
      5  eWriteLongRegEnGPO
        23 eGPOEnI2CDVBS2
        24 eGPODisI2CDVBS2
|-CFePortSKYPHY::SetPortSpectrInv
# 6  eReadLongRegEnGPO
    23 eGPOEnI2CDVBS2
    24 eGPODisI2CDVBS2
# 6  eReadLongRegEnGPO
    23 eGPOEnI2CDVBS2
    24 eGPODisI2CDVBS2
# 6  eReadLongRegEnGPO
    23 eGPOEnI2CDVBS2
    24 eGPODisI2CDVBS2
|-CFePortSKYPHY::SetPortRollOff
# 6  eReadLongRegEnGPO
    23 eGPOEnI2CDVBS2
    24 eGPODisI2CDVBS2
  5  eReadLongRegEnGPO
    23 eGPOEnI2CDVBS2
    24 eGPODisI2CDVBS2 }}}
}}}  
Dejjiter {{{
    16mar2009

Theory {{{

There is fifo buffer in sdram on the dvbs2 card. The sdram size iz 16MB.
The fifo size iz 4MB, it contains 4K rows 1KB each. 
The buffer has 4096 rows each 256*32bits (8192b = 1KB)

            |       |
--wr_row--> |       |
            |       |
            |       |
<--rd_row-- |       |
            |       |
             -------
The fifo_meter is rd_row - wr_row, means number of occupied rows.
The fifometer occupied 12bit int i2c read at bytes 0xb n 0xa
0xa  11 - 8         this is last 4bits of fifo_meter
0xb  7 -  0         this is 1st 8bits of fifometer

If stream packet is 188B, so 

Algorithm

Size of fifo is 33554432 bits
Max fullness allowed 32768000 bits

ram_fullness_crn - current fullness in Bytes
ram_fullness_max - keep max fullness value in B ( 0 )
ram_fullness_min - keep min fullness value in B ( 4194304 x400000 )
ram_fullness_lastdo_max - last max fullness value in B ( 4194304 x400000 )
ram_fullness_lastdo_min - last min fullness value in B ( 0 ) 

 insert ->  | row   | 0
            |       |
            |       |
            |       |
            |       |
            |       |
            | row   | 4095

To get current fullness in Bs. 
If current > max fullness, so set max fullness to current.
If current < min fullness, so set min fullness to current.

}}}
    Follows should be init as 1 in IRP. (Haim 26mar2009)
hw_config.FloatConfig.FeDVBS2AcurateTSOut
hw_config.FloatConfig.FeDVBS2DDSTSOut 
    Follows for new fast algo (Haim 26mar2009)
hw_config.FloatConfig.FeDVBS2DDSDriftDis

            --- StartUp
            -----------
FeEcc3100Tuner::PowerUpInitParam()
|-> ...
|-> Set port sym rate
|   |-> CalcBitRateFromSR()
|-> Set port modulation
|   |-> CalcBitRateFromSR()
|-> Set port stream ID
|   |-> CalcBitRateFromSR()
|-> ...
|-> Get dejitter revision (2nd byte)
|-> if rev==0x03, set FeDVBS2FPGA03_DDS=1, otherwise FeDVBS2FPGA03_DDS=0

            --- RunTime
            -----------
Optimize_lock()
|-> Check ECC if locked.
|-> from unlock to lock: Check MPEG packet type config
|   |->
|   |->
|   |->
|   |->
|   |-> OPTLock_Delay = SKYPHY_ASIC_MONITOR_SML_PERIOD (20ms)
|-> from lock to unlock:
|   |-> ...
|   |-> OPTLock_Delay = SKYPHY_ASIC_MONITOR_BIG_PERIOD (300ms)
|-> staying in lock: on every 5 
|   |-> CalcBitRateFromPCR()
|   |_> OPTLock_Delay = SKYPHY_ASIC_MONITOR_SML_PERIOD (20ms)
|_> otherwise (staying in unlock)
    |-> CalcBitRateFromSR()
    |_> ...


get_ReceiverStatus()
|-> ...
|-> (8) if locked, update bit rate according to receiver params
|   |-> CalcBitRateFromSignalStatus()

            --- Set parameters
            ------------------
|-> Set param
|-> RestartLockOptimize()
    \_> CalcBitRateFromSR() - calc bitrate from sym rate
        |-> see below

            --- Internals
            -------------
CalcBitRateFromSR() {{{
    gets; RS_value, modulation, FastOutputRate, boolean
|-> calc output bit rate from modcod+sym rate and if (FastOutputRate)
|-> set accurateOutputRate=ACCURATE_OUTPUT_START
|-> accurateOutputStamp=0
|   Enable_DDS() - disable DDS
|   SetBitRate2_DDS() - "New SR-Restart"
|   Enable_DDS() - enable DDS
|_> SetBitRate2_ECC()
}}}
CalcBitRateFromPCR() {{{
|-> if get bit rate > 0
|->
}}}
Enable_DDS() - en/dis DDS by reset

SetBitRate2_DDS() {{{
|-> if same rate as before - return
|_> config dj by calling i2c addr
}}}

}}}
Optimize_lock {{{

Acquisition_mode - can be 0 for Range, 1 - Timing
OPTLock_Delay - delay till next call. Can be as follows
    SKYPHY_ASIC_MONITOR_BIG_PERIOD  300m
    SKYPHY_ASIC_MONITOR_SML_PERIOD  20m
OPTtrack_stamp - timestamp
TunerOptimize_TRACK - keep status of last call of Optimize_lock()
OPT_AlgoState
OPT_AlgoRUN
TunerFreq_SEARCH
accurateOutputRate
    ACCURATE_OUTPUT_START
    ACCURATE_OUTPUT_RFSET
    ACCURATE_OUTPUT_1STPCR - need for multi stream
    ACCURATE_OUTPUT_DONE - accurated


    Check if OPTLock_Delay & check w/ OPTtrack_stamp
    Stamp on OPTtrack_stamp
    is_new_telemetry_available() - ?

    Read PL frame sync.
    If PL not synced 
        If OPT_AlgoState==0 || Acquisition_mode==0
            pl_unsync_process() - ?
        set OPTLock_Delay = SKYPHY_ASIC_MONITOR_BIG_PERIOD
        inc OPT_AlgoState

    Read GPIO input status & check sync bit.
    lock_unlock_state() - ? (set tx_lock_state)
        Read TX_STATUS2 reg & check
        if baseband frame failed CRC since last interrupt, so
            basebane frame processor finite state in sync - ?
        if MPEG packet failed CRC since last interrupt - ?
    If PL sync & BB sync
        Read BB_HDR_STAT2 (transport status reg)
        If NPD, set mpeg_type_config
        If ISSY,
            Read BB_HDR_STAT1
            ...
            update mpeg_type_config with ISSY_SHORT or ISSY_LONG
        Config MPEG packet type (write to MPEG_TYPE_CONFIG)
        Set ISI
    If from Unlock to Lock 
        (TunerOptimize_TRACK==OFF & tx_lock_state==ST_FEL_LOCK)
        set OPTLock_Delay = SKYPHY_ASIC_MONITOR_SML_PERIOD
    If from Lock to Unlock
        (TunerOptimize_TRACK==ON & tx_lock_state==ST_FEL_UNLOCK)
        set TunerOptimize_TRACK = OFF
        set OPT_AlgoRUN = 1
        set OPT_AlgoState = 0
        set OPTLock_Delay = SKYPHY_ASIC_MONITOR_BIG_PERIOD
    If stay in Lock
        (TunerOptimize_TRACK==ON & tx_lock_state==ST_FEL_LOCK)
        Every 5 SKYPHY_ASIC_MONITOR_SML_PERIOD call CalcBitRateFromPCR()
        set OPTLock_Delay = SKYPHY_ASIC_MONITOR_SML_PERIOD
    If Unlock
        call CalcBitRateFromSR()
        On every 5th OPT_AlgoState


    NPD - Null-packet Deletion
    ISSY - Input Stream SYncronization
    UPL - User Packet Length
    ISI - Input Stream Identifier
}}}
}}}

DVB frontend configurable parameters {{{
    09mar2009
--- Common
port                - port nbr
frequency           - tuner freq (L band 950000 - 2150000 Hz)
symbol rate         - symbols per sec (sps)
FEC rate            - 1/2, 2/3, 3/4, 4/5, 5/6, 7/8, 8/9, auto
Spectral invertion  - normal, inverted
Drift compansation  - off
Pilots              - on/off
RollOff             - 20%, 25%, 35%, auto
--- LNB
Polarity            - set polarity of LNB converter (13/18V vertical/horizontal)
lnb_band            - On/Off 22kHz to set high or low band in Ku/C band
freq_range      range of 
lnb_lo_type     define LNB local oscillator freq range  (diseqc, universal, wide band, Ku-band, C-band)
lnb_lo_freq     lnb lo frequency

--- DVBS2 only
mode            - 
FEC rate (add.) - 1/4, 1/3, 2/5, 3/5, 9/10

}}}

SNMP runtime path {{{
    The SNMP manager while running looking for MIBs in wrong path (this is 
compilation path).
The work around for the problem is to run script w/ follows
snmpset -c public localhost UCD-DLMOD-MIB::dlmodName.1 s "ifTable" UCD-DLMOD-MIB::dlmodPath.1 s "${PWD}/ifTable.so"
}}}
}}}
-------------------------------------------------------------------------------
----------------------------------- Softier -----------------------------------
-------------------------------------------------------------------------------
001 - QA machine preparation procedure {{{

draft 0.1 07oct2003

--- I --- Introduction {{{2

   This doc supposed to help you to build QA machine and whole
   environment for check images on target cards. It is splited in
   2 main sections called Windows machine and Linux machine, because
   of complication of creation procedure. Shortly speaking, the image
   should be created on Linux machine and executed from Windows machine.

   If you have any question regarding this doc please call to Gery Kahn
   or gxk@softier.com
}}}2
--- II --- Windows machine {{{2

1. Hardware
   a. Hardware to collect
      DM642 card, 
      Power supply for DM642, 
      Emulator, 
      JTAG cable,
      Serial cable
      PCI Bridge card
   b. Connect PCIBridge to Emulator
   c. Connect JTAG cable to Emulator and DM642 
   d. Connect Serial cable between COM port on Windows machine and serial
      port on DM642
   e. Connect power supply to DM642
   
2. PCI Bridge card installation
   a. Insert PCIBridge card in PCI slot
   b. Install WinDrive 6.02
   c. Start WinDrive and choose File>New
   d. Check that follows line exists in the list:
      "PCI: TIPCI2040 PCI-DSP Bridge Controller"

3. Prepare Windows machine
   a. Install Code Composer Studio(CCS) 2.2 
   b. Upgrade it to CCS 2.2.18 from s-main/company/install/codecomposer/upgrade
      c6000-2.20.00-full-to-c6000-2.20.18-full
   c. Install from EVM642 CD (should create c:/ti/boards/...
   d. Copy follows files from gery-dt/share/ccs
      softier.cfg, servis.dll, tixds6400_11.drv
   c. Run CSS Setup (icon on desktop)
      Choose: "Install Device Drivers"
      Add file tixds6400_11.drv
      Drap-n-Drop newly installed driver in "System Config" window
      Properties window automaticly opened
      Choose "Auto generate board data file w/ extra config file"
      Choose config file softier.cfg
      Under tab "Processor Config" choose "Add Single"
      Under tab "Startup GEL file" choose ti/boards/gel/evm642.gel

4. Running Image on Target
   a. Run CCS2
   b. Choose File>Load Program and find linux.out, previously copied
      from Linux machine.
   c. Choose File>Data>Load and find romfs.dat, previously copied from
      Linux machine.
   d. Install and start TerraTerm application
   e. Config it by choosing Setup>Serial port and setup options:
      baud rate = 19200
      data = 8 bit
      parity = none
   f. Choose Run in CCS2. After 5-10 sec should see output of started image
      and get shell prompt.
   g. Run 'ls' and see that it's functional.
}}}2
--- III --- Linux machine {{{2

1. Users to create
   a. create user in linux-s machine

2. Get tools
   a. telnet to linux-s
   b. Copy tms-cx-tools-<timestamp>.tbz to your machine
      scp /stuff/repository/kernel/tools/tms-cx-tools-<timestamp>.tbz
          <user>@<ip>:<path>
   c. back to own machine and cd /
   d. Follows will open tar file:
      sudo tar -jxf <path>/tms-cx-tools-<timestamp>.tar.bz2
   e. cp -r /usr/local/tools/.cxoffice ~
   f. Checking previously installed tools, by calling
      tms320c6-coff-gcc from command line. Should return
      '>>   error: no input files'

3. Create Image 
   a. add to .tcshrc or .bashrc at home dir
      setenv CVSROOT :pserver:<user>@linux-s:/cvs
      or
      export CVSROOT=:pserver:<user>@linux-s:/cvs
   b. In tcsh run 'source ~/.tcshrc'
      if bash run '. ~/.bashrc'
   c. Go to home dir and call 'cvs login'
   d. run 'cvs co uClinux-dist'
   e. 'cd uClinux-dist' 
   f. run 'sh mklinks.sh'
   g. If you running Bash call
      '. /usr/local/tools/env.src 
      If you running Tcsh call
      <missing for now 7oct2003 Gery>
   h. call 'make xconfig' and choose
      'Target platform selection' where 
       put Vendor/Product to 'TI/TMS320C6 ;
       Libc version to 'uClibs' ;
       put 'y' for Customize Kernel Settings
       and 'y' for Customize Vendor/User Settings
         if want to edit those.
      Push 'MainMenu' and 'Save and Exit'
   i. Call 'make dep'
   j. Call 'make'
   k. After build is done copy uClinux-dist/linux-2.4.x/linux.out
      and uClinux-dist/images/romfs.dat to previously prepared Windows
      machine.
}}}2

}}}
002 - Add user appl to uClinux {{{

All paths start from uClinux-dist

add to user/Makefile
dir_$(CONFIG_USER_HELLO_HELLO) +=hello

add to config/config.in
bool 'hello'         CONFIG_USER_HELLO_HELLO

create dir named 'hello'

copy C,H and Makefile to previously created dir

edit Makefile

}}}
003 - Compile LTP for tms320c6 {{{

Changes in /usr/local/tools/tms320c6-coff-gcc {{{2

1. chmod tms320c6-coff-gcc
sudo chmod 775 /usr/local/bin/tms320c6-coff-gcc
2. edit tms320c6-coff-gcc
export GCC2C_CONVERTER_OPTIONS="-D_TMS320C6X -D_TMS320C6x \
-nostdinc \
-I/home/ady/uClinux-dist/uClibc/include \
-I/home/ady/uClinux-dist/linux-2.4.x/include \
-I/home/ady/uClinux-dist/linux-2.4.x/include/linux \
"
export GCC2C_WRAPPER_SAVETEMPS=1

}}}2

sigpending {{{2

If defined _GNU_SOURCE so
uclinux/uclibc/include/signal.h 
|->uclinux/uclibc/include/ucontext.h
   |-> sys/ucontext.h                 which is not found 

from uclinux/glibc/NOTES
If you define this macro, everything is included: ISO C89, ISO C99, POSIX.1,
POSIX.2, BSD, SVID, X/Open, LFS, and GNU extensions.  In the cases where
POSIX.1 conflicts with BSD, the POSIX definitions take precedence.
from uClinux-dist/glibc/manual/signal.texi
signal handler default behaviour depends in GNU and non-GNU libs, so 
depends on _GNU_SOURCE
There is no handler activity in sigpending02.c so ...

solution: delete _GNU_SOURCE from testcases/kernel/syscalls/sigpending/Makefile
sent email to ltp-list@lists.sourceforge.net

}}}2

OLD
Changes in uclinux/linux-2.4.x/include/linux/stddef.h {{{

malloc.h

!!!THOSE CHANGES error uclinux compilation!!!

Add
#ifndef _SIZE_T
#define _SIZE_T          
typedef unsigned long size_t;
#endif

explanation:
Compiler ti search size_t in uclinux/lib/libc/include/stddef.h

Add
# undef  ptrdiff_t
# define ptrdiff_t       int

explanation:
from uClinux-dist/linux-2.4.x/include/linux/malloc.h if __STDC__, so include
stddef.h, but no definition for ptrdiff_t there.

Files uClinux-dist/uClibc/include/malloc.h
uClinux-dist/lib/uClibc/include/malloc.h
uClinux-dist/glibc/malloc/malloc.h
are equals.

}}}

}}}
004 - LTP project {{{1

A - need changes for porting
B - compilation problem/not implemented yet
C - compiled
D - C, but failed
E - C + success
F - D + evaluated
G - E + integrated in test framework

installation {{{2

Min installation needed placed in ~/prjs/rt_ltp

The install target of main Makefile calls to install target of Makefiles under 
testcases and tools directories.

Makefile
|
|->testcases install {{{3
|   |
|   |->create 'bin' dir for further links
|   |
|   |->command install    
|   |                     
|   |->kernel install     
|   |   |
|   |   |->fs install
|   |   |
|   |   |->io install
|   |   |
|   |   |->ipc install
|   |   |
|   |   |->mem install
|   |   |   |
|   |   |   |->mem
|   |   |   |   |
|   |   |   |   |_>create links from local binaries to ../../../bin/
|   |   |   |
|   |   |   |->mmapstress
|   |   |   |
|   |   |   |->mtest01
|   |   |   |
|   |   |   |->mtest05
|   |   |   |
|   |   |   |->mtest06
|   |   |   |
|   |   |   |->mtest07
|   |   |   |
|   |   |   |->page
|   |   |   |
|   |   |   |->shmt
|   |   |   |
|   |   |   |_>vmtests
|   |   |
|   |   |->pty install
|   |   |
|   |   |->sched install
|   |   |
|   |   |_>syscalls install
|   |                     
|   |->misc install       
|   |                     
|   |_>network install
|}}}3
|->tools install {{{3
|   |
|   |->apicmds install
|   |   |
|   |   |_>create links in ../testcases/bin/ for follows binaries
|   |      tst_brk tst_brkm tst_res tst_resm tst_exit tst_flush tst_brkloop
|   |      tst_brkloopm
|   |
|   |->genload install
|   |   |
|   |   |_>create link for 'stress' like ../testcases/bin/genload
|   |
|   |->netpipe-2.4 install
|   |
|   |->netpipe-2.4-ipv6 install
|   |
|   |_>create link for 'gethost' in ../testcases/bin/
|}}}3
|_> run IDcheck.sh {{{3
    |
    |-> creates if needed users: nobody, bin, daemon and groups: nobody, bin,
        deamon, users, sys
    |_> checks if executed by root

 }}}3

}}}2

Running {{{2

At root dir exists 4 scripts:
IDcheck.sh - executed by make install (see installation)
runalltests.sh - actually calls follows
    pan/pan $quiet_mode -e -S $instances $duration -a $$ -n $$ $pretty_prt -f ${TMP}/alltests $logfile $outputfile
    where 'alltests' content binaries and command lines to run. It is created from files under runtests/
    Particulary 'mem01' found in 'mm', 'crashme'; 'mem02' in 'mm', 'stress.part1'

networktests.sh
diskio.sh

}}}2

sbrk,brk {{{2

 |->get_high_address() from ./lib/get_high_address.c {{{3
 |  |
 |  |->testcases/kernel/syscalls/access/access03.c  
 |  |   |_>negative test cases 
 |  |->testcases/kernel/syscalls/access/access05.c
 |  |   |_>negative test cases 
 |  |->testcases/kernel/syscalls/chmod/chmod06.c
 |  |   |_>negative test cases 
 |  |->testcases/kernel/syscalls/chown/chown04.c
 |  |   |_>negative test cases 
 |  |->testcases/kernel/syscalls/lchown/lchown02.c
 |  |   |_>negative test cases 
 |  |->testcases/kernel/syscalls/link/link04.c
 |  |   |_>negative test cases 
 |  |->testcases/kernel/syscalls/lstat/lstat02.c
 |  |   |_>negative test cases 
 |  |->testcases/kernel/syscalls/mkdir/mkdir01.c
 |  |   |_>negative test cases 
 |  |->testcases/kernel/syscalls/mknod/mknod06.c
 |  |   |_>negative test cases 
 |  |->testcases/kernel/syscalls/mremap/mremap03.c
 |  |   |_>negative test cases 
 |  |->testcases/kernel/syscalls/msync/msync05.c
 |  |->testcases/kernel/syscalls/rmdir/rmdir05.c
 |  |   |_>negative test cases 
 |  |->testcases/kernel/syscalls/stat/stat03.c
 |  |   |_>negative test cases 
 |  |->testcases/kernel/syscalls/symlink/symlink03.c
 |  |   |_>negative test cases 
 |  |->testcases/kernel/syscalls/truncate/truncate03.c
 |  |   |_>negative test cases 
 |  |_>testcases/kernel/syscalls/unlink/unlink07.c
 |      |_>negative test cases 
 |  }}}3
 |->usc_global_setup_hook() from lib/parse_opts.c, which is {{{3
 |  macro TEST_PAUSE from include/usctest.h
 |  |
 |  |->get STD_start_break original sbreak size
 |  |  if exist env vars USC_TP_SBRK and USC_LP_SBRK
 |  |
 |  |_>call 'sbrk(STD_TP_sbrk)' if exists env var USC_TP_SBRK
 |  }}}3
 |->usc_test_looping() from lib/parse_opts.c, which is {{{3
 |  macro TEST_LOOPING from include/usctest.h
 |  |
 |  |_>if STD_LP_sbrk and Debug, so call 'sbrk(STD_LP_sbrk)'
 |     Debug set if env var USC_DEBUG or USC_VERBOSE
 |  }}}3
 |->

Conclusion:
Usage of get_high_address() can get *NULL and be Ok, except msync and mremap.
Those tests should be rewrited complete (look at COMMON)

Usage of usc_global_setup_hook() triggered by env vars USC_TP_SBRK and
USC_LP_SBRK. Can't find any place
Usage of usc_test_looping()

}}}2

fork problem
540 files, 422 in syscalls

Testcases {{{2

FS - {{{3
                        fs_inod- Rapidly creates and deletes files through
                                multiple processes running in the background.
                        fs_perms- Regression test for Linux filesystem perms.
                        fsx-linux- Filesystem stress test developed by Apple.
                        growfiles- will grow a list of files.
                        lftest- to verify the file size limitations of a fs.
                        linktest- Regression test for max links per file.
                        openfile- Creates files and opens simultaneously.
                        proc01- Recursively reads all files within /proc fs.
                        rwtest- Currently can handle read,write,reada,writea,
                                ssread,sswrite, and many varieties of listio.
                }}}3
MM - {{{3

In libmm/mm_core_apis.c mm_core_test02() use fork() ???

mem mmapstress mtest01 mtest05 mtest06 mtest07 page shmt vmtests

mem +
|->mem01 exercising virtual memory allocation and usage.
|  log: 122 sym per test; 26330 tests in 100sec, so 693MB for 24h
|
|_>mem02 check that memory can be allocated and freed. check for zeroed memory
   log: 256 sym per test; 972 tests in 100 sec, so 54MB for 24H

mmapstress +
|->mmapstress01 - (fork) stresses mmaps; forks number of children, all of whom
|  mmap the
|  same file, make a given number of accesses to random pages in the map
|  (reading & writing and comparing data).Then the child exits and the parent
|  forks another to take its place. Each time a child is forked, it stats the
|  file and maps the full length of the file.
|_>mmapstress02 - (brk) reading into or writing from a mmaped regular file
                  which lacks the needed permissions.

mtest01 +
|_>mtest01 - (fork) mallocs memory <chunksize> at a time until malloc fails.

mtest05 +
|_>mmstress - (brk,fork,thread) Performs General Stress with Race conditions

mtest06 +
|->mmap1 - (thread) stressing the mm by simultanious
|                               map/unmap/read by light weight processes. (24h)
|->mmap2 - stressing the mm by repeaded
|                               map/write/unmap of a large gb size file.
|->mmap3 - (thread) stressing the mm by repeaded map/write/unmap
|                               of file/memory of random size (maximum 1GB).
|_>shmat1 - (thread) stressing the mm by repeaded shmat/write/read/shmatd of
                                file/memory of random size (maximum 1000 * 4096).

mtest07 +
|->mallocstress - (thread) Stresses the VMM and C library by spawning N threads
|                 which malloc blocks of increasing size until malloc returns
|                 NULL.
|_>shm_test - (thread) Stresses memory management subsystem of Linux. Spawns
              multiple pairs of reader & writer threads. One thread will create
              the shared segment of random size and write to this memory, the 
              other pair will read from this memory.

page +
|->page01 - (fork) Create a number of process, each of which requests a large
|                       chunk of memory to be assigned to an array.  Write to each
|                       element in that array, and verify that what was written/stored
|                       is what was expected.
|_>page02 - (fork)
 
shmt +
|->shmt02
|->shmt03
|->shmt04 - (fork)
|->shmt05
|->shmt06 - (fork)
|->shmt07 - (fork)
|->shmt08
|->shmt09 - (brk for FAIL)
|_>shmt10 - (fork)

vmtests +
|->data_space - (fork)
|
|_>stack_space - (fork)

}}}3
SCH - {{{3

clisrv - Read contents of data file. Write each line to socket, then read
                 line back from socket and write to standard output.
hyperthreading
        ht_enabled - Test for whether HT enabling is the default setting and
                 the kernel option works as expected.
        ht_affinity - Test for whether a set of system calls is provided to bind
                 itself or another process to a subset of currently active
                 processors and to get affinity information.
        ht_interrupt
process_stress - Stresses the process management kernel code.
        fork???
pthreads
        pth_str01 - Creates a tree of threads.
        pth_str02 - Creates n threads.
        pth_str03 - Creates a tree of threads does calculations and returns result
                to parent.
sched_stress -
        sched_tc0
        sched_tc1
        sched_tc2
        sched_tc3
tool

}}}3

}}}2

}}}1
005 - System calls tests {{{1
Porting LTP kernel system calls 669 tests.
  A {{{2
a abort01 - fork
e accept01
e access01
d access02
d access03
d access04
d access05
e acct01
e acct02
b adjtimex01 - #9
b adjtimex02 - #9
c alarm01
c alarm02
c alarm03 - fork
c alarm04
c alarm05
e alarm06
c alarm07 - fork }}}2
  B {{{2
d bind01 - 
d brk01 - }}}2
  C {{{2
b capget01 - #7
b capget02 - #7
b capset01 - #7
b capset02 - #7
e chdir01
e chdir02
a chdir03 - fork
d chdir04
b chmod01 - #10
b chmod02 - #10
b chmod03 - #10
b chmod04 - #10
b chmod05 - #10
b chmod06 - #10
b chmod07 - #10
e chown01
e chown02
d chown03
d chown04
e chown05
d chroot01
a chroot02 - fork
d chroot03
e chroot04
d clone01
d clone02
e clone03
d clone04
e clone05
d clone06
e close01
e close02
e close08
b confstr01 - #10
a connect01 - fork
d creat01
e creat03
a creat04 - fork
d creat05
d creat06
a creat07 - fork
d creat08
e creat09 }}}2
  D {{{2
e dup01
e dup02
e dup03
e dup04
e dup05
e dup06
e dup07
e dup201
e dup202
e dup203
e dup204
e dup205 }}}2
  E {{{2
a execl01 - fork
a execle01 - fork
a execlp01 - fork
a execv01 - fork
a execve01 - fork
a execve02 - fork
d execve03
d execve04
a execve05 - fork
a execve06 - fork
a execvp01 - fork
a exit01 - fork
a exit02 - fork }}}2
  F {{{2
e fchdir01
e fchdir02
a fchdir03 - fork
b fchmod01 - #10
b fchmod02 - #10
b fchmod03 - #10
b fchmod04 - #10
b fchmod05 - #10
b fchmod06 - #10
b fchmod07 - #10
e fchown01
e fchown02
d fchown03
d fchown04
e fchown05
a fcntl01 - fork
a fcntl02 - fork
a fcntl03 - fork
a fcntl04 - fork
a fcntl05 - fork
a fcntl06 - fork
a fcntl07 - fork
a fcntl07 - fork
a fcntl08 - fork
a fcntl09 - fork
a fcntl10 - fork
a fcntl11 - fork
a fcntl12 - fork
a fcntl13 - fork
a fcntl14 - fork
a fcntl15 - fork
a fcntl16 - fork
a fcntl17 - fork
a fcntl18 - fork
a fcntl19 - fork
a fcntl20 - fork
a fcntl21 - fork
a fcntl22 - fork
a fdatasync01 - fork
a fdatasync02 - fork
a flock01 - fork
a flock02 - fork
a flock03 - fork
a flock04 - fork
a flock05 - fork
a flock06 - fork
b fmtmsg01 - #12
a fork01 - fork
a fork02 - fork
a fork03 - fork
a fork04 - fork
a fork05 - fork
a fork06 - fork
a fork07 - fork
a fork08 - fork
a fork09 - fork
a fork10 - fork
a fork11 - fork
a fork12 - fork
e fpathconf01
e fstat01
d fstat02
e fstat03
d fstat04
a fstat05 - fork
e fstatfs01
d fstatfs02
e fsync01
e fsync02
e fsync03
e ftruncate01
e ftruncate02
e ftruncate03
a ftruncate04 - fork
  }}}2
  G {{{2
d getcwd01
d getcwd02
a getcwd03 - #10
a getdents01 - x86
a getdents02 - x86
a getdents03 - x86
a getdents04 - x86
e getdomainname01
e getegid01
e geteuid01
e getgid01
d getgid02
d getgid03
d getgroups01
e getgroups02
d getgroups03
e getgroups04
d gethostid01
e gethostname01
e getitimer01
d getitimer02
e getitimer03
d getpeername01
a getpgid01 - fork
a getpgid02 - #10
e getpgrp01
e getpid01
a getpid02 - fork
e getppid01
a getppid02 - fork
e getpriority01
e getpriority02
e getresgid01
d getresgid02
a getresgid03 - #10
e getresuid01
d getresuid02
d getresuid03
e getrlimit01
d getrlimit02
e getrusage01
d getrusage02
a getsid01 - fork
a getsid02 - thread
d getsockname01
d getsockopt01
d gettimeofday01
d gettimeofday02
e getuid01
d getuid02
d getuid03 }}}2
  I {{{2
a ioctl01 - fork
d ioctl02
d ioperm01
d ioperm02
d iopl01
d iopl02
b ipc/shmget01 - #23
b ipc/shmget02 - #23
b ipc/shmget03 - #23
b ipc/shmget04 - #23
b ipc/shmget05 - #23
  ipc/msgget01 - link error
  ipc/msgget02 - link error
  ipc/msgget03 - link error
  ipc/msgget04 - link error
  ipc/msgctl01 - link error
  ipc/msgctl02 - link error
  ipc/msgctl03 - link error
  ipc/msgctl04 - link error
  ipc/msgctl05 - link error
  ipc/msgctl06 - ok
  ipc/msgctl07 - ok
  ipc/msgctl08 - link error
  ipc/msgctl09 - link error
  msgrcv01 - link error
  msgrcv02 - link error
  msgrcv03 - link error
  msgrcv04 - link error
  msgrcv05 - link error
  msgrcv06 - link error
  msgsnd01 - link error
  msgsnd02 - link error
  msgsnd03 - link error
  msgsnd04 - link error
  msgsnd05 - link error
  msgsnd06 - link error
  semget01 - link error
  semget02 - link error
  semget03 - link error
  semget05 - link error
  semget06 - link error
  semctl01 - link error
  semctl02 - link error
  semctl03 - link error
  semctl04 - link error
  semctl05 - link error
  semctl06 - link error
  semop01 - link error
  semop02 - link error
  ipc/semop03 - link error
  ipc/semop04 - link error
  ipc/semop05 - link error
  ipc/shmat01 - ok
  ipc/shmat02 - ok
  ipc/shmat03 - ok
  ipc/shmdt01 - link error
  ipc/shmdt02 - ok
  ipc/shmctl01 - link error
  ipc/shmctl02 - link error
  ipc/shmctl03 - link error
  ipc/shmctl04 - link error }}}2
  K {{{2
a kill01 - fork
a kill02 - fork
a kill03 - fork
a kill04 - fork
a kill05 - fork
a kill06 - fork
a kill07 - fork
a kill08 - fork
a kill09 - fork
a kill10 - fork
a kill11 - fork
a kill12 - fork }}}2
  L {{{2
e lchown01
d lchown02
e link02
e link03
d link04
e link05
e link06
e link07
e listen01
a llseek01 - #10
a llseek02 - #10
e lseek01
e lseek02
e lseek03
e lseek04
e lseek05
e lseek06
e lseek07
e lseek08
e lseek09
e lseek10
e lstat01
d lstat02
d lstat03 }}}2
  M {{{2
  mallopt
b memcmp01 - #17
b memcpy01 - #17
b memset01 - #17
  mkdir01
b mkdir02 - fork
  mkdir03
b mkdir04 - fork
  mkdir05
  mkdir08
b mkdir09 - fork
  mknod01
  mknod02
  mknod03
  mknod04
  mknod05
  mknod06
  mknod07
  mknod08
  mknod09
b mlock01 - #18
b mlock02 - #18
b mlockall01 - #19
b mlockall02 - #19
  mmap001
  mmap01
  mmap02
b mmap03 - #21
  mmap04
b mmap05 - #21
  mmap06
  mmap07
  mmap08
  mmap09
  modify_ldt01
a modify_ldt02 - fork
b mount01 - #10
b mount02 - #10, fork
b mount03 - #10
b mount04 - #10
  mprotect01
  mprotect02 - fork
  mprotect03 - fork
  mremap01
  mremap02
  mremap03
b mremap04 - #22
  msync01
  msync02
  msync03
  msync04
  msync05
b munlock01 - #18
b munlock02 - #18
b munlockall01 - #19
b munlockall02 - #19
  munmap01
  munmap02
  munmap03 }}}2
  N {{{2
b nanosleep01 - #10(fixed in b11),fork
b nanosleep02 - #10(fixed in b11),fork
b nanosleep03 - #10(fixed in b11),fork
b nanosleep04 - #10(fixed in b11),fork
b nftw01 - #20
  nice01
  nice02
  nice03
  nice04
  nice05 }}}2
  O {{{2
  open01
  open02
  open03
  open04
a open05 - fork
  open06
  open07
  open08
  open09
  open10 }}}2
  P {{{2
  pathconf01
  pause02
  pause03
b personality01 - #24
b personality02 - #24
e pipe01
a pipe02 - fork
e pipe03
a pipe04 - fork
d pipe05
e pipe06
e pipe07
d pipe08
a pipe09 - fork
a pipe10 - fork
a pipe11 - fork
  poll01
b prctl01 - #25
b prctl02 - #25
  pread01
  pread02
  pread03
b profil01 - #10
  ptrace01
  ptrace02
  ptrace03
  pwrite01
  pwrite02 - #26
  pwrite03
  pwrite04  }}}2
  R {{{2
a readdir01 - fork
  readdir02
  readlink01
  readlink02
  readlink03
  readlink04
b read01 - comp err
  read02
  read03
  read04
  readv01
  readv02
  readv03
  reboot01
  reboot02
a recv01 - fork
a recvfrom01 - fork
a recvmsg01 - fork
  rename01
  rename02
  rename03
  rename04
  rename05
  rename06
  rename07
  rename08
a rename09 - fork
  rename10
a rename12 - fork
a rename14 - fork
  rename13
  rmdir01
  rmdir02
a rmdir03 - fork
  rmdir04
  rmdir05  }}}2
  S {{{2
  sbrk01 - sbrk
  sched_getparam01
  sched_getparam02
  sched_getparam03
  sched_get_priority_max01
  sched_get_priority_max02
  sched_get_priority_min01
  sched_get_priority_min02
  sched_getscheduler01
  sched_getscheduler02
  sched_rr_get_interval01
  sched_rr_get_interval02
  sched_rr_get_interval03
  sched_setparam01
  sched_setparam02
  sched_setparam04
a sched_setparam03 - fork
a sched_setparam05 - fork
  sched_setscheduler01
a sched_setscheduler02 - fork
  sched_yield01
  select01
  select02
  select03
a sendfile02 - fork
  sendfile03
a send01 - fork
a sendmsg01 - fork
a sendto01 - fork
  setdomainname01
  setdomainname02
  setdomainname03
  setegid01
  setfsgid01
  setfsuid01
  setgid01
  setgid02
  setgid03
  setgroups01
  setgroups02
  setgroups03
a setgroups04 - sbrk
  sethostname01
  sethostname02
  sethostname03
  setitimer01
  setitimer02
  setitimer03
a setpgid01 - fork
  setpgid02
a setpgid03 - fork
a setpgrp01 - fork
a setpgrp02 - fork
  setpriority01
  setpriority02
  setpriority03
a setpriority04 - thread
  setpriority05
  setregid01
a setregid02 - fork
a setregid03 - fork
a setregid04 - fork
a setresgid01 - fork
a setresgid02 - fork
a setresgid03 - fork
a setresuid01 - fork
a setresuid02 - fork
a setresuid03 - fork
  setreuid01
a setreuid02 - fork
a setreuid03 - fork
a setreuid04 - fork
a setreuid05 - fork
  setreuid06
  setrlimit01 - fork, comp err
  setrlimit02 - #27
  setrlimit03 - #27
a setsid01 - fork
  setsockopt01
a settimeofday01 - fork
a settimeofday02 - fork
  setuid01
  setuid02
  setuid03
a sigaction01 - thread
  sigaction02
  sigaltstack01
a sighold02 - fork
a signal01 - fork
  signal02
  signal03
  signal04
  signal05
  sigpending02
  sigprocmask01
a sigrelse01 - fork
  sigsuspend01
  socketcall01 - compilation error
  socketcall02 - compilation error                
  socketcall03 - compilation error               
  socketcall04 - compilation error              
  socket01
  socketpair01
  sockioctl01   
e statfs01
d statfs02
e statfs03
  stat01
  stat02
  stat03
  stat05
  stat06
  stime01
  stime02
b string01 - #17
  swapoff01
  swapoff02
  swapon01
  swapon02 - fork
  symlink02 - link err
  symlink03 - fork
  symlink04 - fork
  symlink05 - fork
  sync01
b syscall01 - #17
  sysconf01
  sysctl01 - compilation error
  sysctl03 - fork, compilation error
  sysctl04 - compilation error
  sysctl05 - compilation error
  sysfs01
  sysfs02
  sysfs03
  sysfs04
  sysfs05
  sysfs06
  sysinfo01
  sysinfo02
  syslog01 - bash script
  syslog02 - bash script
  syslog03 - bash script
  syslog04 - bash script
  syslog05 - bash script
  syslog06 - bash script
  syslog07 - bash script
  syslog08 - bash script
  syslog09 - bash script
  syslog10 - bash script
  syslog11 - fork
  syslog12 - fork
  syslogtst }}}2
  T {{{2
  time01
  time02
  times01
  times02 - fork
  times03 - fork
  truncate01 - fork
  truncate02 - fork
  truncate03 - fork
  truncate04 - fork }}}2
  U {{{2
  ulimit01 - #28
  umask01
  umask02 - fork
  umask03 - fork
  umount01
  umount02
  umount03 - fork
  umount04 - fork
  uname01
  uname02
  uname03
  unlink05
  unlink06
  unlink07
  unlink08
  ustat01 - #30
  ustat02 - #30
  utime01
  utime04
  utime05
  utime02
  utime03
  utime06 }}}2
 V {{{2
  vfork01
  vfork02
  vhangup01 - fork
  vhangup02 - fork }}}2
  W {{{2
  wait401 - fork
  wait402 - fork
  wait02 - fork
  waitpid01 - fork
  waitpid02 - fork
  waitpid03 - fork
  waitpid04 - fork
  waitpid05 - fork
  waitpid06 - fork
  waitpid07 - fork
  waitpid08 - fork
  waitpid09 - fork
  waitpid10 - fork
  waitpid11 - fork
  waitpid12 - fork
  waitpid13 - fork
  write01
  write02 - fork
  write03 - fork
  write04 - fork
  write05 - fork
  writev01 - fork
  writev02 - fork
  writev03 - fork
  wirtev04
  writev05 - fork }}}2

Common {{{2
  abort
  acct
  capget
  capset
  confstr
  fmtmsg
  gethostid
  gethostname
  getrlimit
  getrusage
  ioctl
  profil
  ptrace
  reboot
  sethostname
  setrlimit
  swapoff
  swapon
  syscall
  sysctl
  sysinfo
  syslog
  ulimit
  uname
  vhangup
}}}2

FileSystem {{{2
  access
  asyncio
  chdir
  chmod
  chown
  chroot
  close
  creat
  dup
  dup2
  fchdir
  fchmod
  fchown
  fcntl
  fdatasync
  flock
  fpathconf
  fstat
  fstatfs
  fsync
  ftruncate
  getcwd
  getdents
  lchown
  link
  llseek
  lseek
  lstat
  mkdir
  mknod
  mount
  nftw
  open
  pathconf
  pipe
  pread
  pwrite
  readdir
  readlink
  read
  readv
  rename
  rmdir
  sendfile
  statfs
  stat
  symlink
  sync
  sysfs
  truncate
  umount
  unlink
  ustat
  utime
  write
  writev
}}}2

Timing {{{2
  adjtimex
  alarm - compiled
  getitimer - compiled
  gettimeofday - compiled
  nanosleep - compiled
  setitimer - compiled
  settimeofday - compiled
  stime - compiled
  tim - compiled
  times
  
}}}2

InterprocesCommunication {{{2
  shmget
  msgget
  msgctl
  msgrcv
  msgsnd
  semget
  semctl
  semop
  shmat
  shmdt
  shmctl
}}}2

Memory {{{2
  brk
  memcpy
  memset
  mlock
  mlockall
  mmap
  modify_ldt
  mprotect
  mremap
  msync
  munlock
  munlockall
  munmap
  recv
  recvfrom
  sbrk
}}}2

Network {{{2
  accept
  bind
  connect
  getpeername
  getsockname
  getsockopt
  listen
  select
  send
  sendmsg
  sendto
  setsockopt
  socketcall
  socket
  socketpair
  sockioctl
}}}2

Process {{{2
  clone
  execl
  execle
  execlp
  execv
  execve
  exit
  fork
  getegid
  geteuid
  getgid
  getgroups
  getpgid
  getpgrp
  getpid
  getppid
  getresgid
  getresid
  getsid
  getuid
  ioperm
  iopl
  nice
  personality
  prctl
  setegid
  setfsgid
  setgid
  setgroups
  setpgid
  setpgrp
  setregid
  setresgid
  setresuid
  setreuid
  setsid
  setuid
  vfork
  wait4
  wait
  waitpid
}}}2

Sched {{{2
  getpriority
  sched_getparam
  sched_get_priority_max
  sched_get_priority_min
  sched_getscheduler
  sched_rr_get_interval
  sched_setparam
  sched_setscheduler
  sched_yield
  setpriority
}}}2

Signals {{{2
  kill
  pause
  sigaction
  sigaltstack
  sighold
  signal
  sigpending
  sigprocmask
  sigrelse
  sigsuspend

}}}2

Fork problem {{{2
abort/abort01.c                         common
creat/creat07.c                         fs
execl/execl01.c                         process
execle/execle01.c                       process
execlp/execlp01.c                       process
execv/execv01.c                         process
execve/execve01.c                       process
execve/execve02.c                       process
execve/execve05.c                       process
execve/execve06.c                       process
execvp/execvp01.c                       process
exit/exit01.c                           process
exit/exit02.c                           process
fcntl/fcntl07.c                         fs
fcntl/fcntl07B.c                        fs
fcntl/fcntl11.c                         fs
fcntl/fcntl12.c                         fs
fcntl/fcntl18.c                         fs
fcntl/fcntl19.c                         fs
fcntl/fcntl20.c                         fs
fcntl/fcntl21.c                         fs
fcntl/fcntl22.c                         fs
flock/flock03.c                         fs
flock/flock04.c                         fs
flock/flock05.c                         fs
ftruncate/ftruncate04.c         fs
getpid/getpid02.c                       process
getsid/getsid01.c                       process
ipc/msgctl/msgctl05.c           ipc
ipc/shmctl/shmctl01.c           ipc
kill/kill01.c                           signal
kill/kill03.c                           signal
kill/kill04.c                           signal
kill/kill05.c                           signal
kill/kill06.c                           signal
kill/kill07.c                           signal
kill/kill08.c                           signal
kill/kill09.c                           signal
kill/kill11.c                           signal
kill/kill12.c                           signal
modify_ldt/modify_ldt02.c       mem
mprotect/mprotect02.c           mem
mprotect/mprotect03.c           mem
nanosleep/nanosleep01.c         time
nanosleep/nanosleep02.c         time
nanosleep/nanosleep03.c         time
nanosleep/nanosleep04.c         time
open/open05.c                           fs
pause/pause02.c                         signal
pause/pause03.c                         signal
pipe/pipe02.c                           fs
pipe/pipe09.c                           fs
pipe/pipe04.c                           fs
pipe/pipe10.c                           fs
poll/poll01.c                           net
prctl/prctl01.c                         process
prctl/prctl02.c                         process
ptrace/ptrace01.c                       common
ptrace/ptrace02.c                       common
ptrace/ptrace03.c                       common
}}}2
}}}1
006 - Serial port tests {{{1

Checking attributes:
baud rate: 75, 110, 150, 300, 600, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200
data bits
parity (odd,even,none)
stop bit

crtsdts - hardware flow control
ixon - software flow control

}}}1
007 - BusyBox project {{{1

current version 0.60.4

Supported applets:

basename        x
cat                     x
chmod           cp
cmp                     x
cp                      x
cut                     x
date
dd                      x
df
dirname         x
dmesg
du
echo            x
env
expr
find            x
free
getopt
grep            x
gzip/gunzip     x
halt
head            uuencode
hostname
ifconfig
kill
killall
ls                      false,which
mkdir           x
more
mount
msh                     x
mv                      x
nslookup
ping
printf
ps
pwd                     x
reboot
reset
rm                      x
rmdir           x
route
sash
sed                     x
sleep
sort
sync
tail
tar                     x
test            many tests
touch           x
umount
uname
uniq
uptime
vi
watchdog
wc                      x
wget            x
xargs
zcat            bunzip2

Taking testsuites from version 1.00-pre5

}}}1
008 - Scheduling tests {{{1

Theory {{{2
busyloop - loop that does nothing
ioloop - a loop that does io operation
systemloop - a loop that does system call

starvation - when a process doesn't get CPU time
fairness - 
goodness - 

1. Run N={2,3,5,10,100} busyloop processes and compare there times
2. Run N={2,3,5,10,100} ioloop processes and compare there times
3. Run N={2,3,5,10,100} systemloop processes and compare there times
4. Run N={3,6,12,99} mixed processes and compare there times

5. Run previous cases when processes have different priorities
6. Max number of ctx switches per sec. Run 2 processes perform sched_yield()
   when done check number of ctx switches.(Need shell patch)
7. Time beetween switch on/out. Measure time between ctx switches for all
   previous scenarious. (Need kernel patch)
8. Signal delivery latency. (Need kernel patch)
}}}2

Status {{{2

D - delta of time (in msec) between checks
N - number of processes {2,3,5,10,100}
M - time to wait in secs {1,5,10,30,60}

1. ./use D N M ./busyloop
2. ./use D N M ./ioloop
3. ./use D N M ./systemloop
4. ./use2 D N M


}}}2
}}}1
009 - Breathru {{{1

Definition:
Functionality and POSIX tests for general_iso group

Status:
Till 22feb2004 get 2 deliveries.


Deliveries:

1. All test should be placed under              DONE
2. Please use makefile.custom                   DONE
3. Check errors in comments, especially at the head of C files.
4. Stop using STD_FUNCTIONAL_TEST macro at all, just print results.
5. Whenever a test requires parameters, the error notes "Parameter is
        missed" should be "Usage: …" with the exact command line
6. 

22feb2004

# asctime02 FAIL on x86 and on tms320c6
# atoll01 FAIL on x86 and crash tms320c6 (they mentioned something about it in their mail)
# calloc02 still FAIL on x86 and crash tms320c6
# strlen01 wrong Usage (written –N instead of –S) [I fixed it]
# malloc02 get stuck on tms320c6
# usage message still not understandable.

}}}1
010 - Tools {{{1

CVS: there are 3 modules: gcc-3_2-gcc2c gcc2c-wrapper gcc2c_scripts

Main flow:
        Wrapper (from <tools>/gcc2c-wrapper/gcc2c-compiler-wrapper) invokes
converter, then pass along the converted output file (in a temp dir) to a 2nd
stage compiler, either vanilla GCC (for fast testsuites), or to TI compiler
(for actual use in the product).
Wrapper may bypass the converter and pass along the original file to a 2nd
stge compiler (GCC or TI). In this case wrapper used to translate GCC options
into relevant TI options.

1. Wrapper {{{2

build {{{3
run 'gcc2c_scripts/make-wrapper.sh'
changed follows:
        gcc2c_scripts/make-wrapper.sh
        gcc2c-wrapper/gcc2c-compiler-wrapper.cpp (only warnings):
}}}3
code {{{3

env vars:

GCC2C_
        WRAPPER_TEMPDIR
        LOGFILE
        NO_CONVERTER_INVOCATION
        ABORT_EXIT
        PASSTHRU_GCC_OPTIMIZE_OPTIONS_TO_CONVERTER
        WRAPPER_SAVETEMPS

GCC2C_CONVERTER_
        ROOT
        OPTIONS

Second stage:
        GCC2C_SECOND_STAGE_GCC_INVOKE
        GCC2C_SECOND_STAGE_GCC_OPTIONS
        GCC2C_SECOND_STAGE_GCC_NO_PASS_WARNING_OPTIONS

        GCC2C_SECOND_STAGE_CCS_WINE_INVOKE
        GCC2C_SECOND_STAGE_CCS_COMPILER_OPTIONS
        GCC2C_SECOND_STAGE_CCS_COMPILER_EXTRA_OPTIONS
        GCC2C_SECOND_STAGE_CCS_CONVERTED_COMPILE_OPTIONS
        GCC2C_SECOND_STAGE_CCS_LINKER_OPTIONS
        GCC2C_SECOND_STAGE_CCS_LIBRARY_PATH
        GCC2C_SECOND_STAGE_CCS_LOADER_OPTIONS
        GCC2C_SECOND_STAGE_CCS_RAW_COMMAND_LINE

Algo

Exit w/ error if
        (No converter root) or ((No 2nd stage gcc) and (No 2nd stage wine)) or
                ((2nd stage gcc) and (2nd stage wine))
        (2nd stage wine) and (No 2nd stage library path)
        wrapper tmp dir doesn't have absolute path
        wrapper tmp dir is root `/'

Prepare cmdln for gcc:
        SecondStageGCCInvoke DEFAULT_SECOND_STAGE_GCC_COMPILER_ARGS \
                SecondStageGCCOptions `-L' ConverterRoot`/'CONVERTER_LIB

}}}3

}}}2
2. Converter {{{2

gcc2c_scripts/build-gcc2c.sh (changed)
        GCC2C_SOURCE_HOME
        GCC2C_GCC_VANILLA_LOCATION
        GCC2C_PREFIX
        |_>build-gcc2c-command.sh
                |-> configure
                |-> make
                |_> make install
}}}2
3. Run testsuite {{{2
For gcc:
        gcc2c_scripts/run-gcc-testsuite.sh
The result file placed at ~/gcc-gcc.log and just do follows
        grep -e "^FAIL" -e "^WARN" -e "^UNRESOLVED" -e "^ERROR" -e "^XPASS"

3. Build libgcc-ti (done by build-gcc2c.sh)
run 'gcc2c_scripts/make-libgcc-ti.sh'


Sankhya testsuite starts from running run-sankhya-testsuite.sh, which
calls 'run-testsuite.sh sankhya', where:
cd ~/gcc2c-build


4. Prepare tools release {{{2
gcc2c_scripts/make-gcc2c-release.sh
}}}2

}}}1
011 - Sankhya {{{1

cd ~/prjs/stam
source /usr/local/tools/env_tcsh.src
source ~/softier/tools/Sankhya/last/tests/setup.csh
check that in /opt/GNUPlus/c64x/lib/gcc-lib/c64x-coff/3.3/specs link has follows:
-c -ar -x -i /opt/GNUPlus/c64x/lib/gcc-lib/c64x-coff/3.3 -i /home/gxk/softier/user_uclinux_evm_k60_l5_u6_i4/libs -l/home/gxk/softier/user_uclinux_evm_k60_l5_u6_i4/libs/crti.o
and libraries follows:
-llibc.lib -llibdt.lib -lliblddk.lib

/opt/GNUPlus/c64x/bin/c64x-coff-gcc -fomit-frame-pointer -Dlinux -D__linux__ -Dunix -D__uClinux__ -DEMBED -fno-builtin -nostartfiles -D_TMS320C6 -D__PIC__ -fpic -D__inline__=inline -D__signed__=signed -D__SOFTIER_LONGLONG__=long -D__SOFTIER_LONG__=int -D__gnuc_va_list=va_list -D_TMS320C6X_NOCONVERTER -I/home/gxk/softier/user_uclinux_evm_k60_l5_u6_i4/include -Wl,/home/gxk/softier/user_uclinux_evm_k60_l5_u6_i4/libs/userapps.cmd -o stam.o stam.c

build project txt_parser:
/opt/GNUPlus/c64x/bin/c64x-coff-gcc -fomit-frame-pointer -Dlinux -D__linux__ -Dunix -D__uClinux__ -DEMBED -fno-builtin -nostartfiles -D_TMS320C6 -D__PIC__ -fpic -D__SOFTIER_LONG__=long -D__SOFTIER_LONGLONG__=long -D_TMS320C6 -D__inline__=inline -D__signed__=signed -D_TMS320C6X_NOCONVERTER -I/home/gxk/softier/user_uclinux_evm_k65_l8_u8_i5/include -c txt_scanner.c -o ./txt_scanner.o
/opt/GNUPlus/c64x/bin/c64x-coff-gcc -fomit-frame-pointer -Dlinux -D__linux__ -Dunix -D__uClinux__ -DEMBED -fno-builtin -nostartfiles -D_TMS320C6 -D__PIC__ -fpic -D__SOFTIER_LONG__=long -D__SOFTIER_LONGLONG__=long -D_TMS320C6 -D__inline__=inline -D__signed__=signed -D_TMS320C6X_NOCONVERTER -I/home/gxk/softier/user_uclinux_evm_k65_l8_u8_i5/include -c txt_parser.tab.c -o ./txt_parser.tab.o
/opt/GNUPlus/c64x/bin/c64x-coff-gcc -fomit-frame-pointer -Dlinux -D__linux__ -Dunix -D__uClinux__ -DEMBED -fno-builtin -nostartfiles -D_TMS320C6 -D__PIC__ -fpic -D__SOFTIER_LONG__=long -D__SOFTIER_LONGLONG__=long -I/home/gxk/softier/user_uclinux_evm_k65_l8_u8_i5/include -Wl,-ar,-x -o txt.sankhya txt.c ./*.o /home/gxk/softier/user_uclinux_evm_k65_l8_u8_i5/libs/crti.o /home/gxk/softier/user_uclinux_evm_k65_l8_u8_i5/libs/userapps.cmd

}}}1
012 - Burning {{{1

Before KAD procedure{{{2
        Copy follows files to local dir: boot_evm642_loadlinux.bin,
evm642_program_flash.out, gzip_linux.bat, osd_fpga_rev4.bin, program_flash.cfg,
ut_minizip.exe
        Also put in the same dir: linux.out and romfs.img
        Run gzip_linux.bat
        Configure program_flash.cfg The example follows:
        "
        rootdir = C:\burnlinux\evm642_v104\
        BOOTLOADER = boot_evm642_loadlinux.bin
        FPGA = osd_fpga_rev4.bin
        LINUX = linux.out.gz
        ROMFS = romfs.img
        "
        Load evm642_program_flash.out from CCS menu (File->Load Program). Press F5 
        and will get menu. Choose Burn all, just romfs, etc. Wait till popup box
        and press '8' to exit.
}}}2

After BSL procedure {{{2
monitor 2.03, gel 2.02
Copy follows to <lddk>/monitor directory:

Create linux.out, kad.out, jffs2.img and copy to previous dir.


}}}2

}}}1
013 - USB tests {{{1
        28jun2004.
                                Total 182 testcases.

All tests should be done on EVM and VM cards.
All tests where DOK (disk on key) used should be done for MSystems,Sandisk and
genery one. It is also hard drive.
All tests should be done with passive hub or without it. Decided not to check
active usb hub.

--- Main Procedure ---
1. Boot with DOK plugged in. Make atomic test. Plugging test.
2. Boot with DOK plugged in. Make N times Plugging test.
3. Boot with DOK plugged in. Make movie test.
4. Boot with DOK plugged in. Do survival test.
5. Boot with DOK plugged in. Do survival test N times.
6. Boot with DOK plugged in. Do survival movie test.
7. Do previous tests without usb device at booting.
---------------------- 12 testcases.

* Plugging test.
Plugg in. Make atomic test. Unplugg.

* Survival test.
Make sure device recognized by system.
Mount device.
Make read and write test. Unplugg device in the middle of read/write.
Plugg in device.
Umount device.

* Survival movie test.
Same as survival test just run movie instead of `read/write test'.

* Atomic test.
Make sure device recognized by system.
Mount device.
Make read and write test.
Unmount device.

* Movie test.
Same as atomic, but instead of `read and write' test, just run player to
see movie on display.

}}}1
014 - Microwindows {{{1
        30jun2004

Have to config kernel for Framebuffer
in order to test config fbtest and compile it.
bug fixed in user/fbtest/Rules.make (not included in u9)

deleted demos/nxscribble , cause use of wide-char which is non-supported.

delete MAP_SHARED flad from mmap() in drivers/scr_fb.c +266

        06feb2005
How to build for linux-x86? {{{2
Pre-build config files placed at <mw>/src/Configs>, where README file describes
them. Copy needed config file as <mw>/src/config and run `make' to build. So
run `cp ./Configs/config.x11 ./config'
- fix -
problem: on FC3 freetype package installs headers in dirs 
`/usr/include/freetype1' and `/usr/include/freetype2', and MW searchs for
`/usr/include/freetype'.
solution: change path to freetype header from `freetype/*.h' to 
`freetype1/freetype/*.h' in file ./engine/font_freetype.c
- fix -
problem: change install dir
solution: in file Makefile.rules
}}}2
How to build for MediaLinux {{{2
Basic `Y' configuration:
THREADSAFE
MICROWIN
NANOX
MICROWINDEMO
NANOXDEMO
NANOWM
HAVE_FILEIO
HAVE_BMP_SUPPORT
HAVE_FNT_SUPPORT
ERASEMOVE
UPDATEREGIONS
FRAMEBUFFER
NOMOUSE
LIRCKBD

export GCC2C_NO_CONVERTER_INVOCATION=1
make all

final changes:
Arch.rules
include/mwtypes.h
include/nano-X.h
nanox/nxtransform.c
nanox/Makefile
demos/mwin/Makefile
demos/nanowm/Makefile
demos/nanowm/nanowm.h
demos/nanox/Makefile
demos/nanox/nxterm.c
demos/nxkbd/Makefile
demos/nxroach/Makefile
demos/nxroach/nxroach.c
demos/nxscribble/li_recognizer.c
demos/nxscribble/util.c
demos/nxscribble/Makefile 
demos/tuxchess/Makefile 
demos/Makefile
demos/nanox/launcher.c
linux/fb.h

status: 15feb2005
deleted demos: nbreak vnc

run problem with:
nxeyes,tux

drivers/scr_fb.c line 307
        the munmap() problem. currently commented.

}}}2

}}}1
015 - Replace linux funcs by TI {{{1

Given list of 208 funcs from TI's lib rts6400.lib which gives good performance
for video.
70 of them already in libm, 73 - already in liblddk, 15 - new for liblddk,
2 canceled (ctime,clearerr), 1 - already in libc (memcpy64)
It is left 47 funcs.

The whole list {{{2
 abs.obj                libc
 absd.obj               liblddk
 absf.obj               liblddk
 acos.obj               libm
 acosf.obj              libm    
 acosh.obj              libm    
 acoshf.obj             libm    
 acot.obj               libm
 acot2.obj              libm    
 acot2f.obj             libm    
 acotf.obj              libm    
 acoth.obj              libm    
 acothf.obj             libm    
 addd.obj               liblddk
 addf.obj               liblddk
 array.obj              ?       
 asin.obj               libm
 asinf.obj              libm    
 asinh.obj              libm    
 asinhf.obj             libm    
 atan.obj               libm
 atan2.obj              libm    
 atan2f.obj             libm    
 atanf.obj              libm    
 atanh.obj              libm    
 atanhf.obj             libm    
 atof.obj               libc
 atoi.obj               libc
 atol.obj               libc
 bsearch.obj            libc
 ceil.obj               libm
 ceilf.obj              libm    
 clearerr.obj           libc    canceled, due to usage of FILE
 cmpd.obj               liblddk
 cmpf.obj               liblddk
 cos.obj                libm
 cosf.obj               libm
 cosh.obj               libm
 coshf.obj              libm    
 cot.obj                libm
 cotf.obj               libm
 coth.obj               libm
 cothf.obj              libm    
 ctime_.obj             ? (ctime_r in libc)     canceled        
 ctype.obj              ?       
 cvtdf.obj              liblddk 
 cvtfd.obj              liblddk 
 defs.obj               ?
 del_af.obj                     liblddk 
 del_afn.obj            liblddk 
 del_afp.obj            liblddk 
 del_sof.obj            liblddk 
 del_sofn.obj           liblddk 
 del_sofp.obj           liblddk 
 div.obj                libc
 divd.obj               liblddk
 divf.obj               liblddk
 divi.obj               liblddk
 divu.obj               liblddk
 dtos.obj               ?
 ecvt.obj               ?
 exp.obj                libm
 exp10.obj              libm    
 exp10f.obj             libm    
 exp2.obj               libm
 exp2f.obj              libm    
 expf.obj               libm
 fabs.obj               libm
 fabsf.obj              libm    
 fcvt.obj               liblddk
 fixdb.obj              liblddk 
 fixdc.obj              liblddk 
 fixdi.obj              liblddk 
 fixdli.obj             liblddk 
 fixdsi.obj             liblddk 
 fixdu.obj              liblddk 
 fixdul.obj             liblddk 
 fixdus.obj             liblddk 
 fixfb.obj              liblddk 
 fixfc.obj              liblddk 
 fixfi.obj              liblddk
 fixfli.obj             liblddk
 fixfsi.obj             liblddk
 fixfu.obj              liblddk
 fixful.obj             liblddk
 fixfus.obj             liblddk
 floor.obj              libm
 floorf.obj             libm
 fltbd.obj              liblddk
 fltbf.obj              liblddk
 fltcd.obj              liblddk
 fltcf.obj              liblddk
 fltid.obj              liblddk
 fltif.obj              liblddk
 fltlid.obj             liblddk
 fltlif.obj             liblddk
 fltsid.obj             ?
 fltsif.obj             liblddk
 fltud.obj              liblddk
 fltuf.obj              liblddk
 fltuld.obj             liblddk
 fltulf.obj             liblddk
 fltusd.obj             liblddk
 fltusf.obj             liblddk
 frcaddd.obj            liblddk
 frcaddf.obj            liblddk
 frcdivd.obj            liblddk
 frcdivf.obj            liblddk
 frcmpyd.obj            liblddk
 frcmpyf.obj            liblddk
 gsmfuncs.obj           ?
 gsmvars.obj            ?
 imath40.obj            liblddk 
 isalnum.obj            libc    
 isalpha.obj            libc    
 isascii.obj            libc    
 iscntrl.obj            libc    
 isdigit.obj            libc    
 isgraph.obj            libc    
 islower.obj            libc    
 isprint.obj            libc    
 ispunct.obj            libc    
 isspace.obj            libc    
 isupper.obj            libc    
 isxdigit.obj           libc    
 ldexp.obj              libm    
 ldexpf.obj             libm    
 log.obj                libm
 log10.obj              libm    
 log10f.obj             libm    
 log2.obj               libm
 log2f.obj              libm    
 logf.obj               libm
 ltoa.obj               ?
 memccpy.obj    libc    
 memchr.obj             libc    
 memcmp.obj             libc    
 memcpy62.obj   ?       
 memcpy64.obj   libc (already)  
 memmov.obj             ? (memmove - libc)      
 memset.obj             libc
 mktime.obj             libc
 modf.obj               libm
 modff.obj              libm    
 mpyd.obj               liblddk
 mpyf.obj               liblddk
 negd.obj               liblddk
 negf.obj               liblddk
 new_af.obj             liblddk 
 new_afn.obj    liblddk 
 new_afp.obj    liblddk 
 new_sof.obj    liblddk 
 new_sofn.obj   liblddk 
 new_sofp.obj   liblddk 
 pow.obj                libm
 powf.obj               libm
 powi.obj               libm
 powif.obj              libm    
 qsort.obj              libc    
 remi.obj               liblddk
 remu.obj               liblddk
 renormd.obj    liblddk 
 renormf.obj    liblddk 
 round.obj              libm    
 roundf.obj             libm    
 rsqrt.obj              libm    
 rsqrtf.obj             libm    
 sin.obj                libm
 sinf.obj               libm
 sinh.obj               libm
 sinhf.obj              libm    
 sinit.obj              ?       
 sqrt.obj               libm
 sqrtf.obj              libm    
 strcat.obj             libc    
 strchr.obj             libc    
 strcmp.obj             libc
 strcoll.obj    ?
 strcpy.obj             libc
 strcspn.obj    libc
 strerror.obj   libc
 strlen.obj             libc
 strncat.obj    libc
 strncmp.obj    libc
 strncpy.obj    libc
 strpbrk.obj    libc
 strrchr.obj    libc
 strspn.obj             libc
 strstr.obj             libc
 strtod.obj             libc
 strtok.obj             libc
 strtol.obj             libc
 strtold.obj    libc    
 strtoul.obj    libc    
 strxfrm.obj    ?       
 subd.obj               liblddk
 subf.obj               liblddk
 tan.obj                libm
 tanf.obj               libm
 tanh.obj               libm
 tanhf.obj              libm    
 tmzone.obj             ?       
 toascii.obj    libc    
 tolower.obj    libc    
 toupper.obj    libc    
 trgmsg.obj             ?       
 trunc.obj              libm    
 truncf.obj             libm    
}}}2

The list of 15 new functions added to liblddk{{{2
 array.obj
 ctype.obj
 defs.obj
 dtos.obj
 ecvt.obj
 fltsid.obj
 gsmfuncs.obj
 gsmvars.obj
 ltoa.obj
 memcpy62.obj
 sinit.obj
 strcoll.obj
 strxfrm.obj
 tmzone.obj
 trgmsg.obj
}}}2
The list of 47 left {{{2
 abs.obj        libc    no      same code or better
 atof.obj       libc    no      same code or better
 atoi.obj       libc    no      same code or better
 atol.obj       libc    no      same code or better
 bsearch.obj    libc    no      same code or better
 div.obj        libc    no      
 isalnum.obj    libc    no      it is macro in our code
 isalpha.obj    libc    no      it is macro in our code
 isascii.obj    libc    no      it is macro in our code
 iscntrl.obj    libc    no      it is macro in our code
 isdigit.obj    libc    no      it is macro in our code
 isgraph.obj    libc    no      it is macro in our code
 islower.obj    libc    no      it is macro in our code
 isprint.obj    libc    no      it is macro in our code
 ispunct.obj    libc    no      it is macro in our code
 isspace.obj    libc    no      it is macro in our code
 isupper.obj    libc    no      it is macro in our code
 isxdigit.obj   libc    no      it is macro in our code
 memccpy.obj    libc    no      
 memchr.obj     libc    ?       "inline, so have to decide"
 memcmp.obj     libc    ?       "inline, so have to decide"
 memmov.obj     libc    no      
 memset.obj     libc    yes     
 mktime.obj     libc            
 qsort.obj      libc    no      same code or better
 strcat.obj     libc    ?       "inline, so have to decide"
 strchr.obj     libc    ?       "inline, so have to decide"
 strcmp.obj     libc    ?       "inline, so have to decide"
 strcpy.obj     libc    ?       "inline, so have to decide"
 strcspn.obj    libc    ?       "inline, so have to decide"
 strerror.obj   libc    ?       "inline, so have to decide"
 strlen.obj     libc    ?       "inline, so have to decide"
 strncat.obj    libc    ?       "inline, so have to decide"
 strncmp.obj    libc    ?       "inline, so have to decide"
 strncpy.obj    libc    ?       "inline, so have to decide"
 strpbrk.obj    libc    ?       "inline, so have to decide"
 strrchr.obj    libc    ?       "inline, so have to decide"
 strspn.obj     libc    ?       "inline, so have to decide"
 strstr.obj     libc    ?       "inline, so have to decide"
 strtod.obj     libc    ?       "inline, so have to decide"
 strtok.obj     libc    ?       "inline, so have to decide"
 strtol.obj     libc    ?       "inline, so have to decide"
 strtold.obj    libc    ?       "inline, so have to decide"
 strtoul.obj    libc    ?       "inline, so have to decide"
 toascii.obj    libc    no      
 tolower.obj    libc    no      
 toupper.obj    libc    no      
}}}2

subset #1 {{{2
 memccpy.obj    libc    no      
 memchr.obj     libc    ?       "inline, so have to decide"
 memcmp.obj     libc    ?       "inline, so have to decide"
 memmov.obj     libc    no      
 memset.obj     libc    yes     
 strcat.obj     libc    ?       "inline, so have to decide"
 strchr.obj     libc    ?       "inline, so have to decide"
 strcmp.obj     libc    ?       "inline, so have to decide"
 strcpy.obj     libc    ?       "inline, so have to decide"
 strcspn.obj    libc    ?       "inline, so have to decide"
 strerror.obj   libc    ?       "inline, so have to decide"
 strlen.obj     libc    ?       "inline, so have to decide"
 strncat.obj    libc    ?       "inline, so have to decide"
 strncmp.obj    libc    ?       "inline, so have to decide"
 strncpy.obj    libc    ?       "inline, so have to decide"
 strpbrk.obj    libc    ?       "inline, so have to decide"
 strrchr.obj    libc    ?       "inline, so have to decide"
 strspn.obj     libc    ?       "inline, so have to decide"
 strstr.obj     libc    ?       "inline, so have to decide"
 strtod.obj     libc    ?       "inline, so have to decide"
 strtok.obj     libc    ?       "inline, so have to decide"
 strtol.obj     libc    ?       "inline, so have to decide"
 strtold.obj    libc    ?       "inline, so have to decide"
 strtoul.obj    libc    ?       "inline, so have to decide"
}}}2
subset #2 {{{2
 memccpy.obj    libc    no      
 memchr.obj     libc    ?       "inline, so have to decide"
 memcmp.obj     libc    ?       "inline, so have to decide"
 memmov.obj     libc    no      
 memset.obj     libc    yes     
}}}2

Results:
Replace memset() in libc
Add 15 TI's functions to liblddk

}}}1
016 - ANT {{{1

Ant build environment {{{2

cd <ant-src>/builds/dm642-xgcui
Makefile
|--> ../.(layers,layers-target)./src/rules/build-auto.txt {{{3
|    |- BUILD_OS
|    |--> ../../src/rules/build-unix.txt {{{4
|    |    |- BUILD_CC, GNU-CPP, RM, CP, BUILD_MAKELIB, BUILD_LINK
|    |    |- BUILD_LINKFLAGS, BUILD_CFLAGS, BUILD_LIB_EXT, BUILD_OBJ_EXT,
|    |    |- BUILD_EXE_SUFFIX, PYTHON, XSLT, RESOURCES_MAKEFILE
|    |    |_ <rules> %.$(BUILD_OBJ_EXT): %.c            }}}4
|    |- BUILD_TARGET
|    |_ BUILD_LTI                       }}}3
|
|--> ../../src/rules/target-gcc.txt {{{3
|    |- MY_OS
|    |- CC, DEPEND_CC, MAKELIB, LINK, LINK_OUT
|    |- LINK_FN
|    |- LIB_EXT, OBJ_EXT, ASM_EXT, DEPEND_OBJ_EXT, DEPEND_EXT, PREPROC_EXT,
|    |- EXE_SUFFIX, EXE_PREFIX
|    |- COMPILER_FLAGS, PREPROC_FLAGS, LINKFLAGS, Warnings
|    |- CFLAGS, CFLAGS_DEP
|    |_ LIBS, LINKFLAGS                 }}}3
|
|--> ../../src/rules/all.txt {{{3
|    |- PROGRAM_NAME, PROGRAM_VERSION, MESSAGE_FILES, UNIT_TESTS,
|    |- INCLUDES, ALL_OBJECTS, PREREQS
|    |- OBJ_DIR, OBJ_ROM_DIR, OBJ_DDT_DIR, OBJ_PRE_DIR, OBJ_MEM_DIR, PRE_DIR,
|    |- DEPEND_DIR, BIN_DIR, GEN_DIR, PREBUILT_DIR
|    |
|    |- SPRITES, SWAPPED, RESOURCES, MESSAGES, FIX_RESOURCES, FIX_MESSAGES
|    |- FIX_SPRITES RESOURCE_PATH
|    |
|    |- <rules>
|    |  $(OBJ_PRE_DIR)/%.$(OBJ_EXT):    $(PRE_DIR)/%.$(PREPROC_EXT)
|    |  $(PRE_DIR)/%.$(PREPROC_EXT):    %.c
|    |  $(OBJ_DIR)/%.$(OBJ_EXT):    %.c
|    |  $(OBJ_ROM_DIR)/%.$(OBJ_EXT):    %.c
|    |  $(DEPEND_DIR)/%.$(DEPEND_EXT):  %.c   Dependencies
|    |      @$(DEPEND_CC) $< $(INCLUDES) $(CFLAGS_DEP) | sed -e '...'
|    |
|    |_ <targets> depends               }}}3
|
|- COMMON_FLAGS, CFLAGS,
|- ANT_MALLOC, ANT_REALFLEX
|
|--> ../../src/layers/xwin/make.txt     {{{3
|    |--> $(ROOT)/src/layers/common/make.txt
|    |--> $(ROOT)/src/layers/fb/make.txt
|    |- OBJECTS, COMPONENT (LAYERS,LAYERS-TARGET), LEAF(layers,layers-target)
|    |--> $(RULES)/rules.txt            }}}3
|   
|--> ../../src/browser/commonsrc/make.txt
...
|--> ../../src/plugins/player/make.txt
|
|- RESOURCE_MASTER
|--> ../../src/fe_generic_glass/make.txt
|
|- ALL_OBJECTS
|--> ../../src/rules/post.txt
|- MODULES, OBJECTS, LIB_NAMES, MY_LIBS
|- <rules> $(BIN_DIR)/ssleay.$(LIB_EXT), $(BIN_DIR)/https.$(LIB_EXT)
|
|_ <targets>
        $(RUN):     $(PREREQS) $(OBJECTS) $(MY_LIBS) $(DLLS)
                $(CC) 
                $(LINK)
}}}2

LTI layer {{{2

driver.h from xwin

#include <X11/Xlib.h>
#include <X11/Intrinsic.h>
#include <X11/StringDefs.h>
#include <X11/Shell.h>
#include <X11/keysym.h>

XtAppContext app

driver.c from xwin

main
|- Widget w, panel;
|-> useropts_process_cmdline()                                          common/useropts.c
|-> memory_initialise()                                                         driver.c
|   |-> flex_init()                                             common/memory/flex2.c or fake-flex.c
|   |_> mm_init()                                                                       common/memwatch.c
|
|-> useropts_geometry()                                                         common/useropts.c   
|-> useropts_process_cmdline()                                          common/useropts.c
|-> XtSetArg()
|-> toplevel = XtAppInitialize()
|-> panel = XtCreateManagedWidget()
|-> layers_recorder_init()                                                      record-replay/record_misc.c
|-> layers_record_cmdline()                                                     record-replay/record.c
|-> xwin_time_init()                                                            xwin/alarm.c
|-> XtAddEventHandler()
|-> useropts_dont_open_window()                                         common/useropts.c
|-> create_image()                                                                      driver.c {{{3
|   |-> XtDisplay()
|   |-> DefaultVisualOfScreen()
|   |-> XtScreen()                                                                      
|   |-> ImageByteOrder()                                                        
|   |-> init_8bpp()                                                                     driver.c
|   |   |-> DefaultColormapOfScreen()
|   |   |-> my_alloc_colour()                                           driver.c
|   |   |   |-> XAllocColor()
|   |   |   |-> ...
|   |   |_> XQueryColor()
|   |_>  XCreateImage()                                                         }}}3
|
|-> init_debug()                                                                        driver.c
|   |_> layers_debug_cmdline()                                          common/trace.c
|
|-> useropts_memdump_disabled()                                         common/useropts.c
|-> layers_dbglist()                                                            common/trace.c
|-> dbg_indent()                                                                        common/trace.c
|-> do_initialise()                                                                     driver.c
|   |-> confman_initialise()                                            common/confman/cm_switch.c
|   |-> layers_namecache_init()
|   |-> layers_dns_init()
|   |-> underlay_initialise2()                                          fb/thewimp.c
|   |_> layers_win_update()                                                     common/peers/selectpeer.c
|
|-> XtAppAddSignal()
|-> layers_recorder_replaying()
|_> event_loop()                                                                                                driver.c
    |-> layers_check_modal()                                                                    common/modal.c
    |-> layers_leaving_modal()                                                                  common/modal.c
    |-> handle_event()                                                                                  driver.c
    |   |-> XtAppPending()
    |   |_> XtAppProcessEvent()
    |-> XtAppPending()
    |-> XtAppProcessEvent()
    |-> DECLARE_TIMER(), START_TIMER(), END_TIMER()                             unix/timing.h
    |-> task__run()                                                                                             common/task.c
    |-> underlay_update()     underlay.h macro - layers_win_update(FALSE)
    |-> layers_clear_modal()                                                                    common/modal.c
    |_> layers_terminate()                                                                              fb/terminate.c

}}}2

X functions from layers/xwin {{{2

XAllocColor (Display, Colormap, XColor) 
XQueryColor (Display, Colormap, XColor)
DefaultColormapOfScreen (Screen)
XtDisplay (Widget)
DefaultVisualOfScreen (Screen)
XtScreen (Widget)
ImageByteOrder (Display)
XCreateImage (Display,Visual,unsigned int depth, int format, int offset,
              char *data, unsigned int width, unsigned int height, 
              int bitmap_pad, int bytes_per_line)
XPutPixel (XImage *ximage, int x, int y, unsigned long pixel)
XtGetGC (Widget w, XtGCMask value_mask, XGCValues *values)
XtWindow (Widget)
XtReleaseGC (Widget w, GC gc)
XPutImage (Display *display, Drawable d, GC gc, XImage *image, int src_x,
           int src_y, int dest_x, dest_y, unsigned int width, height)
XCheckTypedEvent (Display *display, int event_type, XEvent *event_return)
XLookupString (XKeyEvent *event_struct, char *buffer_return,int bytes_buffer,
               KeySym *keysym_return, XComposeStatus *status_in_out)
XtRemoveInput
XtAppAddInput
XCreatePixmap
XCreatePixmapCursor
XDefineCursor
XtNoticeSignal
XtAppPending
XtAppProcessEvent
XtSetArg
XtAppInitialize
XtCreateManagedWidget
XtAddEventHandler
XtRealizeWidget
XtAppAddSignal
XtAppAddTimeOut
XWarpPointer (Display *display, Window src_w, dest_w, int src_x, src_y,
              unsigned int src_width, src_height, int dest_x, dest_y)

Display from /usr/include/X11/Xlib.h
}}}2

+++
Change `Xlib' on `nx11' in `src/rules/target-gcc.txt'
+++
ANT size.
Have 2 heap allocations, which allocated 6MB each, by default. Could be manage
with `--heapsize 2m --flexsize 2m'

`--url www.av.com'
+++
Make resources.
cd <ant>/src
<copy swapped.out to here>
python ../tools/scripts/python/fixresources.py -littleendian -master ../src/fe_generic_glass/master.txt -output r.out
+++
ml --geometry 400x200 --url file:meta.html
+++

Cmd options:
Load new file - ## file:<filename>
Load new page - ## <url>

To automatic close error messages set follows in config:
dialog.autoconfirm.delay: 9

CJK {{{2
16dec2004 22may2005

}}}2

Plugins {{{2

Enable plugins.
Add macro `FLAVOUR_PLUGINS 1' in fe_generic/variant.h
add to Makefile `include $(ROOT)/src/plugins/make.txt'
In fe_generic/frontend.c add follows:
`#if FLAVOUR_PLUGINS
 #include "example_plugin.h" '
and in layers_client() add call to `example_plugin_register()'

Add plugin PL1.
at fe_generic/frontend.c add inside of `FLAVOUR_PLUGINS':
`#if PL1_PLUGIN
     pl1_plugin_register()
 #endif '

Function to implement:
play                    x
stop                    x
pause                   x
exit|close              x
move2back               x
move2front              x
fullscreen              x
setwindow
getState
setframe                x
playbyframe
setsound
txtctrl
send dmx ioctl

}}}2

Fix refresh {{{2

After ANT's start the dmx takes 50% of CPU. This because of dmx region of type
1 and write for every pixel.
Changes: change dmx region to type 2 and explicitly write.
All changes placed under macro CANCEL_FIX_29DEC
bmp.c
mlx.c mlx.h
driver.c

}}}2

ANT window resize {{{2
        18jan2005
The idea is to resize ANT window (and DMX region) by adding HTML META tags in
html document. Not to rescale.
There are 2 ways to do it. By command line parameter and by META tag.

Command line parameter
----------------------
The `ml --geometry 320x160' does open window of given size, but dmx region still
of full size.
Change of fb_init() (from builds/ml/mlx/mlx.c) to send right W&H to dmx region.
Look for architecture bellow: {{{3
-------------
main() (from src/layers/ml/driver.c)
|->mlx_init_size() (from builds/ml/mlx/mlx.c)
|  |->bmp_init()
|  |->bmp_get_scr_size()
|  |_>fix H&W for dmw region from macros MARGIN_TOP,MARGIN_BOT,HMARGIN
|
|->useropts_process_cmdline()
|->memory_initialise()
|->useropts_geometry()
|->mlx_init()
|  |_>fb_init()
|     |-> ...
|     |->bmp_load_dummy() // open dmx region with H&W initialized in 
|        // mlx_init_size()
|     |_> ...
|
|->call_bmp_disable()
|->layers_recorder_init()
|->...
|->create_image() (from src/layers/ml/driver.c)
|  |-> ...
|  |-> // print "Opening screen..."
|  |-> ...
|  |_> ...
|
|->...
|_>
}}}3

META tags side
--------------
HTML lets specify meta data - info about document rather than document
content. For example: <META name="Author" content="David"> Here, `META' element
specifies a property named `Author' and a value for it `David'.
The frontend can resize and reposition the window.
Definition of meta tags:
<META name="winwidth" content="320">
<META name="winheight" content="200">
The ANT should be run w/ option: `fe_generic.toolbar.on: 0'
from fresco-larch-f-2-4.pdf
browser_doc_lookup_meta() (page 57)
Look for architecture bellow: {{{3
-------------
browser_doc_lookup_meta() (src/browser/commonsrc/browser.c)
|->backend_check_meta_merge()
|_>backend_check_meta()

browser_doc_lookup_meta() (src/browser/commonsrc/backend.c)
|->be_doc_finished() (src/browser/commonsrc/backend.c)
|  |-> ...
|  |->backend_check_meta()
|  |-> ...
|  |-> 
|  |-> ...
|  |_>
|
|->...
|_>
}}}3

final changes: {{{3
builds/ml/Makefile
builds/ml/mlx/mlx.c
builds/ml/mlx/mlx.h
src/browser/commonsrc/backend.c
builds/ml/mlx/bmp.c
builds/ml/mlx/bmp.h

release notes:
1. common dmx region size if command line options `--geometry W&H' used
2. add ability to read 4 new meta tags (winwidth,winheight,win_x_pos,win_y-pos)
3. add functionality to resize ANT, depend on new meta tags
   (works if no toolbar)

}}}3
}}}2

Build on 2.6 {{{2

Should change path to dmxio.h ( asm/dmx/dmxio.h ) in follows files:
src/plugins/mplayer/jsmplayer.c
src/plugins/mplayer/mplayer.c
builds/ml/mlx/mlx.c
builds/ml/mlx/bmp.c

Add linker option `--default_order' to Makefile

status 10mar2005
1. Unresolved symbols: pow,ceil,log,floor,fmod ( not exists in libm )
2. Unresolved syms: __cinit, __pinit (crti.o)

}}}2

ANT font manager usage {{{2
16mar2005

Source ape-webfonts-1-4.pdf

src/layers/webfonts.h

webfonts_initialise()
webfont_find_typeface()
        takes font name, style word, language number and set of flags. returns
    typeface id. The lang nbr corresponds to the number returned by func
        lang_name_to_num() from layers/common/unicode/lang.c
webfont_select()
webfont_discard()

TODO:
1. change hardcoded width & height in src/browser/commonsrc/backend.c 
   be_doc_finished() and mlx_resize() from builds/ml/mlx/mlx.c
2. find feature called transition or disloving (HTML,CSS, ANT ???)

}}}2

ARCHITECTURE {{{2
------------
main() (from src/layers/ml/driver.c)
|->mlx_init_size() (from builds/ml/mlx/mlx.c)
|  |->bmp_init()
|  |->bmp_get_scr_size()
|  |_>fix H&W for dmw region from macros MARGIN_TOP,MARGIN_BOT,HMARGIN
|
|->useropts_process_cmdline()
|->memory_initialise()
|->useropts_geometry() (from src/layers/common/useropts.c)
|  // fill W&H for off-screen buffer
|->mlx_init() (from builds/ml/mlx/mlx.c)
|  |_>fb_init() (from builds/ml/mlx/mlx.c)
|     |->irw_init()
|     |->bmp_load_dummy() (from builds/ml/mlx/bmp.c)  // open dmx region with
|     |  | // H&W initialized in mlx_init_size()
|     |  |_>real_bmp_load() (from builds/ml/mlx/bmp.c)
|     |
|     |_>bmp_r_ptr()
|
|->call_bmp_disable()
|->layers_recorder_init()
|->...
|->create_image() (from src/layers/ml/driver.c)
|  |-> ...
|  |-> // print "Opening screen..."
|  |-> ...
|  |_> ...
|
|->init_debug()
|->useropts_memdump_disabled()
|->layers_dbglist()
|->dbg_indent()
|->mlx_init_AddInput()
|->do_initialise()
|->layers_recorder_replaying()
|->event_loop()
| |->...
| |->underlay_update()
| |  |_>layers_win_update() (from src/layers/fb/thewimp.c)
| |     |-?layers_recorder_event()
| |     |->layers_win_validate_all()  30us
| |     |  |->
| |     |  |_>
| |     |->do_update_screen()         30us
| |     |  |->rectlist_optimise()
| |     |  |->screen_to_frame_buffer()
| |     |  |->layers_record_event_string()
| |     |  |->underlay_update_screen() (from src/layers/ml/driver.c)
| |     |  |  |_>destimageblit()
| |     |  |     |_>destimageblit24()
| |     |  |        |->fake_alpha()
| |     |  |        |->mlx_PutPixel()                335 times
| |     |  |        |->mlx_round_corners_validate()
| |     |  |        |_>call_bmp_refresh()
| |     |  |->layers_record_event_string()
| |     |  |_>rectlist_dispose()
| |     |_>layers_record_event_string()
| |
| |->call_bmp_enable()
| |_>...
|_>mlx_term()
}}}2

}}}1
017 - ZLIB {{{1
        31oct2004
version 1.2.1
own makefile. have to change UCLINUX_PATH.
without converter.
}}}1
018 - PNG {{{
        19oct2004

Using my makefiles.
make clean all install

}}}
019 - JPG {{{1
        19oct2004

        make clean all install
}}}1
020 - SDL {{{
        09aug2004 www.libsdl.org

SDL configuration {{{2
x86: {{{3
configure --prefix=/usr/local/SDL --enable-strict-ansi --disable-joystick --disable-cdrom --disable-oss --disable-esd --disable-arts --disable-nas --disable-diskaudio --disable-mintaudio --disable-nasm --disable-dga --disable-pth --disable-stdio-redirect --disable-directx --disable-sdl-dlopen --disable-atari-ldg --without-x --disable-audio
make
sudo make install

cd SDL-1.2.7/test

if havn't sound|cdrom|joystick so delete from Makefile.in follows tests:
        loopwave, testcdrom, testjoystick
configure --prefix=/usr/local/SDL/bin --with-sdl-prefix=/usr/local/SDL
make
}}}3
tms320c6 w/ conv {{{3

Adding cpu-os attributes for config.sub
Should be used w/ configure parameter target like evm642|vm1|vm2*
Changing configure
Add target medialinux case
Changing src/main/Makefile.in
ARFLAGS=ur

setenv CONFIG_SITE ~/prjs/SDL/mySDL/config.site
(w/o sound)
configure --build=i686-pc-linux-gnu --host=x86-linux --target=evm642 --prefix=/opt/tms320c6/SDL --disable-shared --disable-joystick --disable-cdrom --disable-oss --disable-esd --disable-arts --disable-nas --disable-diskaudio --disable-mintaudio --disable-nasm --disable-video-x11 --disable-dga --disable-video-x11-vm --disable-video-x11-dgamouse --disable-video-x11-xv --disable-video-x11-xinerama --disable-video-x11-xme --disable-video-dga --disable-video-photon --disable-video-ps2gs --disable-video-xbios --disable-video-gem --disable-video-opengl --disable-pth --disable-stdio-redirect --disable-directx --disable-sdl-dlopen --disable-atari-ldg --without-x --disable-audio

(w/ sound)
configure --build=i686-pc-linux-gnu --host=x86-linux --target=evm642 --prefix=/opt/tms320c6 --disable-shared --disable-joystick --disable-cdrom --disable-esd --disable-arts --disable-nas --disable-diskaudio --disable-mintaudio --disable-nasm --disable-video-x11 --disable-dga --disable-video-x11-vm --disable-video-x11-dgamouse --disable-video-x11-xv --disable-video-x11-xinerama --disable-video-x11-xme --disable-video-dga --disable-video-photon --disable-video-ps2gs --disable-video-xbios --disable-video-gem --disable-video-opengl --disable-pth --disable-stdio-redirect --disable-directx --disable-sdl-dlopen --disable-atari-ldg --without-x

BUILDING
make clean all install && pushd test && make conv=1 clean all install ; popd

*Change src/video/fbcon/SDL_fbvideo.c
change  MAP_SHARED to 0
comment call to FB_OpenMouse
*Change src/video/fbcon/SDL_fbevents.c
/dev/tty0 to /dev/console
comment ioctls KDGKBMODE, KDSKBMODE and KDSETMODE to keyboard {
        get mode, set raw mode , set graphic mode }

}}}3
tms320c6 w/o conv {{{3
        setenv GCC2C_NO_CONVERTER_INVOCATION 1
Change libtool.
        Add follows 
        # gxk 19aug2004 add GCC2C_NO_CONVERTER_INVOCATION=1
        new_command="GCC2C_NO_CONVERTER_INVOCATION=1 $command"
        in line 1090
Change include/SDL_endian.h
        comment lines 60-68
Change test/makefile

configure --host=x86-linux --target=evm642 CC=tms320c6-coff-gcc LD=tms320c6-coff-ld CXX=tms320c6-coff-gcc AR=tms320c6-coff-ar NM=tms320c6-coff-nm RANLIB=tms320c6-coff-ranlib CFLAGS="-I/home/gxk/softier/uClinux-dist/uClibc/include -I/home/gxk/softier/uClinux-dist/linux-2.4.x/kad/include -fomit-frame-pointer -Dlinux -D__linux__ -Dunix -D__uClinux__ -DEMBED -fno-builtin -nostartfiles -D_TMS320C6 -D__inline__=inline -D__signed__=signed -D_TMS320C6X_NOCONVERTER -D__PIC__ -fpic" AR_FLAGS="ur" --prefix=/usr/local/SDL --disable-shared --disable-joystick --disable-cdrom --disable-oss --disable-esd --disable-arts --disable-nas --disable-diskaudio --disable-mintaudio --disable-nasm --disable-video-x11 --disable-dga --disable-video-x11-vm --disable-video-x11-dgamouse --disable-video-x11-xv --disable-video-x11-xinerama --disable-video-x11-xme --disable-video-dga --disable-video-photon --disable-video-ps2gs --disable-video-xbios --disable-video-gem --disable-video-opengl --disable-pth --disable-stdio-redirect --disable-directx --disable-sdl-dlopen --disable-atari-ldg --without-x --disable-audio
make
pushd test && make clean all install-gxk && popd
}}}3
Tests {{{3
cp Makefile & config.status  from linux-based SDL tests and change it.
Create 23 tests. Status table:
                                                        02sep2004
                checkkeys               -       
                graywin                 -
                testalpha               -+
                testbitmap              -+
                testcpuinfo             +
                testerror               +
                testgamma               -+
                testhread               +
                testkeys                -
                testlock                +
                testoverlay             +
                testoverlay2    -+
                testpalette             -+
                testsem                 +
                testsprite              -
                testtimer               +
                testtypes               +
                testver                 +
                testvidinfo             +
                testwin                 -+
                testwm                  -+
                threadwin               -+
}}}3
}}}2

SDL_image {{{2

The configure way {{{3
Adding follows in config.sub:
        evm642 | vm1 | vm2*)
                basic_machine=tms320c6
                os=-medialinux
                ;;
and
        -medialinux*)
        os=-medialinux
        ;;

cp config.site from <SDL place>
setenv CONFIG_SITE ~/prjs/SDL/mySDL_image/config.site
setenv SDL_CONFIG /home/gxk/prjs/SDL/mySDL/sdl-config

change Makefile.in:
showimage_LDADD = -l$(UCLINUX_PATH)/lib/crti.o -l$(UCLINUX_PATH)/lib/libc.a -l$(UCLINUX_PATH)/lib/libdt.a -l/usr/local/tools/ti-lib/libsoftier.lib -l../SDL/src/.lib/libSDL.a -l./.libs/libSDL_image.a -l../libpng-1.2.7/libpng.a -l$(UCLINUX_PATH)/../vendors/TI/TMS320C6/userapps.cmdshowimage_LDADD = -l$(UCLINUX_PATH)/lib/crti.o -l$(UCLINUX_PATH)/lib/libc.a -l$(UCLINUX_PATH)/lib/libdt.a -l/usr/local/tools/ti-lib/libsoftier.lib -l../SDL/src/.lib/libSDL.a -l./.libs/libSDL_image.a -l../libpng-1.2.7/libpng.a -l$(UCLINUX_PATH)/../vendors/TI/TMS320C6/userapps.cmd
CCLD = tms320c6-coff-ld
LINK = $(LIBTOOL) --mode=link $(CCLD) $(LDFLAGS) -o $@
showimage_LDFLAGS = -z -ar -x
showimage: $(showimage_OBJECTS) $(showimage_DEPENDENCIES)
        $(LIBTOOL) --mode=link $(CCLD) $(LDFLAGS) $(showimage_LDFLAGS) $(showimage_OBJECTS) $(showimage_LDADD) -o $@
install-Programs:
    @list='$(PROGRAMS)'; for p in $$list; do \
      if test -f $$p; then \
        echo "cp $$p $(DESTDIR)$(bindir)/$$p"; \
        $(LIBTOOL)  --mode=install $(INSTALL) $$p $(DESTDIR)$(bindir)/$$p; \
      fi; \
    done
install-exec: install-exec-am install-Programs

Change in ltconfig:
old_archive_cmds='$AR ru $oldlib$oldobjs'

Add follows in configure:
after `# Actually configure libtool.  ac_aux_dir is where install-sh is found.'
AR="AR"

rm -rf config.cache
configure --build=i686-pc-linux-gnu --host=x86-linux --target=evm642 --prefix=/opt/tms320c6 --enable-strict-ansi --disable-shared --disable-joystick --disable-cdrom --disable-video-X11 --enable-video-fbcon --without-x --disable-gif --disable-jpg --disable-lbm --disable-png --disable-pnm --disable-tga --disable-xpm --with-sdl-prefix=/home/gxk/prjs/SDL/mySDL --disable-libtool-lock

configure --build=i686-pc-linux-gnu --host=x86-linux --target=evm642 --prefix=/opt/tms320c6 --enable-strict-ansi --disable-shared --disable-joystick --disable-cdrom --disable-video-X11 --enable-video-fbcon --without-x --disable-gif --disable-lbm --disable-pnm --disable-tga --disable-xpm --with-sdl-prefix=/home/gxk/prjs/apps/SDL --disable-libtool-loc
}}}3

gxk makefiles: make clean all install
}}}2

SDL_mixer {{{2

configuration: {{{3

setenv CONFIG_SITE ~/prjs/SDL/mySDL_mixer/config.site
setenv SDL_CONFIG /home/gxk/prjs/SDL/mySDL/sdl-config

Adding follows in config.sub:
        evm642 | vm1 | vm2*)
                basic_machine=tms320c6
                os=-medialinux
                ;;
and
        -medialinux*)
        os=-medialinux
        ;;

Change in Makefile.in:
libSDL_mixer_la_LIBADD = $(MIKMOD_LIB) $(TIMIDITY_LIB) $(NATIVE_MIDI_LIB) @SYSTEM_LIBS@ -l/opt/tms320c6/SDL/lib/libSDL.a -l/home/gxk/softier/uClinux-dist/uClibc/lib/libm.a
playwave_LDADD = -l/home/gxk/softier/uClinux-dist/uClibc/lib/crti.o -l/home/gxk/softier/uClinux-dist/uClibc/lib/libc.a -l/home/gxk/softier/uClinux-dist/uClibc/lib/libdt.a -l/usr/local/tools/ti-lib/libsoftier.lib libSDL_mixer.la -l/home/gxk/softier/uClinux-dist/vendors/TI/TMS320C6/userapps.cmd
playmus_LDADD =  -l/home/gxk/softier/uClinux-dist/uClibc/lib/crti.o -l/home/gxk/softier/uClinux-dist/uClibc/lib/libc.a -l/home/gxk/softier/uClinux-dist/uClibc/lib/libdt.a -l/usr/local/tools/ti-lib/libsoftier.lib libSDL_mixer.la -l/home/gxk/softier/uClinux-dist/vendors/TI/TMS320C6/userapps.cmd
CCLD = tms320c6-coff-ld
LINK = $(LIBTOOL) --mode=link $(CCLD) $(LDFLAGS) -o $@
playwave_LDFLAGS = -z -ar -x
playwave_LDFLAGS = -z -ar -x
playwave: $(playwave_OBJECTS) $(playwave_DEPENDENCIES)
    @rm -f playwave
    $(LIBTOOL) --mode=link $(CCLD) $(LDFLAGS) $(playwave_LDFLAGS) $(playwave_OBJECTS) $(playwave_LDADD) $(LIBS) -o $@
playmus: $(playmus_OBJECTS) $(playmus_DEPENDENCIES)
    @rm -f playmus
    $(LIBTOOL) --mode=link $(CCLD) $(LDFLAGS) $(playmus_LDFLAGS) $(playmus_OBJECTS) $(playmus_LDADD) $(LIBS) -o $@
install-Programs:
    @list='$(PROGRAMS)'; for p in $$list; do \
      if test -f $$p; then \
        echo "cp $$p $(DESTDIR)$(bindir)/$$p"; \
        $(LIBTOOL)  --mode=install $(INSTALL) $$p $(DESTDIR)$(bindir)/$$p; \
      fi; \
    done
install-exec: install-exec-recursive install-Programs

Change in ltconfig:
old_archive_cmds='$AR ru $oldlib$oldobjs'

Add follows in configure:
after `# Actually configure libtool.  ac_aux_dir is where install-sh is found.'
AR="AR" AR_FLAGS="AR_FLAGS"

rm -rf config.cache
configure --build=i686-pc-linux-gnu --host=x86-linux --target=evm642 --prefix=/opt/tms320c6 --without-x --disable-shared --with-sdl-prefix=/home/gxk/prjs/SDL/mySDL --disable-sdltest --disable-music-cmd --disable-music-mod --disable-music-midi --disable-music-timidity-midi --disable-music-native-midi --disable-music-native-midi-gpl --disable-music-ogg --disable-music-mp3


w/o converter
????

}}}3
make clean
make
make install

Linux x86
configure --without-x --disable-shared --disable-music-cmd --disable-music-wave --disable-music-mod --disable-music-midi --disable-music-timidity-midi --disable-music-native-midi --disable-music-native-midi-gpl --disable-music-ogg --enable-music-mp3

}}}2

SDL_net {{{2
gxk makefiles: make conv=1 clean all install

}}}2

Games {{{2

Marc send 7 games till 13sep2004:

rtts - NO - C++
pacwars2 - NO - C++
maelstrom - NO - C++
phobia - NO - 90MB
kobodeluxe - YES
xpired - non attractive

net-bubble{{{3

make clean net-bubble install

main()
|-> display_InitSDL()
|-> network_Init()
|-> utils_InitRandom()
|-> chargement_LoadGameData()
|-> Intro()
|-> pix_InitAnimPix()
|
|-> while(quit_game==0)
|->  SDL_ShowCursor(1)
|->  MainMenu()
|        |-> switch(etat_menu)
|        |       1 (main menu)
|        |
|        |
|        |
|        |
|        |
|        |
|        |
|        |
|        |
|->  SDL_ShowCursor(0)
|->  if (quit_game!=1)
|->    opponent_type = ...
|->    PlayGame()
|
|-> network_TcpClose()
|-> chargement_UnLoadGameData()
|-> network_Shutdown()
|_> SDL_DestroyMutex()

}}}3
atakks{{{3
make clean all install

}}}3
vectoroids {{{3
The game defined to run is vectoroids needed also SDL_image library, which is
separate project from SDL.

w/o SOUND
make clean DATA_PREFIX=../data/ nosound && make install
w/ SOUND
make clean && make DATA_PREFIX=../data/ all && make install

}}}3
MirrorMagic {{{3
setenv GCC2C_NO_CONVERTER_INVOCATION 1
setenv GCC2C_SECOND_STAGE_CCS_COMPILER_EXTRA_OPTIONS "-pds77 -pds238"
make clean sdl install

main
|-> ...
|-> OpenAll() (src/init.c)
        |-> InitProgramInfo()
        |-> InitPlayerInfo()
        |-> InitCounter()
        |-> InitSound()
        |-> InitRND(NEW_RANDOMIZE)
        |-> InitVideoDisplay()
        |-> InitVideoBuffer()
        |-> InitColor()
        |-> InitEventFilter(FilterMouseMotionEvents)
        |-> InitGfx()
        |-> InitElementProperties();  /* initializes IS_CHAR() for el2gfx() */
        |-> InitLevelInfo()
        |-> InitGadgets();        /* needs to know number of level series */
        |       |-> CreateLevelEditorGadgets() (src/editor.c)
        |       |       |-> CreateControlButtons() (src/editor.c)
        |       |       |-> CreateCounterButtons()
        |       |       |-> CreateDrawingArea()
        |       |       |-> CreateTextInputGadgets()
        |       |       |-> CreateScrollbarGadgets()
        |       |       |_> CreateCheckbuttonGadgets()
        |       |-> CreateGameButtons()
        |       |-> CreateToolButtons()
        |       |_> CreateScreenGadgets()
        |-> InitGfxBackground()
        |_> DrawMainMenu()

}}}3
abombniball {{{3
cd <abombniball>/src
make clean all install

docs {{{4
Abombniball - Version 0.2b (C) 2001

Playing
-------
The objective of Abombniball is to defuse all the explosives on each
level. As a ball, this would normally be a simple task, however each
level is filled with traps and devious puzzles placed there
by...oh...lets say "Dr. Y-Front", your arch-nemesis (he's very evil).
These traps take the form of special tiles which disappear or do other
nasty things.

  Gray Tile  - A solid tile. He never falls away and abandons you like
               all those other tiles. He's always be there for you.

  Blue Tile
  Green Tile
  Red Tile   - These all vanish after you leave them. Leaving a gapping
               hole in the grid and an empty space in your heart.

  2 Tile     - More caring and forgiving than those selfish color tiles.
               You can bounce on these submissive fellas twice before
               they vanish.

  Blue Arrow - Rude fellows. Shove you in whatever direction the arrow
               is pointing.

  Red Arrow  - Even ruder still. They make you jump in whatever
               direction the arrow is pointing.

You defuse bombs by landing on the bombs square, however you can only
defuse the bomb thats currently counting down. Trying to defuse any
other bomb will cause it to explode.

Each level provides you with a certain amount of jumps, they are limit
so use them with care.

Controls
--------
  Left             - Move left
  Right            - Move right
  Up               - Move up
  Down             - Move down
  OK                       - Jump
  Off                      - Escape

}}}4

}}}3

}}}2

Architecture {{{2

common {{{3

start search from test called <sdl>/test/testbitmap.c

main()
|-> SDL_Init() src/SDL.c
|   |-? pth_init()
|   |-> SDL_ClearError()
|   |-> SDL_InitSubsystem() src/SDL.c
|   |   |-? SDL_VideoInit() src/video/SDL_video.c
|   |   |       |-? ... - SDL_videodevice video = FB_CreateDevice()
|   |   |       |       |-> malloc()
|   |   |       |       |-? SDL_OutOfMemory()
|   |   |       |       |_> memset()
|   |   |       |-> memset(vformat)
|   |   |       |-> VideoInit() - FB_VideoInit() src/video/fbcon/SDL_fbvideo.c
|   |   |       |       |-> getenv(SDL_FBDEV) or /dev/fb0
|   |   |       |       |-> open(/dev/fb0)
|   |   |       |       |-? SDL_SetError()
|   |   |       |       |-# SDL_CreateMutex()   // create hardware surface lock mutex
|   |   |       |       |-? SDL_SetError(), FB_VideoQuit()
|   |   |       |       |-> ioctl(,FBIOGET_FSCREENINFO,)        // get the type of video 
|       |       |       |       |   // hardware
|   |   |       |       |-? SDL_SetError(), FB_VideoQuit()
|   |   |       |       |-> ...
|   |   |       |       |-> getenv("SDL_FBACCEL")       // check if disable hw acceleration
|   |   |       |       |-> atoi()
|   |   |       |       |-> mmap()
|   |   |       |       |-? SDL_SetError(), FB_VideoQuit()
|   |   |       |       |-> ioctl(, FBIOGET_VSCREENINFO,) //get current screen depth
|   |   |       |       |-> FB_SavePalette()    // save hw palette if needed
|   |   |       |       |-> ...
|   |   |       |       |-> FB_OpenKeyboard() src/video/fbcon/SDL_fbevents.c
|       |       |       |       |       |-> Open keyboard device: /dev/tty%d,/dev/vc/%d,/dev/tty
|       |       |       |       |       |-> ioctl(,KDGKBMODE,)  // make sure the input is a 
|       |       |       |       |       |   // console terminal
|       |       |       |       |       |_> FB_vgainitkeymaps() // fill vga_keymap[][]
|       |       |       |       |
|   |   |       |       |_> FB_OpenMouse() src/video/fbcon/SDL_fbevents.c
|   |   |       |
|   |   |       |-? SDL_VideoQuit()
|   |   |       |-> SDL_CreateRGBSurface()
|   |   |       |-? SDL_VideoQuit()
|   |   |       |
|   |   |       |-> SDL_StartEventLoop() src/events/SDL_events.c
|   |   |       |   |-> SDL_StopEventLoop()
|   |   |       |   |-> memset()
|   |   |       |       |-> SDL_AppActiveInit()
|   |   |       |       |-> SDL_KeyboardInit() src/events/SDL_keyboard.c
|   |   |       |       |       |-> SDL_EnableUNICODE()
|   |   |       |       |       |-> ... - FB_InitOSKeymap() src/video/fbcon/SDL_fbevents.c
|   |   |       |       |       |       |
|   |   |       |       |       |       |-> KVAL()
|   |   |       |       |       |       |...
|   |   |       |       |       |
|   |   |       |       |       |-> SDL_EnableKeyRepeat()
|   |   |       |       |       |_> fill keynames[]
|   |   |       |       |
|   |   |       |       |-> SDL_MouseInit() src/events/SDL_mouse.c
|   |   |       |       |-> SDL_QuitInit() src/events/SDL_quit.c
|   |   |       |       |-> SDL_StartEventThread() src/events/SDL_events.c
|   |   |       |       |       |   // init event queue
|   |   |       |       |       |
|   |   |       |       |       |-> memset()
|   |   |       |       |       |-# SDL_CreateMutex()
|   |   |       |       |       |->
|   |   |       |       |       |_? SDL_CreateThread() src/thread/SDL_thread.c
|   |   |       |       |               |-> malloc()
|   |   |       |       |               |--? SDL_OutOfMemory()
|   |   |       |       |               |-> memset()
|   |   |       |       |               |-> malloc()
|   |   |       |       |               |--? SDL_OutOfMemory()
|   |   |       |       |               |--? free()
|   |   |       |       |               |-> SDL_CreateSemaphore()
|   |   |       |       |               |--? free()
|   |   |       |       |               |-> SDL_AddThread()
|   |   |       |       |               |-> SDL_SYS_CreateThread() src/thread/SDL_systhread.c
|   |   |       |       |               |--? SDL_DelThread()
|   |   |       |       |               |--? free()
|   |   |       |       |               |-> SDL_SemWait()
|   |   |       |       |               |-> SDL_DestroySemaphore()
|   |   |       |       |               |_> free();
|   |   |       |       |
|   |   |       |       |__? SDL_StopEventLoop()
|   |   |       |
|   |   |       |--? SDL_VideoQuit()
|   |   |       |_> SDL_CursorInit()
|   |   |               |-? SDL_CreateCursor()
|   |   |               |-? SDL_SetCursor()
|   |   |               |_> SDL_CreateMutex()
|   |   |
|   |   |-# SDL_AudioInit()
|   |   |-# SDL_TimerInit()
|   |   |-# SDL_JoystickInit()
|   |   |_# SDL_CDROMInit()
|   |
|   |_? SDL_InstallParachute()
|
|-> SDL_SetVideoMode()
|       |-? SDL_Init()
|       |-> SDL_GetVideoMode()
|       |-> SDL_ResetKeyboard()
|       |-> SDL_ResetMouse()
|       |-? SDL_FreeSurface()
|       |-> SDL_WM_GrabInputOff()
|       |-> SDL_LockCursor() src/video/SDL_cursor_c.h
|       |       |_> SDL_mutexP()
|       |-> SetVideoMode - FB_SetVideoMode() src/video/fbcon/SDL_fbvideo.c
|       |-? SDL_PrivateResize()
|       |-? SDL_DitherColors()
|       |-? SetColors - FB_SetColors() src/video/fbcon/SDL_fbvideo.c
|       |-> SDL_SetClipRect()
|       |-> SDL_ClearSurface()
|       |       |-> ...
|       |       |-> SDL_FillRect()
|       |       |       |-> ...
|       |       |       |-> SDL_UnlockSurface()
|       |       |       |       |-> ...
|       |       |       |       |-> FB_UnlockHWSurface()
|       |       |       |       |       |-> ...
|       |       |       |       |       |-> SDL_mutexV()
|       |       |
|       |-> SDL_SetClipRect()
|       |-> SDL_ResetCursor() src/video/SDL_cursor.c
|       |-> SDL_UnlockCursor() src/video/SDL_cursor_c.h
|       |       |_> SDL_mutexV()
|       |-> SDL_SetCursor() src/video/SDL_cursor.c
|       |-? UpdateMouse - FB_UpdateMouse()
|       |-> SDL_WM_GrabInput()
|       |-> SDL_GetRelativeMouseState()
|       |_> ...
|
|-> SDL_PollEvent() (src/events/SDL_events.c)
|       |-> SDL_PumpEvents() (src/events/SDL_events.c)
|       |       |-> PumpEvents - FB_PumpEvents() (src/video/fbcon/SDL_fbevents.c)
|       |       |       |-> select()
|       |       |       |-> handle_keyboard() src/video/fbcon/SDL_fbevents.c
|       |       |       |       |-> read()
|       |       |       |       |-> TranslateKey()
|       |       |       |       |-? SDL_GetModState()
|       |       |       |       |-? switch_vt()
|       |       |       |       |_? SDL_PrivateKeyboard() (src/events/SDL_keyboard.c)
|       |       |       |               |-> SDL_PushEvent() (src/events/SDL_keyboard.c)
|       |       |       |
|       |       |       |_> handle_mouse() src/video/fbcon/SDL_fbevents.c
|       |       |       |       |-> SDL_PrivateMouseMotion()
|       |       |       |       |-> SDL_GetMouseState()
|       |       |       |       |_> SDL_PrivateMouseButton() src/events/SDL_mouse.c
|       |       |
|       |       |_> SDL_CheckKeyRepeat()
|       |
|       |_> SDL_PeepEvents()
|
|_> SDL_FreeSurface()
}}}3

Keyboard {{{3
        13oct2004
SDL_Init() -> SDL_InitSubsystem() -> SDL_VideoInit() -> FB_VideoInit() ->
FB_OpenKeyboard() (src/video/fbcon/SDL_fbevents.c)
|-> connect to unix socket of lircd
|_> FB_vgainitkeymaps() (src/video/fbcon/SDL_fbevents.c)
        |-> fill vga_keymap[] and keymap_temp[] The last is for map=0 and keys<128

SDL_Init() -> SDL_InitSubsystem() -> SDL_VideoInit() -> SDL_StartEventLoop() ->
SDL_KeyboardInit() (src/events/SDL_keyboard.c)
|-> initialize keynames[] to NULL and SDL_KeyState[] to SDL_RELEASED
|-> FB_InitOSKeymap() (src/video/fbcon/SDL_fbevents.c)
|       |_> fill keymap[] from vga_keymap[0], keymap_temp[]
|-> SDL_EnableKeyRepeat(0, 0)
|_> update keynames[], like `keynames[SDLK_BACKSPACE] = "backspace"'

SDL_PumpEvents() ->
FB_PumpEvents() (src/video/fbcon/SDL_fbevents.c)
|-> handle_keyboard() (src/video/fbcon/SDL_fbevents.c)
|       |-> read(fd)
|       |-> get scancode (buf & 7f)
|       |-> get state (buf & 80) pressed/released
|       |-> TranslateKey()
|       |       |_> update keysym.scancode keysym.sym keysym.mod keysym.unicode
|       |_> SDL_PrivateKeyboard() (src/events/SDL_keyboard.c)
|               |-> update keysym.mod
|               |-> create event
|               |_> SDL_PushEvent()
|                       |-> SDL_PeepEvents() (src/events/SDL_events.c)
|_> handle_mouse()

SDL_GetKeyState() (src/events/SDL_keyboard.c)
|_> returns SDL_KeyState

}}}3

graphics {{{3

SDL_VideoInit() (src/video/SDL_video.c)
|-> FB_VideoInit() (src/video/SDL_fbvideo.c)



}}}3

}}}2

Status {{{
20sep2004 
SDL project
1. Problems
        a. The wrong colors for BMP files (particulary for BMP file in vectoroids game) - ?
        b. Ability to build SDL without converter - week

2. Additions
        a. Add audio support (to port new library called SDL_mixer) - week
        b. To support more color algorithms (GIF,XBM,PNG) - 1 day per algorithm
        c. To define and port more games (depend by input device) - 1 day per game

I believe that for next 2 weeks of my absent could be done, to speed SDL project,
follows:

1. New game definitions
2. New game porting
3. SDL without converter porting
4. SDL audio porting (at least with convereter)

Supported formats:
----------------- 
graphics: BMP,PNG,JPG,PCX
audio: WAVE
libraries: SDL, SDL_image, SDL_mixer, SDL_net, libpng, libjpeg, zlib
games: net-bubble, abombniball

}}}

How to build?
------------
cd <path to SDL>
comp2
. /usr/local/tools/env.src
export CONFIG_SITE="/home/gxk/prjs/apps/SDL/config.site"
make clean all install

}}}
021 - LIRC {{{

Arch:
daemons/lircd.c
main
|-> ...
|_> loop()
        |-> waitfordata()
        |-> hw.rec_func = default_rec() (daemons/hw_default.c)
        |       |-> ...
        |       |-> rec_mode is LIRC_MODE_MODE2
        |       |-> clear_rec_buffer() (daemons/receive.c)
        |       |       |-> //reading int in buffer of type `struct rbuf'
        |       |       |-> ...
        |       |       |-> hw.readdata = default_readdata() (daemons/hw_default.c)
        |       |       |_> ...
        |       |-> decode_all() (daemons/ir_remote.c)
        |       |       |-> ...
        |       |       |-> hw.decode_func = default_decode() (daemons/hw_default.c)

RBUF_SIZE 256
struct rbuf {
    lirc_t data[RBUF_SIZE];
    ir_code decoded;
    int rptr;
    int wptr;
    int too_long;
    int is_biphase;
    lirc_t pendingp;
    lirc_t pendings;
    lirc_t sum;
}

Prepare before configure {{{2

Create config.site like below and set CONFIG_SITE pointed to the file.
setenv CONFIG_SITE ~/prjs/LIRC/lirc-0.6.6/config.site
which contains:
CC=tms320c6-coff-gcc
LD=tms320c6-coff-ld
CXX=tms320c6-coff-gcc
AR=tms320c6-coff-ar
NM=tms320c6-coff-nm
RANLIB=tms320c6-coff-ranlib

--- config.sub ---

  Add at line 452 follows:
    "evm642 | vm1 | vm2*)
        basic_machine=tms320c6
        os=-medialinux
        ;;"
  Add at line 1133 follows:
    "-medialinux*)
        os=-medialinux
        ;;"


--- configure ---

Follows changes could be done in more deep locations(see Problematical changes),
but it cause rerun of all autohell tools,so need further reseach.
Problematical changes {{{3
In configure.in:
Comments follows:
daemon=""
AC_CHECK_FUNCS(daemon)
if test "$ac_cv_func_daemon" != yes; then
  AC_CHECK_LIB(bsd,daemon,daemon="-lbsd")
  if test "$daemon" = ""; then
    AC_MSG_ERROR([*** daemon() function not available on this system])
  fi
fi

Add follows:
if test "$driver" = "sony839"; then
  lirc_driver="none"
  hw_module="hw_default.o receive.o transmit.o serial.o"
  HW_DEFAULT="hw_default"
  lircd_conf="sony/839.cfg"
fi
In aclocal.m4:
Change line 589:
$SHELL -c "export GCC2C_SECOND_STAGE_CCS_COMPILER_EXTRA_OPTIONS=-ppd ; ./depcomp $depcc -c conftest.c -o conftest.o" >/dev/null 2>&1 &&
}}}3

Line 2284:
$SHELL -c "export GCC2C_SECOND_STAGE_CCS_COMPILER_EXTRA_OPTIONS=-ppd ; ./depcomp $depcc -c conftest.c -o conftest.o" >/dev/null 2>&1 &&

Line 7746 (check for daemon):
comments lines 7817 - 7876

Line 9909:
if test "$driver" = "sony839"; then
  lirc_driver="none"
  hw_module="hw_default.o receive.o transmit.o serial.o"
  HW_DEFAULT="hw_default"
  lircd_conf="sony/839.cfg"
fi


--- depcomp ---

add follows option
cl6x)
   tmpdepfile=`echo "$object" | sed -e 's/.o$/.pp/'` 
      "$@"
  stat=$?
  if test $stat -eq 0; then :
  else
    rm -f "$tmpdepfile"
    exit $stat
  fi
  mv "$tmpdepfile" "$depfile"
  ;;

--- Makefile.in ---

Changes in directories daemons, tools, doc:
        sbindir = @bindir@
        LIBS = -l../../../uClibc/lib/crti.o -l../../../uClibc/lib/libc.a \
-l../../../uClibc/lib/libdt.a -l/usr/local/tools/ti-lib/libsoftier.lib \
../../../vendors/TI/TMS320C6/userapps.cmd
        CCLD = tms320c6-coff-ld
        LINK = $(LIBTOOL) --mode=link $(CCLD) $(AM_LDFLAGS) $(LDFLAGS) -o $@


--- ltmain.sh ---

Change line 560:
      new_command="GCC2C_NO_CONVERTER_INVOCATION=1 $command"
      $show "$new_command"
      if $run eval "$new_command"; then :

}}}2

Configure {{{2

w/ converter: {{{3
the RIGHTone:
configure --host=x86-linux --target=evm642 CC_FOR_BUILD=gcc CC=tms320c6-coff-gcc LD=tms320c6-coff-ld CXX=tms320c6-coff-gcc AR=tms320c6-coff-ar NM=tms320c6-coff-nm RANLIB=tms320c6-coff-ranlib CPPFLAGS="-I/home/gxk/softier/uClinux-dist/uClibc/include -fomit-frame-pointer -Dlinux -D__linux__ -Dunix -D__uClinux__ -DEMBED -fno-builtin -nostartfiles -D_TMS320C6 -D__PIC__ -fpic" AR_FLAGS="ur" --prefix=/opt/tms320c6/lirc --with-module-dir=/misc/home/softier/uClinux-dist/linux-2.4.x --with-tty=/dev/ttyS1 --without-x --with-driver=pctv --with-major=61 --with-port=none --with-irq=none --disable-daemonize --disable-long-codes

configure --host=x86-linux --target=evm642 CC_FOR_BUILD=gcc CC=tms320c6-coff-gcc LD=tms320c6-coff-ld CXX=tms320c6-coff-gcc AR=tms320c6-coff-ar NM=tms320c6-coff-nm RANLIB=tms320c6-coff-ranlib CPPFLAGS="-I/home/gxk/softier/uClinux-dist/uClibc/include -fomit-frame-pointer -Dlinux -D__linux__ -Dunix -D__uClinux__ -DEMBED -fno-builtin -nostartfiles -D_TMS320C6 -D__PIC__ -fpic" AR_FLAGS=ur --prefix=/opt/tms320c6/lirc --with-module-dir=/misc/home/softier/uClinux-dist/linux-2.4.x --with-tty=/dev/ttyS1 --without-x --with-driver=pctv --with-major=61 --with-port=none --with-irq=none --disable-daemonize --disable-long-codes

}}}3

w/o converter: {{{3

Previous configurations {{{4
Pinnacle w/o kernel module:
configure --host=x86-linux --target=evm642 --prefix=/opt/tms320c6/lirc --with-module-dir=/misc/home/softier/uClinux-dist/linux-2.4.x --with-tty=/dev/ttyS1 --without-x --with-driver=pctv --with-major=61 --with-port=none --with-irq=none --disable-daemonize --disable-long-codes

configure pinnacle w/o CONFIG_SITE:
configure --host=x86-linux --target=evm642 CC=tms320c6-coff-gcc LD=tms320c6-coff-ld CXX=tms320c6-coff-gcc AR=tms320c6-coff-ar NM=tms320c6-coff-nm RANLIB=tms320c6-coff-ranlib CPPFLAGS="-I/home/gxk/softier/uClinux-dist/uClibc/include -fomit-frame-pointer -Dlinux -D__linux__ -Dunix -D__uClinux__ -DEMBED -fno-builtin -nostartfiles -D_TMS320C6 -D__inline__=inline -D__signed__=signed -D_TMS320C6X_NOCONVERTER -D__PIC__ -fpic" AR_FLAGS="ur" --prefix=/opt/tms320c6/lirc --with-module-dir=/misc/home/softier/uClinux-dist/linux-2.4.x --with-tty=/dev/ttyS1 --without-x --with-driver=pctv --with-major=61 --with-port=none --with-irq=none --disable-daemonize --disable-long-codes
}}}4

setenv CONFIG_SITE ~/prjs/LIRC/lirc-0.6.6/config.site
setenv GCC2C_NO_CONVERTER_INVOCATION 1

configure --build=i686-pc-linux-gnu --host=x86-linux --target=evm642 --prefix=/opt/tms320c6/lirc --with-tty=/dev/ttyS1 --without-x --with-kerneldir=/home/gxk/prjs/uClinux-dist --with-driver=sony839 --disable-daemonize --disable-long-codes

}}}3
}}}2

make
make install

Problems:
1. When building can't see dependencies files

External fixes:
warning 174
WARNING!!! follows files created by uClinux build, so find the original.
Change at ~/softier/uClinux-dist/uClibc/include/bits/sigset.h line 112:
instead of `(__SOFTIER_LONG__)~0' do `~0U'

}}}
022 - PERL {{{1
        02nov2004

simple-way configuration {{{2

Run `sh Configure' and answer follows: {{{3
n
n
none
none                            os name
1                                       os version
n                                       SOCKS
y                                       PerlIO
y                                       threading
gcc
none                            lib search path
none                            file ext for shared lib
n                                       long double
none                            optional libraries
none                            optimizer/debugger flag
none                            cc flags
none                            ld flags
n                                       64 bit int
n                                       max 64 bit support
i686-                           arch
/opt/tms320c6           install prefix
<default>
<default>
<default>
none                            username for security test
n                                       secure setuid
n                                       setuid/setgid emulation
n                                       wrap malloc
n                                       use the malloc that comes with perl5
/opt/tms320c6           install prefix for add-on nmodules
<default>
<default>
n                                       configure vendor-specific add-on
none                            additional directories for perl to search
/opt/tms320c6/bin       public executables pathname
n                                       built with extra modules
none                            dir for install perl html files
none                            dir for install module html files
none
n
n                                       use nm to extrace C symbols
n                                       dynamic loading
<default>
<default>
<default>
<default>
y
<default>                       domain name
<default>                       e-mail address
<default>                       admin e-mail address
n
<default>
<default>
<default>
none                            site-specific html pages should be installed
none                            site-specific library html pages
<default>
<default>
<default>
n                                       fast stdio
n                                       large files
n                                       gethostname
1
y                                       vfork
4
drand48
gid_t
/usr/bin/less
/usr/bin/byacc
none                            extensions do you wish to include
}}}3

Changes of config.sh: {{{3
ccflags=' -fomit-frame-pointer -Dlinux -D__linux__ -Dunix -D__uClinux__ -DEMBED -fno-builtin -nostartfiles -D_TMS320C6 -D__PIC__ -fpic -I/home/gxk/prjs/uClinux-dist/uClibc/include -D__inline__=inline -D__signed__=signed -D_TMS320C6X_NOCONVERTER'
ccname='tms320c6-coff-gcc'
ccsymbols=''
cppccsymbols=''
cppflags=''
cpprun='tms320c6-coff-gcc -E'
cppstdin='tms320c6-coff-gcc -E'
cppsymbols=''
d_tm_tm_gmtoff='undef'
d_tm_tm_zone='undef'
d_tzname='undef'
d_gnulibc='undef'
d_getspnam='undef'
d_isnan='undef'
full_ar='tms320c6-coff-ar'
glibpth=''
i_shadow='undef'
i64size='4'
ld='tms320c6-coff-ld'
ldflags='-z -ar -x'
ldlibpthname=''
locincpth=''
loclibpth=''
longdblsize='8'
longlongsize='4'
nm='tms320c6-coff-nm'
timeincl=''
u64size='4'
}}}3

Comments in makefile: {{{3
wince.h
nwutils.c
}}}3

Building {{{3
If config.sh changes:
To update scripts do `Configure -S'
Dependencies `make depend'
`make'
}}}3

Fixes {{{3

1. commented 2 fields tm_zone and tm_gmtoff in struct tm from time.h
   we r not supporting time zones.
   solution:
   changed config.sh to undefine macros HAS_TM_TM_ZONE and HAS_TM_TM_GMTOFF.
   Not enough. Have to undef HAS_GNULIBC also.

2. from paths.h: line 35: fatal error #5: could not open source file "config/autoconf.h", when compile pp_sys.c
   solution: Temporary
   seems our problematic implementation of shadow. Temporary solution is 
   comment out include of autoconf.h in paths.h
   All functions from shadow.h in compiled in our libc.a, so get linkage
   problem - undefine symbol in libperl.a
   solution:
   change config.sh to undef shadow and getspnam

3. ARFLAGS in main makefile is `rcu'
   solution: Temporary
   mainly changed.

4. Target w/o rules in main makefile: nwutil.h
   solution: Temporary
   mainly changed.

5. Target w/o rules in main makefile: wince.h
   solution: Temporary
   mainly changed.

6. Building of miniperl (main makefile) using CC instead of LD.
   solution: Temporary
   mainly changed.

7. linkage problem in symbol isnan.
   solution: Temporary
   No such symbol in libc.a, libm.a , libsoftier.a So change config.sh to undef.

}}}3

}}}2

full-way configuration {{{2

Old idea to start from dir Cross: {{{3
sh Configure -Dcc=tms320c6-coff-gcc -Dld=tms320c6-coff-ld -Dar=tms320c6-coff-ar -Dnm=tms320c6-coff-nm -Dprefix=/opt/tms320c6 -Dcpp=tms320c6-coff-gcc -Dranlib==tms320c6-coff-ranlib -Accflags="-fomit-frame-pointer -Dlinux -D__linux__ -Dunix -D__uClinux__ -DEMBED -fno-builtin -nostartfiles -D_TMS320C6 -D__PIC__ -fpic -I/home/gxk/prjs/uClinux-dist/uClibc/include"
}}}3

sh ./Configure -des -Dusecrosscompile -Dtargethost=192.168.2.154 -Dtargetdir=/var/nfs -Dtargetarch=tms320c6-coff -Dcc=tms320c6-coff-gcc -Dcpp=tms320c6-coff-gcc -Dusrinc=/home/gxk/prjs/uClinux-dist/uClibc/include -Dincpth=/home/gxk/prjs/uClinux-dist/uClibc/include -Dlibpth=/home/gxk/prjs/uClinux-dist/uClibc/lib -Dtargetrun=telnet -Dtargetto=cp

Canceled:
Access to stdio stream array - try iob, __iob, __sF nothing.
How much NV preserve UVs.

}}}2

new simple-way configuration {{{2

Run `Configure' from <perl> dir w/ follows answers:
answers {{{3
n                                       to see the instructions
none                            policy file
none                            linux
<default>                       os version
n                                       SOCKS
y                                       PerlIO
y                                       threading
y                                       ithreads
gcc
none                            lib search path
none                            file ext for shared lib
n                                       long double
none                            optional libraries
none                            optimizer/debugger flag
-D_REENTRANT            cc flags
none                            ld flags
n                                       64 bit int
n                                       max 64 bit support
<default>                       arch
/opt/tms320c6           install prefix
<default>
<default>
<default>
none                            username for security test
n                                       secure setuid
n                                       setuid/setgid emulation
y                                       wrap malloc
y                                       use the malloc that comes with perl5
/opt/tms320c6           install prefix for add-on nmodules
<default>
<default>
/var/nfs                        configure vendor-specific add-on
/var/nfs                        additional directories for perl to search
/opt/tms320c6/bin       public executables pathname
n                                       built with extra modules
none                            dir for install perl html files
none                            dir for install module html files
none                            include in @INC
n
n                                       use nm to extrace C symbols
n                                       dynamic loading
<default>
<default>
<default>
<default>
y
<default>                       domain name
<default>                       e-mail address
<default>                       admin e-mail address
n
<default>                       what to put after `#!' to startup perl
<default>
<default>
none                            site-specific html pages should be installed
none                            site-specific library html pages
<default>
<default>
<default>
none                            fast stdio
none                            large files
n                                       gethostname
1
y                                       vfork
4
drand48
gid_t
/usr/bin/less
/usr/bin/byacc
}}}3

Changes in makedepend.SH
line 230 add: `grep [^wince] |'

Changes in perl.c
delete lines 79 -82

cp config.sh Cross/config.sh-tms320c6-coff
cd Cross

Do follows changes in it generate_config_sh
Changes {{{3
ccflags='-Dlinux -D__linux__ -Dunix -D__uClinux__ -DEMBED -fno-builtin -nostartfiles -D_TMS320C6 -D__PIC__ -fpic -I/home/gxk/prjs/uClinux-dist/uClibc/include -D__inline__=inline -D__signed__=signed -D_TMS320C6X_NOCONVERTER'
ccsymbols=''
cppccsymbols=''
cppflags='-D_REENTRANT'
cppsymbols=''
d_getspnam='undef'
d_getspnam_r='undef'
d_gnulibc='undef'
d_isnan='undef'
d_tm_tm_gmtoff='undef'
d_tm_tm_zone='undef'
d_tzname='undef'
full_ar='tms320c6-coff-ar'
glibpth=''
i32type='__SOFTIER_LONG__'
i64size=''
i64type=''
i_shadow='undef'
ld='tms320c6-coff-ld'
ldflags='-z -ar -x'
ldlibpthname=''
libc='/home/gxk/prjs/uClinux-dist/uClibc/lib/libc.a'
locincpth=''
loclibpth=''
longdblsize=''
longlongsize=''
osname='medialinux'
nm='tms320c6-coff-nm'
timeincl=''
u32type='unsigned __SOFTIER_LONG__'
u64size=''
u64type=''
uquadtype='unsigned __SOFTIER_LONG_LONG__'


ccflags=' -fomit-frame-pointer'
ccname='tms320c6-coff-gcc'
cpprun='tms320c6-coff-gcc -E'
cppstdin='tms320c6-coff-gcc -E'
}}}3

Comments in makefile: {{{3
wince.h
nwutils.c
}}}3

Building {{{3
If config.sh changes:
To update scripts do `Configure -S'
Dependencies `make depend'
`make'
}}}3

Fixes {{{3

1. commented 2 fields tm_zone and tm_gmtoff in struct tm from time.h
   we r not supporting time zones.
   solution:
   changed config.sh to undefine macros HAS_TM_TM_ZONE and HAS_TM_TM_GMTOFF.
   Not enough. Have to undef HAS_GNULIBC also.

2. from paths.h: line 35: fatal error #5: could not open source file "config/autoconf.h", when compile pp_sys.c
   solution: Temporary
   seems our problematic implementation of shadow. Temporary solution is 
   comment out include of autoconf.h in paths.h
   All functions from shadow.h in compiled in our libc.a, so get linkage
   problem - undefine symbol in libperl.a
   solution:
   change config.sh to undef shadow, getspnam and getspnam_r

3. ARFLAGS in main makefile is `rcu'
   solution: Temporary
   mainly changed.

4. Target w/o rules in main makefile: nwutil.h
   solution: Temporary
   mainly changed.

5. Target w/o rules in main makefile: wince.h
   solution: Temporary
   mainly changed.

6. Building of miniperl (main makefile) using CC instead of LD.
   solution: Temporary
   mainly changed.

7. linkage problem in symbol isnan.
   solution: Temporary
   No such symbol in libc.a, libm.a , libsoftier.a So change config.sh to undef.

8. change in PerlIOStdio_invalidate_fileno() from perlio.c
   solution: add follows
fdef _TMS320C6
    f->filedes = -1;
    return 1;


}}}3

}}}2
/home/gxk/prjs/uClinux-dist/uClibc/include
-l/home/gxk/prjs/uClinux-dist/uClibc/lib/crti.o
-l/home/gxk/prjs/uClinux-dist/uClibc/lib/libc.a
-l/home/gxk/prjs/uClinux-dist/uClibc/lib/libm.a
-l/home/gxk/prjs/uClinux-dist/uClibc/lib/libpthread.a
-l/usr/local/tools/ti-lib/libsoftier.lib
-l/home/gxk/prjs/uClinux-dist/uClibc/lib/libnsl.a
/home/gxk/prjs/uClinux-dist/vendors/TI/TMS320C6/userapps.cmd

Data types config for TI 3 {{{2

Issue: convert all longs to __SOFTIER_LONG__ and not touch `long long', cause
exists in TI 3.

Taking care of `long double':
d_longdbl = define
longdblsize='8'
uselongdouble='define'

Taking care of `long long':
d_longlong = define
i64size='8'
i64type='long long'
longlongsize='8'
u64size='8'
u64type='unsigned long long'
uquadtype='unsigned long long'
quadkind='3'
quadtype='long long'

Taking care of `long':
i32size='4'
i32type='__SOFTIER_LONG__'
ivdformat='"d"'
ivtype='__SOFTIER_LONG__'
ivsize='4'
longsize='4'
randseedtype='__SOFTIER_LONG__'
u32size='4'
u32type='unsigned __SOFTIER_LONG__'
uvXUformat='"X"'
uvoformat='"o"'
uvsize='4'
uvtype='unsigned __SOFTIER_LONG__'
uvuformat='"u"'
uvxformat='"x"'


Problem in compile toke.c
Solution to split it.
}}}2

Project info {{{2

More then 1000 files and lines as follows :
146000 c
 68000 h
 31000 pl
 14000 sh

Configuration options {{{3
This is list of Perl configuration options and they default values.

support of SOCKS [n] - proxy protocol library
support of PerlIO [y] - alternate IO mechanism
support of threading Perl [n] - threading support, which is believed to be
        stable, but runs slightly slower.
support of Perl multiplicity [n] - multiple Perl interpreters can coexist
        within the same Perl executable.
support for long doubles [n] - 
support of 64-bit int [n] -
wrapping malloc [y] - protect against potential overflows
usage of perl5 malloc [n] - 
install extra modules [n] - modules from CPAN
use nm to extract C symbols [n] - ???
support of dynamic loading [y] - have to choose file for linux
        (ext/DynaLoader/dl_dlopen.xs)
build libperl.so [n] - 
support "fast sydio" [y] -
large files [y] -
ignore gethostname [n] -
use vfork() [n] -
Doubles must be aligned on a how-many-byte boundary [4] -
func to to generate random numbers [drand48] -
type pointer is the second argument to getgroups() and setgroups() [gid_t] - 
extensions [attrs B ByteLoader Cwd Data/Dumper Devel/DProf Devel/Peek Devel/PPPort Digest/MD5 Encode Fcntl File/Glob Filter/Util/Call I18N/Langinfo IO IPC/SysV List/Util MIME/Base64 Opcode PerlIO/encoding PerlIO/scalar PerlIO/via POSIX re SDBM_File Socket Storable Sys/Hostname Sys/Syslog threads Time/HiRes Unicode/Normalize threads/shared] -
which to load staticaly [none] -

}}}3

Perl installed (done on linux w/ default config opts){{{3

bin {{{4
        a2p
        c2ph
        cpan
        dprofpp
        enc2xs
        find2perl
        h2ph
        h2xs
        instmodsh
        libnetcfg
        perl
        perl5.8.5
        perlbug
        perlcc
        perldoc
        perlivp
        piconv
        pl2pm
        pod2html
        pod2latex
        pod2man
        pod2text
        pod2usage
        podchecker
        podselect
        prove
        psed
        pstruct
        s2p
        splain
        xsubpp
}}}4
lib {{{4
        perl5
                5.8.5
                site_perl
}}}4
man {{{4
        man1
        man3
}}}4
}}}3

How Perl works.
It reads the entire file, compiles it into an internal representation, and 
executes the instructions. There are 3 major phases: parsing, compiling and
interpreting.

Installed perl on linux with default configuration options takes 41MB.

--- souce structure
Core modules w/o needs of additional treatment - lib/
Core XS modules - ext/
Documentation - pod/
Regression tests - t/
Utils - utils/ x2p/ pod/ (where pod translator)
Others are platform specific dirs.

--- fork/vfork
vfork
Perl can only use a vfork() that doesn't suffer from strict
restrictions on calling functions or modifying global data in
the child.  For example, glibc-2.1 contains such a vfork()
that is unsuitable.  If your system provides a proper fork()
call, chances are that you do NOT want perl to use vfork().
fork
needs further investigation.

--- modules 

Link to modules info:
http://cpan.uwinnipeg.ca/htdocs/faqs/cpan-search.html

There are 3 types of modules. The core modules that not need additional 
treatment (no dependencies), the core modules depend on previously described
and CPAN modules, which can to download, build and install from CPAN
places. All operatins on CPAN modules could be done manualy or automaticaly
by CPAN module.

--- threads

Have 2 different internal threads implementations. The current model
(ithreads), which is one interpreter per thread with explicit sharing of data.
The old model (5005threads) is considered obsolete, buggy and unmaintained.
The `threads' module is api for ithreads and `Thread' offer an interface to
whichever has been configured.

ithreads model
Large overhead of creating a thread and also cost of returning values.
Bug on some platforms, might not be possible to destroy "parent" there is still
"child" exists.
!!!This model based on fork().

5005threads model
All data is implicitly shared and access should be explicitly synchronized.

--- shared libperl

The perl executable is normally obtained by linking perlmain.c with
libperl.a, any static extensions (usually just DynaLoader), and
any other libraries needed on this system (such as -lm, etc.).  Since
your system supports dynamic loading, it is probably possible to build
a shared libperl.so.  If you will have more than one executable linked
to libperl.so, this will significantly reduce the size of each
executable, but it may have a noticeable affect on performance.  The
default is probably sensible for your system.

--- IO

There are 3 implementatio of IO: PerlIO, standard stdio.h and safe|fast stdio.
The most new is PerlIO, but standard stdio also supported. The last one is
kind of feature, which described at  http://www.research.att.com/sw/tools/sfio/

--- malloc 

Perl relies heavily on malloc(3) to grow data structures as needed, so perl
is shipped w/ malloc optimized for typical request from perl.
The system malloc also supported.

}}}2

Questions: {{{2
Open issues

sorted by they influence on project.

DONE
1. Which perl to take?
        The best would be from uClinux source tree, but it has perl-5.0.5, which
        is not supports Tk. The perl starts to support Tk from perl-5.7.3 and 
        Tk-800.xxx. The last update was perl-5.8.0 supports Tk-804.xxx.
        decision:
        to take last stable which is perl-5.8.5
2. Do we have to support modules?
        decision:
        yes, cause some basic functionality (Module loader itself, Sockets, etc.)
        provided by modules.

CRITICAL - must to answer ASAP
?. fork/vfork problem. At config wrote:
        "can only use a vfork() that doesn't suffer from strict restrictions
        on calling functions or modifying global data in the child.  For example,
        glibc-2.1 contains such a vfork() that is unsuitable.  If your system
        provides a proper fork() call, chances are that you do NOT want perl to
        use vfork()."
        So, we can't use our vfork and fork not supported?

?. Modules should be static or dynamic?
        if dynamic depends on implementation of shared object (waits for Mulli's approve)
        if static, so arises problem of perl binary size (w/o modules 3.5M), which
        badly hurts ithreads.

MANDATORY - have to answer, but later
?. The perl binary size problem. Mostly because of libperl.a
        (look at shared libperl)
?. Which modules to build?
        from default extensions and CPAN (TBD - waits for Mark/Haim)
        number of modules must be there.
        Info on default modules/extensions:
        NAME--------    SIZE(KB)        COMPILED        TESTED
        APItest                 84                      y                       n
        attrs                   9                       y                       n
                set/get attrib of subroutine (depricated).
        B                               428
                the perl compiler, changing "backend" of Perl compiler.
        ByteLoader              60                      y                       n
                load byte compiled perl code.
        Cwd                             18                      y                       n
                get current working directory
        Data/Dumper             65                      y                       n
                stringified perl data structures, suitable for both printing and eval.
        DB_File                 ?                       n                       n
                Perl5 access to Berkeley DB version 1.x
        Devel/DProf             30                      y                       n
                code profiler
        Devel/Peek              34                      y                       n
                data debugging tool for the XS programmer
        Devel/PPPort    63                      y                       n
                perl/pollution/portability
        Digest/MD5              32                      y                       n
                interface to MD5 algo
        Encode                  76                      y                       n
                character encoding
        Fcntl                   28                      y                       n
                load the C Fcntl.h defines
        File/Glob               39                      y                       n
        Filter/Util/Call 20                     y                       n
        GDBM_File               ?                       n                       n
                Perl5 access to the gdbm library.
        I18N/Langinfo   27                      y                       n
        IO                              37                      y                       n
        IPC/SysV                43                      y                       n
        List/Util               118                     y                       n
        MIME/Base64             19                      y                       n
        NDBM_File
                access to ndbm files
        Opcode                  52                      y                       n
        ODBM_File               ?                       n                       n
                access to odbm files
        PerlIO/encoding 53                      y                       n
        PerlIO/scalar   12                      y                       n
        PerlIO/via              31                      y                       n
        POSIX                   33                      y                       n
                interface to IEEE std 1003.1
        re                              38                      y                       n
                Perl pragma to alter regular expression behaviour
        SDBM_File               ?                       n                       n       
                access to sdbm files
        Socket                  51                      y                       n
                translation of the socket.h file.
        Storable                204                     y                       n
                persistence for Perl data structures
        Sys/Hostname    10                      y                       n
        Sys/Syslog              43                      y                       n
        threads                 49                      y                       n
        threads/shared  108                     y                       n
        Typemap                 173                     y                       n
        Time/HiRes              36                      y                       n
        Unicode/Normalize 401           y                       n

?. How to install CPAN modules? Should be precompiled or not?
?. What MediaLinux perl package contains?
        libs, utils, html, man, etc.
?. Which thread model to use?
        decided: cause 5005threads not supported, so should ithreads be supported,
        with one obstacle: size of perl binary.
        Another option not to support threads, if not widely used. (TBD by Mark)
        Module needed.
?. Which IO model to use?
        newest PerlIO, but there are support for sfio and regular stdio.h
        Should be used PerlIO or stdio.h (TBD - Mark)
        Usage of sfio w/ Or.

OPTIONAL - may be no need for answer
?. Which malloc to use?
        Anyway can work w/ system malloc, so have to be checked if performance problem.
?. Should be link with ActivePerl IDE?
        Already downloaded.
?. Which utilities have to be ported?
        All placed at bin dir. The list provided below
        a2p
        c2ph
        cpan
        dprofpp
        enc2xs
        find2perl
        h2ph
        h2xs
        instmodsh
        libnetcfg
        perl
        perl5.8.5
        perlbug
        perlcc
        perldoc
        perlivp
        piconv
        pl2pm
        pod2html
        pod2latex
        pod2man
        pod2text
        pod2usage
        podchecker
        podselect
        prove
        psed
        pstruct
        s2p
        splain
        xsubpp

}}}2

Status: {{{2
03nov2004 - 10 objs created
04nov - miniperl created
07nov - trying to fully cross-compile - 30% done
08nov - same
09nov - create project doc
10nov - fork problem research
11nov - continue to fully cross-compile

Problematic modules :
                DB_File - Perl5 access to Berkeley DB version 1.x
                GDBM_File - Perl5 access to the gdbm library.
                NDBM_File - access to ndbm files
                ODBM_File - access to odbm files
                POSIX - interface to IEEE std 1003.1
                SDBM_File - access to sdbm files

}}}2

}}}1
023 - MediaLinux GUI toolkit {{{
MLGT

Exist toolkits:
Tk is a cross-platform toolkit, but development has stalled and thus Tk is missing many modern GUI widgets.
Qt has a different licensing model (which may require a commercial license in some cases where FOX will not)
Gtk has been ported to Windows, but it is not genuinely cross-platform
wxWidgets promotes the use of native widgets on each supported platform

Ruby
Python
Perl
Tcl

}}}
024 - Toolchain w/ CCS 3.0 {{{1

CCS3 arrived and mission is to create new tools w/ stuff from CCS3.
List of stuff needs to rebuild w/ new compiler.
converter and libgcc-ti.lib
kernel
libs
libsoftier.lib
apps

Currently (07dec2004) defined by Ady to rebuild only libs and apps.
Prepare new tools. {{{2
*Install old tools.
*Add new tools.
cd /usr/local/tools/wine-ti-cc/support/dotwine/fake_window
cp -r ./ti ./ti-2
cp -r /misc/share/ccs3_4_lnx ./ti-3
ln -s ti-2 ti
cd <uclinux> and prepare everything
make dep
make linux
pushd /usr/local/tools/wine-ti-cc/support/dotwine/fake_windows ; rm -rf ti ; \
        ln -s ti-3 ti ; popd
make lib
}}}2
Created stuff will be burned and checked.
Problem: sizes of binaries 30-50% bigger compare to CCS2.20

2. Create libgcc-ti.lib (needed by converter)
Creation skiped. Just cp from `ti-lib' for .../cgtools/lib/

3. Kernel can build from this point. It doesn't need libsoftier.lib

New decision (12dec2004):
Create tools for 2.4 with both compilers, when 2.20 would be used as usual
and 3.0 only for certain apps (like Ant or perl). There 3 changes:
Added `ti3' and link `ti' would be to point out.
Added `libsoftier-ti3.lib' and link `libsoftier.lib' would be to point out.
Added tms320c6-coff-strip (original renamed to tms320c6-coff-strip.binutils)

Script `comp.sh' added in `bin' dir.

}}}1
025 - HTTP server {{{
To found multithreaded (ability to serve many connections - performance not
an issue), written in C, easy to port (ANSI C), supports CGI protocol,
support PHP, small, etc.

List of servers:
  name                  AnsiC   model   CGI             PHP             ver             nbr_lines       URL
AOLserver               y                                                                                                       aolserver.com
Apache                  y                                                                                                       apache.org
Boa                             n                                                                                                       boa.org
micro_httpd             ?                                                                                                       acme.com/software/micro_httpd/
roxen                   pike
thttpd                                                                                                                          acme.com/software/thttpd/
netscape
goahead                 y                               y                               2.1.8   30K                     goahead.com


http streaming
1. can't auto detect the user line speed, by HTTP protocol, so have to prepare
   files for each of line speeds;
2. can't run stream live video, cause HTTP must have whole file on server;
3. icur a heavier server load

}}}
026 - Huawei {{{1
Main flug naf Nuawei. (09-15jan2005)

1. The personal entertaiment system used in Swiss Air.
        a. The system contains LCD monitor and wired control device, looks almost 
        like remote control. It has main 6 buttons to control video play and menu
        capabilities. There are also separated cross-like buttons used in some 
        games. No mouse-like functionality.
        b. The GUI system. Very simple 2D shapes. Multicolor, looks like 16bpp.
        c. Functionality. Menu to choose programs listed below:
                video data from outside cameras
                games
                movies
                music
                flight info
        d. Compare to our system (demo):
                The GUI of SelecTV is much better.
                The control device functionality is the same.
2. Huawei meetings.
        a. Most wanted issue was lack of API documentation, even for Linux
        knowledged people in Huawei. This issue could be splitted in two:
        standard API and Softier-decided-to-support API.
        The standard case is about known libraries, like (libc, libm, libpthread).
        Even here, the question was how much we different from uClinux project.
        The Softier-decided-to-support API is like which solution Softier has for
        GUI applications. In this particular case, the needed GUI API was created
        on the place and introduced to them.
        Special interest was in video capabilities, it's API and architecture.
        The BrowserDemo application was introduced to them and seems like what
        they want or at least accept. Our video play architecture was introduced
        and found very persuative compare to there system.
        The detailed description of video/audio codecs can bring strong confidence,
        cause it's gives the ability to compare different systems. The example
        document, which describes current Huawei system attached.
3. Conclusion.
        It seems like we almost have full technical solution for Huawei-like
        customer. The weak pointes are no strong product wrap, which has
        user documentation, knowledge base for solutions (for example, porting).


Questions:
1. support advanced profile in MPEG4
2. support 16bpp (565) and 32bpp BMP
3. jpeg,bmp,gif,png
4. detailed documenation for SelecTV ini files
5. Course how to create video player?
6. How to show OSD profile when player runs (mpeg4)
7. RTSP/RTP
8. MPEG4, H264
9. Picture on picture
10. Detailed doc for KAD
11. Description of supported video file extentions.
12. Documentation for player API
13. Show chineese characters
14. Document for porting C code
15. Ability to bit profile player (with MA file)

}}}1
027 - Toolchain w/ CCs 3.1b {{{1
        23mar2005
New tools needed, cause of better C++ support in CCS 3.1b. Same procedure as 
for Toolchain w/ CCS 3.0. More atention what to copy from Win32.
Changes {{{2
1. Copy ti31b to /usr/local/tools/wine-ti-cc/support/dotwine/fake_windows/ ,
where contents install of CCS 3.1b (3.10.7.2) and RF in WinXP (only dirs left
are: C6000, c6400, referenceframework and ddk (copied from 2.20.18)
2. Prepared libsoftier-ti31b.lib. Done by Zvika, by replacing from
c6000/cgtools/lib/rts6400.lib everything non-exist in libc and libm.
3. Change tms320c6-coff-gcc to add `-pds1311' to CCS 3.x
4. Split env_ll.src in 2 files env3.src and env31b.src, where change
TMS320C6X_SUPPORT_WCHAR to 0 in both. Needed due to env var TMS320C6X_CCS31B
which helps in libm to choose the right objs dir.
5. Change comp.sh to include comp31b command
6. Create `ln -s ../../../../../../../../ti-lib/libgcc-ti.lib libgcc-ti.lib' in
/usr/local/tools/wine-ti-cc/support/dotwine/fake_windows/ti31b/c6000/cgtools/lib
7. In /usr/local/tools/wine-ti-cc/support/dotwine/fake_windows/ti31b/c6000/bios/lib make follows:
`ln -s ../../csl/lib/csl6415.lib csl6415.lib'
}}}2
How to build w/o support for WCHAR?
comp2
env.src
sh mklinks.sh
make xconfig
make dep && make linux
comp31b
env31b.src
make lib
make user
To add WCHAR support?
change TMS320C6X_SUPPORT_WCHAR to 1 in env3.src|env31b.src
change uClibc/.config to add 2 line below or run `make menuconfig' from uClibc:
        UCLIBC_HAS_WCHAR=y
        # UCLIBC_HAS_LOCALE is not set

New objs for libm, new  change of libm/Makefile
cvs update -A
cvs commit -m "long long support" uClibc/libm/Makefile
cvs add uClibc/libm/ti_objs31b
cvs commit uClibc/libm/ti_objs31b
find uClibc/libm/ti_objs31b ! -path '*/CVS/*' ! -type d -exec cvs add {} \;
find uClibc/libm/ti_objs31b ! -path '*/CVS/*' ! -type d -exec cvs commit -m "CCS 3.1b" {} \;
cvs rtag -R libs-26 uClinux-libs
}}}1
028 - LONGLONG & WCHAR changes {{{1

1. Add `long long' support (due to use of TI's compiler v5.0.0 from CCS3) {{{2

libc preparations:  {{{3
-----------------
  a. (from tms320c6-coff-gcc) redefined __SOFTIER_LONGLONG__ to long long
  b. (from uClibc/incbs4videolude/limits.h) check macros LLONG_MAX, LLONG_MIN,
     ULLONG_MAX
  c. (from uClibc/include/bits/uClibc_stdio.h)
     check for __UIM_BUFLEN, __UIM_BUFLEN_LLONG
  d. (from uClibc/include/stdlib.h uClibc/libc/stdlib/stdlib.c) labs() func.
  e. check follows funcs:
++   strtoll() (from uClibc/libc/stdlib/stdlib.c)
++   strtoull() (from uClibc/libc/stdlib/stdlib.c)
++   atoll() (from uClibc/libc/stdlib/stdlib.c)
++   llabs() (from uClibc/libc/stdlib/stdlib.c, uClibc/include/stdlib.h)
++   labs() (from uClibc/libc/stdlib/stdlib.c)
++   lldiv()
-    printf() (from uClibc/libc/stdio/printf.c)
  e. Add striping
+ f. Disable remark 452 which is "the type long long is non standard"
  g. New env var TMS320C6X_SUPPORT_LONGLONG which switchon support for long 
     long without converter.

final changes:
uClibc/include/bits/uClibc_stdio.h -
  (uClibc/libc/sysdeps/linux/common/bits/uClibc_stdio.h
uClibc/include/limits.h
uClibc/include/stdlib.h
uClibc/libc/stdlib/stdlib.c
/usr/local/tools/env_ll.src
/usr/local/tools/env.src
/usr/local/bin/tms320c6-coff-gcc
}}}3

libm preparations:  {{{3
-----------------
  a. objs to analyze
    lltoa.obj -  no such thing in x86 libc.a
    llshift.obj - added, but...
    negll.obj - found at libsoftier.lib
    strcoll.obj - added, but...
    imath64.obj - added, cause needed by code of llabs()

final changes:
uClibc/libm/ti_objs3/*
uClibc/libm/Makefile
}}}3

Released like by follows commands:
cvs update -A
cvs commit -m "long long support" uClibc/libc/sysdeps/linux/common/bits/uClibc_stdio.h
cvs commit -m "long long support" uClibc/include/limits.h
cvs commit -m "long long support" uClibc/include/stdlib.h
cvs commit -m "long long support" uClibc/libc/stdlib/stdlib.c
cvs commit -m "long long support" uClibc/libm/Makefile
cvs add uClibc/libm/ti_objs3
cvs add -kb uClibc/libm/ti_objs3/*
cvs commit -m "long long support" uClibc/libm/ti_objs3/*
cvs rtag -R libs-20 uClinux-libs
}}}2
2. Add support for wchar                                                  {{{

<get source>
comp2
env.src
sh mklinks.sh
make xconfig and cancel busybox->tail
make dep
make linux
comp3
env_ll.src
change uClibc/.config to add 2 line below or run `make menuconfig' from uClibc:
        UCLIBC_HAS_WCHAR=y
        # UCLIBC_HAS_LOCALE is not set
make lib
make user

final changes:
fix previous bugs {{{
+user/busybox-1.00/editors/sed.c
+user/busybox-1.00/Makefile
`./snmpd -f -c ./snmpd.conf -Lf ./log.log &'

now can ask info by:
        snmpget -c gxk -v 2c gxk-nb.softier.local system.sysUpTime.0
        snmpget -c gxk -v 2c 192.168.2.183 system.sysUpTime.0
        snmpwalk -c gxk -v 2c 192.168.2.183 system
To get everything:
        snmpwalk -c gxk -v 2c 192.168.2.183 .1 > a.txt

iso.org.dod.internet.mgmt.mib-2
 1   3   6      1     2     1

iso.org.dod.internet.snmpV2.snmpModules
 1   3   6      1      6        3

Call private MIB:
snmpwalk -c gxk -v 2c 192.168.2.24 ipstbSys
snmpwalk -c gxk -v 2c 192.168.2.24 1.3.6.1.4.1.9999.1
snmpset -c gxk -v 2c 192.168.2.24 ipstbSys.sysContact.0 s gxk@softier.com

Create mib {{{

copy SOFTIER-IPSTB-MIB.txt to /usr/share/snmp/mibs/
env MIBS="+SOFTIER-IPSTB-MIB" mib2c -f ipstb -c mib2c.scalar.conf ipstbSys

05may2005 done MIB w/ 1 ro node.

Add new MIB to ML snmp:
copy MIB source files to <snmp src>/agent/mibgroup
change <snmp src>/agent/mibgroup/mkfile
change <snmp src>/agent/mibgroup/mib_module_includes.h
change <snmp src>/agent/mibgroup/mib_module_inits.h

}}}
SNMPv2-SMI {{{2
        04may2005

iso = 1
  org {iso 3}
    dod {org 6}
      internet {dod 1}
        directory {internet 1}
        mgmt {internet 2}
          mib-2 {mgmt 1}
            transmission {mib-2 10}
        experimental {internet 3}
                private {internet 4}
          enterprises {private 1}       1.3.6.1.4.1
        security {internet 5}
        snmpV2 {internet 6}
          snmpDomains {snmpV2 1}
          snmpProxys  {snmpV2 2}
          snmpModules {snmpV2 3}        1.3.6.1.6.3

}}}2
SNMPv2-TC {{{2
        04may2005
        imports from SNMPv2-SMI
}}}2
SNMPv2-MIB {{{2
        04may2005

import from: SNMPv2-SMI SNMPv2-TC SNMPv2-CONF

snmpMIB { snmpModules 1 }  1.3.6.1.6.3.1

snmpMIBObjects  { snmpMIB 1 }  1.3.6.1.6.3.1.1

system  { mib-2 1 }  1.3.6.1.2.1.1
        sysDescr                        1  ro
        sysObjectID                     2  ro
        sysUpTime               3  ro
        sysContact              4  rw
        sysName                         5  rw
        sysLocation                     6  rw
        sysServices                     7  ro
        sysORLastChange     8  ro
        sysORTable          9  no acc
          sysOREntry                     1  no acc
        sysORIndex                              1  no acc
            sysORID                                     2  ro
            sysORDescr                          3  ro
            sysORUpTime                         4  ro

snmp   { mib-2 11 }
        snmpInPkts                                      1
        snmpOutPkts                                     2  ro
        snmpInBadVersions                       3
        snmpInBadCommunityNames         4
        snmpInBadCommunityUses          5
        snmpInASNParseErrs                      6
        snmpInTooBigs                           8  ro
        snmpInNoSuchNames                       9  ro
        snmpInBadValues                         10 ro
        snmpInReadOnlys                         11 ro
        snmpInGenErrs                           12 ro
        snmpInTotalReqVars                      13 ro
        snmpInTotalSetVars                      14 ro
        snmpInGetRequests                       15 ro
        snmpInGetNexts                          16 ro
        snmpInSetRequests                       17 ro
        snmpInGetResponses                      18
        snmpInTraps                                     19
        snmpOutTooBigs                          20
        snmpOutNoSuchNames                      21
        snmpOutBadValues                        22
        snmpOutGenErrs                          24
        snmpOutGetRequests                      25 ro
        snmpOutGetNexts                         26 ro
        snmpOutSetRequests                      27 ro
        snmpOutGetResponses                     28 ro
        snmpOutTraps                            29 ro
        snmpEnableAuthenTraps           30
        snmpSilentDrops                         31
        snmpProxyDrops                          32

snmpTrap        { snmpMIBObjects 4 }
        snmpTrapOID                                     1
        snmpTrapEnterprise                      3

snmpTraps       { snmpMIBObjects 5 }
        ...

snmpMIBConformance { snmpMIB 2 }  1.3.6.1.6.3.1.2
        snmpMIBCompliances              1
        snmpMIBGroups                   2
          snmpSetGroup                                          5
          systemGroup                                           6  
          snmpBasicNotificationsGroup           7
          snmpGroup                                                     8
          snmpCommunityGroup                            9
          snmpObsoleteGroup                                     10
          snmpWarmStartNotificationGroup        11
          snmpNotificationGroup                         12
}}}2
HOST-RESOURCES-MIB {{{2
        04may2005

import from: SNMPv2-SMI SNMPv2-TC SNMPv2-CONF IF-MIB

hostResourcesMibModule { hrMIBAdminInfo 1 }

host    { mib-2 25 }
        hrSystem                        { host 1 }
        hrStorage                       { host 2 }
        hrDevice                        { host 3 }
        hrSWRun                         { host 4 }
        hrSWRunPerf                     { host 5 }
        hrSWInstalled           { host 6 }
        hrMIBAdminInfo          { host 7 }
        ...
}}}2
Architecture {{{2
agent/snmpd.c
main()
|->
|-> init_mib_modules() (agent/mib_modules.c)
|   |
|   |_> include agent/mibgroup/mib_modules_init.h, where
|   |   ?-> init_snmp_mib()
|   |   ?-> init_system_mib()
|   |   ?-> init_sysORTable()
|   |   ?-> init_vacm_vars()
|   |   ?_> init_vacm_context() 
|   |
|->...
|_>
}}}2
Errors {{{3
1. when call `snmpget -c gxk -v2c 192.168.2.183 1.3.6.1.6.3.1.1.6.1.0' getting
`send response: Error building ASN.1 representation (build int size 2262606604:
s/b 4)'
solution: The error message from snmplib/snmp_api.c, where it is macro called
SNMPERR_BAD_ASN1_BUILD. The usage of this macro found in snmp_build() in the
same file.
from debug log file:
trace: *�*�*(): snmp_api.c, 2880:
snmp_send: Building SNMPv2 message...
trace: *�*�*(): snmp_api.c, 2884:
dumph_send:           PDU-RESPONSE
trace: *�*�*(): snmp_api.c, 3243:
snmp_pdu_realloc_rbuild: starting
trace: *�*�*(): snmp_api.c, 3258:
dumph_send:             VarBind
trace: *�*�*(): snmp.c, 341:
dumph_send:               Value
trace: *�*�*(): snmp_api.c, 4695:
sess_async_send: encoding failure
send response: Error building ASN.1 representation (build int size 2264352924: s/b 4)

snmp_build()
|->_snmp_build()
|  |
|  |->snmp_pdu_realloc_rbuild()
|  |  |
|  |  |->snmp_realloc_rbuild_var_op() (snmplib/snmp.c)
|  |  |  |
|  |  |  |->asn_realloc_rbuild_int() (snmplib/asn1.c)

}}}3

MRTG {{{2

Next will create config file:
cfgmaker --global 'workdir: /home/gxk/prjs/snmp/mrtg' -output mrtg.cfg gxk@192.168.2.183
where gxk -community and 192.168.2.183 -ip card'

env LANG=C /usr/bin/mrtg ./mrtg.cfg --logging ./log.log &

}}}2
Checking :
snmpd/Makefile
snmpd/modules/Makefile
snmpd/snmplib/Makefile
snmpd/snmpd/Makefile
snmpd/snmpd/Rules.mak
snmpd/snmpd/snmpd.c
}}}
030 - wchar telnet fix {{{1
        15may2005
If uClibc is built with UCLIBC_HAS_WCHAR, telnetd sends "InvInvInv" to the
remote client after spawning login. This string is begining of the message
"Invalid multibyte format string."

Changes done to the file: user/telnetd/state.c

Build uClinux-dist release w/ WCHAR:
get 110 16 
. /usr/local/tools/env31b.src
sh mklinks.sh
make xconfig
make dep && make linux
cd uClibc
make menuconfig
cd ..
make lib && make user

}}}1
031 - Locales {{{1
        29may2005
TODO:
1. Add locale support
2. Check wchar w/ it

1.
`cd uClibc' and `make menuconfig', where check support for WCHAR and LOCALE
`cd uClibc/extra/locales'
fix gen_wc8bit.c, gen_wctype.c, gen_collate.c
create codesets.txt and locales.txt
fix uClibc/extra/Makefile
make pregen
make lib

Next error happened in `uClibc/extra/locale', when
`gcc -O2 -Wall  -DCTYPE_PACKED=1 -DDO_WIDE_CHAR=1 gen_wc8bit.c -o gen_wc8bit'
Fix it by change all SOFTIER's macros to original types. 
Next is miss of codesets.txt file. Fixed by running follows:
`find /home/gxk/prjs/uClinux-dist/uClibc/extra/locale/charmaps -name "*.pairs" \
> /home/gxk/prjs/uClinux-dist/uClibc/extra/locale/codesets.txt'
Next problem in uClibc/extra/locale/gen_wctype.c fixed by replace Softier's
macros to original types.
Next miss of locales.txt, fixed bu follows:
`cp /home/gxk/prjs/uClinux-dist/uClibc/extra/locale/LOCALES \
/home/gxk/prjs/uClinux-dist/uClibc/extra/locale/locales.txt'

Changed files:
uClibc/extra/locale/gen_wc8bit.c
uClibc/extra/locale/gen_wctype.c
uClibc/extra/locale/gen_collate.c
uClibc/extra/locale/Makefile
Added files:
uClibc/extra/locale/codesets.txt
uClibc/extra/locale/locales.txt
uClibc/extra/locale/uClibc_locale_data.h
uClibc/extra/locale/locale_data.o

c8tables.h
gen_collate
gen_ldc
gen_locale
gen_wc8bit
gen_wctype
locale_collate.h
locale_data.c
locale_tables.h
lt_defines.h
wctables.h

There is var in uClibc/.config called `UCLIBC_HAS_LOCALE', which used in follows
./uClibc/include/ctype.h
./uClibc/include/iconv.h
./uClibc/include/bits/uClibc_locale.h
./uClibc/libc/stdlib/stdlib.c
./uClibc/libc/misc/locale/Makefile
./uClibc/libc/misc/internals/__uClibc_main.c
./uClibc/libc/misc/wchar/wchar.c
./uClibc/libc/misc/wchar/Makefile
./uClibc/libc/sysdeps/linux/common/bits/uClibc_locale.h
./uClibc/Makefile
./uClibc/extra/Configs/Config.in

2.
Funcs to check
setlocale()             (uClibc/misc/locale/locale.c)
localeconv()    (uClibc/misc/locale/locale.c)
nl_langinfo()   (uClibc/misc/locale/locale.c)

btowc()
wctob()

}}}1
032 - Ping behaviour {{{1
        05jun2005

The problem: When run ping second time it's only print 1 message.

2 ways to check:
        1st - it is ICMP problem, caused by UDP multicast in Softier's network or
                exists only with dhcp client.
        2nd - connected to long_long/wchar support, cause not happened w/ CCS2.

16jun2005
Found that C+c actualy causing problem to ping and th problem exists
aslo in 2.4 where libs compiled with CCS2.

Because cure is to do unblock to SIGALRM,so ..
}}}1
033 - toolchain fix 19jul2005 {{{1

List #1 {{{2

Symbols start w/ `_' from spru187l.pdf and objs names from rts of CCS3.1b
                                                                        Usage of                Current place
                Convert double to ...
_cvtdf                          cvtdf.obj                                                               libsoftier
_fixdi                          fixdi.obj                                                               libsoftier
_fixdli                         fixdli.obj                                                              libsoftier
_fixdlli                        fixdlli.obj             _llshru                                 libsoftier
_fixdu                          fixdu.obj                                                               libsoftier
_fixdul                         fixdul.obj                                                              libsoftier
_fixdull                        fixdull.obj             _llshru                                 libsoftier
                Convert float to...
_cvtfd                          cvtfd.obj                                                               libsoftier
_fixfi                          fixfi.obj                                                               libsoftier
_fixfli                         fixfli.obj                                                              libsoftier
_fixflli                        fixflli.obj             _llshru                                 libsoftier
_fixfu                          fixfu.obj                                                               libsoftier
_fixful                         fixful.obj                                                              libsoftier
_fixfull                        fixfull.obj             _llshru                                 libsoftier
                Convert int to...
_fltid                          fltid.obj                                                               libsoftier
_fltif                          fltif.obj                                                               libsoftier
_fltud                          fltud.obj                                                               libsoftier
_fltuf                          fltuf.obj                                                               libsoftier
                Convert long to...
_fltlid                         fltlid.obj                                                              libsoftier
_fltlif                         fltlif.obj                                                              libsoftier
_fltuld                         fltuld.obj                                                              libsoftier
_fltulf                         fltulf.obj                                                              libsoftier
                Convert long long to...
_fltllid                        fltllid.obj             _llshl                                  libsoftier
_fltllif                        fltllif.obj             _llshl                                  libsoftier
_fltulld                        fltulld.obj             _llshl                                  libsoftier
_fltullf                        fltullf.obj             _llshl                                  libsoftier
                Sign funcs
_absd                           absd.obj                                                                libsoftier
_absf                           absf.obj                                                                libsoftier
_labs                           abs.obj                                                                 libc
_llabs                          abs.obj                                                                 libc
_negd                           negd.obj                                                                libsoftier
_negf                           negf.obj                                                                libsoftier
_negll                          negll.obj                                                               libsoftier
                Shift long long
_llshl                          llshift.obj                                                             libm
_llshr                          llshift.obj                                                             libm
_llshru                         llshift.obj                                                             libm
                Funcs w/ double
_addd                           addd.obj                                                                libsoftier
_cmpd                           cmpd.obj                                                                libsoftier
_divd                           divd.obj                                                                libsoftier
_mpyd                           mpyd.obj                                                                libsoftier
_subd                           subd.obj                                                                libsoftier
                Funcs w/ float
_addf                           addf.obj
_cmpf                           cmpf.obj                                                                libsoftier
_divf                           divf.obj                                                                libsoftier
_mpyf                           mpyf.obj                                                                libsoftier
_subf                           subf.obj                                                                libsoftier
                Funcs w/ int
_divi                           divi.obj                                                                libsoftier
_remi                           remi.obj                                                                libsoftier
_divu                           divu.obj                                                                libsoftier
_remu                           remu.obj                                                                libsoftier
                Funcs w/ long
_divli                          imath40.obj                                                             libsoftier
_remli                          imath40.obj                                                             libsoftier
_divul                          imath40.obj                                                             libsoftier
_remul                          imath40.obj                                                             libsoftier
                Funcs w/ long long
_divlli                         imath64.obj             _llshl,_llshru                  libm
_remlli                         imath64.obj             _llshl,_llshru                  libm
_mpyll                          mpyll.obj                                                               libsoftier
_divull                         imath64.obj             _llshl,_llshru                  libm
_remull                         imath64.obj             _llshl,_llshru                  libm

Not found symbols (from rts):
_lltoa                          lltoa.obj

}}}2

Changes in libraries {{{2
Based on List #1 remove follows objs from libm to libsoftier:
llshift.obj, imath64.obj

Add missed obj to libsoftier:
lltoa.obj

Add follows to libsoftier (from STL project):
defs.obj, error.obj
}}}2

Add tms320c6-coff-mk-cramfs to /usr/local/bin

Change tms320c6-coff-strip to /usr/local/bin
}}}1
034 - filesystem {{{1
        04jul2005

To create remote fs, based http.

exist projects{{{2

ftpfs {{{3
-----
super_ops ftp_sops
        put_inode:              force_delete() - kill unused inodes
    delete_inode:       ftp_delete_inode()
                                        |-> lock_kernel()
                                        |-> clear_inode()
                                        |_> unlock_kernel()
    put_super:          ftp_put_super()
                                        |-> ftp_disconnect()
                                        |-> ftp_cache_empty()
                                        |_> kfree()
    statfs:                     ftp_statfs() - update file attr params
file_ops ftp_dir_operations
        read:           generic_read_dir()
        readdir:        ftp_readdir()
                                |->
                                |->
                                |_>
        open:           ftp_dir_open() - {return 0;}
inode_ops ftp_dir_inode_operations
        create:         ftp_create()
        lookup:     ftp_lookup()
        unlink:     ftp_unlink()
        mkdir:      ftp_mkdir()
        rmdir:      ftp_rmdir()
        rename:     ftp_rename()
inode_ops ftp_symlink_inode_operations
        readlink:               ftp_readlink()
        follow_link:    ftp_follow_link()
file_ops ftp_file_operations
        read:           generic_file_read()
        write:          generic_file_write()
        mmap:           generic_file_mmap()
        open:           ftp_file_open() - {return 0;}
        release:        ftp_file_release() - {return 0;}
inode_ops ftp_file_inode_operations
        permission:             ftp_file_permission()
addr_ops ftp_file_aops
        readpage:               ftp_file_readpage()
        writepage:              ftp_file_writepage()
        prepare_write:  ftp_file_preparewrite()
        commit_write:   ftp_file_commitwrite()

structs {{{4

ftp_fattr {{{5
    unsigned long   f_ino;
    umode_t     f_mode;
    nlink_t     f_nlink;
    uid_t       f_uid;
    gid_t       f_gid;
    kdev_t      f_rdev;
    off_t       f_size;
    time_t      f_atime;
    time_t      f_mtime;
    time_t      f_ctime;
    unsigned long   f_blksize;
    unsigned long   f_blocks;
}}}5

ftp_mount_data {{{5
    int version;
    int force_own;
    int active;
    __kernel_uid_t uid;
    __kernel_gid_t gid;
    __kernel_mode_t file_mode;
    __kernel_mode_t dir_mode;
    char root[FTP_MAXPATHLEN];
    char mount_point[FTP_MAXPATHLEN];
}}}5

ftp_sb_info {{{5
    struct sockaddr_in address;
    struct ftp_mount_data mnt;
    char user[FTP_MAX_USER];
    char pass[FTP_MAX_PASS];
    struct semaphore sem;
    struct socket *ctrl_sock;
    struct socket *data_sock;
    struct ftp_dir_cache cache;
}}}5

}}}4

ftp_read_super() {{{4
|-> create `struct ftp_sb_info info'
|-> update `struct super_block'
|-> ftp_cache_init(info) - init dir_cache 
|-> ftp_parse_options() - update ip,port,user,pass,root,own,uid,gid,fmode,dmode,active
|-> ftp_connect()
|   |-> create socket
|   |-> connect
|   |-> ftp_get_response() - gets number at start of line which is response (200 is Ok)
|   |   |-> ftp_readline() - recv till `\n'
|   |   |_> if 4th char is '-', so ...
|   |-> prepare buf for USER cmd
|   |-> ftp_execute() - send cmd, can reconnect, can care for response
|   |   |-> close data socket
|   |   |-? if ctrl socket is NULL call ftp_reconnect()
|   |   |-> add `\r\n' to cmd
|   |   |-> sock_send()
|   |   |-? if error send, so ftp_reconnect()
|   |   |_? ftp_get_response() (see above)
|   |-> prepare buf for PASS cmd
|   |-> ftp_execute() (see above)
|   |_> ftp_get_response() (see above)
|-> ftp_init_root_dirent() - update file attr of root direntry from info
|-> ftp_iget()
|   |-> new_inode()
|   |-> ftp_set_inode_attr()
|   |-? if dir update i_op, i_fop (ftp_dir_operations,ftp_dir_inode_operations)
|   |-? if link update i_op (ftp_symlink_inode_operations)
|   |-? if file update  i_op, i_fop and i_data.a_ops 
|   |      (ftp_file_inode_operations,ftp_file_operations, ftp_file_aops)
|   |_> insert_inode_hash(res)
|-> d_alloc_root()
|_? iput() - drop usage count of inode. if 0 so destroyed.
}}}4
ftp_file_readpage() {{{4
|-> get_page()
|-> page_address()
|-> ftp_read() till PAGE_SIZE
|   |-> ftp_lock()
|   |-> ftp_getname()
|   |-> prepare RETR cmd
|   |-> ftp_execute_open()
|   |- 
|   |-> 
|   |-> 
|->
|_>
}}}4
ftp_create() {{{4
|-> ftp_get_name() - create full path name
|-> ftp_proc_create()
|   |-> prepare STOR cmd
|   |-> ftp_lock()
|   |-> ftp_execute_open()
|   |   |-> ftp_execute_open_actv()
|   |   |-> ftp_execute_open_pasv()
|   |-> ftp_close_data()
|   |_> ftp_unlock()
|_> ftp_cache_invalidate()
}}}4

}}}3
cramfs {{{3
------
super_ops cramfs_ops
        statfs          cramfs_statfs()
file_ops cramfs_directory_operations
        read            generic_read_dir()
        readdir         cramfs_readdir()
inode_ops cramfs_dir_inode_operations
        lookup          cramfs_lookup()
addr_ops                cramfs_aops
        readpage        cramfs_readpage()
}}}3
httpfs-0.1 {{{3
----------
super_ops my_super_ops
        put_super       my_put_super()
        statfs          my_statfs()
        read_inode      my_read_inode()
        put_inode       my_put_inode()
file_ops my_path_file_ops
        open            my_path_open()
                                --------------
                                |->http_read()
                                |  |->get_tcp_conn()
                                |  |->http_send_query()
                                |  |->http_get_header()
                                |  |_>http_get_body()
        read            my_path_read()
        release         my_path_release()
inode_ops my_path_inode_ops
        lookup          my_path_lookup()
file_ops root_file_ops
        read            generic_read_dir()
inode_ops my_root_inode_ops
        lookup          my_root_lookup()
}}}3
}}}2

Design{{{2

GET - retrvs data with meta-data
HEAD - retrvs only meta-data
PUT - stores data

Apache changes in /etc/httpd/conf/httpd.conf :
KeepAlive On
KeepAliveTimeout 360

1. superblock ops and mount utility.
2. file and inode ops (readonly)

super_ops httpfs_sops
        put_inode:              force_delete()
    delete_inode:       ftp_delete_inode()
    put_super:          ftp_put_super()
    statfs:                     ftp_statfs()
file_ops ftp_dir_operations
        read:           generic_read_dir()
        readdir:        ftp_readdir()
        open:           ftp_dir_open()
inode_ops ftp_dir_inode_operations
        create:         ftp_create()
        lookup:     ftp_lookup()
        unlink:     ftp_unlink()
        mkdir:      ftp_mkdir()
        rmdir:      ftp_rmdir()
        rename:     ftp_rename()
file_ops ftp_file_operations
        read:           generic_file_read()
        write:          generic_file_write()
        mmap:           generic_file_mmap()
        open:           ftp_file_open()
        release:        ftp_file_release()
inode_ops ftp_file_inode_operations
        permission:             ftp_file_permission
addr_ops ftp_file_aops
        readpage:               ftp_file_readpage()
        writepage:              ftp_file_writepage()
        prepare_write:  ftp_file_preparewrite()
        commit_write:   ftp_file_commitwrite()
}}2

status:
        11sep2005
        httpfs - freezed. actualy it's works.
        ftpfs - fixed proc.c to run in passive mode with MS IIS ftp server. active
mode still runs only with Linux ftp server. In Windows -  there is bug in ftp
server where FTP server answer  Ok for PORT command and after send 425 - "can't
open data connection".



}}}1
035 - kernel 119 release {{{1

1. BSP 3.0 integration
2. DMX driver code from Eli
3. Fast Logo bug fix from Oleg

Changes {{{2
<bsp>/bsl/include/kad/ddk/cs4955.h - linux-2.4.x/kad/include/bsl/cs4955.h
<bsp>/include/bsl_aud_codec.h - linux-2.4.x/kad/include/bsl/
<bsp>/include/bsl_queries.h - linux-2.4.x/kad/include/bsl/
All libs from <bsp>/lib/bsl/... - linux-2.4.x/kad/dm642/...

Changes in bsl_queries.h:
Added new macros
#define AUDIO_BURST_MODE_FLG  0x1  /**< Default mode for AIC23 codec*/
#define AUDIO_TDM_MODE_FLG        0x2  /**< Default mode for UDA8113H codec*/
#define AUDIO_DIT_MODE_FLG        0x4  /**< Optional mode for boards that has S/PDIF connector */
Added new field
Uint32 audio_mode_flags;    /**< Possible Audio Transfer mode flags*/
        for audio_ports_prop_t

Changes in bsl_aud_codec.h:
Added new enum for Audio transfer modes
typedef enum {
  AUDIO_BURST_MODE,   /** Burst transfer mode */
  AUDIO_TDM_MODE,     /** Time-Division Transfer mode*/
  AUDIO_DIT_MODE      /** Digital Audio Transmit Transfer mode*/
} audio_xmt_mode_e;
Added new var
audio_xmt_mode_e xmt_mode; /**< Audio Transfer mode */
Changed api of aud_codec_getDevParams
aud_codec_st  aud_codec_getDevParams(Int codec_handle,audio_xmt_mode_e xmt_mode,CODEC_EDMA_DevParams  *devParams);

Follows src files calls ud_codec_getDevParams(), so should be changed. Example
taken from bsp-2.26 (from <bsp-2.26>/ddk/native/src/)
--- linux-2.4.x/kad/sound/edma_codec.c ---
Add new var
extern audio_xmt_mode_e   current_audio_xmt_mode;
Change call to aud_codec_getDevParams():
aud_codec_getDevParams(DEFAULT_AUD_CODEC_HANDLE,current_audio_xmt_mode,&tmp_params)
Add new init for edmaCfg.opt like:
    switch(current_audio_xmt_mode) {
        case AUDIO_BURST_MODE:
            edmaCfg.opt |= EDMA_FMKS(OPT, ESIZE, 32BIT);
            break;
        case AUDIO_TDM_MODE:
        case AUDIO_DIT_MODE:
            edmaCfg.opt |= EDMA_FMKS(OPT, ESIZE, 16BIT);
            break;
        default:
            break;
    }
Minory change at line 224 of 3d argument from `args' to `(Uint32 *)pargs'

--- linux-2.4.x/kad/sound/pcmdrv.c ---
}}}2

Changed files {{{2
linux-2.4.x/arch/tms320c6/drivers/dmx/dmxdrv.c (have chnages from Eli  and Oleg)
linux-2.4.x/kad/gio/evm642/video_api.c
linux-2.4.x/kad/include/kkidef.h
linux-2.4.x/kad/include/video.h
linux-2.4.x/kad/include/bsl/bsl_aud_codec.h 
linux-2.4.x/kad/include/bsl/bsl_queries.h
linux-2.4.x/kad/include/bsl/cs4955.h
linux-2.4.x/kad/sound/edma_codec.c
linux-2.4.x/kad/sound/pcmdrv.c
Follows from linux-2.4.x/kad/dm642/:
        control_mv_600M_bsl.lib
        ec628_600M_bsl.lib
        ec628_720M_bsl.lib
        evmdm642_600M_bsl.lib
        evmdm642_720M_bsl.lib
        gbio_600M_bsl.lib
        mdm_600M_bsl.lib
        mdm_720M_bsl.lib
        media1_600M_bsl.lib
        media2_1_600M_bsl.lib
        media_adapter_600M_bsl.lib
        media_adapter_720M_bsl.lib
        ny7000_600M_bsl.lib
        pci_per_720M_bsl.lib (newly added)
        xds_600M_bsl.lib
}}}2

}}}1
036 - SPDIF {{{1
        08aug2005

To add kernel driver SPDIF sound output. The low-level driver (from BSL) taken
from TI's McASP (Baruch). Should create kernel wrap for SPDIF. This change
should be available for 600/720MHz of ec628 card (Huawei card).

status
1. Add Baruch's BSL
2. Make change SPDIF/other
3. Check for support in OSS
4. add Or's support for Keypad

1. 
<bsp>/include/bsl_aud_codec.h - linux-2.4.x/kad/include/bsl/
<bsp>/include/bsl_queries.h - linux-2.4.x/kad/include/bsl/
All libs from <bsp>/lib/bsl/... - linux-2.4.x/kad/dm642/...

2.
linux-2.4.x/drivers/sound/evm642_aic.c
linux-2.4.x/kad/sound/pcmdrv.c
linux-2.4.x/kad/include/sound/pcmdrv.h
linux-2.4.x/kad/sound/edma_codec.c
linux-2.4.x/kad/include/kkidef.h
linux-2.4.x/include/linux/soundcard.h

4.
<bsp>/include/pca9555_i2c.h - linux-2.4.x/kad/include/bsl/

Source code {{{2

linux-2.4.x/include/linux/autoconf.h
#define CONFIG_SOUND 1
#define CONFIG_SOUND_EVM642 1
#undef  CONFIG_SOUND_MSNDCLAS
#undef  CONFIG_SOUND_MSNDPIN
#undef  CONFIG_SOUND_OSS

linux-2.4.x/drivers/sound/
                evm642_aic.c
                sound_core.c
                sound_firmware.c
linux-2.4.x/kad/sound/
                c6x1x_edma_mcasp.c
                edma_codec.c
                pcmdrv.c
linux-2.4.x/kad/include/sound/
                pcmdrv.h

Driver init:
init_evm642_sound() from linux-2.4.x/drivers/sound/evm642_aic.c
|->pcmdrv_create() from linux-2.4.x/kad/sound/pcmdrv.c
|  |->alloc audio pcm handler
|  |->SWI_create() create SWI manager for playback
|  |->SWI_create() create SWI manager for record
|  |->bsl_getAudioPortsProp() get audio port params
|  |->aud_codec_setMode() set audio transfer mode
|  |->aud_codec_getDevParams() get dev params
|  |->DEV_createDevice( audiocodec ) -from BSP, creates DEV_IOMTYPE type device
|  |  |->EDMA_CODEC_init() from linux-2.4.x/kad/sound/edma_codec.c
|  |  |  |_>C6X1X_EDMA_MCASP_init() from
|  |  |                                         linux-2.4.x/kad/sound/c6x1x_edma_mcasp.c
|  |  |_>mdBindDev() from linux-2.4.x/kad/sound/edma_codec.c
|  |     |->bsl_getAudioPortsProp()
|  |     |->aud_codec_getDevParams()
|  |     |->aud_codec_config() set codec params
|  |     |_>mdBindDev() from linux-2.4.x/kad/sound/c6x1x_edma_mcasp.c
|  |        |->ATM_setu() mark the port in use
|  |        |->IRQ_map() map supplied irq to EDMA event
|  |        |->HWI_dispatchPlug() plug EDMA dispatcher to HWI dispatcher
|  |        |->MCASP_open() open & reset McASP
|  |        |->MCASP_config() config w/ params given by caller func
|  |        |_?
|  |
|  |->DEV_createDevice( dio_Audiocodec )
|  |
|  |->SIO_create() for playback device
|  |  |->mdCreateChan() from linux-2.4.x/kad/sound/edma_codec.c
|  |     |->bsl_getAudioPortsProp()
|  |     |_>mdCreateChan() from linux-2.4.x/kad/sound/c6x1x_edma_mcasp.c
|  |        |->ATM_setu()
|  |        |->QUE_new()
|  |        |->
|  |        |_>
|  |
|  |_>SIO_create() for record device
|     |->mdCreateChan() from linux-2.4.x/kad/sound/edma_codec.c
|        |->mdCreateChan() from linux-2.4.x/kad/sound/edma_codec.c
|
|_>register_sound_dsp()

pcmdrv_delete() from linux-2.4.x/kad/sound/pcmdrv.c
|-? SIO_delete() for output stream
|-? SWI_delete() for output stream
|-? SIO_delete() for input stream
|-? SWI_delete() for input stream
|-> DEV_deleteDevice("/dioAudiocodec")
|-> DEV_deleteDevice("/audiocodec")
|_> kki_free() free audio pcm handler

}}}2

status:
08sep2005
found bug - memory leak - where try to free non-allocated. fixed for k123.
also the example application fixed and explanation added (setamode.c)

}}}1
FLASH driver for MediaLinux {{{1
        22aug2005

done for code from 26nov2005
cvs co -D 2005/10/26 linux-2.6.7

Tasks:
1. enable flash driver (Intel NOR driver for our flash MT28F128J3)
2. make dynamic partitions configuration (from cmdline)
3. search for diff between 2.6.7 and 2.6.13 (for 01sep2005)

Flow of changes {{{2
get new source from cvs (25sep2005). runs `make menuconfig' and set follows
as built-in (not modules):
CONFIG_MTD_BLOCK (not RO)
CONFIG_MTD_CFI (under chip drivers)
CONFIG_MTD_CFI_INTELEXT (under chip drivers)
CONFIG_MTD_PHYSMAP (under mapping)
start addr 0x90000000 (under mapping)
length 0x1000000 (under mapping)
bus 1 (under mapping)

On case MTD block driver is built-in, so change init to mount mtdblock1
instead mtdblock0.
}}}2
Final changes {{{2

1. add delow to include/asm/io.h:
#define __raw_writeb(v,a)   (*(volatile unsigned char  *)(a) = (v))
#define __raw_writew(v,a)   (*(volatile unsigned short *)(a) = (v))
#define __raw_writel(v,a)   (*(volatile unsigned int   *)(a) = (v))

#define __raw_readb(a)      (*(volatile unsigned char  *)(a))
#define __raw_readw(a)      (*(volatile unsigned short *)(a))
#define __raw_readl(a)      (*(volatile unsigned int   *)(a))

and

#define PLL1708_SDIN        GPIO_PIN1   /* Data input to the PLL1708 */
#define DIG_OUT1            GPIO_PIN1   /* Digital output 1 (LED1) */
#define PLL1708_SCLK        GPIO_PIN2   /* Clock input to the PLL1708 */
#define DIG_OUT2            GPIO_PIN2   /* Digital output 2 (LED2) */
#define PLL1708_CS_         GPIO_PIN4   /* CS# signal to the PLL1708 */
#define USB_HC_DREQ         GPIO_PIN5   /* ISP1760/1 HC_DMA_REQ signal */
#define USB_DC_DREQ         GPIO_PIN6   /* ISP1761 DC_DMA_REQ signal */
#define DM642_INT           GPIO_PIN7   /* Sum of UART_INTA,UART_INTB,USB_DC_INT and USB_HC_INT interrupts */
#define FLASH_PAGING_EXT    GPIO_PIN9 | GPIO_PIN10 |\
                            GPIO_PIN11 | GPIO_PIN12 /* FLASH Paging output pins */
#define FLASH_WPENABLE      GPIO_PIN13  /* Flash Write Program Enable pin */
#define DIG_IN1             GPIO_PIN14  /* Digital Input 1 (push button on front panel) */
#define DIG_IN2             GPIO_PIN14  /* Digital Input 2 (push button on front panel) */
#define IR_DATA             GPIO_PIN3   /* Infra Red receiver pin */

2. fix in drivers/mtd/maps/physmap.c
in init_physmap()
instead of `physmap_map.virt = (unsigned long)WINDOW_ADDR; ' write folllows
`physmap_map.virt = (unsigned long)NULL; '
instead of `iounmap((void *)physmap_map.virt);' write follows:
`physmap_map.virt = 0'
in cleanup_physmap()
instead of `iounmap((void *)physmap_map.virt)' write follows
`physmap_map.virt = 0'

3.  fix in user-2.6/config/rc.jffs2
To delete start of dhcpcd at boot. Have to rebuild: `make romfs && make image'

4. fix arch/tms320c6/modules/modules.cmd , where added *(__ksymtab_gpl)

-----------------------------------
4. fix in arch/tms320c6/usr/initramfs/init.
Load modules in follow order
/bin/busybox insmod /lib/modules/2.6.7/kernel/drivers/mtd/mtdpart.ko
/bin/busybox insmod /lib/modules/2.6.7/kernel/drivers/mtd/cmdlinepart.ko
/bin/busybox insmod /lib/modules/2.6.7/kernel/drivers/mtd/chips/cfi_cmdset_0001.ko
/bin/busybox insmod /lib/modules/2.6.7/kernel/drivers/mtd/chips/gen_probe.ko
/bin/busybox insmod /lib/modules/2.6.7/kernel/drivers/mtd/chips/cfi_probe.ko
/bin/busybox insmod /lib/modules/2.6.7/kernel/drivers/mtd/maps/physmap.ko
/bin/busybox insmod /lib/modules/2.6.7/kernel/drivers/mtd/mtd_blkdevs.ko
#/bin/busybox insmod /lib/modules/2.6.7/kernel/drivers/mtd/mtdblock_ro.ko
/bin/busybox insmod /lib/modules/2.6.7/kernel/drivers/mtd/mtdblock.ko
/bin/busybox insmod /lib/modules/2.6.7/kernel/drivers/mtd/mtdchar.ko

5. fix in order to enable write to the flash. (04sep2005)
in arch/tms320c6/bsl/bsl_common.c there is init of different pins (call to
CPIO_pinEnable). there pin #13 should be 1 (write to the flash), but the initial
state is 0.
In order not to change generic mtd drv and init system w/ flash RO, decided
(by Or) to have new ioctl which makes pin #13 writeable

06nov2005
All sources taken w/ -D 2005/09/26
}}}2
Lack of sysfs support in MTD {{{2
        02nov2005
It starts from idea to use MTD tools for softier's driver, but all those tools
use `/dev/mtd0', which is not create, cause MTD version for kernel 2.6.7
doesn't support sysfs, so no /dev/mtd0 device created.
Can't copy from current kernel (2.6.14), cause sysfs api changed also.
Take example from softier's vbios module (from Or).

}}}2
Knowledge {{{2
manage jffs2 image {{{3
        purpose to change given jffs2 image on machine w/o physical flash.
modprobe -r mtdblock
modprobe -r mtdram
modprobe -r jffs2

modprobe mtdblock
modprobe mtdram total_size=6144,erase_block=128
modprobe jffs2

dd if=<image filename> of=/dev/mtdblock0
mount -t jffs2 /dev/mtdblock0 /mnt

Now possible to change/add/delete files.

umount /mnt
dd if=/dev/mtd0 of=<new image file>

}}}3
Kernel configuration and modules names. {{{3
* - MTD                                                                                                 mtdcore
|-> * debugging
|     |_> 1 debugging verbosity
|-> M partitioning support                                                              mtdpart
|-> - concatenating support
|-> - RedBoot partition table parsing
|-> M CmdLine partition table parsing                                   cmdlinepart
|-> - direct char dev access to MTD dev                                 mtdchar
|-> - caching block dev access to MTD dev                               mtdblock mtd_blkdevs
|-> M ReadOnly block dev access to MTD dev                              mtdblock_ro mtd_blkdevs
|-> - FTL support
|-> - NFTL support
|-> - INFTL support
|-> + RAM/ROM/Flash chips drivers
|     |-> M detect flash chips by CFI probe                             cfi_probe
|     |-> - detect non-CFI flash chips 
|     |-> - flash chip driver adv config options
|     |-> M support for Intel/Sharp flash chips                 cfi_cmdset_0001
|     |-> - support for AMD flash chips
|     |-> - support for ST flash chips
|     |-> - support for RAM chips in bus mapping                map_ram
|     |-> - support for ROM chips in bus mapping
|     |-> - Support for absent chips in bus mapping
|     |_> - Older drivers for non-CFI chips
|-> + Mapping drivers for chip access
|     |-> - support non-linear mappings of flash chips
|     |-> M CFI flash device in physical memory map             physmap
|     |-> 0x90000000 phys start addr of flash mapping
|     |-> 0x1000000 phys length of flash mapping
|     |-> 1 bus width in octets
|     |_> - generic uClinux RAM/ROM fs support
|-> - Self-contained MTD dev driver
|     |_>...
|_> - NAND flash dev driver
      |_>...
}}}3

Flows:
mtdcore
|-> init_mtd()
|   |-> create

init_physmap() from drivers/mtd/maps/physmap.c
do_map_probe() from drivers/mtd/chips/chipreg.c
|-> get_mtd_chip_driver() - get driver obj from drivers list by name.
|   cfi_probe,jedec_probe,map_rom,etc.

cfi_probe() (drivers/mtd/chips/cfi_probe.c)
|_>mtd_do_chip_probe() (drivers/mtd/chips/gen_probe.c)
   |->genprobe_ident_chips() (drivers/mtd/chips/gen_probe.c)
   |  |->genprobe_new_chip() (drivers/mtd/chips/gen_probe.c)
   |  |  |->cfi_probe_chip() (drivers/mtd/chips/cfi_probe.c) - probe per dev
   |  |  |  | type X8 or X16
   |  |  |  |->cfi_send_gen_cmd(0xF0, 0,...)
   |  |  |  |->cfi_send_gen_cmd(0x98, 0x55,...)
   |  |  |  |->qry_present() - query for Q R Y at 10h,11h,12h
   |  |  |  |-?cfi_chip_setup() (drivers/mtd/chips/cfi_probe.c)
   |  |  |  |  |->cfi_read_query() (drivers/mtd/chips/cfi_probe.c)


have to create MTD partition with at least 6 contiguous sectors in order to use
jffs2 (garbage collection).

Setting device RO/RW.
History: for RO protection of flash (in 2.4) pin 13 closed.
Found ioctl BLKROSET (from include/linux/fs.h) which set device RO (0 for RW).
Call come to drivers/block/ioctl.c, where disk->fops->ioctl() called. It
brings to drivers/mtd/mtd_blkdevs.c, where blktrans_ioctl().
BUT no case for BLKROSET.
Such case added and call to setblkmode() ( include/linux/mtd/blktrans.h )
Changed struct mtd_blktrans_ops mtdblock_tr where added
.setblkmode
...
}}}2
flash driver arch in 2.4 {{{2
        from BSP bsl/native/src/bsl_flash.c, MT28FxxxJ3_x8.c
Hardware architecture {{{3
Currently in our system there are 4 chip selects, which configured by EMIF.
The addr bus is 20b for every cs and data bus is different.
cs0 - sdram       (data bus 64b)
cs1 - flash, uart (data bus 8b)
cs2 - usb         (data bus ?b)
cs3 - ?

Every cs has it's own address range, where cs1 starts at x90000000

This flash chip has own hardware lock, based on block level. The block or
eraseblock is 128KB.

}}}3
extren struct for simple funcs:
struct FLASHSG_Fxns { erase, read, write, checksum, lock, unlock } where not
used lock and unlock by Softier.

DM642_FLASH_read()
|
FlashRead() - args (src,dst,len)

DM642_FLASH_checksum()

DM642_FLASH_erase()

DM642_FLASH_write()
FlashWrite() - args (hndlr, src, dst, size) - (MT28FxxxJ3.c)
|-> nbr of Bs for each write - 2B
|-> nbr of Bs to skip in 1st write for alignment
|-> nbr of Bs to program on 1st write
|-> start addr of 1st write for alignment
|-> memset for internal buffer (0xff)
|-> cp from src to internal buffer
|-> FlashBufferProgramming() - (dst,src)
|   |-> set dst block addr
|   |-- loop for wait 0xffffffff times
|   |-- cp to block addr buffer write cmd (0x00e8), by call to
|   |   WRITE_FLASH(a,d) - macro `*((volatile BYTE*)(a)) = (d)
|   |-- get status of write buffer cmd, by call to
|   |   READ_FLASH(a) - macro `*((volatile BYTE*)(a))'
|   |-- check if status READY, so end of loop, by call macro FLASH_IDLE()
|   |-? check if waited till end of counter , so return w/ err BUSY
|   |-> write to block buffer count cmd (0x001f), by call WRITE_FLASH
|   |-- loop for index (0-31) to indexed write
|   |-- WRITE_FLASH_INDEX(dst,indx,src[indx]) - macro
|   |   `*((volatile BYTE*)((BYTE*)(dst) + (i)))=(src)'
|   |->WRITE_FLASH(addr,cmd) - set buffer write confirm cmd (0x00d0) to block
|   |_> WaitComplete(src)
|       |-- loop for countr till 0xffffffff
|       |-- write READ_STS_CMD (0x0070) to addr
|       |-- read status
|       |-? if status read, so end of loop
|       |-? if loop ended w/ max counter, so return err timeout
|       |-> write CLEAR_STS_CMD (0x0050)
|       |-> write READ_ARRAY_CMD (0x00ff)
|       |_> FullStatusCheck() - checking status agains follow bits
|           VPP_BIT,LOCK_BIT,WRITE_ERR_BIT,ERASE_ERR_BIT
|-> update src pointer
|-> update how many Bs remain
|-> update start addr
|-> writing the rest in loop

onboard_flash_pg_update()
}}}2

changes made in user also, to bring up mtd-utils.
cvs -Q diff -upwN > patch

create jffs2 image:
mkdir ./opt
cp <>/<file> ./opt/
. /usr/local/tools/env.src
tms320c6-coff-mk-jffs2 -d ./opt -o small.img -e 128 -v -U
tms320c6-coff-bin2tihex -i ./small.img -o small.dat -a 0x90000000

}}}1
037 - add 32M ramfs to linux 2.4 {{{1

Create ramfs32768.img file and place it in uClinux-dist/user/ramimage/
Cahnge follows files:
config/config.in
user/ramimage/Makefile
user/Makefile

create patch: cvs -Q diff -pwuN > patch

}}}1
038 - igmp bug fix in 2.4 {{{1
        released 10oct2005
        fix in linux-2.4.x/arch/tms320c6/drivers/dm642_emac/dm642_emac_linux.c
}}}1
039 - sdk problems from Vertimatrix {{{1
    05feb2006
0.     Critical – missing C++ symbols;          - done; changed libsoftier.a, libc.a
{{{
Those are unresolved symbols
    __add_dtor          ./libvmclient.a
    __new_handler       libsoftier.a
    __ftable            libsoftier.a
Investigation:
The symbol `__add_dtor' found in sinit.obj, symbol `__new_handler' found in 
vars.obj and `__ftable' in defs.obj All objs files from rts6400.lib
After adding above objs to libsoftier.a, new unresolved symbol `__dtors_prt'
from `exit.obj'. This obj can't be added to libsoftier.
TI compiler creates global pointer2func `dtors_ptr', which collect dtors for
global objs. On exit those dtors called. The exit() in libc,a can be changed.
Solution:
Added follows objs to libsoftier.a from rts6400.lib:
vars.obj, sinit.obj,defs.obj
Changed file uClibc/libc/stdlib/atexit.c to create global pointer `dtors_ptr'
and call it at func exit().
}}}
1.     C++ function pointers casting issue;     - done by Ady; typecasting should be added
2.     No try/catch;                            - done; changed libsoftier.a, crti.o, tms320c6-coff-gcc, tms320c6-coff-g++
{{{
When compile simple file with `try n catch' get error `542: support for 
exception handling is disabled'.
Investigation:
In order to enable exception handling (EH), have to add compiler flag 
`--exceptions' (from spnu151b) and instead of crti.o to use crti_eh.o
Compilation w/ above changes brings unresolved symbols:
__free_thrown_object
__curr_eh_stack_entry
__eh_curr_region
__caught_object_address
__catch_clause_number
__exception_caught
__throw
__throw_setup_dtor
__swap_eh_context
All those found at rts6400_eh.lib, in follows objs: dtor_list, eh_util, error,
memzero, pure_virt, rtti, sinit, throw, vars, vec_newdel
All objs from the list (except eh_util) already exist in libsoftier from
rts6400.lib Hannit (07feb2006) told not to order, just to make sure current 
customer can keep working, so...
Solution:
Delete objs from libsoftier.a, which should be added from rts6400_eh.lib Add
new objs. Rename crti_eh.o to crti.o
}}}
3.     Broken include file <netinet/igmp.h>     - done; changed netinet/in.h
{{{
when add include of `netinet/igmp.h' follows error appears: `20: identifier 
"__inline__" is undefined' After adding `-D\"__inline__=inline\"' to tmsg++
new error: `20: identifier "__const__" is undefined', so once again added
`-D\"__inline__=inline\"' to tmsg++.
Both errors from file uClibc/include/linux/byteorder/swab.h
Now unresolved symbol: `_htonl' from vmclient.o
Check uClibc/include/linux/byteorder/generic.h
Found that problem occures, when netinet/in.h included before netinet/igmp.h
Also, when CPP file compiler send error about 2 declations of htonl(), so
changed netinet/in.h to disable 1 of declations.
Solution:
    To put include of netinet/igmp.h before include of netinet/in.h and small
change in netinet/in.h to comment htonl() declaration.
}}}
4.     Broken include file <sys/stat.h>         - done; changed bits/stat.h
{{{
    when compiled CPP file (not C), warning appears:
`83: warning #163-D: unrecognized #pragma' from file include/bits/stat.h
No such warning w/ C file. Based on spru187l.pdf (chap 7.7), macro STRUCT_ALIGN
doesn't work. Check if comment this macro in stat.h will change sizeof struct
stat. Found that not, always 88.
Solution:
    Comment use of pragma STRUCT_ALIGN in bits/stat.h
}}}
5a.    –M / -MM don’t work (auto dependencies)
5b.    ALSO COMPILER VERY SLOW – 2.5 hours for OpebSSL
{{{
    build no tools-lnx (P4 2.66 512MB) for 11min
}}}
6.     Linking via gcc mishandles –L or –l;
7.     tms320c6-coff-ar doesn’t work increamentally;
8.     ^C in compilation crashes compiler;
9.     libpthread & libdt are duplicate;
10.    Can’t link with gcc – need to do it with ld;

status:
09feb2006 finished, email to Ady & Hannit.

}}}1
040 - auto upgrade procedure initial {{{1
        08nov2005
Document {{{2

--- 0. Introduction                                                     {{{3

    The upgrade feature of Softier's MediaLinux OS.
    This feature provides ability to upgrade the whole system (kernel,filesystem,
etc). The approach demands to create separate system, called upgrade, where all 
needed to get new copy of the main system (the name for the system 
actualy runs MediaEngine). Describtion for 2 systems:
Upgrade system - kernel, kad, root filesystem,
Main system - kernel, kad, root filesystem, alt filsystem and logo image.
The only part aware about both systems is bootloader and it can decide which
one (main or upgrade) to load. Normaly it is main system, but there are cases
where it is not:
1. user will  (pushing button in front of Softier's box)
2. application decides that upgrade
                                                                      }}}3
--- 1. System in preliminary status.                                    {{{3

        System setup.
The upgrade system brings new kernel, kad and filesystem image. All placed
on the flash right after bootloader (order can be changed):
        Bootloader + UpgKernel + UpgKAD + UpgFS
and the main system files placed right after (order can be changed)
        Kernel + KAD + FS + AltFS + Logo

   |    Non upgradable part        |           Upgradable  part  |

    -------------------------------------------------------------
   | Boot   | Upg   | Upg    | Upg |        | Root | Alt | Logo  |
   | Loader |  Info | Kernel |  FS | Kernel |  FS  |  FS | image |

So, the system splited in parts, which is upgradable and not. The non
upgradable, means can't be rewrite by upgrade application.
There are number of parameters and flags, which control upgrade flow,
added to the system. Some of them can be changed.
- Address of the upgarde system: read-only, kept by bootloader.
- Upgrade control flags: read-write, API exists.
- Address of the main system: read-write, no API.
- Factory settings: read-write, API exists.

Upgrade system address.
The upgrade system can't be changed, by any application, except Softier's
monitor tool. It's address only used by bootloader. In this case, it's
read-only and no API to application level.

Main system address.
This data needed by bootloder and should be changed by upgrade application.
It is read-write, but ONLY upgrade application knows how to change it, so no
API. Placed in upgrade info block.

Upgrade control flags.
Those are used by bootloader and upgrade application. So defined as read-write
and have API. There are 3 flags:
FU - force upgrade - must to upgarde the system;
FUA - force upgrade A - must to upgrade the system w/ factory settings;
FUB - force upgrade B - must to upgrade the system, because of system boot
        failure;
STYPE - server type - used to choose which upgrade server to use: 0 - TFTP,
        1 - FTP.

Factory settings.
Upgrade server name - changable parameter used, by upgrade application.
Static ip - - changable parameter used, by upgrade application.
There are 2 copies of factory settings. The read-only copy, kept that way
and non upgradable and the read-write copy, placed in upgrade info block and
have API to change it.

The upgrade system description.
        This one have kernel, created as minimal as possible. Approximate list of
discarded kernel options: sound, video, network fs, usb, scsi, ppp.
The filesystem image should be minimal also. Approximate list of applications:
dhcp client, busybox, boa, etc.
                                                                      }}}3
--- 2. Boot sequence definitions.                                       {{{3

At the beginning, bootloader starts. Checks if FU set and if it's up proceedes
to upgrade flow. This is case of simpe Auto upgrade. Otherwise, checks FUB flag,
which, if set, brings us to upgrade flow also. This is case which previous
kernel boot failure.
At this stage, when both FU and FUB equal 0, bootloader checks for press of
reset button.
* If button not pressed or pressed for less then 5sec, proceedes to normal boot
  sequence.
* If button pressed for > 5s and < 20 sec - the upgrade explicitly wanted. So make
  FU=1 (and FUA=0) and goes to upgrade flow.
* If button pressed for > 20sec - the upgrade wanted w/ factory settings. So make
  FUA=1 (and FU=0) and goes to upgrade flow w/ factory settings.

New feature to check if main system loads is flags FUB. It is set by bootloader
before main system loaded and unset by main system itself, when load finished.
Otherwise, when bootloader see it next time, it's mean that something wrong with
boot of the main system and will upgrade it.
                                                                Picture {{{4
            --------------------------> RESET/BOOT
           ^                                  |   y
           |                            < FU==1 > --> UPGRADE <----
           |                                  |n         ^         |
           |                                  |          |         |
           |                            < FUB==1 > ------          |
           |                                  |n                   |
           |                                  |                    |
           |n                        n        |                    |
      <success> <-- IPSTB <-- FUB=1 <--- < btn press >             |
           |y                  ^              |                    |
           |                   |              |y                   |
         FUB=0                 |              |                    |
           |                   |     /------------------\          |
        working system         |     |        |         |          |
                               |    <5s      <20s      >20s        |
                               |     |        |         |          |
                                -----       FU=1       FU=0        |
                                            FUA=0      FUA=1       |
                                              |         |          |
                                               --------------------
                                                                   }}}4 }}}3
--- 3. Upgrade flows.                                                   {{{3

There are 2 types of upgrade scenatious:
    Auto upgrade, where no interaction with user.
    Manual upgrade, where asking for upgarde file from user.

At the beginning of the stage the upgrade system loaded. The only purpose for
this is to run upgrade application, which able to do whole upgrade. The app
have to choose right upgrade scenario.
First, it's checks FUA flag and if set, brings to manual upgrade flow w/
factory settings. Otherwise, it waits 10sec (w/ blinking) for black button
pressed. Press of it brings system to manual scenario. The lack of press brings
to auto upgrade scenario.
                                                                Picture {{{
              UPGRADE
                 |
            load UpgK + UpgFS
                 |
          y      |
        --- < FUA==1 >
       |         |n
       |         |
       |      wait 10s
       |  y      |        n
        --- < btn press > ---
       |                     |
       |                     |
   MANUAL Upg        ----> AUTO Upg
       |            |         |
       |            |  n      |
       |             ---- < success >
       |                      |y
        -------> RESET <------
                                                                   }}} 
}}}3
--- 4. Auto scenario.                                                   {{{3

The upgrade application decided to go in Auto upgrade scenario. In order to 
connect to download upgrade file, DNS resolving needed, so it runs DHCP client.
Second, read upgrade server name and tries to download upgrade file.
Now unzip file and checks its integrity. Finaly, burn unzipped it and
verify. If successfull, set all upgrade flags to 0 and reset.
The upgrade app reads 2 values of upgrade server name - default and volatile.
It's starts with volatile and in case of fail, use default.
Any of above steps if fails 3 times will cause reset. Reset will bring to
auto upgarde once again.
                                                                picture {{{4
               AUTO
                 |           n3
             < set network > -------
                 |y      n3         |
             < connect > -----------|
                 |y       n3        |
             < download > ----------|
                 |y                 |---
             < verify integrity > --|   |
                 |y                 |   |
             < burn flash > --------    |
                 |y                     |
         < update boot info > ----------|
                 |y                     |
               FU=0                     |
                 |                      |
               RESET <------------------
                                                                   }}}4 }}}3
--- 5. Manual scenario.                                               {{{3

There are 2 ways to get to this stage. User pushed button for > 20 sec at 1st
time or user pushed button (for any amount of time) for the second time.
The first way gives manual update scenario with use of factory settings and
the second brings just manual upgrade scenario.
The factory settings is just static IP address burned on flash, by box
provider, w/o ability to update it.
The flow itself goes like this:
The upgrade application checks for FUA flag and if found FUA==1 will read
and set static IP. Otherwise, proceeds to run DHCP client to get dynamic one.
At next step HTTP server (boa) will be started.
From this stage the system will interact w/ user. The user should run HTTP
browser and connect to previously started HTTP server. The html pages will
guide him to add path for the zip file.
After the user push proceed button (from html page), the system will download
zip file and place it in ram disk. Open it and check integrity. Burn and check
validity. Update boot info. Set down FUA flag and reset.
In case of an error happened
                                                                picture {{{4
               MANUAL
                 |                              
                 |      y                  3n   
             < FUA==1 > ---> < static IP > ---- 
                 |n              ^   |y        |
                 |           3n  |   |         |
             < set network > ----    |         |
                 |y                  |         |
                 | <-----------------          |
                 |                             |
                 |        3n                   |
             < run http > -------------------->|
                 |                             |
          / user interaction /                 |
                 |        3n                   |
             < download > -------------------->|
                 |                3n           |
             < verify integrity > ------------>|
                 |          3n                 |
             < burn flash > ------------------>|
                 |            3n               |
         < update boot info > ---------------->|
                 |                             |
                 |                             |
                FUA=0                          |
                 |                             |
               RESET <-------------------------  
                                                                 }}}4 }}}3
--- 6. Upgrade parameters API                                         {{{3

 - Control flags - 

Can read them from procfs, like `cat /proc/upgrade/flags' or change them,
like `echo 1 > /proc/upgrade/flags'
There are 2 functions, provided read and write capabilities, write_upgflags()
and read_upgflags(). Both placed at <source>/user/upgrade/libupg/upg.c

 - Factory settings -

TFTP server name - domain name of tftp server, where to download files. Can
be read from /proc/upgrade/server
There is function set_upg_server_name(), provided ability to change the
parameter. Placed at <source>/user/upgrade/libupg/upg.c

Static ip - used in manual update, when no DNS resolving. Can be read from
/proc/upgrade/static_ip. Also, there is function set_static_ip() , provided
ability to change the parameter. Placed at <source>/user/upgrade/libupg/upg.c

FTP server name, username and password - those parameters for alternative
upgrade server. Placed at <source>/user/upgrade/libupg/upg.c

All API functions selected in one library, called libupg.a and declarations
placed at <source>/user/upgrade/libupg/upg.h
There is example application (<source>/user/upgrade/uman.c), which uses
most of API functions.

--- 7. How to UPGRADE                                                 {{{3

First, have to get 2 separate sources, one for upgrade system and other for
main system.
                How to build upgrade system.
`cd uClinux-dist'
`make xconfig'
choose 'Customize kernel settings' and 'Customize User settings'
then in kernel configuration menu choose 'Load configuration from file' and
write `.config-mdm-upg-720'.
in 'uclinux application configuration' also choose 'Load configuration from
file' and write `.config-upg'
Now save and close all menus.
`sh mklinks.sh'
make dep && make linux && make lib && make user

Now only 3 files needed (linux.out,kad.out,upg-jffs2.img) to be copied to
monitor, in order to burn them.

                How to build main system.
It is almost the same as upgrade system.
Have to load file in kernel configuration menu, called `.config-mdm-720' and
right after to choose 'System type' and after 'General setup', where change
BSL version from BSL-V3 to BSL-V4
In application menu, the file name is `.config-main'

                How to upgrade
There are 5 files from main system, which should be zipped by command:
`tar czf upgrade.tar.gz {linux.out.gz,kad.out.gz,root-jffs2.img,cfg-jffs2.img,logo.jpg}'
Pay attention that linux.out and kad.out already zipped by monitor utility and
logo.jpg also taken from monitor.
Have to place upgrade.tar.gz to TFTP or FTP server directory.

The card starts with upgrade system. Only factory settings exist are default
TFTP server name and default static ip.
In order to set other settings use application called uman. Run it `uman' to 
get help.

Finaly, doing upgrade itself:
`cd /var/upgrade'
`upgrade'
                                                      new big picture {{{4

 --------------------------> RESET/BOOT <-------------------------------------- 
|                            ----------                                        |
|                                |             y                               |
|                         < FU==1 ||  FUB==1 > ---------------> UPGRADE        |
|                                |n             ^                  |           |
|                                |              |           load UpgK + UpgFS  |
|                                |              |                  |           |
|                                |              |                  |           |
|                                |              |           y      |           |
|                       n        |              |         <-- < FUA==1 >       |
|      IPSTB <-- FUB=1 <--- < btn press >       |        |         |n          |
|  n     |        ^              |              |        |         |           |
 <-- <success>    |              |y             |        |      wait 10s       |
         |y       |              |              |        |  y      |        n  |
         |        |     /------------------\    |        |<-- < btn press > -  |
       FUB=0      |     |        |         |    |        |                   | |
         |        |    <5s      <20s      >20s  |        |                   | |
    working sys   |     |        |         |    |        |                   | |
                   -----       FU=1       FU=0  |       /                   /  |
                               FUA=0      FUA=1 |      /                   /   |
                                 |         |    |     /                   /    |
                                  --------------     /                   /     |
                                                    /                   /      |
                                                   /                   /       |
                                                  /                   /        |
                                                 /                   /         |
     MANUAL Upg <-------------------------------      AUTO Upg <----           |
        |                                               |                      |
        |                             n                 |        n3            |
    < FUA==1 > ---> [ get static IP ] --             < dhcp > --------------   |
        |n              ^   |y          |               |                   |  |
        |           n3  |   |           |               |y                  |  |
    < dhcp > -----------    |           |              /    n               |  |
        |y                  |           |     < STYPE==0 > --
        |          y        |           |        |y
        |<---------- <use non def ip>   | <use non def srvr>
        |                   |n          |        |                          |  |
        |           y       |      n    |        |                          |  |
        |<----------- <use def ip> ---->|        |             n3           |  |
        |        n3                     | < use non def srvr > --           |  |
    < run http > ---------------------->|        |               |       n3 |  |
        |                               |        |      < use def srvr > -->|  |
   / user interaction /                 |        |               |y         |  |
        |                               |        |<--------------           |->|
        |        n3                     |        |     n3                   |  |
    < download > ---------------------->|  < connect > -------------------->|  |
        |                n3             |        |y                         |  |
    < verify integrity > -------------->|        |     n3                   |  |
        |          n3                   | < download > -------------------->|  |
    < burn flash > -------------------->|        |             n3           |  |
        |            n3                 | < verify integrity > ------------>|  |
< update boot info > ------------------>|        |       n3                 |  |
        |                               | < burn flash > ------------------>|  |
 FUA=0,FU=0,FUB=0                       |        |             n3           |  |
        |                               | < update boot info > ------------>   |
        |                               |         |                            |
        |                               |   FU=0,FUA=0,FUB=0                   |
        |                               |         |                            |
        |                               |          --------------------------->|
        |                                --------- FU=1,FUA=0 ---------------->|
        |                                       and  3 secs blinking           |
        |                                                                      |
         --------------------------------------------------------------------->
                                                                              }}}4
--- 8. comments for QA                                                {{{3

    Auto upgrade testcases

1. upgrade w/ default TFTP server
1.a upgrade w/ default TFTP server w/o needed file
1.b upgrade w/ default TFTP server w/o running server
1.c upgrade w/ default TFTP server w/o such machine in the network
2. upgrade w/ volatile TFTP server
2.a upgrade w/ volatile TFTP server w/o needed file
2.b upgrade w/ volatile TFTP server w/o running server
2.c upgrade w/ volatile TFTP server w/o such machine in the network
3. upgrade w/ FTP server
3.a upgrade w/ FTP server w/o needed file
3.b upgrade w/ FTP server w/ wrong username
3.c upgrade w/ FTP server w/ wrong password
3.c upgrade w/ FTP server w/ wrong path

    Manual upgrade testcases

1. upgrade w/ volatile static ip
2. upgrade w/ volatile static ip - error in ip parameter
3. upgrade w/ default static ip
4. upgrade w/ IP from DNS
5. upgrade to unknown name
                                                                      }}}3 }}}2
                                                            the old big picture {{{2
                                                                                     
   --------------------------> RESET/BOOT <------------------------------------------------------------------------
  |                            ----------                                                                          |
  |                                |             y                                                                 |
  |                         < FU==1 ||  FUB==1 > ---------------> UPGRADE                                          |
  |                                |n             ^                  |                                             |
  |                                |              |           load UpgK + UpgFS                                    |
  |                                |              |                  |                                             |
  |                                |              |           y      |                                             |
  |                                |              |         --- < FUA==1 >                                         |
  |                       n        |              |        |         |n                                            |
  |      IPSTB <-- FUB=1 <--- < btn press >       |        |         |                                             |
  |  n     |        ^              |              |        |      wait 10s                                         |
   <-- <success>    |              |y             |        |  y      |        n                                    |
           |y       |              |              |         --- < btn press > -----------------                    |
           |        |     /------------------\    |        |                                   |                   |
         FUB=0      |     |        |         |    |        |                                   |                   |
           |        |    <5s      <20s      >20s  |    MANUAL Upg                            AUTO Upg              |
      working sys   |     |        |         |    |        |                                   |        n3         |
                     -----       FU=1       FU=0  |        |      y                n3   < set network > -------    |
                                 FUA=0      FUA=1 |  < FUA==1 > ---> < static IP > --       |       n3         |   |
                                   |         |    |      |n              ^   |y      |  < connect > -----------|   |
                                    --------------       |           n3  |   |       |      |        n3        |   |
                                                     < set network > ----    |       |  < download > ----------|   |
                                                         |y                  |       |      |                n3|-->|  FU=1,FUA=0 and
                                                         | <-----------------        |  < verify integrity > --|   |  3 secs blinking
                                                         |                           |      |          n3      |   |
                                                         |        n3                 |  < burn flash > --------|   |
                                                     < run http > -------------------|      |                n3|   |
                                                         |                           |  < update boot info > --    |
                                                    / user interaction /             |      |                      |
                                                         |        n3                 |    FU=0                     |
                                                     < download > -------------------|      |                      |
                                                         |                n3         |       --------------------->|
                                                     < verify integrity > -----------|                             |
                                                         |          n3               |                             |
                                                     < burn flash > -----------------|-------- FU=1,FUA=0 -------->|
                                                         |            n3             |    and 3 secs blinking      |
                                                 < update boot info > ---------------                              |
                                                         |                                                         |
                                                  FUA=0,FU=0,FUB=0                                                 |
                                                         |                                                         |
                                                          -------------------------------------------------------->
                                                                        }}}2
--- 6. BSP level                                                             {{{2

This level will keep changes describe information about flash and EEPROM. It is
also brings API to read and write, in some cases, that info.
--- boot_prop_t
Information, which needed by bootloader to load upgrade system kept in 
boot_prop_t, from include/bsl_queries.h, shortly desribed as 
address of upgrade info structure (see below) in flash
address, where non-upg system starts in flash
address and size of upg kernel,kad,fs,bootloader
dsp, sdram clocks
cache size
video format
static IP and TFTP server FQDN.
--- upg_prop_t
Information about non-upg system, needed to operate it, will be kept in specialy
allocated flash block, described by newly defined type upg_prop_t):
    Uint32 krnl_adr;    /* kernel address */
    Uint32 krnl_sz;     /* kernel size */
    Uint32 kad_adr;     /* kad address */
        Uint32 kad_sz;      /* kad size */
    Uint32 rootfs_adr;  /* root filesystem address */
    Uint32 rootfs_sz;   /* root filesystem size */
    Uint32 altfs_adr;   /* alt filesystem address */
    Uint32 altfs_sz;    /* alt filesystem size */
    Uint32 logo_adr;    /* logo image address */
    Uint32 logo_sz;     /* logo image size */
Also 2 new functions to be able read and write this data from flash.
--- hw_mng_info_t
There are number of flags needed for upgrade flow that will be kept in EEPROM
and described by new field in type hw_mng_info_t (include/bsl_queries.h)
Also 2 new functions to read and write this data byte, called upgrade_flags.
                                                                      }}}2
--- 7. Kernel/KAD level                                               {{{2
The same kernel/kad source will be used for both upgrade and main system, so
new macro which defines upgrade will be created (CONFIG_ARCH6X_UPGOS).
- Modified
linux-2.4.x/kad/dm642/
linux-2.4.x/kad/include/bsl/bsl_queries.h
linux-2.4.x/arch/tms320c6/config.in

Add eeprom device...
- New
linux-2.4.x/kad/include/bsl/bsl_eeprom.h
}}}2
FAQ {{{2
1. to define upg kernel ? {{{3
                       A         B    +     C         +     D         +      E        +      F
                    current   w/o snd   w/o fat,ftpfs   w/o video         w/o usb,       w/o ppp
                                        nfs,smbfs       input (fix 001)   scsi
                    -------   -------   -------------   ---------------   ------------   ----------
    (own weight)     0        46(33)    541(0)          429(152)          335(0)         69(0)
   MiniOS kernel    3401K     3355K     2814K           2385K (1170K)     2050K (991K)   1981K (949K)
          kad       490K      457K      457K            305K (132K)       305K (132K)    305K (132K)

Kernel size
        SDRAM heap              64MB
        MTD                                             y
        SCSI (needed for USB)   no
        Video                                   no
        Sound                                   no
        Block devs              y
        fs                      w/o FAT,VFAT,smbfs,ftpfs,ntfs
        input core              no
        USB                                             no
        IEEE 1394               no
    Network devs            w/o ppp

a. Check if it can run w/o procfs and devfs.
b. Make root fs cramfs or RO.

}}}3
2. to define upgFS ? {{{3
                                a      +        b         +     c
                              w/o smb,   w/o lirc,wget
                              top,ppp    ftp,adsl,netstat
          fs-jffs2  5034K     3067K      1437K
          cramfs    4660K     2831K      1315K
apps sizes: {{{4
busybox-1.0    1789K
busybox-1.0           bunzip2,cat,cmp,gunzip,
wget            498K
telnetd         152K
top             331K
smb (x3)       2974K
ppp (x8)       1573K
ftp (x2)        507K
inetd           161K
netstat         304K
expand           83K
lirc           1947K
init            213K x
dhcpcd          270k x
boa             514K x
tftp            167K x (fix patch_002)

busybox-1.0: cat,chmod,gunzip,hostname,ifconfig,ln,md5sum,mount,route,tar,tftp
        temp: df,ls,sh
                                SIZE = 716K
dhcpcd = 270K
expand =  83K
boa =    514K
                                - 1.5M -
}}}4
}}}3
3. Force Upgrade flags ! {{{3
Could be placed at flash, but...
minimum 128K block size in flash. can be incorporate w/ factory settings and
monitor info. The alternative place is EEPROM.

15nov2005 after meeting w/ Baruch
Minimize Monitor info and Boot info, so all data could be placed in EEPROM.
Part of info (unchanged) would go to bootloader itself.

prepare_comm_area() from linux-2.4.x/kad/kernel/comm_area.c
|->...
|-> bsl_getMACaddress() from bsl/native/src/bsl_queries.c
|   |-> bsl_eeprom_getProp() from bsl/native/src/bsl_eeprom.c
|   |-> bsl_eeprom_read() 

}}}3
4. define Factory settings ! {{{3
Currently only ip address and FQDN for TFTP server.
}}}3
5. create 32M ramfs image ! {{{3

can be used only w/ extgernal heap <80MB
tar -v -t -f obj.tar.gz
}}}3
Upgrade application {{{

--- Questions ---
1. How to do reset ?
        standart 
2. How to do blinking ?
3. TFTP connection
        To put file: `tftp -p 192.168.2.45 -l ./abc'
        To get file: `tftp -g 192.168.2.45 -r ping.c'
4. Integrity
        Provided by tar/gunzip
5. Validation
6. Burn file on flash
        Current monitor have DSP/BIOS application which use BSL lib also.

--- Checklist ---
+0.  Check if reset button pressed

+1.  Check if has IP and DNS resolving

2 . Read static IP from flash

3.  Setup IP

4.  Read TFTP server name from flash

5.  Get file by tftp

6.  Check integrity

7.  Unzip file

8.  Burn file on flash
        In case of N files, where some are just binaries (kernel, kad) and others
        filesystems - should be able to dynamicaly create/del mtdblock/mtdchar
        devices and change there addresses/sizes.

-9.  Update boot info on flash
        create mtdchar device for info region. define upg_info structure and write
        there at application level.

10. Write/Read on eeprom

11. Reset system

+12. Blinking 
        user/dhcpcd-new/client.c - example of use
        linux-2.4.x/drivers/char/ledman.c - the led driver

}}}
2a. change of compression tool to bzip2 ? {{{
    May safe 300K for linux.out
    There is a problem to use other zip, cause not always works (Belfer).
    I did bzip2 convertion for dm642
}}}
}}}2

    |    Non upgradable part        |           Upgradable  part   |

     ---------------------------------------------------------------
    | Boot   | Upg    | Upg | Upg   ||        | Root | Alt  | Logo  |
    | Loader | Kernel |  FS |  Info || Kernel |  FS  |  FS  | image |
    |        |       |      |       ||        |      |      |       |
     ---------------------------------------------------------------
     ---------------------------------------------------------------
    |                       |                  mtd4                 | upg system
    |                                                               | 
    |                       |  mtd2  |        | mtd0 | mtd4 |       | main system
     ---------------------------------------------------------------

Next {{{3
*. static ip parsing in upgrade app
*. add new option - upgarde w/ default factory settings

The new scenario brought to sight, because of availability to change factory
settings (static ip and upg server). In this case the default value, kept in
read-only area from monitor time, should be differ from volatile one.
When property needed, the upgrade app will get 2 values (default and volatile)
and tries to use volatile one. In case of fail, the app will use default
and copy it's value to volatile in case of success.
The actual place of volatile properties is upgrade info block on flash. This
requests new app/func to be able to write on this block (see project:
explicitly reset factory settings to default).
The default values would be burned, by monitor utility, together w/ bootloader.
Both systems (upgrade and main) would be able to read/write those params (write
only in case of volatile). The volatile parameters could change values in 
follows cases:
- run utility for coping new values from default to volatile explicitly.
- the upgrade app can't use current values of volatile params and successfuly
  uses default ones.
- ...

*. Explicitly reset factory settings to default.
The utility read whole upgrade info data, change values of volatile parameters
from defaults and write it back to the flash.

*. add new upgrade server - FTP
    The FTP server added as secondary upgrade server. This is option that can
be choosen by user. This feature add 3 more parameters: server name, username
and password. All of them keep in upgrade info block. New flag also added,
which server to use TFTP or FTP.

*. build kernel as PRODUCTION

5. hostname resolving
<from Or> - it is part of WINS algorithm, which implemented in samba server,
nmbd. He would look, if it works now.

6. index.cgi not used with Mozilla

7. Add IP and FQDN validation in upg app

8. stop calling ifconfig in upg app

9. Add CRC for upg info data ???
    In case of power failure at uinfo write time, it gives to bootloader option
to to upgrade again. But in this case upg app will not setdown FU/FUA, so
bootloader will upgrade anyway.


}}}3
Fixes {{{2
x fix001
x fix002 - enable tftp client.
x fix003 - create ramfs 32MB image file.
x fix004 - make build DDK optional
x fix005 - added: to clean romfs/image, to choose which image to create, new
         image for upgrade system, new rc file for upgrade system.
x fix006 - new mtdchar for upgrade info, support upgrade kernel, support for
           old style BSP, proc entries for static ip
x fix007 - proc entries for tftp servername
x fix008 - eeprom|uflags device
x fix009 - main kernel shutdown FUB flag, fix for /proc/upg_flags, new config
         files for kernel and apps
x fix009b- fix .config-mdm-main-720 and upg app changes.
x fix010 - fix static_ip form, fix upg flags to hex
x fix011 - move all upgrade files to /proc/upgrade, add default and volatile
         values, change rc files.
x fix012 - enable lock for uinfo dev, fix for upgrade, flashtool, uman
        linux-2.4.x/drivers/mtd/devices/mtd_bslv4.c     -   kernel-build-134
        user/upgrade/upgrade.c                          -   user-45
        user/upgrade/uman.c
        user/upgrade/libupg/upg.c
        user/upgrade/libupg/upg.h
        user/upgrade/Makefile
        user/mtd-utils/flashtool.c
        vendors/TI/TMS320C6/rc_upg
x fix013 - add FTP as upgrade server
+ config/.config-upg
+ config/.config-main
+ linux-2.4.x/kad/include/bsl/bsl_queries_upg.h
+ linux-2.4.x/fs/proc/proc_misc.c
+ user/upgrade/Makefile
+ user/upgrade/uman.c
+ user/upgrade/upgrade.c
+ user/upgrade/libupg/upg.c
+ user/upgrade/libupg/upg.h
+ vendors/TI/TMS320C6/Makefile
+ vendors/TI/TMS320C6/rc_upg 
+ vendors/TI/TMS320C6/rc_bslv4

}}}2
}}}1
041 - add ftp path to FTP upgrade server {{{1
    15jan2006

Add ftp path, so upgrade files could be placed in different directories of ftp
server. The path itself, placed in uinfo and could be changed by management
application.

1. Add new field in bsl_queries_upg.h called `char ftp_path[256]'
2. Change upg.c uman.c upgrade.c 

Get file from ftp from root:
echo "default login ftp password softier" > ~/.netrc
echo "mget <file>" | ftp -pi 192.168.2.45

Get file from certain dir:
echo -e "default login ftp password softier\\nmacdef getit\\ncd /pub\\nbin\\nmget <file>\\nquit\\n\\n" > ~/.netrc
echo "\$ getit" | ftp -pi 192.168.2.45

}}}1
042 - upgrade fixes - user-50 {{{1
    30jan2006
fix read volatile static ip before default static ip
fix read of static ip from new card more accurate
change default upgrade server to FTP instead TFTP
change altfs to be at the end of flash area, even w/ root-cramfs
lots of API changes
change ustart to do vfork at 1st
changes of factory settings flow {{{
in case of button push for >20sec, follows happened
both def values (tftp and ip) copy to volatile values
and all other volatile value deleted (all ftp settings).
after that system goes to regular upgrade, which waits for 2nd button press.
}}}

                                                      new big picture {{{
 --------------------------> RESET/BOOT <-------------------------------------- 
|                            ----------                                        |
|                                |             y                               |
|                         < FU==1 ||  FUB==1 > ---------------> UPGRADE        |
|                                |n             ^                  |           |
|                                |              |           load UpgK + UpgFS  |
|                                |              |                  |           |
|                                |              |                  |           |
|                                |              |           y      |           |
|                       n        |              |       <---- < FUA==1 >       |
|      IPSTB <-- FUB=1 <--- < btn press >       |      |           |n          |
|  n     |        ^              |              | copy factory     |           |
 <-- <success>    |              |y             | settings to      |           |
         |y       |              |              | volatile and     |           |
         |        |     /------------------\    | delete others    |           |
       FUB=0      |     |        |         |    |      |           |           |
         |        |    <5s      <20s      >20s  |      |           |           |
    working sys   |     |        |         |    |       ---------->|           |
                   -----       FU=1       FU=0  |                  |           |
                               FUA=0      FUA=1 |                  |           |
                                 |         |    |               wait 10s       |
                                  --------------         y        |      n     |
                                                       --- < btn press > ---   |
                                                      |                     |  |
                                                     /                     /   |
                                                   /                     /     |
                                                  /                    /       |
     MANUAL Upg <--------------------------------     AUTO Upg <------         |
        |                                               |                      |
        |    n3                       n                 |        n3            |
    < dhcp > -----> [ get static IP ] --             < dhcp > --------------   |
        |y                  |y          |               |                   |  |
        |                   |           |               |y                  |  |
        |                   |           |              /    n               |  |
        |                   |           |     < STYPE==0 > --
        |          y        |           |        |y
        |<---------- <use non def ip>   | <use non def srvr>
        |                   |n          |        |                          |  |
        |           y       |      n    |        |                          |  |
        |<----------- <use def ip> ---->|        |             n3           |  |
        |        n3                     | < use non def srvr > --           |  |
    < run http > ---------------------->|        |               |       n3 |  |
        |                               |        |      < use def srvr > -->|  |
   / user interaction /                 |        |               |y         |  |
        |                               |        |<--------------           |->|
        |        n3                     |        |     n3                   |  |
    < download > ---------------------->|  < connect > -------------------->|  |
        |                n3             |        |y                         |  |
    < verify integrity > -------------->|        |     n3                   |  |
        |          n3                   | < download > -------------------->|  |
    < burn flash > -------------------->|        |             n3           |  |
        |            n3                 | < verify integrity > ------------>|  |
< update boot info > ------------------>|        |       n3                 |  |
        |                               | < burn flash > ------------------>|  |
 FUA=0,FU=0,FUB=0                       |        |             n3           |  |
        |                               | < update boot info > ------------>   |
        |                               |         |                            |
        |                               |   FU=0,FUA=0,FUB=0                   |
        |                               |         |                            |
        |                               |          --------------------------->|
        |                                --------- FU=1,FUA=0 ---------------->|
        |                                       and  3 secs blinking           |
        |                                                                      |
         --------------------------------------------------------------------->
}}}
User big picture                                                            {{{
                                                     upgrade
 --------------------------> SYSTEM BOOT <----- + 3 sec blibking --------------
|                            -----------                                       |
|                                |      y                                      |
|                           < UPGRADE > ---------------> load Upg system       |
|                                |n             ^               |              |
|                                |              |    y          |              |
|                                |              |   -- < Factory Settings >    |
|                                |              |  |            |n             |
|                         n      |              | copy FS to    |              |
|      IPSTB <------------- < btn press >       | volatile and  |              |
|                 ^              |              | delete others |              |
|                 |              |y             |  |            |              |
|                 |              |              |   ----------->|              |
|                 |      ------------------     |               |              |
|                 |     |        |         |    |          wait 10 sec         |
|                 |    <5s      <20s      >20s  |               |              |
|                 |     |        |         |    |               |              |
|                  -----      upgrade  factory  |      y        |      n       |
|                                |     settings |    --- < btn press > ---     |
|                                |         |    |   |                     |    |
|                                 --------------    |                     |    |
|                                                  /                      |    |
|    MANUAL Upg <---------------------------------    AUTO Upg <----------     |
|       |                                               |                      |
|       |    n3                                         |        n3            |
|   < dhcp > -----> <use volatile ip>             < dhcp > ------------------->|
|       |y            y|    |n                     /y                          |
|       |              |    |                     /                            |
|       |<-------------     |                    /    n                        |
|       |                   |             < use ftp > ---------                |
|       |            y      |      n           |y              |               |
|       |<---------- <use FC ip> -->           |      <use volatile tftp>      |
|       |                           |          |         y|    |n              |
|       |                           |          |          |    |               |
|       |        n3                 |          |<---------     |               |
|   < run http > ------------------>|          |               |       n       |
|       |                           |          |       < use FC tftp > ------->|
|  / user interaction /             |          |               |y              |
|       |                           |          |<--------------                |
|       |                           |          |     n3                        |
|       |                           |    < connect > ------------------------->|
|       |                           |          |y                              |
|        -------------------------->|<---------                                |
|                                   |                                          |
|                                   |     n3                                   |
|                            < download > ------------------------------------>|
|                                   |y                                         |
|                                   |          n3                              |
|                         < verify integrity > ------------------------------->|
|                                   |y                                         |
|                                   |                                          |
|                                   |        n3                                |
|                             < burn flash > --------------------------------->|
|                                   |y                                         |
|                                   |                                          |
|                                   |          n3                              |
|                         < update boot info > -------------------------------> 
|                                   |y
|                                   |
|                               delete flags
|                                   |
|                                   |
 -----------------------------------
                                                                              }}}
}}}1
043 - changes in upgrade flow (user-52) {{{

1. No fallback w/ FS server name. If FTP failed and TFTP failed, not try FS TFTP
2. Change TFTP FS to FTP FS

}}}
044 - minimize busybox (user-53) {{{
current size of busybox for upgrade system is 1371KB.
Need follows for runtime:
basename,cat,chgrp,chmod,cmp,echo,expr,gzip,gunzip,hostname,ifconfig,ln,mkdir,
mount,route,rm,sed,shell,msh,tar,test,touch,tftp,umount,uname,wget,
Need follows for debug:
cp,dd,env,ls,mv,ping,ps,rmdir,msh tab completion

The busybox size w/ debug applets is 882KB and w/o debug is 784KB

config/.config-upg
        user/upgrade/upgrade.c  - netrc permissions bug fix
}}}
045 - release w/ lots of changes (140-30-45-54) {{{1

Bootloader - upgrade changes (k140) {{{
Theory {{{

                --- Adding upgrade counter ---

    To catch situation, when main system failed to boot, because of power drop.
There will be counter, decremented by 1 before boot main load. If boot 
successfull, counter put back to some max number, otherwise boot again. This 
way counter will be decremented to 0, so in that case bootloader will load
upgrade system.

                          bootloader
                              |
                           btn check
                              |
                        -------------
                       |      |      |
                      <5s   <20s   >20s
                       |
                  n    |  y
                 -- if FU -------
                |                |
            n   |   y            |
     ------- if FUB ------       |
    |                     |      |
    |                n    |   y  |
    | <--------------- cnt==0 ---
  set FUB                        |
    |                            |
  dec cnt                        |
    |                            |
   main                         upg
  system                       system
    |                            |
  reset cnt                   reset cnt

The main and upgrade systems would set counter back to max value (3).

                --- Check push button before upgrade flags ---

Now the bootloader will check button press before upgrade flags checking. It will fix
situation, when user doing poweroff in the middle of upgrade and push button, which
brings to manual upgrade.

                --- Check push button for more than 60 sec ---

Bootloader will check push button if it pressed > 60 sec and load main system in
that case.

}}}
Changes {{{
New bsl 4.11 brings follows files to <linux>/kad/dm642/ :
    ec628_bsl_v4.lib
    mdm3_hdbsl_v4.lib
    mdm3_sdbsl_v4.lib
    mdm_bsl_v4.lib
    media_adapter_bsl_v4.lib
    pci_per_bsl_v4.lib
and header files to <linux>/kad/include/bsl/ :
    bsl_serial.h
    bsl_queries.h -> bsl_queries_v4.h w/ little changes
    bsl_eeprom.h
Files w/ upgrade counter:
    <linux>/kad/kernel/system.c
    <linux>/include/cmdapi.c
    <linux>/fs/proc/proc_misc.c

vendors/TI/TMS320C6/rc_bslv4
vendors/TI/TMS320C6/rc_upg
}}}
}}}
autorun DOK on main system (user-54) {{{2
    Ability to autorun script from DOK at main system startup.
In /etc/rc check if DOK could be mounted and script (scroll.sh) exists - run 
it in background and exit right away.
Changed|new files:
vendors/TI/TMS320C6/product.sh
vendors/TI/TMS320C6/Makefile
vendors/TI/TMS320C6/rc_bslv4
}}}2
Add telnet (user-54,infra-30) {{{2
Both systems automatic run inetd to have telnet access.
vendors/TI/TMS320C6/rc_bslv4
vendors/TI/TMS320C6/rc_upg
config/.config-upg
}}}2
Fix problem w/ DHCP client (user-54) {{{2
Can't get ip from some servers. Fixed by canceling `-D' option, so run it
`dhcpcd -B -o -t 30 &'

user/upgrade/upgrade.c
}}}2
Fix bug in manual upgrade (user-54) {{{2
Do not run boa in background mode from system()
user/upgrade/upgrade.c
}}}2
Upgrade logging system (user-54,infra-30) {{{2
Ability to write upgrade log file, placed at DOK, if available.

Add USB,SCSI and vfat support for upgrade kernel.
        w/USB       w/o USB     w/USB+vfat
kernel  2370(1140)  2037(961)   2444(1180)
kad - same

changed files:
linux-2.4.x/.config-wave300-upg

Theory {{{3
Log sessions started by magic counter, where each record could length from 1K
to 4K maximum.
All messages collected in buffer, which can be written to flash at 3 stages:
- upgrade finished successful
- error occured
- special point in upgrade flow reached (FTP connect, TFTP connect, HTTP started)

START
|-vfork()
|-chdir()
|-signal()
|_read_upgflags()
  |->open()
  |_>read()
R2FS                        {{{
|-init_uinfo()
| |->open()
| |_>ioctl()
|-reset_fac_settings()
| |_>set_fac_settings()
|    |_>write_udata()
|       |->read_udata()
|       |  |-> lseek()
|       |  |_> read()
|       |_>burn_udata()
|          |-> malloc()
|          |-> read_uinfo()
|          |_> burn_uinfo_block()
|              |->ioctl()
|              |->ioctl()
|              |->ioctl()
|              |->lseek()
|              |->write()
|              |->sys_config()
|              |_>ioctl()
|_write_upgflags()
  |-> open()
  |_> write()               }}}
BTN                         {{{
|_clone()
  |_> checkBUTTON()
      |-> open()
      |_> read()            }}}
DNS                         {{{
|-system()
|_clone()
  |_> checkDNS()
      |_> gethostbyname()   }}}
FTP                        {{{
|_download_ftp()
  |->init_uinfo()
  |  |->open()
  |  |_>ioctl()
  |->get_all_params()
  |  |_> read_udata()
  |      |-> lseek()
  |      |_> read()
  |->open()
  |->write()
  |_>system()               }}}
TFTP                        {{{
|_download_tftp()
  |->get_tftp_server_name()
  |  |-> init_uinfo()
  |      |->open()
  |      |_>ioctl()
  |  |_> get_tftp_server()
  |_system()                }}}
HTTP                        {{{
    set static IP
    start boa               }}}
ARCH                        {{{
Open archive
    unzip
    untar                   }}}
FLSH                        {{{
    open device
    get device parameters
    is erasesize supported
    is altfs - jffs2 image
    unlocking
    erase all sectors
    is enough room for rootfs
    burn uinfo sector
    burn kad
    burn kernel
    burn log
    burn rootfs
    burn altfs
    locking
    verify stage            }}}
FIN                         {{{
    set upgrade flags
    reboot                  }}}
}}}3
}}}2

vendors/TI/TMS320C6/rc_bslv4
vendors/TI/TMS320C6/rc_upg
vendors/TI/TMS320C6/product.sh
vendors/TI/TMS320C6/Makefile
user/upgrade/upgrade.c
user/upgrade/uman.c
user/upgrade/Makefile
user/upgrade/libupg/Makefile
user/upgrade/libupg/log.[c|h]
user/upgrade/libupg/util.[c|h]
user/upgrade/libupg/upg.[c|h]
user/upgrade/libupg/upg_in.h
user/upgrade-cgi/index.cgi.c
vendors/TI/TMS320C6/index.html

config/.config-upg
linux-2.4.x/.config-wave300-upg

cvs rtag -R infra-30 uClinux-infra
cvs rtag -R user-54 uClinux-user

}}}1
046 - UPG> en/dis FTP/TFP; change `rm' to `unlink' (user-55) {{{1
x 1.  Enable/Disable TFTP/FTP - disable_tftp() doing nothing
x 2.  Change call to `rm' to use of unlink()
x 3.  Create set_ipaddr() instead of use ifconfig
x 4.  Show ip, when set DNS (based on set_ipaddr())
x 5.  Doing umount(), when main system find DOK w/ `scroll.sh'
x 6.  Don't call inetd in rc of main system
x 7.  reset to factory setting also set default upgrade source (FTP)

x   user/upgrade/libupg/upg.h
x   user/upgrade/upgrade.c
x   user/upgrade/uman.c
x   user/upgrade/libupg/util.c
x   user/upgrade/libupg/util.h
x   user/upgrade/libupg/log.c
x   vendors/TI/TMS320C6/product.sh
x   vendors/TI/TMS320C6/rc_bslv4

cvs rtag -R user-55 uClinux-user

x 8. Cancel DNS check
x 9. Change upg counter from 3 to 16

x   user/upgrade/upgrade.c
x   vendors/TI/TMS320C6/rc_upg
x   vendors/TI/TMS320C6/rc_bslv4
}}}1
047 - released user-56 {{{

cvs rtag -R user-55 uClinux-user

1x  Add ability to cancel upgrade and call it from cgi button
2x  Fix, when cnt==0 and power off in upgrade - going to main system. - done in bootloader
3x  cancel `ifconfig' applet and more from upgrade system busybox (check w/ rc_upg)
4x  show ip address, when manual upgrade w/ dns
5x  change all upg proc numbers (flags,cntr) to hex - rc files
6x  cancel call to `killall'
7x  cgi to use upg logging system
8x  New log filename per card
9x  Add pid to logging

Changed files:
config/.config-upg
user/busybox-1.00/sysklogd/syslogd.c
user/upgrade/Makefile
user/upgrade/uman.c
user/upgrade/ustart.c
user/upgrade/libupg/Makefile
user/upgrade/libupg/log.c
user/upgrade/libupg/log.h
user/upgrade/libupg/upg.c
user/upgrade/libupg/upg.h
user/upgrade/libupg/util.c
user/upgrade-cgi/Makefile
user/upgrade-cgi/index.cgi.c
vendors/TI/TMS320C6/Makefile
vendors/TI/TMS320C6/boa.conf
vendors/TI/TMS320C6/rc_bslv4
vendors/TI/TMS320C6/rc_upg
}}}
048 - SPARC converter longlong fix - released 26mar2006 {{{

building
cvs co 
`cd ~'
`mkdir gcc2c-build'
`cd gcc2c-build'
`export CC=gcc32'
`/home/gxk/prjs/gcc-3_2-gcc2c/configure --prefix=/home/gxk/gcc2c --enable-languages=c,gcov --with-as=/usr/bin/gcc32 --with-ld=/usr/bin/gcc32 --with-gnu-as=/usr/bin/gcc32 --with-gnu-ld=/usr/bin/gcc32 --without-dwarf2 --without-stabs --disable-nls conv-ix86-linux
change in ~/prjs/gcc-3_2-gcc2c/gcc/c-parse.c +349 `malloc' to `xmalloc'
change in ~/prjs/gcc-3_2-gcc2c/gcc/tradcif.c +153 `malloc' to `xmalloc'
`make LANGUAGES="c gcov" '
`make LANGUAGES="c gcov" install'
`cd /home/gxk/gcc2c'
`cp ./lib/gcc-lib/conv-ix86-linux/3.2/include/varargs.h ./lib/gcc-lib/conv-ix86-linux/3.2/include/stdarg.h ./lib/gcc-lib/conv-ix86-linux/3.2/include/stdbool.h ./lib/gcc-lib/conv-ix86-linux/3.2/include/limits.h ./lib/gcc-lib/conv-ix86-linux/3.2/include/syslimits.h ./include'

Change `__gcc2c_long_long_type__' to become `long long' instead of `long'
in file <source>/gcc/config/conv-ix86/conv-ix86.c line 2681

Incorporated in tools from 26mar2006
}}}
049 - curl and create uClinux-apps (apps-1) {{{
    27mar2006
download package curl-7.15.3, untar. Create lib/Makerfile.tms320c6,
src/Makefile.tms320c6 and lib/config.h
Both Makfiles taken from Makefile.m32 and config file from native
linux package (after run configure) w/ little changes. Most of them
SSL cancelation.
Import to cvs:
    cvs import -m "init" uClinux-dist/apps/curl-7.15.3 gxk apps-1

Create new alias module called uClinux-apps w/ sticky tag apps-1, where
    apps/curl, apps/lirc-0.6.6, apps/textutils, apps/tiprof

Changed files:
apps/Makefile
config/config.in
}}}
050 - Merge LFS support {{{
    produced 142 32 46 58
cvs rtag -R kernel-build-142 uClinux-kernel
cvs rtag -R infra-32 uClinux-infra
cvs rtag -R libs-46 uClinux-libs
cvs rtag -R user-58 uClinux-user
}}}
051 - Bug fixes - 949,954,1010,1030,1032 {{{
# 1010
when no DHCP enabled, system not going to manual upgrade. problem, because
alarm for button no canceled (in case of push button), so till DHCP tries 3
times, comming SIGALRM and seting button to `-1'
solution: call alarm(0), when button found pressed.
# 1030
if upg flags 00, it's become 80. Bug in /etc/rc main system
solution: fix vendors/TI/TMS320C6/rc_bsl4
# 954
if any file missing in upgrade tarball, no retry w/ TFTP fallback.
solution: retry added.
# 949
http download failed, if it takes> 2sec
solution: upgrade process checks if upgrade tarball exists and >0, which
happend in the middle of http download. need more stable way to aware
upgrade process, that http download is done.
solution: added check for specific file, created when download finished.
# 1032
No message when push cancel button in manual upgarde. System doing reset
quicker, than boa returns answer.
solution: add sleep for is_cancel(), enough time to boa to return message

# Change size of config filesystem to 2MB.

# Upgrade from USB DOK.
    During upgrade process, when auto scenario begins, the system will try to
    mount USB DOK and find there upgrade tarball. In case of success, this will
    be the source for auto upgrade scenario, otherwise regular auto upgrade
    flow. In case of failure, 3 times attempt and reboot.

vendors/TI/TMS320C6/rc_bsl4
user/upgrade/ustart.c
user/upgrade/libupg/upg.c
user/upgrade/libupg/util.c
user/upgrade/libupg/util.h
user/upgrad-cgi/index.cgi.c
vendors/TI/TMS320C6/Makefile
user/upgrade/libupg/log.c
user/upgrade/libupg/log.h

cvs rtag -R user-59 uClinux-user
}}}
052 - libssl porting {{{
    27apr2006
Porting whole openssl (0.9.8a) project w/ apps, tools, tests and installation
(to /opt/tms320c6/ssl)

Depend canceled, cause deletes Makefiles. Make install works, if called from
libssl directory.

The most of tests not working and ssltest also.
Porting done w/o converter, so may be switch it on will fix situation.
Given to Oleg 30apr2006

All changes made in Makefiles and doc directory, added to libs46.

cd uClinux-dist/lib/libssl/doc/apps
cvs commit -m "fix" uClinux-dist/lib/libssl/doc/apps gxk libs-46

    25may2006
Change Makefile.org Makefile.shared  apps/Makefile and test/Makefile

Add new architecture to  Configure 
"linux-tms320c6","tms320c6-coff-gcc:\$(CFLAGS)::-D_REENTRANT:::SIXTY_FOUR_BIT BN_LLONG DES_INT:${no_asm}:::::    ",

Configure --prefix=/ssl --install_prefix=/opt/tms320c6 --openssldir=/ssl no-shared no-hw no-asm no-dso no-krb5 no-zlib no-zlib-dynamic no-sse2 linux-tms320c6
}}}
053 - (user-60) Release upgrade2, config size for altfs{{{
    22may2006
* user/upgrade2 user/upgrade2/libupg user/upgrade2/cgi
* config/.config-main
* config/.config-upg
* config/.config-upg-dbg
* config/config.in
* vendors/TI/TMS320C6/Makefile
* user/busybox-1.00/networking/tftp.c
* user/Makefile

}}}
054 - (user-61) add route & ifconfig to upg2 {{{
    28may2006
    #    - when configured upg2, still build index.cgi from upg1
    #1072- upg app too quick and can't catch pluged-in DOK. (fixed u-61)
    #    - cancel in manual upg, reboots to the main system (fixed u-61)
    #    - pushing cancel upgrade button (in manual upgrade) does reboot, but
           browser left in wait for answer. (fixed u-61)
cvs rtag -R user-61 uClinux-user
cvs rtag -R infra-34 uClinux-infra
}}}
055 - (libs-47 'n' infra-35) DNS resolving {{{
cvs rtag -R infra-35 uClinux-infra
cvs rtag -R libs-47 uClinux-libs
}}}
056 - (user-63) full upgrade for wave300 {{{
    21jun2006
Purpose to do full upgrade (for both upgrade and main systems), when
application runs from DOK device.

Prepare the package.
Copy follows files to DOK:
    fupg - upgrade application
    program_flash.cfg - config file
    mdm3_hd_wave_300.bin - full image

Run it.
Run the system (wave300) and plugin DOK. Connect to the system
by telnet and get prompt. Now run follows:
`mount /dev/sda1 /mnt' - mount DOK
`cd /mnt' - change directory 
`./fupg' - run upgrade application
From now the upgrade application will run till the end.
Important! There is not enough memory to run for upgrade application,
so kill all players and browsers before you run upgarde.

Changed files under `user/upgrade2/':
Makefile
libbsl/bsl_flash.c
libbsl/bsl_flash_def.h
libbsl/bsl_onboard_flash_params.h
libbsl/Makefile
libbsl/mdm3_cpld.c
libbsl/mdm3_cpld.h
libbsl/MT28FxxxJ3_x8.c
fupg/Makefile
fupg/fupg.c
fupg/burn_mng.c
fupg/burn_mng.h

cvs rtag -R user-63 uClinux-user

fixed bug for wave300 boards, where write to flash switch by GPIO pin 8 and not
by CPLD.
changed libbsl/bsl_flash.c

cvs rtag -R user-65 uClinux-user
}}}
PPPOE release {{{
    25jul2006
1x make PPPOE tools build with UPG system
2? Check filesystem image size (bl+k+fs <= 3MB)
    Left for main system 12MB+768KB
3. add pppoe params to upg data and connectivity option flag
 ax bootloader
 bx application API
    pppoe params definitions:
        user 3 - 128
        pass 3 - 128
        mtu 1 - 5 
 cx upgrade app flow
4. Add pppoe to upgrade app

25jul2006 status
Done everything except connect itself. Have to change upgrade flow to connect
through pppoe and minimize pppoe package (>600KB).
changed files:
user/upgrade2/uman.c
user/upgrade2/libupg/upg.c
user/upgrade2/libupg/upg.h
user/upgrade2/libupg/upg_in.h
vendors/TI/TMS320C6/devfile_upg.txt

Connect w/ PPPOE from Oleg {{{
MediaLinux uses pppd version 2.4.3 and rp-pppoe version 3.5.

    MediaLinux supports PPPOE using pre_pppoe (a softier developed utility) ONLY.
    pre_pppoe does the following:
        - opens a pseudo terminal
        - duplicates its file descriptor into standard input and standard output
        - starts pppoe program

    After starting pppoe process, pppd should be invoked with pty device name (created by p    re_pppoe) as the first parameter.

    pppd invocation according to the PPPOE man page is _NOT_ supported.

    The following scripts converted for Media Linux: adsl-setup, adsl-status, adsl-start, a    dsl-connect, adsl-stop.
    No changes were done to pppd and rp-pppoe application sources.

    To create a pppoe connection:

    1. Reboot the card.
    2. Connect the card with a network cable to ADSL modem.
    3. Open eth0 interface, but don't set IP address: "ifconfig eth0 up"
    4. Make your filesystem writable: "mount -o remount,rw -t jffs2 rootfs /"
    5. Create ppp interface: "mknod /dev/ppp c 108 0"
    6. Run "adsl-setup" script and supply all needed information.
    7. Run "adsl-start &"
    8. Run "adsl-status" in order to obtain the current connection status.
    9. To stop ppp connection run adsl-stop.
}}}
}}}

malloc {{{1
        30may2005

Current (30may2005) malloc algo:
malloc_from_heap() (from uClibc/libc/stdlib/malloc/malloc.c)
Add header (MALLOC_HEADER_SIZE = sizeof double) to original size.
  __heap_alloc() (from uClibc/libc/stdlib/malloc/heap_alloc.c)
  If succed
  If not succed, check if size > MALLOC_HEAP_EXTEND_SIZE, so do
`MALLOC_ROUND_UP_TO_PAGE_SIZE' - round size to a multiple MALLOC_PAGE_SIZE.
Now allocate by mmap().

__heap_alloc()
rounds size to be a multiple of HEAP_GRANULARITY (sizeof double). Make sure
size !< sizeof `struct heap_free_area'. Look for a free area that can contain
the size and call __heap_free_area_alloc() from
__heap_free_area_alloc() from uClibc/libc/stdlib/malloc/heap.h.

}}}1
Macromedia Flash (ANT plugin) performance {{{2

To build:
cd prjs
cvs co uClinux-dist/apps/ant
cd uClinux-dist/apps/ant/builds/ml-flash6-css-f-fb32

flash tests placed at ant/3rdparty/macromedia/FlashPlayer6SDK/ats/...
flash games URLs:
http://www.media.ebaumsworld.com/pacman.swf
http://www.media.ebaumsworld.com/duckhunt.swf
http://www.media.ebaumsworld.com/fireballs.swf

1. To build ant+flash w/o converter 3.1B +ll +wch
2. Add stripping


}}}2

Java {{{1

1. To run JEVM as described in doc. Be able to run tests and benchmarks.
   can run tests.
   can run benchmarks.  
2. to run MIDP demo
   can do.
3. To run benchmarks on Win32 and compare to benchmark doc.
   Win32 results half of document and ML results ~10% less.
4. Download java http browser for STB and try to run it.
   ? - can't install

Nokia S40 phones (MIDP 2.0,XHTML,128x128,12bit(4K colors))
Nokia S60 v2 phones (MIDP 2.0,XHTML,176x208,16bit)

email form 16apr2005 {{{2

Softier open issues:

1. which env they have or which env to send them
2. Needed ML libraries libc, libpthread, libdt and libm
3. Can other open source jvm could be build?

Questions to FADATA
1. Can it be build only on Nano-X (+ nxlib) (w/o GTK and Xlibs) ?
2. To build everything with static libraries.
3. Which projects involved ? (GTK, Xlib, Zlib, etc...)
}}}2

28apr2005 {{{2
It seems that GNU classpath depends on GTK and Xlibs. Another question if whole
system has good performance, even build with all libs.
So decided to build classpath and check performance with simple GUI app. Also
to compare with Sun's performace.

Build classpath-0.14:
untar
configure --prefix=/opt/x86/classpath
make
make install

Run examples:
export LD_LIBRARY_PATH=/opt/x86/classpath/lib/classpath
export CLASSPATH=/opt/x86/classpath/share/classpath/glibj.zip:.
pushd /opt/x86/classpath/share/classpath/examples/
unzip examples.zip
gcj -C gnu/classpath/examples/awt/Demo.java
gij gnu.classpath.examples.awt.Demo &
/usr/java/jdk1.5.0_02/bin/java gnu.classpath.examples.awt.Demo &

Build and run jamvm-1.3.0:
configure --prefix=/opt/x86/jamvm --with-classpath-install-dir=/opt/x86/classpath
make
make install

}}}2

Build javm {{{2

Configure options should be try:
--enable-int-threading
        enable threaded version of the interpreter (default enabled)
--enable-int-direct
        enable direct threaded version of the interpreter (default enabled)
--enable-int-caching
        enable stack-caching version of the interpreter
        (default powerpc,arm enabled : i386 disabled)
--enable-int-prefetch
        enable prefetching version of the interpreter
        (default powerpc enabled : i386,arm disabled)

Near 11 makefiles.

configure --prefix=/opt/x86/javm 
}}}2

}}}1
Timezone {{{1
        11may2005
Theory{{{3
from uClibc FAQ:
 The uClibc time functions get timezone information from the TZ environment variable, as described in the Single Unix Specification Version 3. See  http://www.opengroup.org/onlinepubs/007904975/basedefs/xbd_chap08.html  for details on valid settings of TZ. For some additional examples, read  http://www.uclibc.org/lists/uclibc/2002-August/004010.html in the uClibc mailing list archive. You can store the value of TZ in the file '/etc/TZ' and uClibc will then automagically use the specified setting.

from www.opengroup.org/onlinepubs/007904975/basedefs/xbd_chap08.html:
This variable shall represent timezone information. The contents of the environment variable named TZ shall be used by the ctime(), localtime(), strftime(), mktime(), ctime_r(), and localtime_r() functions, and by various utilities, to override the default timezone. The value of TZ has one of the two forms (spaces inserted for clarity):
        :characters
or
        std offset dst offset, rule
If TZ is of the first format (that is, if the first character is a colon), the characters following the colon are handled in an implementation-defined manner.
The expanded format (for all TZ s whose value does not have a colon as the first character) is as follows:
        stdoffset[dst[offset][,start[/time],end[/time]]]
where: {{{4
- std and dst -
        Indicate no less than three, nor more than {TZNAME_MAX}, bytes that are the designation for the standard ( std) or the alternative ( dst -such as Daylight Savings Time) timezone. Only std is required; if dst is missing, then the alternative time does not apply in this locale.
Each of these fields may occur in either of two formats quoted or unquoted:
  * In the quoted form, the first character shall be the less-than ( '<' ) 
        character and the last character shall be the greater-than ( '>' ) 
        character. All characters between these quoting characters shall be 
        alphanumeric characters from the portable character set in the current 
        locale, the plus-sign ( '+' ) character, or the minus-sign ( '-' ) 
        character. The std and dst fields in this case shall not include the 
        quoting characters.
  * In the unquoted form, all characters in these fields shall be alphabetic 
        characters from the portable character set in the current locale.
The interpretation of these fields is unspecified if either field is less than three bytes (except for the case when dst is missing), more than {TZNAME_MAX} bytes, or if they contain characters other than those specified.
- offset -
        Indicates the value added to the local time to arrive at Coordinated Universal Time. The offset has the form:
        hh[:mm[:ss]]
The minutes ( mm) and seconds ( ss) are optional. The hour ( hh) shall be required and may be a single digit. The offset following std shall be required. If no offset follows dst, the alternative time is assumed to be one hour ahead of standard time. One or more digits may be used; the value is always interpreted as a decimal number. The hour shall be between zero and 24, and the minutes (and seconds)-if present-between zero and 59. The result of using values outside of this range is unspecified. If preceded by a '-', the timezone shall be east of the Prime Meridian; otherwise, it shall be west (which may be indicated by an optional preceding '+' ).
-rule -
Indicates when to change to and back from the alternative time. The rule has 
the form:
        date[/time],date[/time]
where the first date describes when the change from standard to alternative 
time occurs and the second date describes when the change back happens. Each 
time field describes when, in current local time, the change to the other 
time is made. The format of date is one of the following:
        Jn - The Julian day n (1 <= n <= 365). Leap days shall not be counted. 
        That is, in all years-including leap years-February 28 is day 59 and March 
        1 is day 60. It is impossible to refer explicitly to the occasional 
        February 29.
        n - The zero-based Julian day (0 <= n <= 365). Leap days shall be counted,
        and it is possible to refer to February 29.
        Mm.n.d - The d'th day (0 <= d <= 6) of week n of month m of the year 
        (1 <= n <= 5, 1 <= m <= 12, where week 5 means "the last d day in month m" 
        which may occur in either the fourth or the fifth week). Week 1 is the 
        first week in which the d'th day occurs. Day zero is Sunday.
The time has the same format as offset except that no leading sign ('-' or '+')
is allowed. The default, if time is not given, shall be 02:00:00.
}}}4
}}}3
}}}1
STL {{{1
        04jul2005
Start project STLportForceInstantiations.pjt
Change paths for libs and includes. Remark call for lddk.h in follows:
src/c_locale.c
src/stlport_prefix.h
Add to BuildOptions-Diagnostic at `-pds=77'

Build procedure:
Rebuild on project STLportForceInstantiations.pjt
Inc build of project STLportLib.pjt

        01aug2005
The tests not running, but hello do.
}}}1
GPIO changes {{{1
        20sep2005

GPIO initialization happened in bsl_init() from arch/tms.../bsl/bsl_common.c
where used follow GPIO API funcs:
        GPIO_open
        GPIO_config
        GPIO_pinEnable
        GPIO_pinDirection
        GPIO_pinWrite
Already exist 4 Softier wraper funcs:
gpio_deltaHighClear for GPIO_deltaHighClear
gpio_deltaLowClear for GPIO_deltaLowClear
gpio_deltaHighGet for GPIO_deltaHighGet
gpio_deltaLowGet for GPIO_deltaLowGet

Create new file arch/tms.../bsl/gpio.c, where relevant stuff will be. Also
gpio.h which calls <device>/gpio_hw_defs.h
New file have gpio_init(), new wrappers 
        gpio_pinEnable()
        gpio_pinDirection()
        gpio_pinWrite()

Deleted from bsl_common.c {{{2

    /** Enable flash paging pins and set to page 0 by default */
    GPIO_pinEnable(GPIO_hGPIO, FLASH_PAGING_EXT );
    GPIO_pinDirection(GPIO_hGPIO, FLASH_PAGING_EXT, GPIO_OUTPUT);
    GPIO_pinWrite(GPIO_hGPIO, FLASH_PAGING_EXT, 0);

    /** Enable interrupt line */
    GPIO_pinEnable(GPIO_hGPIO, DM642_INT );
    GPIO_pinDirection(GPIO_hGPIO, DM642_INT, GPIO_INPUT);

    /** Enable PLL1708 lines */
    GPIO_pinEnable(GPIO_hGPIO, PLL1708_SDIN|PLL1708_SCLK|PLL1708_CS_ );
    GPIO_pinDirection(GPIO_hGPIO, PLL1708_SDIN|PLL1708_SCLK|PLL1708_CS_, GPIO_OUTPUT);
    GPIO_pinWrite(GPIO_hGPIO, PLL1708_CS_, 0xFFFF);
    GPIO_pinWrite(GPIO_hGPIO, PLL1708_SDIN|PLL1708_SCLK, 0);

    /** Enable USB Host controller DMA request lines*/
    GPIO_pinEnable(   GPIO_hGPIO,  USB_HC_DREQ|USB_DC_DREQ );
    GPIO_pinDirection(GPIO_hGPIO,  USB_HC_DREQ|USB_DC_DREQ, GPIO_INPUT);

    /** Configure and enable the IR data pin*/
    GPIO_pinEnable(   GPIO_hGPIO,  IR_DATA | GPIO_PIN0 );
    GPIO_pinDirection(GPIO_hGPIO,  IR_DATA | GPIO_PIN0, GPIO_INPUT);

}}}2

Changed and added files:
arch/tms320c6/bsl/bsl_common.c
arch/tms320c6/bsl/bsl_mod.c
arch/tms320c6/bsl/gpio.c
include/asm-tms320c6/io.h
arch/tms320c6/drivers/phcd/hal_dm642.c
arch/tms320c6/bsl/Makefile
arch/tms320c6/drivers/sound/bsl_apll.c
arch/tms320c6/bsl/ma/hw_defs.h
arch/tms320c6/drivers/lirc_media642.c

}}}1
new TI compiler wrapper {{{1
        05apr2005 01may2005 14jan2006

Common idea {{{2
The idea is to redesign of Softier's wrapper. Wrapper exists because of
differences between gcc and TI compiler options.
In addition, it should recognize converter (convert non-ANSI C to ANSI),
which used before preprocessor. There 2 converters already (02may2005).
It is needed to solve auto-tools problems also.

Technicaly most close implementation is gcc driver. The part of gcc which
already reading command line options and constructs calls to preproccesor\
compiler\assembler\linker.

Taken gcc version 4.0.0 as most current.
}}}2
from previous attempt gcc.c {{{2

static const char *cc1_options =
 "%{pg:%{fomit-frame-pointer:%e-pg and -fomit-frame-pointer are incompatible}}\
 -pden -pds97 -pds225 -pds552 -pds878 -pds880 -pds992 -pds179 -pds195\
 -pdr -mv6400 -eo.o -ea.s -el.s -es.lst -ml3\
 -d__SOFTIER_LONGLONG__=long -d__SOFTIER_LONG__=int -d__gnuc_va_list=va_list\
 %{c:%W{o*}%{!o*:-o %w}}%{!c:-o %w%b.o}";

static const struct compiler default_compilers[] =
{"@c",
             "%{E|M|MM:%(trad_capable_cpp) %(cpp_options) %(cpp_debug_options)}\
      %{!E:%{!M:%{!MM:\
        %{traditional|ftraditional:\
          %eGNU C no longer supports -traditional without -E}\
        %{save-temps|traditional-cpp|no-integrated-cpp:%(trad_capable_cpp) \
          %(cpp_options) -o %{save-temps:%b.i} %{!save-temps:%g.i} \n\
          cc1 -fpreprocessed %{save-temps:%b.i} %{!save-temps:%g.i} \
          %(cc1_options)}\
        %{!save-temps:%{!traditional-cpp:%{!no-integrated-cpp:\
          cc1 %(cpp_unique_options) %(cc1_options)} } }\
        } } }", 0},
...

}}}2
Build & install gcc core {{{2
version 3.4.3 {{{3
untar gcc-core-3.4.3.tar.bz2
cd gcc-3.4.3
configure --prefix=/opt/x86/wrapper --with-local-prefix=/opt/x86/wrapper --disable-nls --enable-languages=c --disable-shared
make BOOT_LDFLAGS="-static" bootstrap
make install
}}}3
gcc-4.0.0 {{{3
untar gcc-core-4.0.0.tar.bz2
cd gcc-4.0.0
mkdir softier
cd softier
../configure --prefix=/opt/x86/wrapper --with-local-prefix=/opt/x86/wrapper --disable-nls --enable-languages=c --disable-shared
make CFLAGS='-O' LIBCFLAGS='-g -O2' LIBCXXFLAGS='-g -O2 -fno-implicit-templates' BOOT_LDFLAGS='-static' bootstrap
make install
}}}3
gcc-4.0.2 {{{3
untar gcc-core-4.0.2.tar.bz2
cd gcc-4.0.0
mkdir softier
cd softier
../configure --prefix=/usr/local/tools/wrapper \
--with-local-prefix=/usr/local/tools/wrapper --disable-shared \
--enable-languages=c --disable-nls
make CFLAGS='-O' LIBCFLAGS='-g -O2' LIBCXXFLAGS='-g -O2 -fno-implicit-templates' BOOT_LDFLAGS='-static' bootstrap
make install
}}}3
Follows files installed (starts at /usr/local/tools/wrapper): {{{3
bin/
        cpp
        gcc
        gccbug
        gcov
    i686-pc-linux-gnu-gcc
    i686-pc-linux-gnu-gcc4.0.2
include/
    mf-runtime.h
info/
    6 info files
lib/
    gcc/i686-pc-linux-gnu/4.0.2/
        crt files
        libgcc.a
        libgcov.a
            (specs - not exist at 4.0.2)
        libiberty.a
    libmudflap.a
    libmudflapth.a
libexec/gcc/i686-pc-linux-gnu/4.0.2/
        cc1
        collect2
man/
    man1/
    man7/ ...
share/
}}}3
}}}2
TODO:
+ 1.  disable gcc call to as.
+ 2.  delete wine warnings about timezone
`export WINEDEBUG=-all'
+ 3.  source paths for wine
+ 4.  the `-o' param for linkage
+ 5.  check compile and link together like `gcc -o stam stam.c'
+ 6.  run it
status {{{2

wine cl6x -qq -D__SOFTIER_LONG__=int -i/home/gxk/prjs/uClinux-dist/uClibc/include stam.c -d__SOFTIER_LONG__=int -mv6400 -ml3 -eo.o -ea.s -el.s -es.lst -qq -pden -pdr -d__SOFTIER_LONGLONG__=long\ long -d_TMS320C6X_LONGLONG -d__gnuc_va_list=va_list -dlinux -d__linux__ -dunix -d__uClinux__ -dEMBED -d_TMS320C6 -d__PIC__ -d_TMS320C6 -d__inline__=inline -d__signed__=signed -d_TMS320C6X_NOCONVERTER

gcc -d__SOFTIER_LONG__=int -d_TMS320C6X_LONGLONG -d_TMS320C6X_WCHAR -d__gnuc_va_list=va_list -dlinux -d__linux__ -dunix -d__uClinux__ -dEMBED -d_TMS320C6X -d__PIC__ -d_TMS320C6 -d__inline__=inline -d__signed__=signed -d_TMS320C6X_NOCONVERTER -i/home/gxk/prjs/uClinux-dist/uClibc/include -o stam stam.c

}}}2
7.  check gcc include files path creation
this is part of cc1 (compiler)
8.  check gcc lib path creation
9.  to change install dirs from `i686-pc-linux-gnu' to `c6x-coff-ml'
11. Replace cxoffice w/ wine
procedure {{{2
Change files:
./linux-2.4.x/Makefile                  kernel
./uClibc/Rules.mak                              libs-34
./uClibc/Makefile                               libs-34
./user/pciutils/Makefile                user
./user/tests/mpeg2/Makefile             user
./user/tests/play/Makefile              user
./user/tests/dmxplay/Makefile   user
./user/init/Makefile                    user
Redefine link to libgcc-ti.lib in <ti2|ti3|ti31b>/c6000/cgtools/lib/
cp msvcp60.dll  to `windows/system'

Links to care about:
.wine/drive_c/ti --> /usr/local/tools/ti31b
/usr/local/tools/ti-lib/libsoftier.lib -->
        /usr/local/tools/ti-lib/libsoftier-ti31b.lib
/usr/local/tools/ti31b/c6000/cgtools/lib/libgcc-ti.lib -->
        /usr/local/tools/ti-lib/libgcc-ti.lib

}}}2
12.

Left problems:
01. to use variable path in spec file
02. The `--target-help' works, but trying to link after.
03. The macro `-d__SOFTIER_LONGLONG__=long\ long' placed at gcc script, cause
    can't write in cmd line.
04. The `-E' options brings `-mtune=pentiumpro'
05. Use of option `-no-integrated-cpp' cancel call to built-in preprocessor,
    which can be used for converter call.

Info:
01. The preprocessor predefine `-d' changed to `-D' from CCS 3.0. If needed,so
    half way is to add `%{D*:-d%*}' at specs tag `*cpp_unique_options:'
02. To find where is cc1, run `gcc -print-prog-name=cc1'
03. run file `gcc --verbose -specs=/home/gxk/prjs/stam/specs stam.c -o stam -cmd'

Wrapper options translate table {{{2

--- List of  gcc options ans switches, based gcc 4.0.2

Options controlling output {{{3
x
pass-exit-codes
c
S
E
o
v
###
pipe
combine
help
target-help
-version
}}}3
Options controlling C lang {{{3
ansi
std=
aux-info
fno-asm
fno-builtin
fno-builtin-
fhosted
ffreestanding
fms-extensions
trigraphs
no-integrated-cpp
traditional
traditional-cpp
fcond-mismatch
funsigned-char
fsigned-char
fsigned-bitfields
funsigned-bitfields
fno-signed-bitfields
fno-unsigned-bitfields
}}}3
Warning options
C-only warnings
Debugging options {{{3
d
dumpspecs
dumpmachine
dumpversion
fdump-unnumbered
fdump-translation-unit
fdump-class-hierarchy[-n] 
fdump-ipa-all
fdump-ipa-cgraph
fdump-tree-all
...
fvar-tracking
g glevel gcoff gdwarf-2 ggdb gstabs gstabs+ gvms gxcoff gxcoff+
p pg print-file-name=library print-libgcc-file-name print-multi-directory
print-multi-lib print-prog-name=program print-search-dirs
Q
save-temps
time
}}}3
Optimization options
Preprocessor options {{{3
Xpreprocessor
D
U
undef
I
o
Wall
Wcomment
Wcomments
Wtrigraphs
Wtraditional
Wimport
Wundef
Wunused-macros
Wendif-labels
Werror
Wsystem-headers
w
pedantic
pedantic-errors
M
MM
MF
MG
MP
MT
MQ
MD
MMD
fpch-deps
fpch-preprocess
x
std
ansi
I-
nostdinc
nostdinc++
include
imacros
idirafter
iprefix
iwithprefix
iwithprefixbefore
isystem
iquote
fdollars-in-identifiers
fpreprocessed
ftabstop
fexec-charset
fwide-exec-charset
finput-charset
fworking-directory
fno-show-column
A
d
P
C
CC
traditional-cpp
trigraphs
remap
help
target-help
v
H
version
}}}3
Assembler options {{{3
Wa
Xassembler
}}}3
Linker options {{{3
l
nostartfiles
nodefaultlibs
nostdlib
pie
s
static
shared
shared-libgcc
static-libgcc
symbolic
Xlinker
Wl
u
}}}3
Options to search dirs for header files, libraries and parts of compiler
Directory search options {{{3
I
iquote
L
B
specs=
I-
}}}3
Code generation options {{{3
fcall-saved-reg  fcall-used-reg 
ffixed-reg  fexceptions 
fnon-call-exceptions  funwind-tables 
fasynchronous-unwind-tables 
finhibit-size-directive  finstrument-functions 
fno-common  fno-ident 
fpcc-struct-return  fpic  fPIC fpie fPIE 
freg-struct-return  fshared-data  fshort-enums 
fshort-double  fshort-wchar 
fverbose-asm  fpack-struct[=n]  fstack-check 
fstack-limit-register=reg  fstack-limit-symbol=sym 
fargument-alias  fargument-noalias 
fargument-noalias-global  fleading-underscore 
ftls-model=model 
ftrapv  -fwrapv  fbounds-check 
fvisibility
}}}3

--- List of cl6x options, based CCS 3.1b

TMS320C6x C/C++ Compiler                v5.1.0B2
Tools Copyright (c) 1996-2004 Texas Instruments Incorporated

Usage: cl6x [-options] filename

Use 'cl6x -h <option>' for more information on a particular option.  Use
'cl6x -h <text>' to search options for information regarding <text>.

Option arguments surrounded by [] declare they are optional.  Option arguments
separated by commas specify that the option's argument must be chosen from
those arguments listed.

General Options {{{3
  -@=filename          Read options from file filename
  -D=NAME[=value]      Pre-define NAME
  -I=dir               Add dir to #include search path
  -U=NAME              Undefine NAME
  -c                   Disable linking (overrides -z)
  --compiler_revision  Print compiler revision and exit
  --consultant         Generate compiler consultant information
  -h                   Show help screen
  -k                   Keep the generated assembly language (.asm) file
  -ma                  Assume called funcs create hidden aliases (rare)
  -n                   Compile only; do not assemble
  --profile:breakpt    Compile for breakpoint-based profiling
  --profile:power      Compile for power profiling
  -q                   Quiet Mode
  -qq                  Super Quiet Mode
  -s                   Generate interlisted assembly file
  -ss                  Generate source interlisted assembly file
  --verbose            Display banner and function progress information
  -version             Print version numbers for each tool
  -z[=filename]        Perform link using options following
}}}3
Symbolic Debug Options {{{3
  -g                   Full symbolic debug
  --machine_regs       Display reg operands as machine registers in asm file
  --symdebug:coff      Full symbolic debug (COFF, deprecated)
  --symdebug:dwarf     Full symbolic debug (same as -g)
  --symdebug:none      Suppress all symbolic debug generation
  --symdebug:profile_coff
                       Function profile debug (COFF, deprecated)
  --symdebug:skeletal  Symbolic debug for program analysis (default)
}}}3
Parser Options {{{3
  --exceptions         Enable C++ exception handling
  -pc                  Multibyte character support
  -pe                  Embedded C++
  -pi                  Ignore inline keyword
  -pk                  K & R compatibility
  -pl                  Output raw listing to .rl file
  -pm                  Program mode compilation
  -pn                  Disable intrinsic functions
  -pr                  Relaxed parsing (non-strict ANSI)
  -ps                  Strict ANSI mode (errors)
  -px                  Output xref listing to .crl file
  -rtti                Support C++ run-time type information
}}}3
Parser Preprocessing Options {{{3
  -ppa                 Generate a preprocessed file and continue compilation
  -ppc                 Preprocess only; maintain comments
  -ppd[=filename]      Generate include file dependency information
  -ppi[=filename]      Generate first-level include file list
  -ppl                 Preprocess only; maintain line directives
  -ppo                 Preprocess only
}}}3
Parser Diagnostics Options {{{3
  -pdel=count          Set error limit to <count>
  -pden                Emit diagnostic identifier numbers
  -pdf                 Output diagnostic to .err file
  -pdr                 Issue remarks
  -pds=id              Suppress diagnostic <id>
  -pdse=id             Treat diagnostic <id> as error
  -pdsr=id             Treat diagnostic <id> as remark
  -pdsw=id             Treat diagnostic <id> as warning
  -pdv                 Verbose diagnostics
  -pdw                 Suppress warnings
}}}3
Runtime Model Options {{{3
  -mb                  Enable 62xx compatibility
  -mc                  Do not reorder floating point operations
  -me                  Generate big endian code
  --mem_model:data=far,far_aggregates,near
                       Data access model (Default:far_aggregates)
  -mh[=#]              Specify speculative load byte count threshold
  -mi[=#]              Specify maximum cycles that interrupts may be disabled
  -mo                  Place each function in a separate subsection
  -mpic                Generate position independent code for call returns
  -ms[=0-3]            Optimize for code size (Default:0)
  -mt                  Assume no irregular alias or loop behavior
  -mu                  Disable software pipelining
  -mv=id               Target processor version (Default:6200)
  -mw                  Generate verbose software pipelining information
  --no_reload_errors   Prevent detection of loop buffer reload-related errors
  -ox                  Use const to disambiguate pointers.
  --speculate_unknown_loads
                       Speculate loads with unbounded address ranges
}}}3
Optimizations Options {{{3
  -O[=0-3]             Optimization level (Default:2)
  -oi[=size]           Specify threshold for automatic inlining
  -on=0-2              Generate optimizer information file at level [0-2]
  -op=0-3              Specify call assumptions when optimizing
  -os                  Generate optimized source interlisted assembly file
}}}3
Library Function Assumptions Options {{{3
  -ol0                 File redefines an RTS library function.
  -ol1                 File contains an RTS library function.
  -ol2                 File does not define any RTS library func (def.)
}}}3
Assembler Options {{{3
  -aa                  Generate absolute listing file
  -ac                  Symbol names are not case-significant
  -ad=NAME[=value]     Pre-define assembly symbol NAME
  -ahc=filename        Simulate source '.copy filename'
  -ahi=filename        Simulate source '.include filename'
  -al                  Generate listing file
  -apd                 Generate assembly dependency information
  -api                 Generate first-level assembly include file list
  -as                  Keep local symbols in output file
  -au=NAME             Undefine assembly symbol NAME
  -ax                  Generate cross reference file
}}}3
File Type Specifier Options {{{3
  -fa=filename         File is an assembly file (default for .asm)
  -fc=filename         File is a C file (default for .c/no ext)
  -fl=filename         File is a linear asm file (default for .sa)
  -fo=filename         File is an object file (default for .obj)
  -fp=filename         File is a C++ file (default for .C .cpp .cc)
}}}3
Directory Specifier Options {{{3
  -fb=dir              Absolute listing directory (default is .obj dir)
  -ff=dir              Listing/xref file directory (default is .obj dir)
  -fr=dir              Object file directory (default is .)
  -fs=dir              Assembly file directory (default is .)
  -ft=dir              Temporary file directory (default is .)
}}}3
Default File Extensions Options {{{3
  -ea=.ext             Extension for assembly files (default is .asm)
  -ec=.ext             Extension for C files (default is .c)
  -el=.ext             Extension for linear asm files (default is .sa)
  -eo=.ext             Extension for object files (default is .obj)
  -ep=.ext             Extension for C++ files (default is .cpp)
  -es=.ext             Extension for listing files (default is .lst)
  -fg                  Treat C files as C++ files
}}}3
Linker options {{{3
The following Linker options can be specified following the -z
option.  Linking is only enabled if -z is used and -c is not:

General Options:
  -a                   Produce an absolute, executable object file (default)
  -abs                 Produce absolute listing file
  --args=size          Set C argc/argv memory size
  -b                   Disable type merging in symbolic debugging information
  -c                   Link using ROM autoinitialization model
  -cr                  Link using RAM autoinitialization model
  -e=symbol            Specify the program entry point for the output module
  -f=value             Set default fill value for holes in output sections
  -g=symbol            Make specified symbol global (overrides -h)
  -h                   Make all global symbols static
  -heap,--heap=size    Specify heap size for C/C++ dynamic memory allocation
  -help,--help         Display usage information
  -i=dir               Add <dir> to library search path
  -j                   Disable conditional linking; ignore .clink directives
  -k                   Ignore alignment flags specified in input sections
  -l=file              Include library file or command file as input
  -m=file              Produce listing of input and output sections in <file>
  -o=file              Specify output file name
  -priority            Search libraries in priority order
  -r                   Produce a relocatable output module
  -s                   Strip symbol table and line number entries
  -stack,--stack=size  Set C system stack size
  --trampolines[=off,on]
                       Generate far call trampolines (Default:on)
  -u=sym               Add <sym> to symbol table as an unresolved symbol
  -w                   Warn if an unspecified output section is created
  -x                   Reread libraries; resolve backward references
  -xml_link_info=file  Produce detailed link information data-base in <file>
}}}3
}}}2
}}}1
toolchain {{{1
    05jan2005

STATUS:
    05jan2005
except kernel, everything compiled w/ sparc converter and work.
kernel compiled w/ sparc. check needed.
kernel compiled mixed - sparc, cil. check needed.

TODO:
1. release of toolchain, based sparc converter
2. release of toolchain, based cil converter
3. autotools improvement

1. wrapper {{{2

build {{{3
run 'gcc2c_scripts/make-wrapper.sh'
changed follows:
        gcc2c_scripts/make-wrapper.sh
        gcc2c-wrapper/gcc2c-compiler-wrapper.cpp (only warnings):
}}}3
code {{{3

GCC2C_CCS_PDK_ROOT
GCC2C_PDK_INCLUDE_PATH
GCC2C_WRAPPER_TEMPDIR
GCC2C_LOGFILE
GCC2C_NOSTDINC
GCC2C_NOSTDLIB
GCC2C_LIBPTHREAD
GCC2C_DEBUG_MODE
GCC2C_MAKE_PJT_FILE
GCC2C_ABORT_EXIT

GCC2C_CONVERTER         - instead of GCC2C_NO_CONVERTER_INVOCATION
GCC2C_CONVERTER_ROOT
GCC2C_CONVERTER_OPTIONS
GCC2C_PASSTHRU_GCC_OPTIMIZE_OPTIONS_TO_CONVERTER
GCC2C_CIL_CONVERTER_ROOT
GCC2C_CIL_PREPROCESSOR_OPTIONS

GCC2C_SECOND_STAGE_GCC_INVOKE
GCC2C_SECOND_STAGE_GCC_OPTIONS
GCC2C_SECOND_STAGE_GCC_NO_PASS_WARNING_OPTIONS

GCC2C_SECOND_STAGE_CCS_WINE_INVOKE
GCC2C_SECOND_STAGE_CCS_COMPILER_OPTIONS
GCC2C_NOCONVERTER_SECOND_STAGE_CCS_COMPILER_OPTIONS
GCC2C_SECOND_STAGE_CCS_COMPILER_EXTRA_OPTIONS
GCC2C_SECOND_STAGE_CCS_CONVERTED_COMPILE_OPTIONS
GCC2C_SECOND_STAGE_CCS_LINKER_OPTIONS
GCC2C_SECOND_STAGE_CCS_LIBRARY_PATH
GCC2C_SECOND_STAGE_CCS_ADDITIONAL_LIBRARY_PATH
GCC2C_SECOND_STAGE_CCS_INCLUDE_PATH
GCC2C_SECOND_STAGE_CCS_LOADER_OPTIONS
GCC2C_SECOND_STAGE_CCS_RAW_COMMAND_LINE
-------------------------------------------

GCC2C_WRAPPER_SAVETEMPS - ???

GCC2C_CIL_PREPROCESSOR_ROOT
GCC2C_CIL_CONVERTER_INVOCATION



Algo

Exit w/ error if
(! converter root) || ((! 2nd stage gcc) && (! 2nd stage wine)) || ((2nd stage gcc) && (2nd stage wine))
(2nd stage wine) && (! 2nd stage library path)
(2nd stage wine) && (! 2nd stage include path)
        wrapper tmp dir doesn't have absolute path
        wrapper tmp dir is root `/'

Prepare cmdln for gcc:
        SecondStageGCCInvoke DEFAULT_SECOND_STAGE_GCC_COMPILER_ARGS \
                SecondStageGCCOptions `-L' ConverterRoot`/'CONVERTER_LIB

}}}3

shahar's wrapper {{{3

Env vars usage {{{4
GCC2C_CCS_PDK_ROOT
GCC2C_PDK_INCLUDE_PATH
GCC2C_WRAPPER_TEMPDIR
GCC2C_LOGFILE
GCC2C_WRAPPER_SAVETEMPS - ??? 
GCC2C_NOSTDINC
GCC2C_NOSTDLIB
GCC2C_LIBPTHREAD
GCC2C_DEBUG_MODE

DEFAULT_CONVERTER_ARGS  -mnew-abi -D__NO_STRING_INLINES -D__NO_MATH_INLINES
DEFAULT_SECOND_STAGE_CCS_LINKER_ARGS    -z -x -b -ar --defualt-order
DEFAULT_CCS_LOADER_OPTIONS  -qq -map 1
SECOND_STAGE_CCS_COMPILER_ARGS_FOR_NON_CONVERTED
SECOND_STAGE_CCS_COMPILER_ARGS_FOR_CIL_CONVERTED
SECOND_STAGE_CCS_COMPILER_ARGS_FOR_CONVERTED
DEFAULT_SECOND_STAGE_CCS_COMPILER_ARGS
DEFAULT_SECOND_STAGE_GCC_COMPILER_ARGS
GCC2C_CONVERTER_DEFAULT_OPTIMIZE_ARGS
DEFAULT_CIL_PREPROCESSOR_ARGS

GCC2C_CONVERTER_ROOT
GCC2C_CONVERTER_OPTIONS
GCC2C_CIL_CONVERTER_ROOT
GCC2C_CIL_PREPROCESSOR_OPTIONS

GCC2C_SECOND_STAGE_GCC_INVOKE
GCC2C_SECOND_STAGE_GCC_OPTIONS
GCC2C_SECOND_STAGE_CCS_WINE_INVOKE
GCC2C_SECOND_STAGE_CCS_COMPILER_OPTIONS
GCC2C_SECOND_STAGE_CCS_COMPILER_EXTRA_OPTIONS
GCC2C_SECOND_STAGE_CCS_CONVERTED_COMPILE_OPTIONS
GCC2C_SECOND_STAGE_CCS_LINKER_OPTIONS
GCC2C_SECOND_STAGE_CCS_LIBRARY_PATH
GCC2C_SECOND_STAGE_CCS_ADDITIONAL_LIBRARY_PATH
GCC2C_SECOND_STAGE_CCS_INCLUDE_PATH
GCC2C_SECOND_STAGE_CCS_LOADER_OPTIONS
GCC2C_NOCONVERTER_SECOND_STAGE_CCS_COMPILER_OPTIONS
}}}4

Exit w/ error if
(! converter root) || ((! 2nd stage gcc) && (! 2nd stage wine)) || ((2nd stage gcc) && (2nd stage wine))
(2nd stage wine) && (! 2nd stage library path)
(2nd stage wine) && (! 2nd stage include path)
        wrapper tmp dir doesn't have absolute path
        wrapper tmp dir is root `/'

Create wrapper temp dir

def GCCConverterCommand + converter path (GCC2C_CONVERTER_ROOT) + name GCC_BIN
def GCCConverterArgs
    + DEFAULT_CONVERTER_ARGS
    + (GCC2CPassThruGCCOptimizeOptionsToConverter) GCC2C_CONVERTER_DEFAULT_OPTIMIZE_ARGS
    + GCC2C_CONVERTER_OPTIONS

def CILPreprocessorCommand + GCCConverterCommand
def CILPreprocessorArgs
    + DEFAULT_CIL_PREPROCESSOR_ARGS
    + (GCC2CPassThruGCCOptimizeOptionsToConverter) GCC2C_CONVERTER_DEFAULT_OPTIMIZE_ARGS
    + GCC2C_CIL_PREPROCESSOR_OPTIONS

def SecondStageGCCCommand
    + GCC2C_SECOND_STAGE_GCC_INVOKE
def SecondStageGCCArgs
    + DEFAULT_SECOND_STAGE_GCC_COMPILER_ARGS
    + GCC2C_SECOND_STAGE_GCC_OPTIONS
    + '-L' + GCC2C_CONVERTER_ROOT + CONVERTER_LIB

def SecondStageCCSCommand
    + GCC2C_SECOND_STAGE_CCS_WINE_INVOKE
    + CCS_COMPILER_BIN
def SecondStageCCSArgs
def SecondStageLinkerArgs

parsing options (285 long options)
print-libgcc-file-name
Xlinker - check if arg is `-T'
ansi - `pr'(CCS), `ansi'(SPARC,CIL)
fno-rtti - `rtti'(CCS)=???
save-temps - save-temps(SPARC), WrapperSaveTemps=1
list of optins added to SPARC and CIL as is {{{
finstrument-functions
fno-builtin
fno-builtin-abs
fno-show-column
finline-functions
fno-common
fno-show-column
fno-strict-aliasing
fomit-frame-pointer
fno-omit-frame-pointer
fstrict-aliasing
nostdinc
pedantic
pedantic-errors
traditional
traditional-cpp
iwithprefixbefore
iwithprefix
Werror
Wuninitialized
Wsign-compare
Wmissing-format-attribute
Wno-format-extra-args
Wcast-qual
Wconversion
Wunused
Wno-format-y2k
Wno-trigraphs
Wparentheses
Wreturn-type
Wswitch
Wunknown-pragmas
Wunreachable-code
Wformat-security
Wsequence-point
Wmissing-noreturn
Wno-long-long
Wformat-nonliteral
Wshadow
Wstrict-prototypes
Wtraditional
Wtrigraphs
Wwrite-strings
Wall
}}}
add to SPARC and CIL follows:
(!finline-limit) || (!std) || (!Wformat) || (!fmessage-length) ||
    (GCC2CPassThruGCCOptimizeOptionsToConverter && ((!funroll-loops) || (!funroll-all-loops))
add to SPARC and CIL follows:
(!idirafter)
add to SPARC follows:
(!fpic) || (!fno-pic) || (!ffreestanding) || (!fleading-underscore) ||
    (!GCC2C_SECOND_STAGE_GCC_NO_PASS_WARNING_OPTIONS && (!Wlarger-than-)) || (!trigraphs) || (!###)
target-help - `h'(CCS)
save-temps - `k -pl -px -s -ss'(CCS)
fno-inline - `pi'(CCS)
traditional - `pk'(CCS)
Wa - `Wa'(GCC)
Wp - `Wp'(SPARC,CIL)
Wl - `Wl'(GCC)
Ws - `Ws'(GCC) ???can't find in gcc options
A,B,H,d,$ - as is to SPARC and CIL
m,Q,x,s,u,l,b,V - as is to GCC and CCS(for linker)
v - 
P - as is CIL and GCC
M,E - SPARC,CIL,GCC
n - error???
D - SPARC,CIL,GCC, `d'(CCS)
o -
L -
w-
U -
c -
S - 
g -
p -
I - SPARC,CIL,GCC, `i'(CCS)
}}}3 
}}}2

fixes:
apps/Makefile
linux-2.4.x/kad/bios/Makefile
Makefile
user/init/Makefile

Patch build 132_23_41_42
get source
get patch source
run `get-k132 p' and get output {{{
/home/gxk/prjs/tools/uClinux-dist
/home/gxk/prjs/tools/uClinux-dist
/home/gxk/prjs/tools/uClinux-dist
/home/gxk/prjs/tools/uClinux-dist
/home/gxk/prjs/tools/uClinux-dist
patched eXTRA 63 files
}}}
`cd uClinux-dist'
`. /opt/softier/env.src -il uClibc'
`. /opt/softier/env.src /opt/softier/object.list'
`make xconfig' and set ma-600

`make linux-dep' and `make linux'

. /opt/softier/env.src -il /home/gxk/prjs/tools/uClinux-dist/uClibc
. /opt/softier/env.src -c CIL

Pack new sdk version:
cd packsdk/headers-n-libraries
./win2lin -o ./il-1.2.38 k138_l43_u50_i28_
cd ..
./pack -l./headers-n-libraries/il-1.2.38 -rsdk-v05-x.x.xx.tar 05-1.2.38

}}}1
boa-php {{{
    09jul2006
The purpose to build php as cgi for boa and demonstrate it with my glib,
based gd.

package 5.1.4 {{{
./configure --prefix=/usr/local/php5.1.4
created /usr/local/php5.1.4/bin/php size 7.7MB and libraries for 2.9MB

./configure --prefix=/usr/local/php5.1.4 --disable-all
created /usr/local/php5.1.4/bin/php size 4.9MB and libraries for 2.9MB
}}}
}}}
Upgrade2 design {{{
    Have to create well managed upgrade process, where each stage can be 
intercepted. Means, ability to freez upgrade process in "any" stage and even
put it in step-by-step mode.
    Two features needed - upgrade flow, which can be intercepted in almost any
time and interactive management tool (`control console') to control upgrade
flow already intercepted.
    The interception itself made by introduction of new upgrade flow, where 
manager creates separate upgrade jobs and waits till end of each. Each job is 
minimal task from upgrade flow (see ???). Manager will keep upgrade status in
oder to know which stage and in which status  running now.
    New feature `control console', which brings interactive remote shell to
upgrade system. User connects (w/ common telnet client) to the system and if
succeful, gets shell, w/ limited number of commands (see ???).
    If connection refused, upgrade flow got to the stage, where nothing can be
done (means alredy writing to flash).
    Accepting conection, will freez upgrade flow from moving forward, but 
alredy running job will end.

              Manager
                 |
     ------> new upg mission
    |            |
    |            | <------------------------
    |            |                          |
    |            |      n                   |
    |        new connection ---             |
    |            |y            |            |
    |            |             |            |
    |        remote shell      |            |
    |            |             |            |
    |            | <-----------             |
    |            |       n                  |
    |        job status done ---------------
    |            |y
    |            |           n
    |        is next mission ---
    |            |y             |
     -----------                |
                                |
                               EXIT

List of upgrade tasks
START - prepares manager process, by settings signals, environment, etc.
R2FS - doing reset to factory settings
BTN - checking push button for timeout period
DHCP - starts dhcp client
HTTP - starts boa server and brings upgrade file
FTP - starts ftp client and brings upgrade file
TFTP - starts tftp client and brings upgrade file
ARCH - open upgrade tarball
FLSH - writes everything on flash
FIN - updates upgrade flags

              Manager
                 |
     ------> new upg mission
    |            |
    |            | <---------
    |            |       n   |
    |        status done ----
    |            |y
    |            |           n
    |        is next mission ---
    |            |y             |
     -----------                |
                                |
                                EXIT

Statuses (20):
init, start, start_done, r2fs, r2fs_done, btn, btn_done, dhcp, dhcp_done, http,
http_done, ftp, ftp_done, tftp, tftp_done, arch, arch_done, flsh, flsh_done, fin
}}}
upgrade checklist {{{
        project time till 30apr - 30may 2006 -2 days

Normal flow (w/o telnet connection)

A FTP (+-DOK, +-DHCP, +-fallback)
        success
        no route to host
        no ftp service on host
        no such path on ftp server
        no upg archive on ftp server

B TFTP (+-DOK, +-DHCP)
        success
        no route to host
        no tftp service on host
        no upg archive on tftp server

C USB
        success
        no DiskOnKey
        no upg archive on DOK

D HTTP (+-DOK, +-DHCP)
        download success
        upload success

E OPEN (+-DOK, +-DHCP)
        fail to open archive
        fail to open tarball
        wrong tarball content

Telnet flow
        +-DHCP

}}}
Upgrade wave400 {{{
    21jun2006

- The main picture -

    The new system based on 64MB flash, where placed 2 separated systems
(A and B). Each one is fully operational with all needed abilities to run
IPTV. The system itself is kernel and writable filesystem image.

Bootloader  A system    B system

Currently not avaiable application upgrade, cause it is opens issue of
packaging system. How to keep track of different applications? Have tp keep
uninstall file.

--- Acronyms ---

UC - Upgrade Client
US - Upgrade Server

--- New concepts ---

1. What to upgrade?  (upgrade types)
It is required to upgrade whole system, any part of it or any choosen 
application. Three types of upgrade could be described:
    Full (FSU-full system upgarde) is upgrade of whole system.
    Partial (PSU-partial system upgrade) is upgrade only kernel or on of 
        filesystems.
    User Application - upgrade certain application.

2. Server activated upgrade.
    The upgrade can be started by client itself or by middleware server, which
sends command to start through JS API. The client can start it from button push
of remote control.

3. Background upgrade (TBD).
    Ability to do it, when user applications running. The question here is
memory needs to store upgrade tarball, while video application running.

4. New upgrade transport (TBD)
    In addition to FTP, TFTP, HTTP protocols and USB device, used to bring 
upgrade tarball to the system, one new transport - multicast file transfer.
Multicast based (like UDP FTP Multicast)

5. Upgrade User Interface (UUI)
    Upgrade monitor in 2 modes (runtime/debug), where upgrade progress
information dumped on screen

6. Ability to interact with remote control (start or cancel upgrade)

7. Upgrade tarball verification (MD5)

8. Dynamic name for upgrade tarball

LLDD

Interaction w/ UUI and IR closed w/ Tal (04jul2006), as telnet connection w/
browser, where certain language used for sevewral purposes:
- show progress on screen;
- get noted, if cancel button pushed;
- show lots of debug info on screen;

Upgrade client flow description
- reads configuration data
- connect to US
- builds upgrade image name
- download image
- opens and verifies upgrade image
- burns image
- update UUI, during whole process

}}}
Upgrade status {{{
High
1.  Fix http download
    Homepage w/ download,upload,cancel. If download or upload pressed, so get
    new page w/ cancel button only and message "in progress". When
    [down|up]load finished, new html page w/ result message.
    If canceled pushed, will get result page.
    If [down|up]load failed and result page given, user should do refresh in
    order to get homepage again.
2.  Add LOGDEBUG level, when debug output only w/ logfile
3.  Partial upgrade
4.  All checking done in FLSH, move to VERI stage.
Low
1.  Add check DNS resolving (if resolve.conf exists and >0)
2.  FQDN validate function
3.  Bugs 
    #899 - only windows ftp, download file from root, if path not exists
    #960 - system hangs, when network cable pluged out during ftp download
    #    - browser (IE) display timeout error, while boa downloads tarball
           too long.
Postponed
1.  Make upgrade kernel to production (waits for Hannit permission)
2.  Ability to write at upgrade filesystem (more ~700KB)
}}}
davinci {{{
    30may2006
from softier2003\install...\davinci\Code_Composer_Studio_v3.2_build_3.2.31.0

ARM subsystem (from sprue14.pdf) {{{

ARM926EJ-S CPU includes
    Coprocessor 15 (CP15)
    MMU
    instruction cache (I-Cache 16KB)
    data cache (D-Cache 8KB)
ARM internal memories
    16KB RAM (32bit)
    8KB ROM (ARM bootloader for non-AEMIF options)
Embedded Trace Module and Embedded Trace Buffer (ETM/ETB)
System control peripherals
    ARM interrupt controller
    PLL controller
    Power 'n' Sleep controller
    System module

ARM926EJ-S (from DDI0198D_926_TRM.pdf)

}}}
NAND {{{
    samsung K9F120R0B from series K9F120X0B (from ds_k9f1208x0b_rev03.pdf)
This is 512Mb (64MB). The actual size is 528Mb.
Devided in 4 planes, where each contents 1024 blocks + 528 byte page register.
Each plane is 128Mb (16MB), so each block 128Kb. Each block contents 32 pages,
so each page is 4Kb (512B).
      | plane block  page  bit   bytes
---------------------------------------
plane |   x   1024   32768 128M   16M
block | 1024    x     32   128K   16K
page  | 32768  32      x    4K    512
bit   | 128M  128K    4K    x      -

Because of physical size is 528Mb, it is left 16Mb (2MB) or 128 blocks..
}}}

svn checkout http://192.168.2.226/repos/bsp/infrastructure/trunk infrastructure

Build kernel {{{
    07jun2006

configure the kernel by following the underlined steps
make ARCH=arm CROSS_COMPILE=arm_v5t_le- davinci_dm644x_defconfig
make ARCH=arm CROSS_COMPILE=arm_v5t_le- checksetconfig

# This will setup the default config settings for the DaVinci Linux Baseline1 kernel.
# Configure the kernel to create the exact config requirements using
make ARCH=arm CROSS_COMPILE=arm_v5t_le- xconfig

# Ensure that the location of your MVL ToolChain installation is available in the
# search patch. Compile Linux kernel using:
make ARCH=arm CROSS_COMPILE=arm_v5t_le- uImage modules

# Copy kernel image to tftp server directory
sudo cp arch/arm/boot/uImage /tftpboot

# Install modules into target
sudo make ARCH=arm INSTALL_MOD_PATH=/opt/montavista/pro/devkit/arm/v5t_le/target modules_install
}}}
Build uboot {{{
    07jun2006
cd u-boot
[make distclean]
make davinci_config
make ARCH=arm CROSS_COMPILE=arm_v5t_le-
}}}
Boot flow {{{
Starts from NOR or ROM, depends on device configuration pins BTSEL[1:0].
After reset, the ARM program execution begins in ARM ROM 0x0000:40000, except
case when of NOR boot (BTSEL[1:0] = 01).
* BTSEL[1:0] = 01, so AEMIF or NOR boot mode
* RBL - ROM bootloader
  BTSEL[1:0] = 00, ARM NAND boot
  BTSEL[1:0] = 11, ARM UART boot
  BTSEL[1:0] = 10, Reserved
    ARM NAND boot
Not support for full firmware boot. instead copies 2nd stage UBL (user
  bootloader) from NAND to ARM internal RAM. The UBL up to 14KB size.
So, if BTSEL[1:0]==00 (from BOOTCFG register), NAND mode executes. This boot
mode assumes the NAND is located on the EM_CS2 interface, whose bus width is
controled by the external EM_WIDTH pin at reset.
The RBL uses the state of EM_WIDTH pin from BOOTCFG register to determine the
access size to be used when reading data from NAND.
1st, the device ID is read from the device. Any needed access info obtained
from device inoformation table in the RBL. Then the RBL searches for the UBL
descriptor in page 0 of the block, after CIS/IDI block.
To validate UBL, the UBL signature is read. If a valid UBL is not found, the
next block is searched. This will continues up to 5 blocks.
}}}

Uboot flow {{{
    12jun2006
start.S (cpu/arm926ejs/)  
|-> start_armboot() (lib_arm/board.c)
|   |-> cpu_init() (cpu/arm926ejs/cpu.c)
|   |
|   |-> board_init() (board/davinci/davinci.c)
|   |   |-> ...
|   |   |-> davinci_psc_all_enable() - power on required peripherals,
|   |   |   turns on all clocks  in the ALWAYSON and DSP power domains.
|   |   |_> inittimer() (board/davinci/timer.c)
|   |
|   |-> interrupt_init() (cpu/arm926ejs/interrupts.c)
|   |
|   |-> env_init() (common/env_nand.c) - just set env to valid, cause called
|   |   before nand_init()
|   |
|   |-> init_baudrate() (lib_arm/board.c)
|   |   |-> getenv_r() (common/cmd_nvedit.c)
|   |   |   |-> env_get_char() (common/env_common.c)
|   |
|   |-> serial_init()
|   |
|   |-> console_init_f()
|   |
|   |-> display_banner() (lib_arm/board.c) - show address of _armboot_start,
|   |   _bss_start and _bss_end from (cpu/arm926ejs/start.S)
|   |
|   |-> dram_init() (board/davinci/davinci.c) - set global value of SDRAM start
|   |   and size
|   |
|   |-> display_dram_config() (lib_arm/board.c) - shows info set by dram_init()
|   |
|   |-> flash_init() (board/davinci/flash.c) - setup flash_info and returns
|   |   |   size of FLASH
|   |   |_> flash_protect() (common/flash.c)
|   |       |_> flash_real_protect() (drivers/cfi_flash.c)
|   |
|   |-> display_flash_config()
|   |
|   |-> mem_malloc_init() (lib_arm/board.c) - prepare chunk of memory for 
|   |   malloc
|   |
|   |-> nand_init() (board/davinci/davinci.c)
|   |   |_> nand_probe()
|   |
|   |-> env_relocate() (common/env_common.c)
|   |
|   |-> get IP addr from env
|   |
|   |-> set MAC addr
|   |
|   |-> devices_init() (common/devices.c) - init list of devices
|   |   |->i2c_init() (drivers/davinci_i2c.c)
|   |   |-> ...
|   |
|   |-> jumptable_init() (common/exports.c)
|   |
|   |-> console_init_r() (common/console.c)
|   |
|   |-> misc_init_r() (board/davinci/davinci.c)
|   |   prints - `ARM Clock' 'n' `DDR Clock'
|   |
|   |-> enable_interrupts() (cpu/arm926ejs/interrupts.c)
|   |
|   |-> emac_set_mac_addr() - (board/davinci/dm644x_emac.c) network card init
|   |
|   |_> main_loop() (common/main.c)
|
}}}
video driver - drivers/video/davincifb.c
uboot on pc x86 {{{
    15jun2006
1. How to load it? Like GRUB, the same.
2. Hardware init?
}}}
}}}
building minimo {{{
    10jul2006
The purpose to build Minimo for davinci, where 1st to do it on MVP(mediaware).
1. Build on MVP w/ X, check for footprint and dependencies
2. Build w/o X (may be NanoX), w/ GTK and DirectFB, check for footprint and
    dependencies

Building Minimo from CVS (10jul2006 see cmn.txt)
    30jul2006
1. Build minimo + GTKDFB on x86
Files with gdkx {{{
gfx/src/gtk/nsNativeThemeGTK.cpp
gfx/src/gtk/nsRenderingContextGTK.cpp
gfx/src/gtk/nsImageGTK.cpp
gfx/src/gtk/mozilla-decoder.cpp
gfx/src/gtk/nsScreenGtk.cpp
modules/plugin/base/src/nsPluginHostImpl.cpp
modules/plugin/base/src/ns4xPluginInstance.cpp
modules/plugin/base/src/ns4xPlugin.cpp
toolkit/components/remote/nsGTKRemoteService.h
modules/plugin/base/src/nsPluginHostImpl.cpp
modules/plugin/base/src/ns4xPluginInstance.cpp
toolkit/components/remote/nsGTKRemoteService.h
widget/src/gtk2/nsClipboard.cpp
widget/src/gtk2/nsWindow.h
widget/src/gtk2/nsWindow.cpp
}}}
Unresolved symbols {{{

gdk_x11_drawable_get_xid
gdk_x11_drawable_get_xdisplay
gdk_x11_visual_get_xvisual
gdk_x11_gc_get_xgc
gdk_x11_get_default_screen
gdk_x11_xatom_to_atom
gdk_x11_atom_to_xatom
gdk_x11_get_xatom_by_name
gdk_display
gdk_x11_image_get_ximage
gdk_x11_colormap_get_xcolormap

Remove `-lX11' from config/autoconf.mk brings follows {{{
XGetImage
XChangeGC
XCreateImage
XFillRectangle
XPutImage
XSetDashes
XSetErrorHandler
XCheckIfEvent
XGetInputFocus
XRaiseWindow
XSetInputFocus
XGetWindowAttributes
XSelectInput
XSync
XCheckWindowEvent
XFlush
XServerVendor
XPending
XChangeProperty
XSendEvent
XQueryTree
XFree
XInternAtom
}}}
Follows canceled by removing xremoteclient and gtkxtbin {{{
XtStrings
XtShellStrings
XtDisplay
XtOpenDisplay
XtDisplayToApplicationContext
XtAddEventHandler
XtRemoveEventHandler
XtAppProcessEvent
XtWindowToWidget
XtWindow
XtDestroyWidget
XtUnrealizeWidget
XtRealizeWidget
XtVaCreateWidget
XtAppPending
XtToolkitInitialize
XtCreateApplicationContext
XtAppSetFallbackResources
XtAppCreateShell
XtUnregisterDrawable
XtRegisterDrawable
XtManageChild
XtSetValues
compositeWidgetClass
applicationShellWidgetClass
}}}
}}}
02aug2006 {{{
Usage gdk/gdkx.h
  widget/src/gtkxtbin/gtk2xtbin.c
  gfx/src/gtk/nsDeviceContextGTK.cpp
  gfx/src/gtk/nsDrawingSurfaceGTK.cpp
  gfx/src/gtk/nsImageGTK.cpp
  gfx/src/gtk/nsGCCache.cpp
  gfx/src/gtk/nsRenderingContextGTK.cpp
  gfx/src/gtk/nsScreenGtk.cpp
  gfx/src/gtk/nsScreenManagerGtk.cpp (removed)
  gfx/src/gtk/nsNativeThemeGTK.cpp
  widget/src/gtk2/nsWindow.h
  widget/src/gtk2/nsWindow.cpp
  widget/src/gtk2/nsGtkKeyUtils.cpp
  widget/src/gtk2/nsClipboard.cpp
  widget/src/gtk2/nsDragService.cpp
  toolkit/components/remote/nsGTKRemoteService.cpp
  toolkit/components/remote/nsGTKRemoteService.h
FT2 issues
  gfx/idl/nsIFreeType2.idl
  gfx/src/freetype/nsFreeType.h
  gfx/src/freetype/nsFreeType.cpp
Can't see nsIFontEnumerator
  gfx/src/gtk/nsGfxFactoryGTK.cpp
Usage pango/pangox.h
  gfx/src/gtk/nsDeviceContextGTK.cpp
Can't see PRUint32 and nsresult
  gfx/src/gtk/nsFontMetricsUtils.cpp
undefined reference to nsFT2FontCatalog::nsFT2FontCatalog()
  gfx/src/gtk/Makefile.in
}}}
Build browser from src ff-1.5.0.6 based gtkdfb {{{
        10aug2006
get firefox-1.5.0.6-source.tar.bz2
tar jxf firefox-1.5.0.6-source.tar.bz2
cd mozilla
export MOZCONFIG=
export LD_LIBRARY_PATH=
export PKG_CONFIG_PATH=
make -f client.mk build
Have to disable MOZ_X11 and unselect gtkxtbin module. changed files:
  mozilla/Makefile.in
  mozilla/configure
  mozilla/widget/src/Makefile.in
  mozilla/toolkit/library/Makefile.in
  mozilla/modules/plugin/base/src/Makefile.in
Changes call to gdkx.h and pangox.h
  gfx/src/gtk/nsDeviceContextGTK.cpp
  gfx/src/gtk/nsDrawingSurfaceGTK.cpp
  gfx/src/gtk/nsImageGTK.cpp
  gfx/src/gtk/nsGCCache.cpp
  gfx/src/gtk/nsRenderingContextGTK.cpp
  gfx/src/gtk/nsScreenGtk.cpp
  gfx/src/gtk/nsScreenManagerGtk.cpp (removed)
Can't see nsIFontEnumerator (add `#include "nsIFontEnumerator.h"')
  gfx/src/gtk/nsGfxFactoryGTK.cpp
Can't see PRUint32 and nsresult
  gfx/src/gtk/nsFontMetricsUtils.cpp
Changes call to gdkx.h
  gfx/src/gtk/nsNativeThemeGTK.cpp
...
}}}
Build browser (ff-1.5.0.6) based xlib {{{
        10aug2006
get firefox-1.5.0.6-source.tar.bz2
tar jxf firefox-1.5.0.6-source.tar.bz2
cd mozilla
export MOZCONFIG=
make -f client.mk build
Change `configure' to accept xlib+xft
FT2 issues
  gfx/idl/nsIFreeType2.idl
  gfx/src/freetype/nsFreeType.h
  gfx/src/freetype/nsFreeType.cpp

}}}
Build ??? based cairo-gtk2 on trunk {{{
06aug2006
FT2 issues
  mozilla/gfx/idl/nsIFreeType2.idl
  mozilla/gfx/src/freetype/nsFreeType.h
  gfx/src/freetype/nsFreeType.cpp
}}}
Build minimo based xlib toolkit w/ NanoX {{{
        07aug2006
Done Minimo based xlib toolkit. After changing LibX11.so original to one from
microwindows projects follow undefined references appeare
libXt.so: undefined reference to `XFindContext'
libXt.so: undefined reference to `XDisplayOfScreen'
libXt.so: undefined reference to `XSetSelectionOwner'
libXt.so: undefined reference to `XDeleteContext'
libXt.so: undefined reference to `XConvertSelection'
libXt.so: undefined reference to `XUngrabButton'
libXt.so: undefined reference to `XNextRequest'
libXt.so: undefined reference to `XGetSelectionOwner'
libXt.so: undefined reference to `XGrabButton'
libXt.so: undefined reference to `XListDepths'
libXt.so: undefined reference to `XkbLookupKeySym'
libXt.so: undefined reference to `XGrabKey'
libXt.so: undefined reference to `XSaveContext'
libXt.so: undefined reference to `XUngrabKey'
}}}
}}}
Resolve stubbing for X funcs in  minimo {{{
        13sep2006
XSetErrorHandler done {{{
Used in follows
1 embedding/browser/gtk/tests/TestGtkEmbedChild.cpp
2 widget/src/gtk2/nsNativeThemeGTK.cpp

Changed in 1, calling to gdk_error_trap_pop() and gdk_error_trap_push()
}}}
XCheckWindowEvent done {{{
Used in follows
1 widget/src/gtk2/nsWindow.cpp
Cause this call to get all motion events from X queue, so not needed.
}}}
XCheckIfEvent done {{{
        Bool XCheckIfEvent(Display *display, XEvent *event_return, 
                Bool (*predicate)(), XPointer arg);
Checks if match found, by calling predicate function, copies event and remove
it from queue.
Used in follows
1 widget/src/gtk2/nsClipboard.cpp
}}}
XAllocClassHint XSetClassHint XFree done {{{
1 widget/src/gtk2/nsWindow.cpp

}}}
XGetInputFocus XSetInputFocus done {{{
1 widget/src/gtk2/nsWindow.cpp

}}}
XGetWindowAttributes done {{{
1 widget/src/gtk2/nsWindow.cpp

}}}
XSync {{{
Used in follows
1 widget/src/gtk2/nsWindow.cpp
2 widget/src/xremoteclient/XRemoteClient.cpp
3 widget/src/xlibxtbin/xlibxtbin.cpp
4 widget/src/gtk/nsWindow.cpp
5 widget/src/gtk/nsPointerService.cpp
6 widget/src/gtksuperwin/gdksuperwin.c
7 widget/src/gtkxtbin/gtk2xtbin.c
8 widget/src/gtkxtbin/gtkxtbin.c
9 gfx/src/thebes/nsThebesDeviceContext.cpp

}}}
}}}
DMX {{{
        19sep2006

To define multiplatform video API can be applied to general set-top box.
The API offers full display path that manages the contents to be displayed
from the source to the output through scalers, mixers and routers.

The scaler alternates the size of a picture. There are number of scalers 
depends by it's output purpose.
OSD scaler
Primary video scaler
Secondary video scaler
Logotype scaler
Subtitle scaler
Graphics accelerator

The mixer combines and positiones pictures from different scalers. The picture
from any source (scaler) goes to positioning, prioritizing and finaly blending.
The router assignes mixer to proper output.

}}}
porting DFB to sigma8634 {{{
        26sep2006
source sigma8634.src
export PREFIX=/opt/sigma8634/dfb
export EPREFIX=/mnt/dfb

libpng
Delete `AC_FUNC_MALLOC' from configure.ac

FreeType 
Fixed builds/exports.mk in order to use apinames tool in cross compile
environment.

DirectFB
Fixed include/asm/page.h to get PAGE_SIZE out of _KERNEL_
Fixed configure.in in order to use libpng-config tool. Patch sent 03oct2006
        and accepted  from 05oct2006
Commit source
cd DirectFB {{{
svn commit -m "preliminary sigma8634 release"
svn copy http://192.168.2.227/kernelrep/generic/zlib/trunk http://192.168.2.227/kernelrep/generic/zlib/tags/0.1 -m "tagging zlib 0.1"
svn copy http://192.168.2.227/kernelrep/generic/libpng/trunk http://192.168.2.227/kernelrep/generic/libpng/tags/0.1 -m "tagging libpng 0.1"
svn copy http://192.168.2.227/kernelrep/generic/freetype/trunk http://192.168.2.227/kernelrep/generic/freetype/tags/0.1 -m "tagging freetype 0.1"
svn copy http://192.168.2.227/kernelrep/generic/directfb/trunk http://192.168.2.227/kernelrep/generic/directfb/tags/0.1 -m "tagging DirectFB 0.1"
svn import /home/gxk/prjs/scripts/creator http://192.168.2.227/kernelrep/generic/creator/trunk -m "import initial"
svn mkdir -m "making tags directory" http://192.168.2.227/kernelrep/generic/creator/tags
svn copy http://192.168.2.227/kernelrep/generic/creator/trunk http://192.168.2.227/kernelrep/generic/creator/tags/0.1 -m "tagging creator 0.1"
}}}
Add tiff-3.7.4 
Add jpeg-6b to creator.sh

}}}
porting GTK (based DFB) to sigma8634 {{{
        15oct2006
Insert all source in subversion {{{
                FONTCONFIG
svn import /home/gxk/prjs/sigma8634/directfb/fontconfig-2.3.96 http://192.168.2.227/kernelrep/vendors/fontconfig/trunk -m "import initial 2.3.96 vendor drop"
svn mkdir -m "making tags directory" http://192.168.2.227/kernelrep/vendors/fontconfig/tags
svn copy http://192.168.2.227/kernelrep/vendors/fontconfig/trunk http://192.168.2.227/kernelrep/vendors/fontconfig/tags/2.3.96 -m "tagging fontconfig 2.3.96"
svn mkdir -m "making vendors directory" http://192.168.2.227/kernelrep/generic/fontconfig
svn copy http://192.168.2.227/kernelrep/vendors/fontconfig/tags/2.3.96 http://192.168.2.227/kernelrep/generic/fontconfig/trunk -m "bringing fontconfig-2.3.96 into softier generic"
svn mkdir -m "making tags directory" http://192.168.2.227/kernelrep/generic/fontconfig/tags
                GLIB
svn import /home/gxk/prjs/sigma8634/directfb/glib-2.12.2 http://192.168.2.227/kernelrep/vendors/glib/trunk -m "import initial 2.12.2 vendor drop"
svn mkdir -m "making tags directory" http://192.168.2.227/kernelrep/vendors/glib/tags
svn copy http://192.168.2.227/kernelrep/vendors/glib/trunk http://192.168.2.227/kernelrep/vendors/glib/tags/2.12.2 -m "tagging glib 2.12.2"
svn mkdir -m "making vendors directory" http://192.168.2.227/kernelrep/generic/glib
svn copy http://192.168.2.227/kernelrep/vendors/glib/tags/2.12.2 http://192.168.2.227/kernelrep/generic/glib/trunk -m "bringing lib-2.12.2 into softier generic"
svn mkdir -m "making tags directory" http://192.168.2.227/kernelrep/generic/glib/tags
                LIBICONV
svn import /home/gxk/prjs/sigma8634/directfb/libiconv-1.11 http://192.168.2.227/kernelrep/vendors/libiconv/trunk -m "import initial 1.11 vendor drop"
svn mkdir -m "making tags directory" http://192.168.2.227/kernelrep/vendors/libiconv/tags
svn copy http://192.168.2.227/kernelrep/vendors/libiconv/trunk http://192.168.2.227/kernelrep/vendors/libiconv/tags/1.11 -m "tagging libiconv 1.11"
svn mkdir -m "making vendors directory" http://192.168.2.227/kernelrep/generic/libiconv
svn copy http://192.168.2.227/kernelrep/vendors/libiconv/tags/1.11 http://192.168.2.227/kernelrep/generic/libiconv/trunk -m "bringing libiconv-1.11 into softier generic"
svn mkdir -m "making tags directory" http://192.168.2.227/kernelrep/generic/libiconv/tags
                GETTEXT
svn import /home/gxk/prjs/sigma8634/directfb/gettext-0.15 http://192.168.2.227/kernelrep/vendors/gettext/trunk -m "import initial 0.15 vendor drop"
svn mkdir -m "making tags directory" http://192.168.2.227/kernelrep/vendors/gettext/tags
svn copy http://192.168.2.227/kernelrep/vendors/gettext/trunk http://192.168.2.227/kernelrep/vendors/gettext/tags/0.15 -m "tagging gettext 0.15"
svn mkdir -m "making vendors directory" http://192.168.2.227/kernelrep/generic/gettext
svn copy http://192.168.2.227/kernelrep/vendors/gettext/tags/0.15 http://192.168.2.227/kernelrep/generic/gettext/trunk -m "bringing gettext-0.15 into softier generic"
svn mkdir -m "making tags directory" http://192.168.2.227/kernelrep/generic/gettext/tags
                GTK+
svn import /home/gxk/prjs/sigma8634/directfb/gtk+ http://192.168.2.227/kernelrep/vendors/gtk+/trunk -m "import initial 2.10.2 vendor drop"
svn mkdir -m "making tags directory" http://192.168.2.227/kernelrep/vendors/gtk+/tags
svn copy http://192.168.2.227/kernelrep/vendors/gtk+/trunk http://192.168.2.227/kernelrep/vendors/gtk+/tags/2.10.2 -m "tagging gettext 2.10.2"
svn mkdir -m "making vendors directory" http://192.168.2.227/kernelrep/generic/gtk+
svn copy http://192.168.2.227/kernelrep/vendors/gtk+/tags/2.10.2 http://192.168.2.227/kernelrep/generic/gtk+/trunk -m "bringing gtk+-2.10.2 into softier generic"
svn mkdir -m "making tags directory" http://192.168.2.227/kernelrep/generic/gtk+/tags
                PANGO
svn import /home/gxk/prjs/sigma8634/directfb/pango http://192.168.2.227/kernelrep/vendors/pango/trunk -m "import initial 1.13.3 vendor drop"
svn mkdir -m "making tags directory" http://192.168.2.227/kernelrep/vendors/pango/tags
svn copy http://192.168.2.227/kernelrep/vendors/pango/trunk http://192.168.2.227/kernelrep/vendors/pango/tags/1.13.3 -m "tagging gettext 1.13.3"
svn mkdir -m "making vendors directory" http://192.168.2.227/kernelrep/generic/pango
svn copy http://192.168.2.227/kernelrep/vendors/pango/tags/1.13.3 http://192.168.2.227/kernelrep/generic/pango/trunk -m "bringing pango-1.13.3 into softier generic"
svn mkdir -m "making tags directory" http://192.168.2.227/kernelrep/generic/pango/tags
                ATK
svn import /home/gxk/prjs/sigma8634/directfb/atk http://192.168.2.227/kernelrep/vendors/atk/trunk -m "import initial 1.9.1 vendor drop"
svn mkdir -m "making tags directory" http://192.168.2.227/kernelrep/vendors/atk/tags
svn copy http://192.168.2.227/kernelrep/vendors/atk/trunk http://192.168.2.227/kernelrep/vendors/atk/tags/1.9.1 -m "tagging gettext 1.9.1"
svn mkdir -m "making vendors directory" http://192.168.2.227/kernelrep/generic/atk
svn copy http://192.168.2.227/kernelrep/vendors/atk/tags/1.9.1 http://192.168.2.227/kernelrep/generic/atk/trunk -m "bringing atk-1.9.1 into softier generic"
svn mkdir -m "making tags directory" http://192.168.2.227/kernelrep/generic/atk/tags
                CAIRO
svn import /home/gxk/prjs/sigma8634/directfb/cairo http://192.168.2.227/kernelrep/vendors/cairo/trunk -m "import initial 1.2.4 vendor drop"
svn mkdir -m "making tags directory" http://192.168.2.227/kernelrep/vendors/cairo/tags
svn copy http://192.168.2.227/kernelrep/vendors/cairo/trunk http://192.168.2.227/kernelrep/vendors/cairo/tags/1.2.4 -m "tagging gettext 1.2.4"
svn mkdir -m "making vendors directory" http://192.168.2.227/kernelrep/generic/cairo
svn copy http://192.168.2.227/kernelrep/vendors/cairo/tags/1.2.4 http://192.168.2.227/kernelrep/generic/cairo/trunk -m "bringing cairo-1.2.4 into softier generic"
svn mkdir -m "making tags directory" http://192.168.2.227/kernelrep/generic/cairo/tags
                LIBXML2
svn import /home/gxk/prjs/sigma8634/directfb/libxml2-2.6.26 http://192.168.2.227/kernelrep/vendors/libxml2/trunk -m "import initial 2.6.26 vendor drop"
svn mkdir -m "making tags directory" http://192.168.2.227/kernelrep/vendors/libxml2/tags
svn copy http://192.168.2.227/kernelrep/vendors/libxml2/trunk http://192.168.2.227/kernelrep/vendors/libxml2/tags/2.6.26 -m "tagging libxml2 2.6.26"
svn mkdir -m "making vendors directory" http://192.168.2.227/kernelrep/generic/libxml2
svn copy http://192.168.2.227/kernelrep/vendors/libxml2/tags/2.6.26 http://192.168.2.227/kernelrep/generic/libxml2/trunk -m "bringing libxml2-2.6.26 into softier generic"
svn mkdir -m "making tags directory" http://192.168.2.227/kernelrep/generic/libxml2/tags
                JPEG
svn import /home/gxk/jpeg-6b http://192.168.2.227/kernelrep/vendors/jpeg/trunk -m "import initial v6b vendor drop"
svn mkdir -m "making tags directory" http://192.168.2.227/kernelrep/vendors/jpeg/tags
svn copy http://192.168.2.227/kernelrep/vendors/jpeg/trunk http://192.168.2.227/kernelrep/vendors/jpeg/tags/v6b -m "tagging jpeg v6b"
svn mkdir -m "making vendors directory" http://192.168.2.227/kernelrep/generic/jpeg
svn copy http://192.168.2.227/kernelrep/vendors/jpeg/tags/v6b http://192.168.2.227/kernelrep/generic/jpeg/trunk -m "bringing jpegv6b into softier generic"
svn mkdir -m "making tags directory" http://192.168.2.227/kernelrep/generic/jpeg/tags
                TIFF
svn import /home/gxk/tiff-3.7.4 http://192.168.2.227/kernelrep/vendors/tiff/trunk -m "import initial 3.7.4 vendor drop"
svn mkdir -m "making tags directory" http://192.168.2.227/kernelrep/vendors/tiff/tags
svn copy http://192.168.2.227/kernelrep/vendors/tiff/trunk http://192.168.2.227/kernelrep/vendors/tiff/tags/3.7.4 -m "tagging tiff 3.7.4"
svn mkdir -m "making vendors directory" http://192.168.2.227/kernelrep/generic/tiff
svn copy http://192.168.2.227/kernelrep/vendors/tiff/tags/3.7.4 http://192.168.2.227/kernelrep/generic/tiff/trunk -m "bringing tiff-3.7.4 into softier generic"
svn mkdir -m "making tags directory" http://192.168.2.227/kernelrep/generic/tiff/tags
}}}
Package dependencies:

gtk2-devel-*.rpm

zlib
png
jpeg
ftype
dfb

#iconv
#gettext
glib (deps: iconv)
#libxml2
fconfig

atk
cairo
pango
gtk


}}}
porting Minimo (based GTKDFB) on sigma8634 {{{
        26oct2006
1. added libIDL to creator
        Insert source to subversion {{{
svn import /home/gxk/libIDL-0.8.7 http://192.168.2.227/kernelrep/vendors/libIDL/trunk -m "import initial 0.8.7 vendor drop"
svn mkdir -m "making tags directory" http://192.168.2.227/kernelrep/vendors/libIDL/tags
svn copy http://192.168.2.227/kernelrep/vendors/libIDL/trunk http://192.168.2.227/kernelrep/vendors/libIDL/tags/0.8.7 -m "tagging libIDL 0.8.7"
svn mkdir -m "making vendors directory" http://192.168.2.227/kernelrep/generic/libIDL
svn copy http://192.168.2.227/kernelrep/vendors/libIDL/tags/0.8.7 http://192.168.2.227/kernelrep/generic/libIDL/trunk -m "bringing libIDL-0.8.7 into softier generic"
svn mkdir -m "making tags directory" http://192.168.2.227/kernelrep/generic/libIDL/tags
}}}

Source from Ady (before Tal's update)
svn copy http://192.168.2.227/appsrep/Main/trunk/browsers/mozilla/tvmo -r 2289 http://192.168.2.227/appsrep/Main/branches/browsers/mozilla/tvmo-gxk
svn co http://192.168.2.227/appsrep/Main/branches/browsers/mozilla/tvmo-gxk

Host package dependencies:
libIDL-devel

Patch to minimo to build host_xpidl under PKG_CONFIG_PATH

cp gtk+/gdk/x11/gdkx.h /opt/sigma8634/gtkdfb/include/gtk-2.0/gdk/gdk-gxk.h
mkdir /opt/sigma8634/tvmo/include/X11
cp /usr/include/X11/{Xatom.h,Xlib.h,Xutil.h,X.h,Xfuncproto.h,Xosdefs.h} /opt/sigma8634/tvmo/include/X11

In order to build minimo needed:
set MOZCONFIG, LD_LIBRARY_PATH, PKG_CONFIG_PATH

. ../sigma8634/smp86.env
export PREFIX=/opt/sigma8634/tvmo
export RT_PREFIX=/mnt/tvmo

Building mozilla
1. build libIDL


}}}
New mozilla port to Sigma8634 {{{
        05dec2006

Sigma8634 changes:
<toolchain>/toolchain/uClibc/Config.in
<toolchain>/toolchain/uClibc/uClibc.config-locale
<rootfs>/toolchain/uClibc/uClibc.config
<mrua>/MRUA_src/rua/emhwlib_kernel/kernel_src/em8xxx_fb.c
<mrua>/lib/{librmjpeg.so,librmhttp.so, libsamples.so}

zlib
gettext (gettext-tools/lib/Makefile.in,gettext-tools/m4/Makefile.in)
jpeg (changed creator.sh - make libtool)
png
ftype
dfb

glib
libxml2
fconfig

atk
cairo
pango
gtk (gtk+/gtk/Makefile.in)

Fontconfig configuration.
cp from FC5 /etc/fonts and /usr/share/fonts and set
export FONTCONFIG_PATH=/etc/fonts
sudo cp -r /etc/fonts /opt/sigma8634/142/nfsroot/etc/
sudo cp -r /usr/share/fonts /opt/sigma8634/142/nfsroot/usr/share/

Pango 
mkdir /opt/sigma8634/142/gtkdfb/lib/pango/1.5.0/modules
cp -r /mnt/tvmo/lib/pango/1.5.0/modules/* /opt/sigma8634/tvmo/lib/pango/1.5.0/modules/
mkdir /opt/sigma8634/tvmo/etc/pango
/mnt/tvmo/bin/pango-querymodules > /opt/sigma8634/tvmo/etc/pango/pango.modules

libIDL

XPTCall asm mips changes (from bug #258429)
mozilla/xpcom/reflect/xptcall/src/md/unix/Makefile.in
mozilla/xpcom/reflect/xptcall/src/md/unix/xptcinvoke_asm_mips.s
mozilla/xpcom/reflect/xptcall/src/md/unix/xptcinvoke_mips.cpp
mozilla/xpcom/reflect/xptcall/src/md/unix/xptcstubs_asm_mips.s

Fix link w/ libpipboot.a 
mozilla/minimo/base/linux/minimo-link-comps

Just Ady's leftovers
mozilla/minimo/base/Minimo.cpp

released 12dec2006
}}}
Minimo project {{{
1. Add libtiff to creator
Creator project
3. Add `--[no]deps' - build w/ or w/o dependencies
4. cancel use of softier.cache in glib (causing to collision with configuration
        parameters)
}}} 
gnash {{{
        02jan2007
Gnash site: http://www.gnu.org/software/gnash/

Getting Gnash from CVS 
export CVS_RSH="ssh"
cvs -z3 -d:pserver:anonymous@cvs.sv.gnu.org:/sources/gnash co gnash

Status:
Checkout source from CVS at 02jan2007
./autogen.sh
./configure --prefix=/opt/x86/gnash --with-plugindir=/opt/x86/gnash/plugin
./configure --prefix=/opt/x86/gnash --with-plugindir=/opt/x86/gnash/plugin --enable-gui=SDL --enable-sound=SDL
}}}
-------------------------------------------------------------------------------
----------------------------------- Sphera ------------------------------------
-------------------------------------------------------------------------------
I.      #300000/238 qpopper in server mode(see cmn.txt){{{

This mail determined to try answer question about Qpopper in server mode and
to give procedures how to run Qpopper in server mode.

1. What are the contributions and restrictions of server mode ?
    Reduces th I/O usage where users download and delete all their messages
    and by avoiding initial scan of pool when session starts (mail check time).
    Also, from Sphera point of view, it is not creates temporary file.
    The known restrictions or misbehaviours are
        Usage of a mailbox by Qpopper and any other application
        simulteniously can damage emails content.

2. Is it good practice to start qpopper at server mode by default ?
    No.
    Server mode should be given for users with disk quota
    or performance problems. The main problem with other applications
    using the same files that can corrupt email data.
   
3. What can de done now and quickly ?
    Possible to implement in any way (GUI/command line) server mode
    and advise for customers w/ disk usage or responce time problems
    to use it.

4. How to run Qpopper in server mode? (procedures)

    a. To run Qpopper for all VDSs of HostingDirector in server mode needs
    to change in hostdir.xml
    Under <services> - <service> for name="pop" find under <mode
    property param="-f /etc/.qpopper-options" and change to
    param="-S -f /etc/.qpopper-options" ( uppercase '-S' added )

    b. To run Qpopper for certain VDS needs to change file named
    .qpopper-options under <VDS owner home dir>/etc
    Just add new line as follows:
    set server-mode=true

NOT INCLUDED IN ANSWER cause no procedure to create groups of users in VDS

    c. There is possibility to run in server mode for just a group of users.
    Needs to add in file .qpopper-options (same as in previous 4.b) folows:
    --enable-server-mode-group-include=<group name>

    The oposit exists also. When needed to exclude group of users from running
    Qpopper in server mode also to add in the same file follows:
    --enable-server-mode-group-exclude=<group name>

Theory{{{2
        from http://www.eudora.com/qpopper/faq.html#server_mode
        What is server mode?
        --------------------
        Server mode makes an assumption that the spool file is only altered by 
        Qpopper or the local delivery agent (for example,  mail.local).
        This means that, apart from Qpopper, the spool file is only changed
        when new mail is appended to the end.
        Server Mode reduces I/O on sessions that:
                # delete all mail on the server
                # leave all the mail on the server
        In other words, transactions that delete all or none of the messages.
        In normal mode, the mail spool is copied into a temporary file at the
        beginning of the session.  Once the session is complete, the undeleted
        messages are copied back to the mail spool.
        In Server Mode this copying is avoided if all of the messages are
        deleted or all of the messages are left on the server.
        Restrictions
        ------------
        Do not enable server mode for users who telnet to the mail server and
        access the mail spool directly, or run local programs which access the
        mail spool.
}}}2

}}}
II.     #200018/8 ftpd w/ restricted passive ports{{{1
}}}1
III.    #200030/25 mysql down{{{1
        change VDS's rc script to log everything. to script ~herman/etc/rc.d/rc
        added:
        TIMESTAMP=`date +%Y%m%d%I%M%S`
        LOGFILE="/var/log/appl.log-$TIMESTAMP"
        and changed follows:
        $Sfile start >> $LOGFILE
        $Sfile stop >> $LOGFILE

2dec2002
The script ~herman/etc/rc.d/rc changed back to orig
At ~herman/usr/local/mysql/bin
rm safe_mysqld          // it was my program to catch signals
mv safe_mysqld2 safe_mysqld

}}}1
IV.     #300000/135 implementation APOP{{{1
--- Inro ---{{{2
APOP command is POP3 protocol optional feature even that it is fully acceptable
by POP3 protocol standard. Our implementation  should consider follows steps:
--- Steps needed for both types of VDS
1. Compilation of qpopper w/ new optoins (required to enable APOP)
2. Changing VDS installation procedure in order to initialize popd
   authentication database file
3. Changing procedure of adding new VDS user (needs to add it to
   database file)
--- Steps needed only for shared IP VDS
4. Change procedure of getting popd prompt
5. Change flow of commands for APOP connectivity
--- Open issues
a. Need to find all timeout options for APOP command
b. Need more time to try other email clients to check there compatibility
w/ APOP.

                        answers for questions

1. The only one binary of popd needed to support current configuration and APOP option
2. The initialization example: popauth -init -safe
   The update example: popauth -user <username> <password>
3. POP server should give prompt w/ special string which tells to client that APOP supported
   Base on that client sends APOP command contains username and encrypted string.
   So, we can take username and find out VDS name. In that scenario there is no need for any
   manage/cache of user unique ID.
4. NeoMail doesn't support APOP (not speaks w/ qpopper at all). Also not supported by:
   Netscape, MS Outlook express, IncrediMail
   Supported by Kmail (from KDE package) and Eudora
   Seems like APOP is too old authentication mechanism, so todays clients supports more
   sophisticated authentications.
5. Assume 4 days.
6. There is no influence on POP before SMTP
}}}2
--- Design ---{{{2
I. External source{{{3

   1. Need to recompile qpopper w/ additional options and patch (see IV.3)
        --enable-apop=/etc/pop.auth --enable-popuid=sphera_pop
   
   2. Need to change extsrc/qpopper/make/build.sh to add above options.

   3. Have to copy to the source 2 files popd, popauth.
}}}3
II. Installation procedure{{{3

x  1. Every VDS would have, by default, new system user sphera_pop. 
        Need to add to passwd and shadow files, in continuus under
        templates/vs/etc, which placed under <SD home>/vs/t_1/etc
        Linux forbides creation 2 users w/ the same name, so have to prevent it
        also (see III.1).

x  2. Every VDS would have file .qpopper-options w/ new line as follows:
        set clear-text-password=always
        Add .qpopper-options to continuus under templats/vs/etc and add to
        make/install.mak follows (seperate task #14184):
        /bin/cp ${SRC}/templates/vs/etc/.qpopper-options                \
        ${DST}/hostdir/vs/t_1/etc/.qpopper-options;                     \
        /bin/chown 1000:100 ${DST}/hostdir/vs/t_1/etc/.qpopper-options; \
        /bin/chmod 644 ${DST}/hostdir/vs/t_1/etc/.qpopper-options;      \

   3. Check that every VDS should have, by default, follows hardlinks
        to <SD home>/vs/t_1/bin/popd, to <SD home>/vs/t_1/bin/popauth and
        apop db file etc/pop.auth
}}}3
III. Manager changes{{{3

   1. Should prevent creation of VDS or VDS users w/ name sphera_pop.(Ilya)

   2. New VDS property apop_enabled="false" would shows if APOP enabled for
        current VDS. In hostdir.xml under account_template node to add
                apop_enabled="false"

   3. When add/set VDS or add/set/del user account occures needed to run
        powerscript to update apop db.
        The CAccountUtil::UpdateAPopDb() (added to manager/CAccountUtils.cc)
        calles powerscript to add/set/del users. It would do it if 
        plain_password property exists in cmd and apop_enabled=true.
        It called by follows:
                CAccountDataBase::Add_Account() directly to add VDS user.
                On error returns error, so adding VDS failes.
                CAccountDataBase::SetVUser() throw internal procedure (actualy
                calls CUserAccountDataBase::Preform() which calls Set() ) only
                if user password changed.
                The next funcs from CUserAccountDataBase. Here have to add
                apop_enabled VDS property to the cmd. It is done by
                CUserAccountDataBase::GetServer() and also for not saving
                this property at user account changed hostdir.xml under
                \\sphera\\not_saves\\user_account added apop_enabled. So
                CUserAccountDataBase::Add() on error returns exception.
                CUserAccountDataBase::Set() called if user passwd changed. On
                error returns exception.
                CUserAccountDataBase::Del() On error debug returns message.
        The CAccountUtil::DeleteAPopDb() (added to manager/CAccountUtils.cc)
        calls  powerscript to del VDS apop db. It is called only from one place
                CAccountDataBase::Set_Account() if apop_enabled changed to
                false. On error returns warning can't del apop db.

   4. Follows formatted messages added to messages/manager.msg used by III.3
        ADD_APOP_USER_FAILED = "Failed to add user to apop db" , TYPE_ERR, ST_CONFIG, ERR_ERROR;
        SET_APOP_USER_FAILED = "Failed to set user in apop db" , TYPE_ERR, ST_CONFIG, ERR_ERROR;
        DEL_APOP_USER_FAILED = "Failed to delete user in apop db" , TYPE_ERR, ST_CONFIG, ERR_ERROR;
        INIT_APOP_DB_FAILED = "Failed to initialize apop db", TYPE_ERR, ST_CONFIG, ERR_ERROR;

?  5. The GUI(Larik) should send plain password at every add/set/del of VDS or
        user account. Till 11dec02 it was nt_passwd not saved property and it
        would called plain_password. It triggers changes in hostdir.xml

x  6. The plain text password of users need to add to APOP db, so plain_password
        property will be used and shouldn't be filtered out. Changes in
        CApiDataBase::ApiSet()

x  7. The powerscript called ctlpopdb.py would get commanf from manager and run
        popauth under VDS in order to add/set/del users in apop db. The script
        named ctlpopdb.py and placed under <SD hoem>/bin/enhanced_services/
        Changes in hostdir.xml as follows:
                under server_management obj:
                        <mnt_type
                        ext_path="sphera\user_scripts\ctlpopdb"
                        gui_visible="false"
                        key="ctlpopdb"/>
                under user_scripts obj:
                        <user_script
                                key="ctlpopdb"
                                script="bin/enhanced_services/ctlpopdb.pyc"
                                template="sphera\script_template"/>

        If cmd=='add' and it is VDS, so init apop db before add VDS to it.
        If cmd=='set' and apop_cmd=='init', so only init apop db.

        1st, if apop_enabled="false", powerscript doing nothing. The PM decided
        that after changing apop_enabled="true" VDS owner should update apop db
        for exist users(11dec02).
        When apop_enabled="false" the apop db is empty, so every time openapi
        command changes apop_enable should replace VDS apop db w/ empty one.
        2nd, if apop_enabled="true", powerscript calls popauth utility to
        add/set/del users in apop db.
        The rollback send from powerscript only for add cmd. Others too
        complicated.

}}}3
IV. Sphera changes and qpopper patch{{{3

x  1. Change in Sphera POP prompt. Add unique string at run time.
        cpopproxy.cc CPopProxy::GetClientInfo()
        CStringUtils.h
        CStringUtils.cc long2str() change to able to append not only overwrite.
        cservice.cc CService::SetPrompt()

x  2. Change PopProxy commands flow where APOP command should be added.
        cpopproxy.hh static const string POP_APOP
        cpopproxy.cc in CPopProxy::GetClientInfo()
                MessageParser(user_domain, CPopProxy::POP_APOP)
        cbaseproxy.hh CBaseProxy
                AUTH_ERR
        Support of CAPA and AUTH. Will not done now, cause needed to research
        if answer will influence authentication flow.

x  3. Patch to qpopper to find env param(SPHERA_POP_STR) w/ previously created
        unique string by PopProxy and replace the original qpopper unique
        string by it.
        Change Changes.txt!!!
        popper.c
        pop_apop.c
        Bug fix: sphera_util.h strong_trim_domain() !!!take out from prj!!!!
                when VDS name contents domain name triming not workes.
                func will get delim,domain_name and will cut last found string
                delim+domain name for any VDS.
                !!!Should be notice in release
                notes Not to create regular VDSs or it's users w/ name contents
                delim+domain name string.
}}}3
V. Performance and drawbacks{{{3

   1. The APOP database size

   2. Performance of qpopper compiled w/ APOP
}}}3
VI. QA, API changes, help procedures{{{3

        APOP project API changes.

        The not saved nt_passwd property changed it's name to plain_password by
        Larik requirement. New VDS property apop_enabled w/ default value
        false. The new python script to control apop db added under
        server_management tag.
        There are changes in openapi commands. Each time not saved property
        passwd send should also be send property plain_password.
        The creation of VDS make new empty apop db and if apop_enabled equals
        true the VDS going to be added to it.
        When apop_enabled equals false nothing happened to apop db and with
        apop db actualy empty at that time gives us disabling APOP for the VDS.
        

   1. List of recommended tests for QA

        Brief instruction
                apop_enabled=true/false and change it.
                add/set/del VDS (ip based/name based)
                add/set/del user (ip based/name based)

                The APOP scenarious and where the example.
                 -----------------------------------------------
                |               |         apop_enabled          |
                |               |-------------------------------|
                |               | false | true  |    change     |
                 ---------------|-------|-------|---------------|
                |       |  add  |   B   |   J   |               |
                |  VDS  |  set  |   D   |   J   |       E       |
                |       |  del  |   D   |   J   |               |
                 -------|-------|-------|-------|---------------|
                |       |  add  |   C   |   F   |               |
                | User  |  set  |   D   |   H   |       G       |
                |       |  del  |   D   |   I   |               |
                 -----------------------------------------------

                Which email clients to use?
                The best to check w/ all APOP enable clients and at least
                those which uses client (call Yoram Goren).
                I can provide follows.
                Linux: Mozilla, Kmail
                Windows: Eudora (copy from w2k122/h/eudora5_2.exe) and 
                        Becky (copy from w2k122/h/bk20506.exe)

        A. SD installation check (all checks should be done right after 
                        SD installation)
                The apop_enabled="false" should be in hostdir.xml
                Check existing of <SD name>/vs/t_1/etc/popd,
                <SD name>/vs/t_1/etc/popauth

        B. 1st VDS creation (all checks should be done right after VDS creation)
                Check existence of <VDS>/etc/.qpopper-options w/ line
                        set clear-text-password=always
                Check existence of hardlink <VDS>/bin/popd and popauth
                Check existence of new system user named sphera_pop in
                        <VDS>/etc/passwd and <VDS>/etc/shadow
                Run in VDS context follows: popauth -list ALL
                Shouldn't get anything at all, cause no APOP db file.

        C. Add VDS user
                Add VDS user (let's name it u1). Check that it is able to get
                emails.
                Now, cause apop_enabled=false, so newly created user not in
                APOP db and it can get email only the plain way by providing
                username and password. Check that u1 can't get email by APOP.

        D. Everything when apop_enabled=false
                Till now have checked add of VDS and it's user. Check also
                set and del of VDS. The flow should be as follow
                create vds, set it password, add vds user, set vds user passwd,
                del vds user, del vds.
                At every stage have to check that any APOP email can't be
                delivered.

        E. Changing apop_enabled property.
                Our VDS (created at .B) should have apop_enabled="false". Now
                send openapi command to change apop_enabled to true (cmd:
                        cmd="set"
                        keys_path="sphera\accounts\rg1"
                        apop_enabled="true"
                )
                Create 2nd VDS and check that apop_enabled = false.
                Now, have 2 VDSs which have 
                1st - apop_enabled=true
                2nd - apop_enabled=false

        F. Add user for VDS w/ apop_enabled=true
                The newly created users would have APOP ability. Lets check it.
                Add user (let's say u2) to 1st VDS and check that it can get
                emails w/ APOP.
                So, 1st VDS have 3 users with follows apop abilities:
                vds owner can't get apop emails
                u1 can't get apop emails
                u2 can get apop emails
                
        G. Fix emails of old VDS users created when apop_enabled was false.
                There are  2 iof that kind email users for 1st VDS the VDS
                owner and u1 user. Both of them still can get email the old way
                not by APOP, cause they not in APOP db.
                They can be added by 2 ways. First, by changing user's
                password from GUI or OpenAPI; second, by explicitly adding
                user to APOP db. cmd:
                        popauth -user <username> <password>
                Add VDS owner to APOP db by changing it's (VDS owner) password
                and add u1 to APOP db by adding it (u1) from command line.
                Now, have 1st VDS apop_enabled=true w/ 3 users able to get
                emails by APOP.

        H. Changing users of 1st VDS.
                We have to check APOP functionality in add/set/del of VDS user
                commands. From .E, we did it for add of VDS user. Let's do it
                for set. Change password for u1 user and check that it still
                can get APOP email.

        I. Deleting users of 1st VDS.
                Let's check del user. Delete user u2 and check it can't get
                email anyway by APOP or by old fashion way (username/password).

        J. Special case VDS owner like email user.
                That user also should be checked for add/set/del commands.
                Cause VDS owner user created together w/ it's VDS, actualy we
                deal w/ VDS add/set/del
                The set of VDS already done by .F where VDS owner added to
                APOP db by changing it's password.
                The del of VDS. Let's del VDS and see that no email can be get.
                In order to check add VDS needs that newly created VDS have
                apop_enabled=true, but by default it is false. Lets stop HD
                and change under account_template property apop_enabled to
                true.Now start HD and create our 3rd VDS. It should be already
                apop_enabled=true and VDS owner can have emails by APOP. Also
                can see VDS owner in APOP db by running cmd:
                        popauth -list ALL

   2. Checking w/ real client of customer. Which client used? (Yoram)

   3. Create help for customer
}}}3
VII. Open issues{{{3

   1. APOP db keeps passwords as plain text. Security problem? Can be prevent
        by common solution of creation password storage.

   2. APOP support in Windows application.

   3. The unique string created by Sphera for name-based VDS case doesn't have
        hostname.

   4. Who will run popauth root w/ chroot or VDS owner?
        If root, so VDS owner can't change db from cmdline, otherwise if VDS
        owner, so he can add itself to the apop db even apop_enabled='false'
        and qpopper would works w/ APOP.

   5. Should popauth be hardlink or not? (change at VI.1.B)
}}}3
}}}2
}}}1
V.      #100056/3 VDS username contents domain name{{{1
        Problem found in patch function strong_trim_domain() (sphera_util.h)
        where scenario username contents(|equals) domain name causing bug.

        Solution:{{{2
void strong_trim_domain (POP * p, char * q) {
  char  vdsName[MAXHOSTNAMELEN * 2];  /* To cover the cases of white spaces */
  char *tmp=NULL,*tmp1, *tkn; 
  int   fd, nLen;

  fd = open("/etc/nodename", O_RDONLY);
  if (fd<0)
    return;
  
  nLen = read(fd,vdsName,MAXHOSTNAMELEN * 2 - 1);
  close(fd);
  
  if (nLen <= 0)
    return ;
  
  tmp1 = strtok(vdsName," \t\n");
  if (!tmp1)
    return;
  
  if (strlen(tmp1) <= 0)
    return;

  tkn = strstr(q,tmp1);
  while(tkn != NULL) {    
    tmp = tkn;
    tmp++;
    tkn = strstr(tmp, tmp1);
    pop_log(p, POP_WARNING, HERE, "tmp trim: %s", tkn);
  }

  if (tmp != NULL)
    tmp--;
  else //There is nothing to takeof
    return;

  if (tmp == q)
    return;
 
  tmp--;
  if (tmp == q)
    return;
 
  //We need to take of the vdsname from the name
  *tmp = '\0';
}//}}}2

}}}1
VI.     Backup project{{{1

A. Theory{{{2
        from www.legato.com
        LEGATO NetWorker protects the critical business data by backup and
        recovery operations across Unix, Windows, Linux and NetWare platforms
        in DAS, NAS(Network Attached Storage), and SAN storage environments.
        With NetWorker Network Data Management Protocol (NDMP) Client
        Connection, Legato offers unparalleled protection for data stored on
        NDMP-based Network Attached Storage (NAS) devices. Backup and restore
        using the NDMP protocol is fast and reduces network traffic on a LAN or
        WAN. With the NetWorker architecture, one can enable a tape library to
        be shared among NetWorker Servers, Storage Nodes and NDMP-enabled NAS
        devices for simple, centralized media management.
        More about NDMP protocol www.ndmp.org

        How to backup w/ Legato?{{{3
                A. Starting nwadmin on backup server machine
                        run 'xhost +' on linux machine
                        login to backup server as root
                        run 'nwadmin -display<ip of linux machine:0> &'
                B. Create group of clients
                        1. from menu Customize->Groups
                        2. push create
                        3. fill name
                C. Create device
                        1. from menu Media->Devices
                        2. push create
                        3. fill Name(like /export/home/file1), Media type(file)
                        4. push Apply
                D. Create label templates
                        1. from menu  Customize->Label Templates
                        2. push create
                        3. fill Name, Fields ( like 000-999)
                        4. push Apply
                E. Create pool
                        1. from menu Media->Pools
                        2. push create
                        3. fill Name, Type (like backup), Label Template(choose
                                previously created), Levels(unchecked)
                        4. push Apply
                F. Create Schedule
                        1. from menu open Customize->Schedules
                        2. push create
                        3. fill Name
                        4. push everyday and change to full
                        5. push Apply
                G. Create client
                        1. from menu open Client->Client Setup
                        2. window Clients opened. Push Create button
                        3. add Name, Schedule (previously created), Directive
                        (Unix with compression directive)
                        4. choose group (one of them previously created)
                        5. fill save set (/export/home/tmp_bck and push add)
                        6. push Apply
                H. Do it
                        1. push Label button
                        2. fill Pool(anyway push)
                        3. actualy mounted, so push GroupControl button
                        4. window "Group Control" opened.
                        5. button preview doing dry-run
                        6. button start actualy starts backup
        }}}3
        How to recover w/ Legato{{{3
                1st way (GUI):
                backup device should be mounted
                run nwrecover as root
                2nd way (CmdLine):
                recover -d <dest> -c <client machine> -s <server name>
                -i[N|Y|R] <path to dir>
        }}}3
}}}2

B. Sphera backup project{{{2
        PRD{{{3
        Introduction{{{4
                Product Overview
                        This feature is procedure which provides full description
                        how to backup/restore HD. The main idea is to provide
                        ability to backup HD and to restore it at fully working
                        status.
                Reference
                        ------------------------------------------------------
                        | Title         |       Date(ver.)      |   Author   |
                        ------------------------------------------------------
                        |               |                       |            |
        }}}4
        Product Functionality{{{4
                Major Functionalities - List
                        Backup/Restore procedure of ServerDirector
                Specific Functionality Specifications
                        The Backup/Restore procedure can be devided in follow
                        steps: pre-backup, backup, restore, post-restore.
                        The pre-backup step. Stop HD, named, crond and run
                        pre-backup script to save info about HD's rpm installed.
                        The backup step. Here, with file list provided,
                        client can actualy to backup HD by any utility in his
                        possession.
                        The restore step. In similar w/ backup step, client
                        doing restore of HD.
                        The post-restore step. Here needed to run utility,
                        provided by Sphera that doing two things. Fixes hardlinks
                        and restore records in rpm db of computer. HD can be
                        started from this point.
        }}}4
        Design Constrains{{{4
                The only backup/restore that can't be done is when doing backup
                w/ Legato utility to HD w/ Legato PSP. There is mismatch of
                Legato versions where Legato PSP is 6.0.1 and Legato utility
                should be at least 6.1.2
        }}}4
        Assumptions & Dependencies{{{4
                The only assumption exists that backup would be after HD stoped.
        }}}4

        A. question about technology{{{4
                1. There are files that HD changes during it's lifetime.{{{5
                What to do at restore time to
                overwrite or to fix those files?
                Decided to overwrite files.(12nov2002)
                }}}5
                2. How to backup shared plugins?{{{5
                Have to backup/restore only HD or HD+shared plugins?
                Will create file lists to backup separatly for HD and each of
                shared plugins. Customer should check what to backup.
                (wishlist) Warning if doing backup w/o any of existing parts
                of HD (if doing backup only to HD in spite of installed PSP).
                }}}5
                3. The backup file list of HD w/o PSP{{{5
                        <HD dir>
                        <Accounts dir> if not under <HD dir>
                        <Reseller dir> if not under <HD dir>
                        /etc/rc.d/
                        /var/spool/cron/ 
                        /etc/sphera.netconf
                        /etc/sphera.conf
                        /etc/sphera.repository
                                (slink to <Accounts dir>/.repository)
                        /etc/passwd
                        /etc/shadow
                        /etc/group
                        /etc/aliases
                        /etc/aliases.db
                        /etc/fstab
                        /etc/hosts
                        /etc/shells
                        /usr/bin/sphadmin (not on Sun)
                        /etc/xinetd.d/
                        /etc/inetd.conf
                        /etc/syslog.conf
                        /etc/sysconfig/iptables
                        /etc/localtime
                        /etc/timezone
                        /etc/sysconfig/clock
                        /bin/nawk
                        aquota.user (one per filesystem)
                        <sphera base mirror> (one per filesystem)
                }}}5
                4. The backup file list of PSPs{{{5
                        ChiliSoft
                                /opt/casp
                                /usr/opt/casp
                                /usr/local/casp
                        OpenSSH
                                /usr/local/openssh_sphera
                        RealServer
                                <sphera base>
                        SharedSSL
                                <sphera base>
                        ColdFusion[MX]
                                /opt/coldfusion[mx]
                                /usr/lib/coldfusion
                        Legato
                                /usr/bin/networker
                                /usr/bin/nsrfile
                                /usr/bin/nsrports
                                /usr/bin/nsrwatch
                                /usr/bin/nwadmin
                                /usr/bin/nwarchive
                                /usr/bin/nwbackup
                                /usr/bin/nwrecover
                                /usr/bin/nwretrieve
                                /usr/bin/preclntsave
                                /usr/bin/pstclntsave
                                /usr/bin/recover
                                /usr/bin/save
                                /usr/bin/savepnpc
                                /usr/lib/X11/app-defaults/Networker
                                /usr/lib/nsr/C/nsr.help
                                /usr/lib/nsr/de_de/nsr.help
                                /usr/lib/nsr/gls/cm/registry
                                /usr/lib/nsr/gls/lc/os/portable/C
                                /usr/lib/nsr/poin.cln
                                /usr/lib/nsr/product.res
                                /usr/lib/nsr/prrm.cln
                                /usr/lib/nsr/uasm
                                /usr/sbin/mminfo
                                /usr/sbin/mmlocate
                                /usr/sbin/mmpool
                                /usr/sbin/nsr_shutdown
                                /usr/sbin/nsr_support
                                /usr/sbin/nsradmin
                                /usr/sbin/nsralist
                                /usr/sbin/nsrarchive
                                /usr/sbin/nsrclone
                                /usr/sbin/nsrdmpix
                                /usr/sbin/nsrexec
                                /usr/sbin/nsrexecd
                                /usr/sbin/nsrinfo
                                /usr/sbin/nsrmm
                                /usr/sbin/nsrndmp_2fh
                                /usr/sbin/nsrndmp_recover
                                /usr/sbin/nsrndmp_save
                                /usr/sbin/nsrretrieve
                                /usr/sbin/nsrsup
                                /usr/sbin/preclntsave
                                /usr/sbin/pstclntsave
                                /usr/sbin/save
                                /usr/sbin/savefs
                                /usr/sbin/savepnpc
                                /legatoinfo
                                /etc/rc.d/init.d/networker
                }}}5
        5. Legato client{{{5
        Not possible to install Legato client twice on the same comp. So cause
        the version of Legato provided as PSP is 6.0.1 but version of Legato
        for backup project 6.1.2 can't check backup/restore procedure for HD +
        Legato PSP.
        Solution: to mention in release notes.
        }}}5
                6. How to backup RPM files of HD and UPs?{{{5
                The HD and UPs installed like RPM file w/ record in rpm db of
                the machine. So after restore there were no records about
                previously installations. Can't keep installed rpms, too big.

                Solution A: will keep all SPEC files of any Sphera rpm in order
                to find before backup which rpm installed and to create after
                restore those rpm (w/o files) in order to install them.
                To create rpm run
                        rpm -bb <file>
                per each rpm. This solution creates rpm db records which differ
                from original at follows: Install date,Build Date,Build Host.

                Solution B: To query rpm db with params which creates output to
                create SPEC file. After as previous solution. Follows the rpm
                queryformat to get all tags:
                rpm -q --queryformat "Name: %{NAME}\nSummary: %{SUMMARY}\n\
                Version: %{VERSION}\nRelease: %{RELEASE}\nVendor: %{VENDOR}\n\
                Group: %{GROUP}\nCopyright: %{COPYRIGHT}\nBuildroot: \
                %{BUILDROOT}" $pckg_name

                Decided to use solution B.(21nov2002)
                ~integ/3.5/build
                }}}5
                7. Files common used by Sphera, Dns and Master?{{{5
                There r files used by all (or >1) Sphera applications. They
                create problematic scenatious if installed on the same machine:
                install Sphera, DNS, Master on the same comp. They r editing
                files sphadmin or /etc/sphera.conf (may be more files). If to
                do backup, later to uninstall anyone of application and right
                after to do restore, so commonly used files will be rong state.
                }}}5
        8. How to fix hardlinks?{{{5
        If there is problem w/ hardlinks after restore fix needed.
        Solution(see cmn.txt): already exist script hardlinks_manager.pyc (ask Vitaly) that going
        throw lists of files (placed <sphera>/home/<vds name>), which content hardlinks
        of VDS.
        }}}5
        }}}4
        B. questions about backup tools{{{4
                1. Which backup tools to consider?
                PM wants Legato (www.legato.com) and Veritas tools.
                2. Does backup tool accept file list?
                Legato do.
                Veritas?
                3. Does backup tool restore links?
                Legato do.
                Veritas?
                4. Backup/restore w/ files in use.
                Legato do.
                Veritas?
                5. How to run something before backup and after restore?
                Legato?
                Veritas?
                6. Behaviour when backup target not exist?
                Legato. Sends message.
                Veritas?
                7. Restore link when original file not exist?
                Legato?
                Veritas?
        }}}4

        Procedure
                The Backup/Restore procedure is devided in follows
                steps: pre-backup, backup, restore, post-restore.

                I. The pre-backup step.
                1. stopping HostDirector
                Here, should run sphadmin utility w/ root permitions.
                It will bring up menu where to choose option:
                        11 - HostingDirector - Stop
                2. stopping named utility
                Run /etc/rc.d/rc2.d/S99Snamed_hd stop w/ root permitions.
                3. stopping cron
                Run /etc/rc.d/init.d/crond stop w/ root permitions.
                4. save additional information.
                Needed to run 
                        <HD place>/bin/backup.sh -p
                which creates specification files of HD's RPMs in
                <HD place>/backup/specs This step also to do w/ root
                permitions.

                II. The backup step.
                Here, with file list provided below, client can actualy 
                to backup HD by any utility in his possession.
                The HD common files required to backup:
                        <HD base>
                        <Accounts dir> - if not under <HD base>
                        <Reseller dir> - if not under <HD base>
                        <HD base mirror> - in each partition where placed
                                        accounts if not under <HD base>
                        aquota.user - in each partition where placed
                                        accounts if not under <HD base>
                        /etc/rc.d/
                        /var/spool/cron/ 
                        /etc/sphera.netconf
                        /etc/sphera.conf
                        /etc/sphera.repository
                        /etc/passwd
                        /etc/shadow
                        /etc/group
                        /etc/aliases
                        /etc/aliases.db
                        /etc/fstab
                        /etc/hosts
                        /etc/shells
                        /usr/bin/sphadmin
                        /etc/xinetd.d/
                        /etc/inetd.conf
                        /etc/syslog.conf
                        /etc/sysconfig/iptables
                        /etc/localtime
                        /etc/timezone
                        /etc/sysconfig/clock
                        /bin/nawk
                Files needed to backup ChiliSoft PSP:
                        /opt/casp
                        /usr/opt/casp
                        /usr/local/casp
                Files needed to backup OpenSSH PSP:
                        /usr/local/openssh_sphera
                Files needed to backup ColdFusion PSP:
                                /opt/coldfusion
                                /usr/lib/coldfusion
                Files needed to backup ColdFusionMX PSP:
                                /opt/coldfusionmx
                                /usr/lib/coldfusion
                Files needed to backup Legato PSP:
                                /usr/bin/networker
                                /usr/bin/nsrfile
                                /usr/bin/nsrports
                                /usr/bin/nsrwatch
                                /usr/bin/nwadmin
                                /usr/bin/nwarchive
                                /usr/bin/nwbackup
                                /usr/bin/nwrecover
                                /usr/bin/nwretrieve
                                /usr/bin/preclntsave
                                /usr/bin/pstclntsave
                                /usr/bin/recover
                                /usr/bin/save
                                /usr/bin/savepnpc
                                /usr/lib/X11/app-defaults/Networker
                                /usr/lib/nsr/C/nsr.help
                                /usr/lib/nsr/de_de/nsr.help
                                /usr/lib/nsr/gls/cm/registry
                                /usr/lib/nsr/gls/lc/os/portable/C
                                /usr/lib/nsr/poin.cln
                                /usr/lib/nsr/product.res
                                /usr/lib/nsr/prrm.cln
                                /usr/lib/nsr/uasm
                                /usr/sbin/mminfo
                                /usr/sbin/mmlocate
                                /usr/sbin/mmpool
                                /usr/sbin/nsr_shutdown
                                /usr/sbin/nsr_support
                                /usr/sbin/nsradmin
                                /usr/sbin/nsralist
                                /usr/sbin/nsrarchive
                                /usr/sbin/nsrclone
                                /usr/sbin/nsrdmpix
                                /usr/sbin/nsrexec
                                /usr/sbin/nsrexecd
                                /usr/sbin/nsrinfo
                                /usr/sbin/nsrmm
                                /usr/sbin/nsrndmp_2fh
                                /usr/sbin/nsrndmp_recover
                                /usr/sbin/nsrndmp_save
                                /usr/sbin/nsrretrieve
                                /usr/sbin/nsrsup
                                /usr/sbin/preclntsave
                                /usr/sbin/pstclntsave
                                /usr/sbin/save
                                /usr/sbin/savefs
                                /usr/sbin/savepnpc
                                /legatoinfo
                                /etc/rc.d/init.d/networker

                III. The restore step.
                In similar w/ backup step, client doing restore of HD
                w/ utility in his possession.

                IV. The post-restore step.
                1. Here, have to run utility for checking and fixing if needed,
                restored data. The utility also run under root permissions:
                        <HD base>/plugins/bin/Spython <HD base>/bin/enhanced_services/hardlinks_manager.pyc cmd=set keys_path=sphera\\hardlinks
                It is checking for broken hardlinks and fix it. The result should look like:
                        <API>
                                <RESPONSE
                                        cmd_id="1"
                                        result="OK" />
                        </API>
                2. Restore additional information from pre-backup step.
                Also to run w/ root permission follows
                        <HD base>/bin/backup.sh -r
                This utility will restore HD's rpm registrations.

        }}}3
        Status{{{3
        2d      learning legato (12nov,13nov)
        1d      how to intervent in backup process.
        2d      integration
        5d      tests
        /etc/rc.d/rc2.d/S99Snamed_hd stop
        /etc/rc.d/init.d/crond stop
        }}}3
        QA procedure{{{3
        }}}3
}}}2

C. VDS backup project{{{2
        PRD{{{3
        Introduction{{{4
                Product Overview
                        Product Scope & Definition
                        Product Perspective
                Reference
                        ------------------------------------------------------
                        | Title         |       Date(ver.)      |   Author   |
                        ------------------------------------------------------
                        |               |                       |            |
                Definitions & Acronyms
        }}}4
        Product Functionality{{{4
                Major Functionalities - List
                Specific Functionality Specifications
                Database Specifications
                Future - List
        }}}4
        External Interfaces{{{4
                User Interface - Concept
                Hardware Interface
                System/Software Interface
        }}}4
        Design Constrains{{{4
        }}}4
        Assumptions & Dependencies{{{4
        }}}4
        Performance{{{4
                Static
                Dynamic
        }}}4
        Attributes{{{4
                1.Reliability
                2.Availability
                3.Security
                4.Maintainability
                5.Portability
                6.Scalability
                7.Usefulness & Friendliness
        }}}4
        Appendixes{{{4
        }}}4
                Ability to backup HD files to be able to restore HD at fully
                working status. To create procedure of backup/restore list of
                files and directories with number of widely used backup tools.
        A. question about technology{{{4
                1. There are files that HD changes during it's lifetime which
                should be backup/restore. What to do at restore time to
                overwrite or to fix those files?
                Decided to overwrite files.(12nov2002)
                2. How to backup shared plugins? Have to backup/restore only
                HD or HD+shared plugins?
                Will create file lists to backup separatly for HD and each of
                shared plugins. Customer should check what to backup.
                (wishlist) Warning if doing backup w/o any of existing parts
                of HD (if doing backup only to HD in spite of installed PSP).
                3. The backup file list of HD w/o PSP{{{5
                        <HD dir>
                        <Accounts dir> if not under <HD dir>
                        <Reseller dir> if not under <HD dir>
                        /etc/rc.d/
                        /var/spool/cron/ 
                        /etc/sphera.netconf
                        /etc/sphera.conf
                        /etc/sphera.repository
                                (slink to <Accounts dir>/.repository)
                        /etc/passwd
                        /etc/shadow
                        /etc/group
                        /etc/aliases
                        /etc/aliases.db
                        /etc/fstab
                        /etc/hosts
                        /etc/shells
                        /usr/bin/sphadmin (not on Sun)
                        /etc/xinetd.d/
                        /etc/inetd.conf
                        /etc/syslog.conf
                        /etc/sysconfig/iptables
                        /etc/localtime
                        /etc/timezone
                        /etc/sysconfig/clock
                }}}5
                4. The backup file list of PSPs{{{5
                        ColdFusion
                                /opt/coldfusion
                                /opt/coldfusionmx
                                /usr/lib/coldfusion
                        ChiliSoft
                                /opt/casp
                                /usr/opt/casp
                                /usr/local/casp
                        OpenSSh
                                /usr/local/openssh_sphera
                        Legato
                                /usr/bin/networker
                                /usr/bin/nsrfile
                                /usr/bin/nsrports
                                /usr/bin/nsrwatch
                                /usr/bin/nwadmin
                                /usr/bin/nwarchive
                                /usr/bin/nwbackup
                                /usr/bin/nwrecover
                                /usr/bin/nwretrieve
                                /usr/bin/preclntsave
                                /usr/bin/pstclntsave
                                /usr/bin/recover
                                /usr/bin/save
                                /usr/bin/savepnpc
                                /usr/lib/X11/app-defaults/Networker
                                /usr/lib/nsr/C/nsr.help
                                /usr/lib/nsr/de_de/nsr.help
                                /usr/lib/nsr/gls/cm/registry
                                /usr/lib/nsr/gls/lc/os/portable/C
                                /usr/lib/nsr/poin.cln
                                /usr/lib/nsr/product.res
                                /usr/lib/nsr/prrm.cln
                                /usr/lib/nsr/uasm
                                /usr/sbin/mminfo
                                /usr/sbin/mmlocate
                                /usr/sbin/mmpool
                                /usr/sbin/nsr_shutdown
                                /usr/sbin/nsr_support
                                /usr/sbin/nsradmin
                                /usr/sbin/nsralist
                                /usr/sbin/nsrarchive
                                /usr/sbin/nsrclone
                                /usr/sbin/nsrdmpix
                                /usr/sbin/nsrexec
                                /usr/sbin/nsrexecd
                                /usr/sbin/nsrinfo
                                /usr/sbin/nsrmm
                                /usr/sbin/nsrndmp_2fh
                                /usr/sbin/nsrndmp_recover
                                /usr/sbin/nsrndmp_save
                                /usr/sbin/nsrretrieve
                                /usr/sbin/nsrsup
                                /usr/sbin/preclntsave
                                /usr/sbin/pstclntsave
                                /usr/sbin/save
                                /usr/sbin/savefs
                                /usr/sbin/savepnpc
                                /legatoinfo
                                /etc/rc.d/init.d/networker
                }}}5
                5. There are UPs installed w/ rpm registration?{{{5
                Most likely to scan rpmdb before backup and to do registrations
                after restore. So needed ability to run scripts during backup/
                restore process (look B5)
                }}}5
        }}}4
        B. questions about backup tools{{{4
                1. Which backup tools to consider?
                PM wants Legato (www.legato.com) and Veritas tools.
                2. Does backup tool accept file list?
                Legato do.
                Veritas?
                3. Does backup tool restore links?
                Legato do.
                Veritas?
                4. Backup/restore w/ files in use.
                Legato do.
                Veritas?
                5. How to run something before backup and after restore?
                Legato?
                Veritas?
                6. Behaviour when backup target not exist?
                Legato. Sends message.
                Veritas?
                7. Restore link when original file not exist?
                Legato?
                Veritas?
        }}}4
        }}}3
        Requirements{{{3
                Ability to backup/restore all VDS files. Actualy backup/restore
                of user files already exists, so needs to split VDS backup in
                2 kinds like system and user. VDS owner should do start backup.
                There is question about backup/restore files w/ root (non
                VDS owner) ownership. 2 solutions.
                a. VDS call API procedure that run some script w/ root permi
                   ssions (SETUID server)
                b. The procedure permited only for Sphera admin.
                Next qestion where to store backup file?
                a. user place (quota problem)
                b. Sphera admin place (manage backup places+tape backup)
                c.
        }}}3
        Status{{{3
                Leon to speak about current VDS backup.
                VDS filelist to backup.
        }}}3
}}}2

}}}1
VII.    tomcat{{{1

install rpm under VDS{{{2
cd ~VDS
cp -p /bin/rpm ./bin/.
tar cvf - /usr/lib/rpm | tar xvf -
tar cvf - /usr/lib/librpm* | tar xvf -
tar cvf - /usr/lib/libbz2.* | tar xvf -
tar cvf - /usr/lib/libpopt.* | tar xvf -
(if not exists mkdir ./var/lib)
tar cvf - /var/lib/rpm | tar xvf -
tar cvf - /dev/shm/ | tar xvf -
(if not exists mkdir sbin)
cp -p /sbin/install-info ./sbin/.
cp -p /sbin/ldconfig ./sbin/.
cp -p /bin/egrep ./bin/.
cp -p /sbin/chkconfig sbin/
cp /usr/sbin/userdel usr/sbin/
cp /usr/sbin/useradd usr/sbin/
(cp rpm to ~VDS)
chroot <VDS path> /bin/sh
rpm -ivh --force <rpm name>

}}}2

edit    /usr/local/apache/conf/httpd.conf
        /usr/local/apache/conf/workers.properties
        /var/tomcat4/conf/tomcat4.conf
        /var/tomcat4/conf/server.xml
from httpd.conf
LoadModule jk_module libexec/mod_jk.so
<IfModule mod_jk.c>
    JkWorkersFile conf/workers.properties
    JkLogFile logs/mod_jk.log
    JkLogLevel debug
    JkLogStampFormat "[%a %b %d %H:%M:%S %Y] "
    JkMount /examples/servlet/* worker1
    JkMount /*.jsp worker2
    JkOptions +ForwardURICompat
</IfModule>

/export/home/hostdir/plugins/bin/Spython /export/home/hostdir/plugins/bin/InstallManager.pyc "/export/home/hostdir/accounts/deri11.devsphera.com/www/htdocs/plugins/Tomcat/installed" "/export/home/hostdir/plugins/packages/Tomcat" "/export/home/hostdir/accounts/deri11.devsphera.com" "/export/home/hostdir/accounts/deri" "_plugin_VDS_GROUP=101" "_plugin_VDS_MODE=standard" "_plugin_VDS_NAME=v2" "_plugin_install=installed" "_plugin_name=installed" "_plugin_status=installed"

Tomcat VA installation procedure{{{2
        What should be done to install?

        cp mod_jk.so to /usr/local/apache/libexec/
        cp workers.properties to /usr/local/apache/conf/
        add newline to /usr/local/apache/conf/httpd.conf
        Include conf/mod_jk.conf
        cp mod_jk.conf to /usr/local/apache/conf/
        edit /usr/local/apache/conf/mod_jk.conf
        should have follows lines
LoadModule jk_module libexec/mod_jk.so
<IfModule mod_jk.c>
    JkWorkersFile conf/workers.properties
    JkLogFile logs/mod_jk.log
    JkLogLevel debug

    JkMount /*.jsp worker1
    JkMount /examples/* worker1

#    JkLogStampFormat "[%a %b %d %H:%M:%S %Y] "
#    JkOptions +ForwardKeySize +ForwardURICompat -ForwardDirectories
#    JkRequestLogFormat "%w %V %T"
#    JkMount /*/servlet/ worker2
#    JkOptions +ForwardURICompat
</IfModule>
        add to /var/tomcat4/conf/tomcat4.conf follows
JAVA_HOME="/usr/java/j2sdk1.4.1_01"
        edit /etc/rc.d/init.d/tomcat4
        remark  su - $TOMCAT_USER -c "$TOMCAT_SCRIPT stop"
        add follows
cd /var/tomcat4
$TOMCAT_SCRIPT <start|stop>

        Prepare to Sphera installation?
        Create dir named Tomcat under <HD base>/plugins/packages

        File ownership and permissions?
        <VDS owner>     755     /var/tomcat4
        <root>          755     |- bin
        <VDS owner>     755     |- common
        <VDS owner>     775     |- (conf->) /etc/tomcat4
        <VDS owner>     755     |- (logs->) /var/log/tomcat4
        <root>          755     |- server
        <root>          755        |- lib
        <VDS owner>     755     |- shared
        <VDS owner>     775     |- (temp->) /var/cache/tomcat4/temp
        <VDS owner>     770     |- webapps
        <VDS owner>     775     |- (work->) /var/cache/tomcat4/work
        <VDS owner>     755     /var/lock/subsys

        Sizes ?
        Size of /var/tomcat4 4748 kB

        Tomcat installation
        copy jdk files
rpm2cpio <jdk rpm> | cpio -i --make-directories
        copy tomcat files
rpm2cpio <tomcat4-4.1.18-full.1jpp.noarch.rpm> | cpio -i --make-directories
        edit server.xml
        add address of VDS to connector
}}}2    

Tomcat PSP installation{{{2

install jdk and Tomcat rpm files on machine
add to server.xml before localhost
      <Host name="www.deri2.devsphera.com" appBase="vds/deri2.devsphera.com">
        <Context path="" docBase="/" debug="1"/>
      </Host>
mkdir /var/tomcat4/vds
cd /var/tomcat4/vds
ln -s /export/home/hostdir/accounts/deri2.devsphera.com/usr/local/apache/htdocs/ deri2.devsphera.com
under ~rg2/usr/local/apache/conf place workers.properties like in VA.
change http.conf as in VA.
}}}2

Performance tests{{{2


Size of rpms: jdk,tomcat(+admin+webapps),mod_jk = ~47M
VDS size = ~128M
VDS size w/ installation = ~372

Regular tomcat installation on deri under ip based VDS with command
ab -n 100 -c 20 http://www.deri4.devsphera.com/examples/jsp/dates/date.jsp

without Java runtime options{{{3

Server Software:        Apache/1.3.26                                      
Server Hostname:        www.deri4.devsphera.com
Server Port:            80
Document Path:          /examples/jsp/dates/date.jsp
Document Length:        421 bytes

Concurrency Level:      20
Time taken for tests:   1.440 seconds
Complete requests:      100
Failed requests:        0
Broken pipe errors:     0
Total transferred:      58700 bytes
HTML transferred:       42100 bytes
Requests per second:    69.44 [#/sec] (mean)
Time per request:       288.00 [ms] (mean)
Time per request:       14.40 [ms] (mean, across all concurrent requests)
Transfer rate:          40.76 [Kbytes/sec] received

Connnection Times (ms)
              min  mean[+/-sd] median   max
Connect:        0     0    0.3      0     4
Processing:    12   265   98.4    285   436
Waiting:       11   265   98.5    285   436
Total:         12   265   98.5    285   436
Percentage of the requests served within a certain time (ms)
  50%    285
  66%    319
  75%    326
  80%    356
  90%    405
  95%    418
  98%    433
  99%    435
 100%    436 (last request)
}}}3
with JAVA_OPTS="-Xms1m"{{{3
Server Software:        Apache/1.3.26                                      
Server Hostname:        www.deri4.devsphera.com
Server Port:            80

Document Path:          /examples/jsp/dates/date.jsp
Document Length:        421 bytes

Concurrency Level:      20
Time taken for tests:   2.093 seconds
Complete requests:      100
Failed requests:        0
Broken pipe errors:     0
Total transferred:      58700 bytes
HTML transferred:       42100 bytes
Requests per second:    47.78 [#/sec] (mean)
Time per request:       418.60 [ms] (mean)
Time per request:       20.93 [ms] (mean, across all concurrent requests)
Transfer rate:          28.05 [Kbytes/sec] received

Connnection Times (ms)
              min  mean[+/-sd] median   max
Connect:        0     0    0.2      0     2
Processing:   192   397  229.5    303   986
Waiting:      192   397  229.7    303   986
Total:        192   397  229.6    303   986

Percentage of the requests served within a certain time (ms)
  50%    303
  66%    312
  75%    326
  80%    654
  90%    858
  95%    916
  98%    965
  99%    981
 100%    986 (last request)
}}}3
with JAVA_OPTS="-Xms1m -Xss120K"{{{3
Server Software:        Apache/1.3.26                                      
Server Hostname:        www.deri4.devsphera.com
Server Port:            80

Document Path:          /examples/jsp/dates/date.jsp
Document Length:        421 bytes

Concurrency Level:      20
Time taken for tests:   2.061 seconds
Complete requests:      100
Failed requests:        0
Broken pipe errors:     0
Total transferred:      58700 bytes
HTML transferred:       42100 bytes
Requests per second:    48.52 [#/sec] (mean)
Time per request:       412.20 [ms] (mean)
Time per request:       20.61 [ms] (mean, across all concurrent requests)
Transfer rate:          28.48 [Kbytes/sec] received

Connnection Times (ms)
              min  mean[+/-sd] median   max
Connect:        0     0    0.6      0     7
Processing:   155   326  225.5    258   947
Waiting:      154   325  225.4    258   947
Total:        155   326  225.5    258   947

Percentage of the requests served within a certain time (ms)
  50%    258
  66%    284
  75%    302
  80%    376
  90%    783
  95%    881
  98%    931
  99%    934
 100%    947 (last request)
}}}3
with JAVA_OPTS="-Xss120K"{{{3
Server Software:        Apache/1.3.26                                      
Server Hostname:        www.deri4.devsphera.com
Server Port:            80

Document Path:          /examples/jsp/dates/date.jsp
Document Length:        421 bytes

Concurrency Level:      20
Time taken for tests:   1.666 seconds
Complete requests:      100
Failed requests:        0
Broken pipe errors:     0
Total transferred:      58700 bytes
HTML transferred:       42100 bytes
Requests per second:    60.02 [#/sec] (mean)
Time per request:       333.20 [ms] (mean)
Time per request:       16.66 [ms] (mean, across all concurrent requests)
Transfer rate:          35.23 [Kbytes/sec] received

Connnection Times (ms)
              min  mean[+/-sd] median   max
Connect:        0     0    0.2      0     2
Processing:   188   312  131.3    288   684
Waiting:      188   312  131.2    288   683
Total:        188   312  131.3    288   684

Percentage of the requests served within a certain time (ms)
  50%    288
  66%    316
  75%    339
  80%    389
  90%    553
  95%    603
  98%    662
  99%    678
 100%    684 (last request)
}}}3

Two VDSs w/ tomcats. Initial RSS for each is 28M

call 1 VDS{{{3
./ab -n 100 -c 5 http://www.deri4.devsphera.com/examples/jsp/jsptoserv/jsptoservlet.jspi 
Server Software:        Apache/1.3.26                                      
Server Hostname:        www.deri4.devsphera.com
Server Port:            80

Document Path:          /examples/jsp/jsptoserv/jsptoservlet.jspi
Document Length:        782 bytes

Concurrency Level:      5
Time taken for tests:   1.096 seconds
Complete requests:      100
Failed requests:        60
   (Connect: 0, Length: 60, Exceptions: 0)
Broken pipe errors:     0
Non-2xx responses:      100
Total transferred:      87440 bytes
HTML transferred:       68360 bytes
Requests per second:    91.24 [#/sec] (mean)
Time per request:       54.80 [ms] (mean)
Time per request:       10.96 [ms] (mean, across all concurrent requests)
Transfer rate:          79.78 [Kbytes/sec] received

Connnection Times (ms)
              min  mean[+/-sd] median   max
Connect:        0     0    0.3      0     3
Processing:    11    53   44.3     38   185
Waiting:       11    53   44.3     38   184
Total:         11    53   44.3     38   185

Percentage of the requests served within a certain time (ms)
  50%     38
  66%     56
  75%     89
  80%     93
  90%    119
  95%    138
  98%    171
  99%    179
 100%    185 (last request)
}}}3
call 2 VDSs{{{3
./ab -n 100 -c 5 http://www.deri4.devsphera.com/examples/jsp/jsptoserv/jsptoservlet.jspi &
./ab -n 100 -c 5 http://www.deri5.devsphera.com/examples/jsp/jsptoserv/jsptoservlet.jsp &

Server Hostname:        www.deri4.devsphera.com
Server Port:            80

Document Path:          /examples/jsp/jsptoserv/jsptoservlet.jspi
Document Length:        782 bytes

Concurrency Level:      5
Time taken for tests:   1.508 seconds
Complete requests:      100
Failed requests:        42
   (Connect: 0, Length: 42, Exceptions: 0)
Broken pipe errors:     0
Non-2xx responses:      100
Total transferred:      90608 bytes
HTML transferred:       71312 bytes
Requests per second:    66.31 [#/sec] (mean)
Time per request:       75.40 [ms] (mean)
Time per request:       15.08 [ms] (mean, across all concurrent requests)
Transfer rate:          60.08 [Kbytes/sec] received

Connnection Times (ms)
              min  mean[+/-sd] median   max
Connect:        0     0    1.6      0    11
Processing:    13    73   51.2     61   275
Waiting:       13    73   51.2     61   275
Total:         13    73   51.1     62   275

Percentage of the requests served within a certain time (ms)
  50%     62
  66%     74
  75%     85
  80%     98
  90%    129
  95%    184
  98%    248
  99%    273
 100%    275 (last request)

Server Hostname:        www.deri5.devsphera.com
Server Port:            80

Document Path:          /examples/jsp/jsptoserv/jsptoservlet.jsp
Document Length:        183 bytes

Concurrency Level:      5
Time taken for tests:   1.774 seconds
Complete requests:      100
Failed requests:        43
   (Connect: 0, Length: 43, Exceptions: 0)
Broken pipe errors:     0
Non-2xx responses:      43
Total transferred:      58569 bytes
HTML transferred:       37005 bytes
Requests per second:    56.37 [#/sec] (mean)
Time per request:       88.70 [ms] (mean)
Time per request:       17.74 [ms] (mean, across all concurrent requests)
Transfer rate:          33.02 [Kbytes/sec] received

Connnection Times (ms)
              min  mean[+/-sd] median   max
Connect:        0     0    1.8      0    11
Processing:    15    86   56.6     70   272
Waiting:       14    86   56.7     70   272
Total:         15    86   56.5     70   272

Percentage of the requests served within a certain time (ms)
  50%     70
  66%     93
  75%    108
  80%    126
  90%    179
  95%    215
  98%    233
  99%    240
 100%    272 (last request)
}}}3

Interception design{{{3

The common solution for every bind to localhost:port create unix socket
and to every connect to localhost:port add created unix socket.

Check if any consequences for giving unix socket instead of tcp socket.

}}}3

VA installation{{{3

        /export/homeext3/hostdir/plugins/bin/Spython /export/homeext3/hostdir/plugins/bin/InstallManager.pyc "//www/htdocs/plugins/ChiliSoftServers/ChiliSoftServer" "/export/homeext3/hostdir/plugins/packages/ChiliSoftServers" $1 "/" "/export/homeext3/hostdir/accounts/chile75"    "_plugin_VDS_GROUP=101"    "_plugin_VDS_MODE=dedicated"    "_plugin_VDS_NAME=ds"    "_plugin_link=http://172.16.27.1/chile42.devsphera.com-asp/test.asp"    "_plugin_name=ChiliSoftServer"    "_plugin_status=installed"    "ds_plugin=true"

}}}3

}}}2

Default installation and configuration{{{2

        The default installation would bring only Tomcat w/o any applications,
        except our HelloWorld example for GUI link. By default, Tomcat would
        listen to localhost:8009. The installation also brings follows files:
        mod_jk.so, workers.properties, mod_jk.conf, server.xml
        There are optinal Tomcat applications that could be installed. That
        kind of installation will brings number of applications and also new
        file server.xml.optional
        This file (server.xml.optional) actualy original Tomcat config file
        comming w/ Tomcat rpm installation.

        Configuration of Tomcat side.
        The Tomcat itself do not have any changes made by us except the fact
        it runs under VDS environment. There is also main Tomcat config file
        called server.xml placed at <VDS>/etc/tomcat4. Here, can be found lots
        of Tomcat config parameters like 'port and 'address' to which Tomcat
        should bind.
        The full explanation how to config Tomcat can be found at
        http://jakarta.apache.org/tomcat/tomcat-4.1-doc/jk2/jk/workershowto.html

        Configuration Apache side.
        First of all, the new Apache module called mod_jk.so, which actually
        connecting Apache and Tomcat and compiled by us. It is placed as usual
        at <VDS>/usr/local/apache/libexec
        There are 2 configuration files for that module called mod_jk.conf and
        workers.properties placed where httpd.conf is.
        The full explanation how to config Apache for Tomcat can be found at
        http://jakarta.apache.org/tomcat/tomcat-4.1-doc/jk2/jk/aphowto.html

        Apache/Tomcat connectivity.
        Our default configuration brings Tomcat to listen localhost:8009 and
        Apache to connect that 'ip:port'. That can be reconfigured by changing
        server.xml and workers.properties files

}}}2

QA procedure{{{2

-----------------------
Tomcat VA installation.
-----------------------
There are 2 types of installation. First, only mandatory files of Tomcat and
second, mandatory plus optional files. Second case brings number of Tomcat
applications.
Tomcat VA folder : <SPHERA_BASE>/plugins/packages/Tomcat-4-SA/
Tomcat initialization/upgrade utility : tomcat4_util

I .Initialization :
    1. Download and copy to Tomcat VA folder at least 2 RPMS : j2sdk and
       tomcat4 (tomcat4-webapps and tomcat4-admin-webapps are optional)
    2. Execute the initialization utility without parameters. Example of the
       utility output :
        [root@blade Tomcat-4-SA]# ./tomcat4_util
        Looking for j2sdk
        Looking for tomcat4
        Looking for tomcat4-webapps
        Creating Mirror for /export/home/hostdir/plugins/packages/Tomcat-4-SA/tomcat4-webapps-4.1.18-full.1jpp.noarch.rpm
        Looking for tomcat4-admin-webapps

        Tomcat4 package parts status :
        (   Flag  )        RPM name          : Status/Version
        -----------------------------------------------------
        (mandatory)                    j2sdk : j2sdk-1.4.1_01-fcs
        (mandatory)                  tomcat4 : tomcat4-4.1.18-full.1jpp
        (optional )          tomcat4-webapps : tomcat4-webapps-4.1.18-full.1jpp
        (optional )    tomcat4-admin-webapps :  -- MISSING --

II. Upgrade/Extend.
    1. Download the new updated rpms and/or additional optional rpms (tomcat4-admin-webapps or/and tomcat4-webapps) to  the tomcat VA folder.
    2. Execute the 'tomca4_util'. After finishing the mirror update, utility will upgrade all VDSes with tomcat4 already installed. In case there is a number of rpms with the same name, but different version/build - the latest will be used.
 / ServerDirector must be up and running! /

III. 'Custom' files. /Advanced configuration/
    1. Put all additional files in CUSTOM directory (in Tomcat4 VA folder). Files from CUSTOM  directory installs in VDS with the same path : CUSTOM/etc/example will bee installed <VDS_HOME>/etc/example.
    2. Execute 'tomcat4_util -c ' (or -custom)  to install new files from CUSTOM to VDSes with tomcat4 already installed (not necessary if there is no VDS with tomcat installed on this machine)
    File removed from CUSTOM, but already present in VDS(s) must be removed from VDS(s) manually!

IV. RPM names change/RPM list extending(or reducing)  /Advanced configuration/
    tomcat4_util use tomcat4.rpmlist as default VA rpm list. The file contains (default):

        #name|minver|minbuild|reqver|reqbuild|mandatory|
        j2sdk|1.4.1||||M|
        tomcat4|4.1.17|||^full\.|M|
        tomcat4-webapps|4.1.17||||O|
        tomcat4-admin-webapps|4.1.17||||O|

    Line started with '#' sign is comment. '|' sign is delimiter beet wen the parameters in line
    Each line contains parameters RPM-short-name,Minimum-version, Minimum-build(release), Version-pattern, Build(release)-pattern, Mandatory/Optional switch.
    Any version/build parameter can be empty. This mean 'any'.
    Patterns are regular expression pattern that version (or build) must match.

V. Alternative folder with rpms.
    tomcat4_util searches for rpms by default in Tomcat4 VA folder, but there is possible to provide in command line an alternative folder : ./tomcat4_util /home/marko/tomcat_prepend/

----------------
Tomcat GUI link.
----------------
It will gives page w/ 2 other links, one to call jsp file,
other servlet file.

Check that VDS owner can changed Tomcat configuration files. All check in
<VDS>/etc/tomcat4 where try to create new file and edit server.xml and
server.xml.optional

-----------------------------
Tomcat database connectivity.
-----------------------------
One of Tomcat functionality abilities is to run application that gets data from
databases. Mysql and Postgress sql servers implemented as VDS VA, so needs to
check Tomcat-Mysql and Tomcat-Postgress connections.

Common things for both checks are need of database java driver (to connect java
application w/ db), Tomcat application that inquires connection and database w/
data to have the answer.

                                Mysql.

Driver.
Copy database driver mysql-connector-java-2.0.14-bin.jar to <VDS>/var/tomcat4
Database.
Telnet to the VDS. Run mysql (./usr/local/mysql/bin/mysql) and get prompt:
mysql>
Now follows creation of database, table and insert some data:
./usr/local/mysql/bin/mysql -p < /var/tomcat4/webapps/db_test/add_data.mysql

Tomcat application.

}}}2

Ensim config{{{2

Apache
MaxKeepAliveRequests 100
KeepAliveTimeout 15
MinSpareServers 5
MaxSpareServers 10
StartServers 5
MaxClients 150

}}}2

}}}1
VIII.  QOS checking{{{1

                                                                01jul2002
Context{{{2
I.  Machine config
II. Tests
        1. Regression tests
                a. OS
                b. QOS module
                c. HostDir
        2. Stability tests
                a. OS
                b. Sphera
                c. QOS module
        3. Functionality
                a. Framework
                b. CPU manager
                c. Mem manager
                d. Both
        4. Performance
                a.
III. Checks
        1. Switch mode
        2. Static_Dynamic
        3. Load/Unload
IV.  Configurations
        1. common
        2. mon/enf
        3. nbr_of_users
V.   Benchmarks
    1. LTP
}}}2

I. Machine config{{{2

}}}2

II. Tests{{{2

II.1.a Regression OS test{{{3
        Purpose: one time test to ensure that certain functionality of OS
                works proper included ftp, http, pop3, smtp services.
        What to test:
                basic functionality of linux OS(see How).
        Configurations:
                monitor/enforcement modes;
        Tools:
                LTP (ltp.sourceforge.net), scripts
        How:
                Start to run LTP tests one by one as follows:
                kernel sc - checks 153 system calls {{{4
accept
access
alarm
asyncio
bind
brk
chdir
chmod
chown
chroot
close
connect
creat
dup
execl
execle
execlp
execv
execve
execvp
exit
fchdir
fchmod
fchown
fcntl
fork
fpathconf
fstat
fstatfs
fsync
ftruncate
getcwd
getdents
geteuid
getgid
getgroups
gethostid
gethostname
getitimer
getpeername
getpgid
getpgrp
getpid
getppid
getpriority
getresuid
getsid
getsockname
getsockopt
gettimeofday
getuid
ioctl
kill
lchown
link
listen
llseek
lseek
lstat
mkdir
mknod
qmm
mmap
modify_ldt
mprotect
mremap
msgctl
msgget
msgrcv
msgsnd
msync
munmap
nanosleep
nice
open
pathconf
pause
personality
pipe
poll
pread
pwrite
read
readdir
readlink
readv
recv
recvfrom
recvmsg
rename
rmdir
sbrk
sched_getscheduler
sched_setscheduler
sched_yield
select
semctl
semget
semop
send
sendfile
sendmsg
sendto
setfsgid
setfsuid
setgid
setgroups
setitimer
setpgid
setpgrp
setpriority
setregid
setresuid
setreuid
setrlimit
setsid
setsockopt
settimeofday
setuid
shmat
shmctl
shmdt
shmget
sigaction
sigaltstack
sighold
signal
sigprocmask
sigrelse
sigsuspend
socket
socketpair
sockioctl
stat
statfs
stime
symlink
sync
sysctl
sysinfo
time
times
truncate
umask
uname
unlink
utime
vfork
vhangup
wait
waitpid
write
writev }}}
                kernel fs - {{{4
                        fs_inod- Rapidly creates and deletes files through
                                multiple processes running in the background.
                        fs_perms- Regression test for Linux filesystem perms.
                        fsx-linux- Filesystem stress test developed by Apple.
                        growfiles- will grow a list of files.
                        lftest- to verify the file size limitations of a fs.
                        linktest- Regression test for max links per file.
                        openfile- Creates files and opens simultaneously.
                        proc01- Recursively reads all files within /proc fs.
                        rwtest- Currently can handle read,write,reada,writea,
                                ssread,sswrite, and many varieties of listio.
                }}}4
                kernel mm - {{{4
                        mem01- exercising virtual memory allocation and usage.
                        mtest01- mallocs memory <chunksize> at a time until
                                malloc fails.
                        mtest05/mmstress- Performs General Stress with Race
                                conditions
                        mtest06/mmap1- stressing the mm by simultanious
                                map/unmap/read by light weight processes. (24h)
                        mtest06/mmap2- stressing the mm by repeaded
                                map/write/unmap of a large gb size file.
                        mtest06/mmap3- stressing the mm by repeaded
                                map/write/unmap
                                of file/memory of random size (maximum 1GB).
                        mtest06/shmat1- stressing the mm by repeaded
                                shmat/write/read/shmatd of file/memory of
                                random size (maximum 1000 * 4096).
                }}}4
                kernel ade - {{{4
                        ar01- Construct one or more command lines which use
                                options that do not take args.For each of these
                                invocations: specify the options seperately;
                                group the options together;
                                compare the behavior of the two cases;
                                If they behave differently, then fail
                                If none of the cases fail, then pass
                        ld01- To test the basic functionality of `ld` cmd.
                        ldd01- To test the basic functionality of `ldd` cmd.
                        nm01- To test the basic functionality of the `nm` cmd.
                        objdump01- Tests the functionality of `objdump` cmd.
                        size01- To test the basic functionality of `size`.
                }}}4
                kernel ipc - {{{4
                        pipeio- to beat on system or named pipes.
                        sem01- semaphore scenario.
                        sem02- multithreaded semaphore scenario.
                }}}4
                kernel sch - {{{4
                        clisrv- Read contents of data file. Write each line to
                                socket, then read line back from socket and
                                write to standard output.
                        pth_str01- Creates a tree of threads.
                        pth_str02- Creates n threads.
                        pth_str03- Creates a tree of threads does calculations,
                                and returns result to parent.
                }}}4
                kernel fp - {{{4
                        purpose to increase CPUs workload - verify that results
                        of some math functions are stable. There are 5 tests:
                        float_bessel, float_exp_log, float_iperb, float_power,
                        float_trigo.
                }}}4
                kernel sctp - {{{4
                 accept01-sctp
                        Verify that accept returns the proper errno for
                        various failure cases.
                 bind01-sctp-udp tcp
                        Verify that bind returns the proper errno for
                        various failure cases.
                 listen01-sctp-udp tcp
                        Verify that listen returns the proper errno for
                        various failure cases.
                 recv01-sctp-udp tcp
                        Verify that recv returns the proper errno for
                        various failure cases.
                 recvfrom01-sctp-udp tcp
                        Verify that recvfrom returns the proper errno for
                        various failure cases.
                 recvmsg01-sctp-udp tcp
                        Verify that recvmsg returns the proper errno for
                        various failure cases.
                 send01-sctp-udp tcp
                        Verify that send returns the proper errno for
                        various failure cases.
                 sendmsg01-sctp-udp tcp
                        Verify that sendmsg returns the proper errno for
                        various failure cases.
                 sendto01-sctp-udp tcp
                        Verify that sendto returns the proper errno for
                        various failure cases.
                 setsockopt01-sctp-udp tcp
                        Verify that setsockopt returns the proper errno for
                        various failure cases.
                 socket01-sctp-udp tcp
                        Verify that socket returns the proper errno for
                        various failure cases.
                }}}4
                diskio disktest - {{{4
                Does repeated accesses to a filespec and optionally writes to, reads from,
                and  verifies  the  data.  By default, disktest makes assumptions about
                the running environment which allows for a quick start of IO generation.
                However, Disktest has  a  large  number  of command line options which can
                be used to adapt the test for a variety of uses including data integrity,
                medium integraty, performance, and  simple application simulation.
                }}}4
                diskio stress_cd - {{{4
                Creates multiple read threads on the cdrom device.
                }}}4
                diskio stress_floppy - {{{4
                reading/writing/formatting on a floppy drive.
                }}}4
                network ipv6 - {{{4
echo601
        Stresses the inetd/xinetd daemon using the `echo` service.
finger601
        test the basic functionality of the `finger` command.
ftp601
        test the basic functionality of the `ftp` command.
perf_lan6
        Generates LAN traffic using ICMP echo packets.
ping601
        test the basic functionality of the `ping` command.
rcp601
        test the basic functionality of the `rcp` command.
rlogin601
        Tests the basic functionality of `rlogin`.
rsh601
        test the basic functionality of the `rsh` command.
rwho601
        test the basic functionality of the rwhod daemon using the
sendfile601
         Copy files from server to client using the sendfile()
         function.
tcpdump6
        test the basic functionality of `tcpdump`.
telnet601
        Tests the basic functionality of `telnet`.
                }}}4
                network multicast - {{{4
mc_cmds
        To determine the stability of the IP Multicast product
        and to verify the accuracy and usablility of IP Multicast
        related publications associated with changes and/or
        additions to command level interfaces for this implementations
        of IP Multicast.
mc_commo
         To verify that IP Multicast can be used to send UDP datagrams
         between two or more nodes on the same subnetwork using
         a specific IP Multicast group and a specific port address.
mc_member
        To verify that two of the new options for level IPPROTO_IP
        Service Interface allow the list of host group memberships
        to be updated properly in response to the JoinHostGroup and
        LeaveHostGroup requests. To test boundary conditions while
        exercising IP Multicast JoinHostGroup and LeaveHostGroup
        Service Interfaces.
mc_opts
        To verify that three of the new options for level IPPROTO_IP
        Service Interface are initially set to the default values as
        defined in the documentation and that each of the new options
        can be set and read properly by the setsockopt and getsockopt
        routines, respectively.  To test boundary conditions and to
        generate errors while exercising the IP Multicast Service
        Interface options.
                }}}4
                network nfs - {{{4
fsx-linux
        Created by NeXT Software (Apple Computer, Inc.).  This test will 
        thrash your NFS filesystem and has uncovered numerous bugs within 
        the Linux implementation.
nfs01
        Stresses NFS by opening a large number of files on a nfs
        mounted filesystem.
nfs02
        Tests NFS copy of various filesizes, file consistency between copies
        and preservation of write/nowrite permissions.
nfs03
        Runs the LTP filesystem test: fs_inod, on an NFS mountpoint.    
nfslock01
        Two processes open FLOCK_IDATA file simultaneously
        each one locks odd and even lines of the file simultaneously
        and fill them with '0's and '1's. After they find eof, the
        datafiles are compared.
nfsstat01
         Tests the 'nfsstat' command.  This test runs locally, so no
         actual network connection is needed.
nfsstress 
        This program is designed stress the NFS implimentation.       
        Many bugs were uncovered in the AIX operating system          
        implimentation of NFS when AIX kernel was built over NFS.     
        Source directory on a remote machine (one server many clients)
        NFS-mounted on to a directory on a local machine from which   
        the kernel build was initiated. Apparently many defects/bugs  
        were uncovered when multiple users tried to build the kernel  
        by NFS mounting the kernel source from a remote machine and   
        tried to build the kernel on a local machine. AIX build envi- 
        ronment is set up to create the object files and executable   
        on the local machine.                                         
        This testcase will try to recreate such a senario.            
        Spawn N number of threads. Each thread does the following.    
        * Create a directory tree.                                    
        * Populate it with ".c" files and makefiles.                  
        * initate a build. Executable will print hello world when executed
        * clean up all the executables that were created.             
        * recurssively remove each subdir and its contents.           
        The test is aimed at stressing the NFS client and server.     
                }}}4
                network rpc - {{{4
rpc01
        Test rpc using file transfers between a client & server
rpcinfo01
        Basic test for the `rpcinfo` command.
rup01
        Basic test for the `rup` command.
rusers01
        Basic test for the `rusers` command.
                }}}4
                network sctp - {{{4
                same as kernel sctp
                }}}4
                network tcp_cmds - {{{4
arp01
        Test the basic functionality of `arp`.
echo01
        Stresses the inetd/xinetd daemon using the `echo` service.
finger01
        test the basic functionality of the `finger` command.
ftp01
        test the basic functionality of the `ftp` command.
host01
        test the basic functionality of the `host` command.
netstat01
        test the basic functionality of the `netstat` command.
perf_lan
        Generates LAN traffic using ICMP echo packets.
ping01
        test the basic functionality of the `ping` command.
rcp01
        test the basic functionality of the `rcp` command.
rdist01
        test the basic functionality of the `rdist` command.
rlogin01
        Tests the basic functionality of `rlogin`.
rsh01
        test the basic functionality of the `rsh` command.
rwho01
        test the basic functionality of the rwhod daemon using the
sendfile01
         Copy files from server to client using the sendfile()
         function.
tcpdump
        test the basic functionality of `tcpdump`.
telnet01
        Tests the basic functionality of `telnet`.
                }}}4

                To check ftp, http, pop3, smtp services:
                FTP - run script ftp_check.sh which opens ftp connection, puts
                        file and closes ftp connection.
                POP - run script pop_check.sh which opens pop connection, reads
                        mailbox and closes pop connection.
                SMTP - run script smtp_check.sh which opens smtp connection, sends
                        email and closes smtp connection.
                HTTP - run script http_check.sh which open http connection, sends
                        command GET and closes http connection.
        Runs: {{{4
                kernel
                - sc                                            hangs
                        personality01   #266
                        personality02   #266
                        shmdt02         2.4.9-pre4
                        pread02         investigating
                        mprotect01      2.4.19-pre4
                        msync05         2.4.19-pre4
                        pwrite02        ???
                        recv01          2.4.18
                        recvfrom01      2.4.18
                        recvmsg01       2.4.18
                        signal04        ???
                        waitpid05       ???
                - fs                                            ???
                - mm                                            PASS
                - ade                                           PASS
                        ar              known but...
                - ipc                                           PASS
                        sem02           #351
                - sch                                           PASS
                - fp                                            PASS
                - sctp udp                                      PASS
                        bind01-sctp-udp Socket type not supported
                        listen01-sctp-udp -"-
                        recv01-sctp-ud  -"-
                        recvfrom01-sctp-udp -"-
                        recvmsg01-sctp-udp -"-
                        send01-sctp-udp -"-
                        sendmsg01-sctp-udp -"-
                        sendto01-sctp-udp -"-
                        setsockopt01-sctp-udp -"-
                        socket01-sctp-udp ??? (same w/o module)
                - sctp tcp                                      PASS
                        accept01-sctp   Socket type not supported
                        bind01-sctp-tc  -"-
                        listen01-sctp-tcp -"-
                        recv01-sctp-tcp -"-
                        recvfrom01-sctp-tcp -"-
                        recvmsg01-sctp-tcp -"-
                        send01-sctp-tcp -"-
                        sendmsg01-sctp-tcp -"-
                        sendto01-sctp-tcp -"-
                        setsockopt01-sctp-tcp -"-
                        socket01-sctp-tcp ??? (same w/o module)
                disk i/o                                        PASS
                network
        }}}4
}}}3

II.1.b Regression QOS module test{{{3

        Purpose of test:
                one time tests to ensure that module interface
                works. Not intend to check if it works right.(see functionaly)

        Objects to test:
                all set of module interface commands
                        * start/stop moduel
                        * get module status
                        * get module's managers status
                        * set module's manager mode
                        * create pnode
                        * attach uid
                        * attach self
                        * attach forward
                        * set flags (barrier,go_other,deffer_uid)
                        * set pnode's name
                        * create pnode's managers
                        * start pnode
                        * delete pnode
                        * get pnode status
                        * get pnode children
                        * get pnode tasks
                        * kill pnode tasks
                        * get pnode by uid
                        * set pnode thread limit
                        * set pnode sched weight
                        * get pnode sched weight
                        * set pnode mem limit
                        * get pnode mem limit
                        * get pnode watermark
                        * reset pnode watermark;
                basic scenarious
                        * add/del PNODE w/o tasks,
                        * add/del PNODE w/ existing tasks,
                        * add/del task to PNODE,
                        * task changes PNODE;
                period scenarious
                        * basic scenarious by time periods or number
                        of loops;
                legal constraints scenarious
                        * the 1st pnode to start should be w/ UID=0;
                        * the pnode w/ UID=0 should be deleted last
                        * can't create 2 pnodes w/ same UID rule
                        * can't del pnode w/ son
                        * can't del predefined pnode
                        * can't set any rule after pnode start
                        * can't set any flag after pnode start
                        * can't change any rule
                        * can't create pnode manager after pnode started
                        * can't set sched weight < 1 && > 1024
                        * can't set mem limit < 0

        How to test:
                Testing each module interface command
                        01-mdl_start            <sphera_module start>                   
                        02-mdl_stop             <sphera_module stop>
                        03-mdl_get_status       <mod_status>
                        04-mdl_get_mngr_status  <man_status nbr>
                        05-mdl_set_mngr_mode    <man_mode nbr mode>
                        06-pn_create            <create parent>
                        07-pn_set_uid           <uid parent uid>
                        08-pn_set_self          <self handle>
                        09-pn_set_forward       <forward parent child>
                        11-pn_set_gother        <flags handle <barrier|go_other|deffer_uid>
                        12-pn_set_name          <name handle name>
                        13-pn_create_mngr       <handle nbr>
                        14-pn_start             <start handle>
                        15-pn_del               <delete handle>
                        16-pn_get_status        <status handle>
                        17-pn_get_children      <children handle size>
                        18-pn_get_tasks         <tasks handle size>
                        19-pn_kill              <kill handle signum>
                        20-pn_lookup            <uid>

                Testing basic scenarious
                        do_check_add_del_pn_all
                
                        ----add/del PNODE
                        steps   description                     expected results
                        1       add PNODE                       new PNODE under VDS
                        2       del PNODE                       no PNODE under VDS
                        ----add PNODE w/ existing tasks
                        steps   description                     expected results
                        1       create task w/ PNODE's uid      see process
                        2       add PNODE                       new PNODE under VDS
                        3       attach uid to PNODE             success
                        4       start PNODE                     previous task linked to PNODE
                        ----del PNODE w/ existing tasks
                        steps   description                     expected results
                        1       add PNODE                       new PNODE under VDS
                        2       attach uid to PNODE             success
                        3       set PNODE flags                 success
                        3       start PNODE                     success
                        4       create task w/ PNODE's uid      see process
                        5       del PNODE                       (see below)
                        none flag
                                in case of del PNODE it's tasks relink to father
                                PNODE exists till last task exists.
                        barrier flag
                                in case of del PNODE it will exists till last task, so task
                                can't be relink anywhere.
                        goother flag
                                in case of del PNODE it's tasks relink to predefined PNODE
                                called OTHER.
                        ----del PNODE w/ existing sons
                        steps   description                     expected results
                        1       add PNODE                       new PNODE under VDS
                        2       add PNODE under previous        new PNODE under previous PNODE
                        3       start both PNODEs               success
                        4       del 1st PNODE                   failure
                        ----add/del task
                        steps   description                     expected results
                        1       add PNODE                       new PNODE under VDS
                        2       attach uid to PNODE             success
                        3       start PNODE                     success
                        4       create task w/ PNODE's uid      task linked to PNODE
                        5       del previous task               task not exist
                        ----task changes PNODE
                        steps   description                     expected results
                        1       add PNODE                       new PNODE under VDS
                        2       attach uid to PNODE             success
                        3       start PNODE                     success
                        4       create task w/ PNODE's uid      task linked to PNODE
                        5       change task uid to 0            task linked to pnode other}}}3

                Testing legal constraints scenarious
                        do_1st_pn_to_start
                        do_last_pn_to_del
                        do_2_pn_w_same_ui
                        do_del_pn_with_son
                        do_del_predefined_pn
                        do_set_rule_after_pn_start
                        do_set_flag_after_pn_start
                        do_change_rule
                        do_create_pn_mngr_after_start
                        do_set_weight_1_1024
                        do_set_limit_less_0


II.2.c Stability QOS module test{{{3
        Purpose: regression test of QOS module for a time period. To create
                stress conditions could be run number of times simultaneously.
                Also added 
        What:
                Module commands - checks each of command from module api.
                Basic scenarious - lite scenarious from module workflow. Could
                be called simultaneously number of time for stress purposes.
                Heavy scenarious - complicated scenarious from module workiflow.
                Each of heavy scenarious produce massive workload for stress
                conditions.
        Configurations:
                monitor/enforcement modes; dynamic number of users;
        Tools: script
        How:
                Module commands.{{{4
                Testing follows module commands by running script test_module.sh
                (same as Regression QOS module test):
                ----get_mdl_status
                        get module status
                ----create_pn
                        create pnode
                ----start_pn
                        start pnode
                ----del_pn
                        delete pnode
                ----pn_set_uid
                        attach uid to pnode
                ----pn_kill
                        kill pnode's tasks
                ----pn_lookup
                        find pnode by uid
                ----get_pn_status
                        get pnode's status
                ----get_pn_children
                        get list of pnode's children
                ----get_pn_tasks
                        get list of pnode's tasks
                ----create_pn_man
                        create pnode's cpu or memory manager
                ----get_man_name
                        get manager's name
                ----set_pn_name
                        set pnode's name
                ----set_man_mode
                        set pnode's manager mode (monitor|enforcement)}}}4
                Basic scenarious.{{{4
                Testing follows scenarious:
                ----add/del PNODE
                steps   description                     expected results
                1       add PNODE                       new PNODE under VDS
                2       del PNODE                       no PNODE under VDS
                ----add PNODE w/ existing tasks
                steps   description                     expected results
                1       create task w/ PNODE's uid      see process
                2       add PNODE                       new PNODE under VDS
                3       attach uid to PNODE             success
                4       start PNODE                     previous task linked to PNODE
                ----del PNODE w/ existing tasks
                steps   description                     expected results
                1       add PNODE                       new PNODE under VDS
                2       attach uid to PNODE             success
                3       set PNODE flags                 success
                3       start PNODE                     success
                4       create task w/ PNODE's uid      see process
                5       del PNODE                       (see below)
                no flags
                        PNODE exists till last task exists.
                barier flag
                        PNODE's tasks link to father
                goother flag
                        PNODE's tasks link to pnode OTHER
                ----del PNODE w/ existing sons
                steps   description                     expected results
                1       add PNODE                       new PNODE under VDS
                2       add PNODE under previous        new PNODE under previous PNODE
                3       start both PNODEs               success
                4       del 1st PNODE                   failure
                ----add/del task
                steps   description                     expected results
                1       add PNODE                       new PNODE under VDS
                2       attach uid to PNODE             success
                3       start PNODE                     success
                4       create task w/ PNODE's uid      task linked to PNODE
                5       del previous task               task not exist
                ----task changes PNODE
                steps   description                     expected results
                1       add PNODE                       new PNODE under VDS
                2       attach uid to PNODE             success
                3       start PNODE                     success
                4       create task w/ PNODE's uid      task linked to PNODE
                5       change task uid to 0            task linked to pnode other}}}4
                Heavy scenarious.{{{4
                }}}4
}}}3

II.3.c Functionality mem manager{{{3

        Purpose of test:
                detailed tests to ensure all module interface
                functionaly. Basically to validate every answer of
                module interface commands.

        Objects to test (object and how to get info):
                        * start/stop moduel
                                
                        * get module status

                        * get module's managers status

                        * set module's manager mode

                        * create pnode

                        * attach uid

                        * attach self

                        * attach forward

                        * set flags (barrier,go_other,deffer_uid)

                        * set pnode's name

                        * create pnode's managers

                        * start pnode

                        * delete pnode

                        * get pnode status

                        * get pnode children

                        * get pnode tasks
                                ps -ewf | grep <uid>
                        * kill pnode tasks

                        * get pnode by uid

                        * set pnode thread limit
                                try to create tasks > limit
                        * set pnode sched weight

                        * get pnode sched weight

                        * set pnode mem limit

                        * get pnode mem limit

                        * get pnode watermark

                        * reset pnode watermark;
                
        How:

}}}2

III. Checks{{{2

Switch mode check{{{3
        Purpose: check module after changing it's mode from enforcement to
                monitor and vice versa.
        What to check:
                monitor/enforcement - to be sure that enforcement alive.
                enforcement/monitor - to be sure that monitor alive.
        Conditions:
        How to check:
                create pnode
                set resource limit
                try to allocate resource more than limited
                look for declining of resource allocation in enforcement mode
                look for permition of resource allocation in monitor mode
}}}3
Static_Dynamic check{{{3
        Purpose: check module Static/Dynamic number of users
 
}}}3

}}}2

IV. Configurations{{{2

        1. common{{{3
                Every test can be done in diff configurations of module and OS.
                mon/enf - Monitor/Enforcement
                nbr_of_users - static or dynamic number of UIDs
        }}}3
        2. mon/enf{{{3
        }}}3
        3. nbr_of_users{{{3
        }}}3

}}}2

V.  Benchmarks{{{2

        1. LTP{{{3
        home site: ltp.sourceforge.net
        tests:
                kernel - sys calls,                             sc
                        file system,                            fs
                        memory management,                      mm
                        application development environment,    ade
                        ipc,                                    ipc
                        scheduler,                              sch
                        floating point                          fp
                        SCTP                                    sctp
                disk i/o - disktest,
                        stress_cd,
                        stress_floppy
                network - ipv6,                                 ipv6
                        multicast,                              mcst
                        nfs,                                    nfs
                        rpc,                                    rpc
                        sctp,                                   sctp
                        tcp_cmds                                tcmd
        decription:
                kernel sc - checks 153 system calls {{{4
accept
access
alarm
asyncio
bind
brk
chdir
chmod
chown
chroot
close
connect
creat
dup
execl
execle
execlp
execv
execve
execvp
exit
fchdir
fchmod
fchown
fcntl
fork
fpathconf
fstat
fstatfs
fsync
ftruncate
getcwd
getdents
geteuid
getgid
getgroups
gethostid
gethostname
getitimer
getpeername
getpgid
getpgrp
getpid
getppid
getpriority
getresuid
getsid
getsockname
getsockopt
gettimeofday
getuid
ioctl
kill
lchown
link
listen
llseek
lseek
lstat
mkdir
mknod
qmm
mmap
modify_ldt
mprotect
mremap
msgctl
msgget
msgrcv
msgsnd
msync
munmap
nanosleep
nice
open
pathconf
pause
personality
pipe
poll
pread
pwrite
read
readdir
readlink
readv
recv
recvfrom
recvmsg
rename
rmdir
sbrk
sched_getscheduler
sched_setscheduler
sched_yield
select
semctl
semget
semop
send
sendfile
sendmsg
sendto
setfsgid
setfsuid
setgid
setgroups
setitimer
setpgid
setpgrp
setpriority
setregid
setresuid
setreuid
setrlimit
setsid
setsockopt
settimeofday
setuid
shmat
shmctl
shmdt
shmget
sigaction
sigaltstack
sighold
signal
sigprocmask
sigrelse
sigsuspend
socket
socketpair
sockioctl
stat
statfs
stime
symlink
sync
sysctl
sysinfo
time
times
truncate
umask
uname
unlink
utime
vfork
vhangup
wait
waitpid
write
writev }}}4
                kernel fs - {{{4
                        fs_inod- Rapidly creates and deletes files through
                                multiple processes running in the background.
                        fs_perms- Regression test for Linux filesystem perms.
                        fsx-linux- Filesystem stress test developed by Apple.
                        growfiles- will grow a list of files.
                        lftest- to verify the file size limitations of a fs.
                        linktest- Regression test for max links per file.
                        openfile- Creates files and opens simultaneously.
                        proc01- Recursively reads all files within /proc fs.
                        rwtest- Currently can handle read,write,reada,writea,
                                ssread,sswrite, and many varieties of listio.
                }}}4
                kernel mm - {{{4
                        mem01- exercising virtual memory allocation and usage.
                        mtest01- mallocs memory <chunksize> at a time until
                                malloc fails.
                        mtest05/mmstress- Performs General Stress with Race
                                conditions
                        mtest06/mmap1- stressing the mm by simultanious
                                map/unmap/read by light weight processes. (24h)
                        mtest06/mmap2- stressing the mm by repeaded
                                map/write/unmap of a large gb size file.
                        mtest06/mmap3- stressing the mm by repeaded
                                map/write/unmap
                                of file/memory of random size (maximum 1GB).
                        mtest06/shmat1- stressing the mm by repeaded
                                shmat/write/read/shmatd of file/memory of
                                random size (maximum 1000 * 4096).
                }}}4
                kernel ade - {{{4
                        ar01- Construct one or more command lines which use
                                options that do not take args.For each of these
                                invocations: specify the options seperately;
                                group the options together;
                                compare the behavior of the two cases;
                                If they behave differently, then fail
                                If none of the cases fail, then pass
                        ld01- To test the basic functionality of `ld` cmd.
                        ldd01- To test the basic functionality of `ldd` cmd.
                        nm01- To test the basic functionality of the `nm` cmd.
                        objdump01- Tests the functionality of `objdump` cmd.
                        size01- To test the basic functionality of `size`.
                }}}4
                kernel ipc - {{{4
                        pipeio- to beat on system or named pipes.
                        sem01- semaphore scenario.
                        sem02- multithreaded semaphore scenario.
                }}}4
                kernel sch - {{{4
                        clisrv- Read contents of data file. Write each line to
                                socket, then read line back from socket and
                                write to standard output.
                        pth_str01- Creates a tree of threads.
                        pth_str02- Creates n threads.
                        pth_str03- Creates a tree of threads does calculations,
                                and returns result to parent.
                }}}4
                kernel fp - {{{4
                        purpose to increase CPUs workload - verify that results
                        of some math functions are stable. There are 5 tests:
                        float_bessel, float_exp_log, float_iperb, float_power,
                        float_trigo.
                }}}4
                kernel sctp - {{{4
                 accept01-sctp
                        Verify that accept returns the proper errno for
                        various failure cases.
                 bind01-sctp-udp tcp
                        Verify that bind returns the proper errno for
                        various failure cases.
                 listen01-sctp-udp tcp
                        Verify that listen returns the proper errno for
                        various failure cases.
                 recv01-sctp-udp tcp
                        Verify that recv returns the proper errno for
                        various failure cases.
                 recvfrom01-sctp-udp tcp
                        Verify that recvfrom returns the proper errno for
                        various failure cases.
                 recvmsg01-sctp-udp tcp
                        Verify that recvmsg returns the proper errno for
                        various failure cases.
                 send01-sctp-udp tcp
                        Verify that send returns the proper errno for
                        various failure cases.
                 sendmsg01-sctp-udp tcp
                        Verify that sendmsg returns the proper errno for
                        various failure cases.
                 sendto01-sctp-udp tcp
                        Verify that sendto returns the proper errno for
                        various failure cases.
                 setsockopt01-sctp-udp tcp
                        Verify that setsockopt returns the proper errno for
                        various failure cases.
                 socket01-sctp-udp tcp
                        Verify that socket returns the proper errno for
                        various failure cases.
                }}}4
                diskio disktest - {{{4
                Does repeated accesses to a filespec and optionally writes to, reads from,
                and  verifies  the  data.  By default, disktest makes assumptions about
                the running environment which allows for a quick start of IO generation.
                However, Disktest has  a  large  number  of command line options which can
                be used to adapt the test for a variety of uses including data integrity,
                medium integraty, performance, and  simple application simulation.
                }}}4
                diskio stress_cd - {{{4
                Creates multiple read threads on the cdrom device.
                }}}4
                diskio stress_floppy - {{{4
                reading/writing/formatting on a floppy drive.
                }}}4
                network ipv6 - {{{4
echo601
        Stresses the inetd/xinetd daemon using the `echo` service.
finger601
        test the basic functionality of the `finger` command.
ftp601
        test the basic functionality of the `ftp` command.
perf_lan6
        Generates LAN traffic using ICMP echo packets.
ping601
        test the basic functionality of the `ping` command.
rcp601
        test the basic functionality of the `rcp` command.
rlogin601
        Tests the basic functionality of `rlogin`.
rsh601
        test the basic functionality of the `rsh` command.
rwho601
        test the basic functionality of the rwhod daemon using the
sendfile601
         Copy files from server to client using the sendfile()
         function.
tcpdump6
        test the basic functionality of `tcpdump`.
telnet601
        Tests the basic functionality of `telnet`.
                }}}4
                network multicast - {{{4
mc_cmds
        To determine the stability of the IP Multicast product
        and to verify the accuracy and usablility of IP Multicast
        related publications associated with changes and/or
        additions to command level interfaces for this implementations
        of IP Multicast.
mc_commo
         To verify that IP Multicast can be used to send UDP datagrams
         between two or more nodes on the same subnetwork using
         a specific IP Multicast group and a specific port address.
mc_member
        To verify that two of the new options for level IPPROTO_IP
        Service Interface allow the list of host group memberships
        to be updated properly in response to the JoinHostGroup and
        LeaveHostGroup requests. To test boundary conditions while
        exercising IP Multicast JoinHostGroup and LeaveHostGroup
        Service Interfaces.
mc_opts
        To verify that three of the new options for level IPPROTO_IP
        Service Interface are initially set to the default values as
        defined in the documentation and that each of the new options
        can be set and read properly by the setsockopt and getsockopt
        routines, respectively.  To test boundary conditions and to
        generate errors while exercising the IP Multicast Service
        Interface options.
                }}}4
                network nfs - {{{4
fsx-linux
        Created by NeXT Software (Apple Computer, Inc.).  This test will 
        thrash your NFS filesystem and has uncovered numerous bugs within 
        the Linux implementation.
nfs01
        Stresses NFS by opening a large number of files on a nfs
        mounted filesystem.
nfs02
        Tests NFS copy of various filesizes, file consistency between copies
        and preservation of write/nowrite permissions.
nfs03
        Runs the LTP filesystem test: fs_inod, on an NFS mountpoint.    
nfslock01
        Two processes open FLOCK_IDATA file simultaneously
        each one locks odd and even lines of the file simultaneously
        and fill them with '0's and '1's. After they find eof, the
        datafiles are compared.
nfsstat01
         Tests the 'nfsstat' command.  This test runs locally, so no
         actual network connection is needed.
nfsstress 
        This program is designed stress the NFS implimentation.       
        Many bugs were uncovered in the AIX operating system          
        implimentation of NFS when AIX kernel was built over NFS.     
        Source directory on a remote machine (one server many clients)
        NFS-mounted on to a directory on a local machine from which   
        the kernel build was initiated. Apparently many defects/bugs  
        were uncovered when multiple users tried to build the kernel  
        by NFS mounting the kernel source from a remote machine and   
        tried to build the kernel on a local machine. AIX build envi- 
        ronment is set up to create the object files and executable   
        on the local machine.                                         
        This testcase will try to recreate such a senario.            
        Spawn N number of threads. Each thread does the following.    
        * Create a directory tree.                                    
        * Populate it with ".c" files and makefiles.                  
        * initate a build. Executable will print hello world when executed
        * clean up all the executables that were created.             
        * recurssively remove each subdir and its contents.           
        The test is aimed at stressing the NFS client and server.     
                }}}4
                network rpc - {{{4
rpc01
        Test rpc using file transfers between a client & server
rpcinfo01
        Basic test for the `rpcinfo` command.
rup01
        Basic test for the `rup` command.
rusers01
        Basic test for the `rusers` command.
                }}}4
                network sctp - {{{4
                same as kernel sctp
                }}}4
                network tcp_cmds - {{{4
arp01
        Test the basic functionality of `arp`.
echo01
        Stresses the inetd/xinetd daemon using the `echo` service.
finger01
        test the basic functionality of the `finger` command.
ftp01
        test the basic functionality of the `ftp` command.
host01
        test the basic functionality of the `host` command.
netstat01
        test the basic functionality of the `netstat` command.
perf_lan
        Generates LAN traffic using ICMP echo packets.
ping01
        test the basic functionality of the `ping` command.
rcp01
        test the basic functionality of the `rcp` command.
rdist01
        test the basic functionality of the `rdist` command.
rlogin01
        Tests the basic functionality of `rlogin`.
rsh01
        test the basic functionality of the `rsh` command.
rwho01
        test the basic functionality of the rwhod daemon using the
sendfile01
         Copy files from server to client using the sendfile()
         function.
tcpdump
        test the basic functionality of `tcpdump`.
telnet01
        Tests the basic functionality of `telnet`.
                }}}4
        }}}3

}}}2

Old stuff {{{2

II.1.b Regression Sphera test{{{3
        Purpose: one time test to ensure that certain functionality of Sphera
                works proper.
        What:
                services - ftp, http, pop3, smtp
                Sphera - add/del VDS, move VDS.
        Configurations:
                mon/enf
        Tools:
                script, openapi
        How:
                FTP service check
                aim: check if service works proper
                steps   description             expected results
                1       open ftp connection     success
                2       put file                number of transferred bytes
                3       get file                number of transferred bytes
                4       close ftp connection    success

                POP service check
                aim: check if service works proper
                Run pop_check.sh

                SMTP service check
                aim: check if service works proper
                Run smtp_check.sh

                HTTP sevice check
                aim: check if service works proper
                Run http_check.sh

                Add/Del VDS
                aim: check Sphera functionmality
                steps   description             expected results
                1       create VDS              success
                2       delete VDS              success

                Move VDS
                aim: check Sphera functionmality
                steps   description             expected results
                1       create VDS              success
                2       move VDS                success
}}}3

}}}2
}}}1