Signed Application Update

Topics
	NBUpdate Function Return Values

Functions
void	RegisterAppSigningPublicKey (const char *pKey)
	Enable APP Signing by registering a RSA PEM or DER format public key.
int	ProgramApplication (uint32_t where, uint8_t *pAppImage)
	Program an appliction image into Flash memory.
int	UpdateFromStream (int fd, AppUpdateRecord *&pu, uint32_t timeout)
	Program/update an appliction image from a data stream.

Detailed Description

#include< nbupdate.h>

Function Documentation

ProgramApplication()

int ProgramApplication	(	uint32_t	where,
		uint8_t *	pAppImage )

#include <nbupdate.h>

Program an appliction image into Flash memory.

Parameters

where	Location in Flash memory
pAppImage	Pointer to the application image to program

Return values

0	Success
-1	Application image pointer invalid
-2	Invalid platform header

RegisterAppSigningPublicKey()

void RegisterAppSigningPublicKey

(

const char *

pKey

)

#include <nbupdate.h>

Enable APP Signing by registering a RSA PEM or DER format public key.

This function should be called BEFORE the init() function if you want to guarantee security. It is ok to register a temporary text blob early, then overwrite it once the key via other means.

Parameters

pKey	Pointer to the public key to register

UpdateFromStream()

int UpdateFromStream	(	int	fd,
		AppUpdateRecord *&	pu,
		uint32_t	timeout )

#include <nbupdate.h>

Program/update an appliction image from a data stream.

Parameters

fd	File descriptor of data stream
pu	Application record
timeout	Timeout value in system time ticks (eg TICKS_PER*SECOND * 10)

Return values

0	Success
-1	Application image pointer invalid
-2	Invalid platform header