FireSync API
 All Classes Files Functions Variables Typedefs Friends Macros Modules Pages
kStatus kNode_ReloadFirmware ( kNode  node,
kNodeFirmwareType  type,
const kChar path 
)

Replaces currently running firmware without affecting non-volatile storage.

This method can be used to dynamically replace a firmware component without affecting the boot image and without the need to reset the device. This methodology is only supported on some devices and only with some types of firmware. (E.g., at the time of this writing, it can only dynamically replace the primary PL program on Zynq7k-based controllers).

Upon completion, this method will automatically refresh the node. As such, it is possible that high-level modules such as cameras, projectors, or outputs may be created or destroyed as a result of calling this method. It is recommended that clients should discard any kNode child handles (e.g, kCamera, kLight) before calling this method and acquire new handles after calling this method.

When PL programs are changed, some existing node settings may be invalidated as a result. These violations are not automatically addressed. Accordingly, it is recommended to clear node settings and reconfigure from scratch after switching configurations.

Parameters
nodeNode object.
typeType of firmware to write
pathPath to local firmware file (or kNULL to unload firmware without loading a new program).
Returns
Operation status.