📄 dfukeyinsert.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- Copyright 2001, 2002 Cambridge Silicon Radio Limited -->
<html>
<head>
<title>CSR DFU Tools - dfukeyinsert</title>
</head>
<body bgcolor="white">
<h1 align=center>CSR DFU Tools - dfukeyinsert</h1>
The <code>dfukeyinsert</code> tool is used to add a public key to the <a href="#sk" title="Adding Stack Key to Loader">loader</a> or <a href="#ak" title="Adding Application Key to Protected Stack Persistent Store">stack persistent store</a> for verifying signatures. See the individual descriptions below for details.
<h2><a name="sk">Adding Stack Key to Loader</a></h2>
<dl>
<dt>Usage</dt>
<dd>
<code><b>dfukeyinsert</b> [-v] [-o <i>OUTPUTBASENAME</i>] -l <i>LOADERCONSTFILE</i> [-ks <i>STACKENCKEYFILE</i>]</code>
</dd>
<dt>Parameters</dt>
<dd>
<dl>
<dt><code>-v</code></dt>
<dd>Run in verbose mode, displaying detailed information about the actions performed.</dd>
<dt><code>-o <i>OUTPUTBASENAME</i></code></dt>
<dd>Base name for the output file, to which <code>.xpv</code> and <code>.xdv</code> extensions will be added. If this parameter is omitted then the output files overwrite the source files; use this option with care.</dd>
<dt><code>-l <i>LOADERCONSTFILE</i></code></dt>
<dd>Name of the <code>.xdv</code> file containing the loader software's constants. The name of the <code>.xpv</code> file containing the loader software's program code is constructed by replacing the <code>.xdv</code> extension with <code>.xpv</code>.</dd>
<dt><code>-ks <i>STACKENCKEYFILE</i></code></dt>
<dd>Name of the file containing the public key to use for verifying the stack software and the protected stack persistent store.</dd>
</dl>
</dd>
<dt>Remarks</dt>
<dd>
Add the public key used to verify the stack's signature to the loader software. The resulting file, when combined with the corresponding <code>.xpv</code> file, is suitable for programming to flash using BlueFlash or similar tools. The corresponding private key file should be specified for <a href="dfusign.html#ss" title="Signing Stack Software"><code>dfusign</code></a>.
<p>
If the <code>-ks</code> parameter is omitted (no key file specified) then no key is inserted; the only action is to update the firmware checksum. This usage is intended for internal CSR use only.
</dd>
<dt>Example</dt>
<dd>
<code>dfukeyinsert -v -o loader_with_key -l loader_unsigned.xdv -ks my_stack_key.public.key</code>
</dd>
</dl>
<h2><a name="ak">Adding Application Key to Protected Stack Persistent Store</a></h2>
<dl>
<dt>Usage</dt>
<dd>
<code><b>dfukeyinsert</b> [-v] [-o <i>OUTPUTBASENAME</i>] [-ps <i>STACKPSFILE</i>] -ka <i>APPENCKEYFILE</i></code>
</dd>
<dt>Parameters</dt>
<dd>
<dl>
<dt><code>-v</code></dt>
<dd>Run in verbose mode, displaying detailed information about the actions performed.</dd>
<dt><code>-o <i>OUTPUTBASENAME</i></code></dt>
<dd>Base name for the output file, to which a <code>.psr</code> extension is added. If this parameter is omitted then the output file overwrites the source file; use this option with care.</dd>
<dt><code>-ps <i>STACKPSFILE</i></code></dt>
<dd>Name of the <code>.psr</code> file containing the stack software's persistent store data. If this parameter is omitted then a new persistent store file is created, containing just the public key.</dd>
<dt><code>-ka <i>APPENCKEYFILE</i></code></dt>
<dd>Name of the file containing the public key to use for verifying the application software and the protected application persistent store.</dd>
</dl>
</dd>
<dt>Remarks</dt>
<dd>
Add the public key used to verify the application's signature to a persistent store file. The resulting file is suitable for inclusion in a DFU file as protected stack persistent store, or programming using some versions of PSTool. The corresponding private key file should be specified for <a href="dfusign.html#as" title="Signing Application Software"><code>dfusign</code></a>.
<p>
This can be used on persistent store files that have already had a key added; the existing key is replaced.
<p>
If the persistent store containing the key is to be downloaded via a DFU file then it should be signed using <a href="dfusign.html#sps" title="Signing Protected Stack Persistent Store"><code>dfusign</code></a> after the key has been added, but before the DFU file is created using <a href="dfubuild.html" title="dfubuild"><code>dfubuild</code></a>.
</dd>
<dt>Example</dt>
<dd>
<code>dfukeyinsert -v -o stack_ps_with_key_unsigned -ps stack_ps_unsigned.psr -ka my_app_key.public.key</code>
</dd>
</dl>
<p align=right><font size="-1">© 2001, 2002, 2003 <a href="http://www.csr.com" title="CSR" target="_blank">CSR</a></font></p>
</body>
</html>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -