rockbox/utils/nwztools/plattools/README
Amaury Pouly ba91ff10e8 nwztools: add a new plattools directory with code to run on the device
This is code is intended to development into a library of code for the NWZ that
will be useful to write the "bootloader" on those device. At the same time, it
comes with test programs that are easy to run in firmware upgrade mode and also
provide a great test bench for the library. At the moment, two test programs are
available:
- test_display: simply prints two messages using /usr/bin/lcdmsg
- test_keys: displays input key event

Change-Id: I9d214894ffc9127b528fcdd3eb5d6b61f4e657a7
2016-10-19 17:09:04 +02:00

27 lines
1.2 KiB
Text

Platform tools
--------------
Those tools are designed to run on the devices. They are mostly tests that can
be run in firmware upgrade mode (using exec_file in utils/nwztools/scripts/). To
compile those, you will need the sony nwz cross compiler. The canonical way to
run them is as follows:
1) Build the tools:
cd /path/to/utils/nwztools/plattools
make
Note that the default cross compiler prefix is arm-sony-linux-gnueabi- but it
can be changed using PREFIX:
PREFIX="sony-nwz-linux-gnueabi-" make
2) Embed the wanted excutable in a firmware upgrade for your device. The README
in utils/nwztools/scripts contains more documentation on how to select the right
target. For example if you want to embed test_display for the NWZ-E460 series,
you should run:
cd /path/to/utils/nwztools/scripts
make exec_file UPG=test_display_nwze46x.upg NWZ_TARGET=nwz-e46x EXEC=../plattools/test_display.elf
3) Put the upgrade file on the device and trigger a firmware upgrade. Assuming
your NWZ device is /dev/sdb1 and is mounted at /media/pamaury/WALKMAN, run:
cd /path/to/utils/nwztools/scripts
make copy_fw_upgrade UPG=test_display_nwze46x.upg NWZ_MOUNT=/media/pamaury/WALKMAN/
sudo make do_fw_upgrade NWZ_DEV=/dev/sdb1