meiSynqNetFlashTopologySave

Declaration

	long meiSynqNetFlashTopologySave(MEISynqNet synqNet, MEIFlash flash);
	Required Header: stdmei.h

Description

meiSynqNetFlashTopologySave will save the current SynqNet topology to the controller's flash memory.

After a power-on or network shutdown/init, the controller/MPI Library will compare the discovered network topology with the topology saved in flash memory. If the topology information matches, the controller will automatically transition the network to SYNQ (cyclic) mode and configured service commands are sent to the nodes.

WARNING: This is a low-level network configuration routine that will reset the SynqNet network.

The meiSynqNetFlashTopologySave method will:

Shutdown the SynqNet network.
Set SqNode and Motor configurations to the values from Dynamic memory. See MPI Object Configurations that use Service Commands.
Initialize the SynqNet network.
Save network topology information to Flash memory.

synqNet

a handle to an MEISynqNet object whose network topology is to be saved.

flash

flash is either an MEIFlash handle or MPIHandleVOID. If flash is MPIHandleVOID, an MEIFlash object will be created and deleted internally. Using MPIHandleVOID is recommended, as it simplifies code.

If flash is a valid MEIFlash handle, then the MEIFlash object cache will be updated, but the actual write to controller flash will not occur. Use meiFlashMemoryFromFileType(...) to prompt the actual write to flash.

Return Values
MPIMessageOK
MPISynqNetMessageTOPOLOGY_SAVED