155 lines
4.4 KiB
C
155 lines
4.4 KiB
C
/**
|
|
* Application interface for CANopenNode stack.
|
|
*
|
|
* @file application.h
|
|
* @ingroup CO_application
|
|
* @version SVN: \$Id: application.h 39 2013-06-29 08:24:52Z jani22 $
|
|
* @author Janez Paternoster
|
|
* @copyright 2012 - 2013 Janez Paternoster
|
|
*
|
|
* This file is part of CANopenNode, an opensource CANopen Stack.
|
|
* Project home page is <http://canopennode.sourceforge.net>.
|
|
* For more information on CANopen see <http://www.can-cia.org/>.
|
|
*
|
|
* CANopenNode 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 program 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 program. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
|
|
#ifndef CO_APPLICATION_H
|
|
#define CO_APPLICATION_H
|
|
|
|
|
|
/**
|
|
* @defgroup CO_application Application interface
|
|
* @ingroup CO_CANopen
|
|
* @{
|
|
*
|
|
* Application interface for CANopenNode stack. Function is called
|
|
* from file main_xxx.c (if implemented).
|
|
*
|
|
* ###Main program flow chart
|
|
*
|
|
* @code
|
|
(Program Start)
|
|
|
|
|
V
|
|
+------------------------------------+
|
|
| programStart() |
|
|
+------------------------------------+
|
|
|
|
|
|<-------------------------+
|
|
| |
|
|
V |
|
|
(Initialze CANopen) |
|
|
| |
|
|
V |
|
|
+------------------------------------+ |
|
|
| communicationReset() | |
|
|
+------------------------------------+ |
|
|
| |
|
|
V |
|
|
(Enable CAN and interrupts) |
|
|
| |
|
|
|<----------------------+ |
|
|
| | |
|
|
V | |
|
|
+------------------------------------+ | |
|
|
| programAsync() | | |
|
|
+------------------------------------+ | |
|
|
| | |
|
|
V | |
|
|
(Process CANopen asynchronous) | |
|
|
| | |
|
|
+- infinite loop -------+ |
|
|
| |
|
|
+- reset communication ----+
|
|
|
|
|
V
|
|
+------------------------------------+
|
|
| programEnd() |
|
|
+------------------------------------+
|
|
|
|
|
V
|
|
(delete CANopen)
|
|
|
|
|
V
|
|
(Program end)
|
|
@endcode
|
|
*
|
|
*
|
|
* ###Timer program flow chart
|
|
*
|
|
* @code
|
|
(Timer interrupt 1 millisecond)
|
|
|
|
|
V
|
|
(CANopen read RPDOs)
|
|
|
|
|
V
|
|
+------------------------------------+
|
|
| program1ms() |
|
|
+------------------------------------+
|
|
|
|
|
V
|
|
(CANopen write TPDOs)
|
|
@endcode
|
|
*
|
|
*
|
|
* ###Receive and transmit high priority interrupt flow chart
|
|
*
|
|
* @code
|
|
(CAN receive event or)
|
|
(CAN transmit buffer empty event)
|
|
|
|
|
V
|
|
(Process received CAN message or)
|
|
(copy next message to CAN transmit buffer)
|
|
@endcode
|
|
*/
|
|
|
|
|
|
/**
|
|
* Called after microcontroller reset.
|
|
*/
|
|
void programStart(void);
|
|
|
|
|
|
/**
|
|
* Called after communication reset.
|
|
*/
|
|
void communicationReset(void);
|
|
|
|
|
|
/**
|
|
* Called before program end.
|
|
*/
|
|
void programEnd(void);
|
|
|
|
|
|
/**
|
|
* Called cyclically from main.
|
|
*
|
|
* @param timer1msDiff Time difference since last call
|
|
*/
|
|
void programAsync(uint16_t timer1msDiff);
|
|
|
|
|
|
/**
|
|
* Called cyclically from 1ms timer task.
|
|
*/
|
|
void program1ms(void);
|
|
|
|
|
|
/** @} */
|
|
#endif
|