include/states.h
author greg
Fri, 09 May 2008 10:25:45 +0200
changeset 464 7d3637f763be
parent 381 854c43cdc24a
child 528 0a30e161d63c
permissions -rw-r--r--
update Doxyfile , manual.tex
add Msys/mingw target in vscom interface
/*
This file is part of CanFestival, a library implementing CanOpen Stack. 

Copyright (C): Edouard TISSERANT and Francis DUPIN

See COPYING file for copyrights details.

This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
*/

#ifndef __states_h__
#define __states_h__

#include <applicfg.h>

/* The nodes states 
 * -----------------
 * values are choosen so, that they can be sent directly
 * for heartbeat messages...
 * Must be coded on 7 bits only
 * */
/* Should not be modified */
enum enum_nodeState {
  Initialisation  = 0x00, 
  Disconnected    = 0x01,
  Connecting      = 0x02,
  Preparing       = 0x02,
  Stopped         = 0x04,
  Operational     = 0x05,
  Pre_operational = 0x7F,
  Unknown_state   = 0x0F
};

typedef enum enum_nodeState e_nodeState;

typedef struct
{
	INTEGER8 csBoot_Up;
	INTEGER8 csSDO;
	INTEGER8 csEmergency;
	INTEGER8 csSYNC;
	INTEGER8 csHeartbeat;
	INTEGER8 csPDO;
	INTEGER8 csLSS;
} s_state_communication;

/** Function that user app can overload
 * 
 */
typedef void (*initialisation_t)(CO_Data*);
typedef void (*preOperational_t)(CO_Data*);
typedef void (*operational_t)(CO_Data*);
typedef void (*stopped_t)(CO_Data*);

void _initialisation(CO_Data*);
void _preOperational(CO_Data*);
void _operational(CO_Data*);
void _stopped(CO_Data*);

#include "data.h"

/************************* prototypes ******************************/

/** Called by driver/app when receiving messages
*/
void canDispatch(CO_Data* d, Message *m);

/** Returns the state of the node 
*/
e_nodeState getState (CO_Data* d);

/** Change the state of the node 
*/
UNS8 setState (CO_Data* d, e_nodeState newState);

/** Returns the nodId 
*/
UNS8 getNodeId (CO_Data* d);

/** Define the node ID. Initialize the object dictionary
*/
void setNodeId (CO_Data* d, UNS8 nodeId);

/** Some stuff to do when the node enter in reset mode
 *
 */
/* void initResetMode (CO_Data* d); */


/** Some stuff to do when the node enter in pre-operational mode
 *
 */
void initPreOperationalMode (CO_Data* d);

#endif