1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
|
riff - Raw Image File Flasher version 0.5.2
=================================================================================
Description:
=================================================================================
A tool for flashing a device.
=================================================================================
Hardware and software requirements:
=================================================================================
NOTE that building the tool requires the following packages to be installed:
libusb-dev-1.0-0
riff-loadercomm
riff-configpack
NOTE: To use riff on internal development board riff-configpack-internal also
needs to be installed. To use internal config pack instead of default create a
symlink to /usr/share/riff/snowball_internal/config in $HOME/.riff/config
$ ln -s /usr/share/riff/snowball_internal/config $HOME/.riff/config
=================================================================================
Usage:
=================================================================================
$ sudo make install
Will build from source and put the binary and lib in /usr/bin/share and /usr/lib/
respectively. It's then possible to run riff from anywhere.
## Configuration file ##
A template config file is provided in the source tree as config/riff.config
It will be renamed and placed in /usr/share/riff/
when using the make install target.
This file can be overridden with a user-specific config file placed in
$HOME/.riff, or by providing a full path to a config file at
runtime, as option on the command line (using the -c option).
riff will look for configuration file to use in the following order:
1) Config file provided on command line (using the -c option) at runtime.
2) Config file in user's home directory ($HOME/.riff/config)
3) /usr/share/riff
## Running ##
Usage: riff [OPTION]...[FILE]...
Available command line arguments are:
-h, --help Display this help message.
-m, --mode ACTION Select the mode.
ACTION is `flash` or `erase`
-c, --config PATH Give path to configuration file.
-f, --flashimage IMAGEPATH Give path to flashimage.
-a, --address FLASHADDR Give a start address in hex.
-l, --length HEXLENGTH Length of the dump [Byte] in hex.
-d, --dumppath DUMPPATH File path on PC where to store dump.
-v, --verbose Shows more detailed information.
--version Shows version information.
Examples:
$ riff -f <path/to/flashimage>
Default mode 'flash' will be used, and configuration originally from config/riff.config
but put in /usr/share/riff will be used (if the user hasn't overridden this file
by its own in $HOME/.riff/config).
The flashimage at the provided path will be flashed onto the device starting at address 0.
To start at any other address than 0, use
$ riff -f <path/to/flashimage> -a <address>
WARNING:
NOTE THAT RIFF HAS NO WAY OF KNOWING WHETHER YOU ARE OVERWRITING IMPORTANT
SECTIONS ON YOUR DEVICE OR NOT WHEN FLASHING! THE TOOL DOES NOT WARN YOU OR
PREVENT YOU FROM PROVIDING ANY ADDRESS TO FLASH TO.
In other words: it's up to you to know what you're doing, the tool takes no
responsibility for it!
Path to flashimage can also be specified in the config file and the -f flag
can then be omitted.
Build from source without installing:
$ make
riff binary ends up in riff directory. To run, libcdal (located in CDAL
directory) must be then be added to your LD_LIBRARY_PATH.
=================================================================================
Known issues:
=================================================================================
1) Linux can't find device.
Power down device and disconnect and reconnect USB cable.
Restart the flash tool and power up the device.
=================================================================================
Version history and changelog:
=================================================================================
0.3.0 Initial version.
0.4.0 Dump functionality added.
0.4.1 Packaging and README updated.
0.4.2 Larger image file support.
0.5.0 Support for Windows.
0.5.1 Error description for LCD error number
0.5.2 Build fixes, split large writes into 16k chunks
=================================================================================
Contact and support
=================================================================================
http://igloocommunity.org/support
|
