include/hcs12/applicfg.h
changeset 0 4472ee7c6c3e
child 13 0e43acff2c96
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/include/hcs12/applicfg.h	Wed May 10 16:59:40 2006 +0200
@@ -0,0 +1,193 @@
+/*
+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 __APPLICFG_HC12__
+#define __APPLICFG_HC12__
+
+#include <string.h>
+#include <stdio.h>
+
+#include <../include/hcs12/asm-m68hc12/portsaccess.h>
+#include <../include/hcs12/asm-m68hc12/ports_def.h>
+#include <../include/hcs12/asm-m68hc12/ports.h>
+#include <../include/hcs12/interrupt.h>
+
+
+/// Define the architecture : little_endian or big_endian
+// -----------------------------------------------------
+// Test :
+// UNS32 v = 0x1234ABCD;
+// char *data = &v;
+//
+// Result for a little_endian architecture :
+// data[0] = 0xCD;
+// data[1] = 0xAB;
+// data[2] = 0x34;
+// data[3] = 0x12;
+//
+// Result for a big_endian architecture :
+// data[0] = 0x12;
+// data[1] = 0x34;
+// data[2] = 0xAB;
+// data[3] = 0xCD;
+
+
+#define CANOPEN_BIG_ENDIAN
+
+// Use or not the PLL
+//#define USE_PLL
+
+#ifdef USE_PLL
+#  define BUS_CLOCK 24 // If the quartz on the board is 16 MHz. If different, change this value
+#else 
+#  define BUS_CLOCK 8  // If the quartz on the board is 16 MHz. If different, change this value
+#endif
+
+/// Configuration of the serials port SCI0 and SCI1
+// Tested : 
+//   SERIAL_SCI0_BAUD_RATE 9600      BUS_CLOCK 8   Send OK      Receive not tested
+//   SERIAL_SCI0_BAUD_RATE 19200     BUS_CLOCK 8   Send OK      Receive not tested
+//   SERIAL_SCI0_BAUD_RATE 38400     BUS_CLOCK 8   Send OK      Receive not tested
+//   SERIAL_SCI0_BAUD_RATE 57600     BUS_CLOCK 8   Send Failed  Receive not tested
+//   SERIAL_SCI0_BAUD_RATE 115200    BUS_CLOCK 8   Send Failed  Receive not tested
+
+//   SERIAL_SCI0_BAUD_RATE 9600      BUS_CLOCK 24  Send OK      Receive not tested
+//   SERIAL_SCI0_BAUD_RATE 19200     BUS_CLOCK 24  Send OK      Receive not tested
+//   SERIAL_SCI0_BAUD_RATE 38400     BUS_CLOCK 24  Send OK but init problems     Receive not tested
+//   SERIAL_SCI0_BAUD_RATE 57600     BUS_CLOCK 24  Send Failed  Receive not tested
+//   SERIAL_SCI0_BAUD_RATE 115200    BUS_CLOCK 24  Send Failed  Receive not tested
+
+#define SERIAL_SCI0_BAUD_RATE 19200
+#define SERIAL_SCI1_BAUD_RATE 9600
+
+
+
+
+
+
+// Several hardware definitions functions
+// --------------------------------------
+
+
+/// Initialisation of the serial port 0
+extern void initSCI_0 (void);
+
+/// Initialisation of the serial port 1
+extern void initSCI_1 (void);
+
+/// Convert an integer to a string in hexadecimal format
+/// If you do not wants to use a lastCar, put lastCar = '\0' (end of string)
+/// ex : value = 0XABCDEF and lastCar = '\n'
+/// buf[0] = '0'
+/// buf[1] = 'X'
+/// buf[2] = 'A'
+/// ....
+/// buf[7] = 'F'
+/// buf[8] = '\n'
+/// buf[9] = '\0'
+extern char *
+hex_convert (char *buf, unsigned long value, char lastCar);
+
+/// Print the string to the serial port sci 
+/// (sci takes the values SCI0 or SCI1)
+extern void printSCI_str (char sci, const char * str); 
+
+/// Print the number in hexadecimal  to the serial port sci 
+/// (sci takes the values SCI0 or SCI1)
+extern void printSCI_nbr (char sci, unsigned long nbr, char lastCar);
+
+/// to start using the PLL. Bus clock becomes 24 MHz if the quartz 
+/// on the board is at 16 MHz
+extern void initPLL (void);
+
+/// Put here all the code to init the HCS12
+extern void initHCS12 (void);
+
+// Integers
+#define INTEGER8 signed char
+#define INTEGER16 short
+#define INTEGER24
+#define INTEGER32 long
+#define INTEGER40
+#define INTEGER48
+#define INTEGER56
+#define INTEGER64
+ 
+// Unsigned integers
+#define UNS8   unsigned char
+#define UNS16  unsigned short
+#define UNS32  unsigned long
+#define UNS24
+#define UNS40
+#define UNS48
+#define UNS56
+#define UNS64 
+
+// Whatever your microcontroller, the timer wont work if 
+// TIMEVAL is not at least on 32 bits
+#define TIMEVAL UNS32 
+
+// The timer of the hcs12 counts from 0000 to 0xFFFF
+#define TIMEVAL_MAX 0xFFFF
+
+// The timer is incrementing every 4 us.
+#define MS_TO_TIMEVAL(ms) (ms * 250)
+#define US_TO_TIMEVAL(us) (us>>2)
+
+
+// Reals
+#define REAL32	float
+#define REAL64 double
+
+#include "can.h"
+
+
+/// Definition of MSG_ERR
+// ---------------------
+#ifdef DEBUG_ERR_CONSOLE_ON
+#    define MSG_ERR(num, str, val)            \
+          initSCI_0();                        \
+          printSCI_nbr(SCI0, num, ' ');       \
+          /* large printing on console  */    \
+          printSCI_str(SCI0, str);            \
+          printSCI_nbr(SCI0, val, '\n');      
+#else
+#    define MSG_ERR(num, str, val)
+#endif
+
+/// Definition of MSG_WAR
+// ---------------------
+#ifdef DEBUG_WAR_CONSOLE_ON
+#    define MSG_WAR(num, str, val)          \
+        initSCI_0();                        \
+        printSCI_nbr(SCI0, num, ' ');       \
+        /* large printing on console  */    \
+        printSCI_str(SCI0, str);            \
+        printSCI_nbr(SCI0, val, '\n');      
+#else
+#    define MSG_WAR(num, str, val)
+#endif
+
+
+#endif
+
+