/******************************************************************************
*
* File Name:      j1939.h
*
* Description:    Main part of the J1939 protocol stack 
*                 
*
* Comments:       
*                 
*
* Version  Date         Author           Comments
* -------  ----------   --------------   ------------------------------
*    0.9   18.12.98     Ft               Create
*    1.0   28.04.99     Ft               C167CR and Tasking Compiler
*    1.1   01.06.01     Ma               Doxygen
*    1.2   10.08.01     Ma/Ft            modificatio for 8051
*
* Copyright (c) 1998, 99, 00, 01 Vector Informatik GmbH
*****************************************************************************/

/*--------------------------------------------------------------------*/
/*  documentation                                                     */
/*--------------------------------------------------------------------*/

/*!
  \file
  \brief J1939 Protocol stack source code Documentation.
*/

/*!
  \mainpage J1939 Source Code documentation
  \section maintask10 Overview

   This source code provides J1939 functionality which conforms
   to the SAE J1939 specification
   The code incorporates the following features:

   - Transmission of "Address Claiming" at boot-up
   - Response to "Address Claiming" messages at boot-up and during later operation
   - Support of the "Commanded Address" parameter group
   - Support of the "Request" parameter group
   - Independent handling of "Connection Mode Data Transfer" blocks
   - Independent handling of "Broadcast Announce Message" blocks
   - Automatic transmit and receive of application-specific PGs
   - Timeout monitoring for Cyclic Receive PGs

  \subsection maintask11 Introduction

   With regard to function, the protocol stack essentially consists of 4 parts:

   1. CAN driver 
   2. Time management
   3. Buffer Module
   4. J1939 protocol
   
   The CAN driver is operated Basic-CAN. Objects 1 (TX Object) and 4 (RX Object) are available 
   as transmit respectively receive queues for all the system parameter groups. The user parameter groups
   will handled by a buffer structure. The used parameter groups must be allocated in the buffer by
   the application. Also they are used to handle all protocol communications. This includes nodes 
   signing onto the network (Address Claiming) and the handling of transport protocols (BAM and CMDT) 
   and the Request commands. Time management is the smallest module. All timers needed by the protocol 
   stack are managed here. Time management runs in the interrupt of Timer 2 (16 bit timer mode). Hardware 
   Timer 2 triggers an interrupt every ms and increments the software timer 攖ick