Luis Silvio Cordova Rivadeneira / Mbed 2 deprecated Can_open_masternode

Can_open_masternode

Dependencies:   mbed

framework/include/nmtMaster.h@7:537bae5a6fc6, 2012-09-26 (annotated)

Committer:
sam_grove
Date:
Wed Sep 26 05:48:14 2012 +0000
Revision:
7:537bae5a6fc6
Parent:
0:9dd7c6129683 
Pushing the project into the new repo

Who changed what in which revision?

UserRevisionLine numberNew contents of line
sam_grove 0:9dd7c6129683 1 /*
sam_grove 0:9dd7c6129683 2 This file is part of CanFestival, a library implementing CanOpen Stack.
sam_grove 0:9dd7c6129683 3
sam_grove 0:9dd7c6129683 4 Copyright (C): Edouard TISSERANT and Francis DUPIN
sam_grove 0:9dd7c6129683 5
sam_grove 0:9dd7c6129683 6 See COPYING file for copyrights details.
sam_grove 0:9dd7c6129683 7
sam_grove 0:9dd7c6129683 8 This library is free software; you can redistribute it and/or
sam_grove 0:9dd7c6129683 9 modify it under the terms of the GNU Lesser General Public
sam_grove 0:9dd7c6129683 10 License as published by the Free Software Foundation; either
sam_grove 0:9dd7c6129683 11 version 2.1 of the License, or (at your option) any later version.
sam_grove 0:9dd7c6129683 12
sam_grove 0:9dd7c6129683 13 This library is distributed in the hope that it will be useful,
sam_grove 0:9dd7c6129683 14 but WITHOUT ANY WARRANTY; without even the implied warranty of
sam_grove 0:9dd7c6129683 15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
sam_grove 0:9dd7c6129683 16 Lesser General Public License for more details.
sam_grove 0:9dd7c6129683 17
sam_grove 0:9dd7c6129683 18 You should have received a copy of the GNU Lesser General Public
sam_grove 0:9dd7c6129683 19 License along with this library; if not, write to the Free Software
sam_grove 0:9dd7c6129683 20 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
sam_grove 0:9dd7c6129683 21 */
sam_grove 0:9dd7c6129683 22
sam_grove 0:9dd7c6129683 23 /** @defgroup networkmanagement Network Management
sam_grove 0:9dd7c6129683 24 * @ingroup userapi
sam_grove 0:9dd7c6129683 25 */
sam_grove 0:9dd7c6129683 26 /** @defgroup nmtmaster NMT Master
sam_grove 0:9dd7c6129683 27 * @brief NMT master provides mechanisms that control and monitor the state of nodes and their behavior in the network.
sam_grove 0:9dd7c6129683 28 * @ingroup networkmanagement
sam_grove 0:9dd7c6129683 29 */
sam_grove 0:9dd7c6129683 30
sam_grove 0:9dd7c6129683 31 #ifndef __nmtMaster_h__
sam_grove 0:9dd7c6129683 32 #define __nmtMaster_h__
sam_grove 0:9dd7c6129683 33
sam_grove 0:9dd7c6129683 34 #include "data.h"
sam_grove 0:9dd7c6129683 35
sam_grove 0:9dd7c6129683 36 #ifdef __cplusplus
sam_grove 0:9dd7c6129683 37 extern "C"{
sam_grove 0:9dd7c6129683 38 #endif
sam_grove 0:9dd7c6129683 39
sam_grove 0:9dd7c6129683 40 /**
sam_grove 0:9dd7c6129683 41 * @ingroup nmtmaster
sam_grove 0:9dd7c6129683 42 * @brief Transmit a NMT message on the network to the slave whose nodeId is node ID.
sam_grove 0:9dd7c6129683 43 *
sam_grove 0:9dd7c6129683 44 * @param *d Pointer to a CAN object data structure
sam_grove 0:9dd7c6129683 45 * @param nodeId Id of the slave node
sam_grove 0:9dd7c6129683 46 * @param cs The order of state changement \n\n
sam_grove 0:9dd7c6129683 47 *
sam_grove 0:9dd7c6129683 48 * Allowed states :
sam_grove 0:9dd7c6129683 49 * - cs = NMT_Start_Node // Put the node in operational mode
sam_grove 0:9dd7c6129683 50 * - cs = NMT_Stop_Node // Put the node in stopped mode
sam_grove 0:9dd7c6129683 51 * - cs = NMT_Enter_PreOperational // Put the node in pre_operational mode
sam_grove 0:9dd7c6129683 52 * - cs = NMT_Reset_Node // Put the node in initialization mode
sam_grove 0:9dd7c6129683 53 * - cs = NMT_Reset_Comunication // Put the node in initialization mode
sam_grove 0:9dd7c6129683 54 *
sam_grove 0:9dd7c6129683 55 * The mode is changed according to the slave state machine mode :
sam_grove 0:9dd7c6129683 56 * - initialisation ---> pre-operational (Automatic transition)
sam_grove 0:9dd7c6129683 57 * - pre-operational <--> operational
sam_grove 0:9dd7c6129683 58 * - pre-operational <--> stopped
sam_grove 0:9dd7c6129683 59 * - pre-operational, operational, stopped -> initialisation
sam_grove 0:9dd7c6129683 60 * \n\n
sam_grove 0:9dd7c6129683 61 * @return errorcode
sam_grove 0:9dd7c6129683 62 * - 0 if the NMT message was send
sam_grove 0:9dd7c6129683 63 * - 1 if an error occurs
sam_grove 0:9dd7c6129683 64 */
sam_grove 0:9dd7c6129683 65 UNS8 masterSendNMTstateChange (CO_Data* d, UNS8 nodeId, UNS8 cs);
sam_grove 0:9dd7c6129683 66
sam_grove 0:9dd7c6129683 67 /**
sam_grove 0:9dd7c6129683 68 * @ingroup nmtmaster
sam_grove 0:9dd7c6129683 69 * @brief Transmit a NodeGuard message on the network to the slave whose nodeId is node ID
sam_grove 0:9dd7c6129683 70 *
sam_grove 0:9dd7c6129683 71 * @param *d Pointer to a CAN object data structure
sam_grove 0:9dd7c6129683 72 * @param nodeId Id of the slave node
sam_grove 0:9dd7c6129683 73 * @return
sam_grove 0:9dd7c6129683 74 * - 0 is returned if the NodeGuard message was send.
sam_grove 0:9dd7c6129683 75 * - 1 is returned if an error occurs.
sam_grove 0:9dd7c6129683 76 */
sam_grove 0:9dd7c6129683 77 UNS8 masterSendNMTnodeguard (CO_Data* d, UNS8 nodeId);
sam_grove 0:9dd7c6129683 78
sam_grove 0:9dd7c6129683 79 /**
sam_grove 0:9dd7c6129683 80 * @ingroup nmtmaster
sam_grove 0:9dd7c6129683 81 * @brief Ask the state of the slave node whose nodeId is node Id.
sam_grove 0:9dd7c6129683 82 *
sam_grove 0:9dd7c6129683 83 * To ask states of all nodes on the network (NMT broadcast), nodeId must be equal to 0
sam_grove 0:9dd7c6129683 84 * @param *d Pointer to a CAN object data structure
sam_grove 0:9dd7c6129683 85 * @param nodeId Id of the slave node
sam_grove 0:9dd7c6129683 86 */
sam_grove 0:9dd7c6129683 87 UNS8 masterRequestNodeState (CO_Data* d, UNS8 nodeId);
sam_grove 0:9dd7c6129683 88
sam_grove 0:9dd7c6129683 89 #ifdef __cplusplus
sam_grove 0:9dd7c6129683 90 }
sam_grove 0:9dd7c6129683 91 #endif
sam_grove 0:9dd7c6129683 92
sam_grove 0:9dd7c6129683 93 #endif /* __nmtMaster_h__ */