rockbox/utils/nwztools/database/nvp
Amaury Pouly 15e66a5b19 nwztools: small cleanups
Change-Id: I4fde020ca0556a84d051f9b5e46f49ee1241266e
2017-04-25 11:21:54 +10:00
..
Makefile nwztools: small cleanups 2017-04-25 11:21:54 +10:00
nodes-nw-a20.txt nwztools: rename nwz-a20 to nw-a20, that was a typo 2017-01-08 12:09:49 +01:00
nodes-nw-zx100.txt nwztools: fix typo (nwz-zx100 -> nw-zx100) 2017-01-09 21:48:43 +01:00
nodes-nwz-a10.txt
nodes-nwz-a820.txt
nodes-nwz-a860.txt
nodes-nwz-e450.txt
nodes-nwz-e460.txt
nodes-nwz-e580.txt
nvptool.cpp nwztools: small cleanups 2017-04-25 11:21:54 +10:00
nw-a20.txt nwztools: rename nwz-a20 to nw-a20, that was a typo 2017-01-08 12:09:49 +01:00
nw-a30.txt
nw-e060.txt
nw-e080.txt
nw-s640.txt nwztools: add various info about S740, S750, S640, E050 2017-01-08 22:34:57 +01:00
nw-s780.txt
nw-wm1.txt nwztools: add NW-WM1 nvp table, regenerate database 2017-01-04 17:03:54 +01:00
nw-zx100.txt nwztools: fix typo (nwz-zx100 -> nw-zx100) 2017-01-09 21:48:43 +01:00
nwz-a10.txt
nwz-a840.txt nwztools: add various info about S740, S750, S640, E050 2017-01-08 22:34:57 +01:00
nwz-a850.txt
nwz-a860.txt
nwz-e050.txt nwztools: add various info about S740, S750, S640, E050 2017-01-08 22:34:57 +01:00
nwz-e350.txt
nwz-e450.txt
nwz-e460.txt
nwz-e470.txt
nwz-e580.txt
nwz-s740.txt nwztools: add various info about S740, S750, S640, E050 2017-01-08 22:34:57 +01:00
nwz-s750.txt nwztools: add various info about S740, S750, S640, E050 2017-01-08 22:34:57 +01:00
nwz-s760.txt
parse_all_nvp_headers.sh nwztools: small fixes 2017-01-04 17:03:14 +01:00
parse_all_nvp_nodes.sh nwztools: small fixes 2017-01-04 17:03:14 +01:00
parse_nvp_header.sh nwztools: small fixes 2017-01-04 17:03:14 +01:00
parse_nvp_nodes.sh nwztools: small fixes 2017-01-04 17:03:14 +01:00
README

The NVP map varies a lot from players to players, it is inconceivable to build
it by hand. The approach taken is to extract it from the kernel of each player.
Since Sony provides the kernel of all players, it is 'only' a matter of
downloading all of them. A bit of back story on the NVP: it is non-volatile
area of the flash that is divided in regions and then "sectors" (unrelated to
hard drive sectors). Each "sector" stores the data of a "node". The ABI
between the NVP driver and the userspace is an index: the userspace gives the
index of a node, and then drives looksup its table to see where it is and what
is its size. The index map changes over time so Sony introduces standard "names"
for its entries, those are 3-letters acronym (for example "fup" or "bti" or "shp")
that have a corresponding index. For some reason, the driver also contains a
description of the nodes, in english (so "bti" stands for "boot image").

parse_nvp_header.sh
===================

This script is given a file name, a kernel directory or a kernel tgz and it will
try to extract the mapping automatically. It produces a list of pairs
  <node>,<name>
where <node> is the index of the node (that's the only thing that is usable on
a running device) and <name> is the standard name of the node. Note that is
some kind of acronym (like 'fup') and the description needs to be generated
separatly (see other section).

parse_all_nvp_headers.sh
========================

This scripts expects a directory to have the following structure:
  dir/
    nwz-a10/
      linux-kernel-*.tgz
    nwz-e460/
      linxu-kernel-*.tgz
    ...
Each sudirectory must the series name (as used in ../series.txt) and the kernel
must be a tgz (end in .tgz and not .tar.gz) of the form linux-kernel-*.tgz. Usually
the variable bit will be the version but some kernels have unknown versions. It
will then run parse_nvp_header.sh on each of them and store the result in a
file called <series name>.txt

NOTE: the kernel can be symlinks to other files

nvptool
=======

The kernel headers do no contain the description of the nvp node names.
This one can be extract from the icx_nvp[_emmc].ko driver on target using complicated
elf parsing done by nvptool. Technically nvptoo can find much more information
like the node -> humanname mapping as well and the actual sector on the disk but
since we can already extract it easily from the headers, we only extract description
names from it.

parse_all_nvp_nodes.sh
======================

This scripts expects a directory to have the following structure:
  dir/
    nwz-a10/
      rootfs.tgz
    nwz-e460/
      rootfs.tgz
    ...
Each sudirectory must the series name (as used in ../series.txt) and the rootfs
must be a tar. It will then extract the relevant icx_nvp driver from it and run
nvptool on it to produce a file called nodes-<series name>.txt

NOTE: the rootfs can be symlinks to other files