1

/*

     2

This file is part of CanFestival, a library implementing CanOpen Stack. 

     3

     4

Copyright (C): Edouard TISSERANT and Francis DUPIN

     5

     6

See COPYING file for copyrights details.

     7

     8

This library is free software; you can redistribute it and/or

     9

modify it under the terms of the GNU Lesser General Public

    10

License as published by the Free Software Foundation; either

    11

version 2.1 of the License, or (at your option) any later version.

    12

    13

This library is distributed in the hope that it will be useful,

    14

but WITHOUT ANY WARRANTY; without even the implied warranty of

    15

MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU

    16

Lesser General Public License for more details.

    17

    18

You should have received a copy of the GNU Lesser General Public

    19

License along with this library; if not, write to the Free Software

    20

Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

    21

*/

    22

    23

#ifndef __APPLICFG_HC12__

    24

#define __APPLICFG_HC12__

    25

    26

#include <string.h>

    27

#include <stdio.h>

    28

    29

#include <../include/hcs12/asm-m68hc12/portsaccess.h>

    30

#include <../include/hcs12/asm-m68hc12/ports_def.h>

    31

#include <../include/hcs12/asm-m68hc12/ports.h>

    32

#include <../include/hcs12/interrupt.h>

    33

    34

    35

/// Define the architecture : little_endian or big_endian

    36

// -----------------------------------------------------

    37

// Test :

    38

// UNS32 v = 0x1234ABCD;

    39

// char *data = &v;

    40

//

    41

// Result for a little_endian architecture :

    42

// data[0] = 0xCD;

    43

// data[1] = 0xAB;

    44

// data[2] = 0x34;

    45

// data[3] = 0x12;

    46

//

    47

// Result for a big_endian architecture :

    48

// data[0] = 0x12;

    49

// data[1] = 0x34;

    50

// data[2] = 0xAB;

    51

// data[3] = 0xCD;

    52

    57

    58

    59

// Use or not the PLL

    60

//#define USE_PLL

    61

    62

#ifdef USE_PLL

    63

#  define BUS_CLOCK 24 // If the quartz on the board is 16 MHz. If different, change this value

    64

#else 

    65

#  define BUS_CLOCK 8  // If the quartz on the board is 16 MHz. If different, change this value

    66

#endif

    67

    68

/// Configuration of the serials port SCI0 and SCI1

    69

// Tested : 

    70

//   SERIAL_SCI0_BAUD_RATE 9600      BUS_CLOCK 8   Send OK      Receive not tested

    71

//   SERIAL_SCI0_BAUD_RATE 19200     BUS_CLOCK 8   Send OK      Receive not tested

    72

//   SERIAL_SCI0_BAUD_RATE 38400     BUS_CLOCK 8   Send OK      Receive not tested

    73

//   SERIAL_SCI0_BAUD_RATE 57600     BUS_CLOCK 8   Send Failed  Receive not tested

    74

//   SERIAL_SCI0_BAUD_RATE 115200    BUS_CLOCK 8   Send Failed  Receive not tested

    75

    76

//   SERIAL_SCI0_BAUD_RATE 9600      BUS_CLOCK 24  Send OK      Receive not tested

    77

//   SERIAL_SCI0_BAUD_RATE 19200     BUS_CLOCK 24  Send OK      Receive not tested

    78

//   SERIAL_SCI0_BAUD_RATE 38400     BUS_CLOCK 24  Send OK but init problems     Receive not tested

    79

//   SERIAL_SCI0_BAUD_RATE 57600     BUS_CLOCK 24  Send Failed  Receive not tested

    80

//   SERIAL_SCI0_BAUD_RATE 115200    BUS_CLOCK 24  Send Failed  Receive not tested

    81

    82

#define SERIAL_SCI0_BAUD_RATE 38400

    83

#define SERIAL_SCI1_BAUD_RATE 9600

    84

    85

    86

    87

    88

    89

    90

// Several hardware definitions functions

    91

// --------------------------------------

    92

    93

    94

/// Initialisation of the serial port 0

    95

extern void initSCI_0 (void);

    96

    97

/// Initialisation of the serial port 1

    98

extern void initSCI_1 (void);

    99

   100

/// Convert an integer to a string in hexadecimal format

   101

/// If you do not wants to use a lastCar, put lastCar = '\0' (end of string)

   102

/// ex : value = 0XABCDEF and lastCar = '\n'

   103

/// buf[0] = '0'

   104

/// buf[1] = 'X'

   105

/// buf[2] = 'A'

   106

/// ....

   107

/// buf[7] = 'F'

   108

/// buf[8] = '\n'

   109

/// buf[9] = '\0'

   110

extern char *

   111

hex_convert (char *buf, unsigned long value, char lastCar);

   112

   113

/// Print the string to the serial port sci 

   114

/// (sci takes the values SCI0 or SCI1)

   115

extern void printSCI_str (char sci, const char * str); 

   116

   117

/// Print the number in hexadecimal  to the serial port sci 

   118

/// (sci takes the values SCI0 or SCI1)

   119

extern void printSCI_nbr (char sci, unsigned long nbr, char lastCar);

   120

   121

/// to start using the PLL. Bus clock becomes 24 MHz if the quartz 

   122

/// on the board is at 16 MHz

   123

extern void initPLL (void);

   124

   125

/// Put here all the code to init the HCS12

   126

extern void initHCS12 (void);

   127

   128

// Integers

   129

#define INTEGER8 signed char

   130

#define INTEGER16 short

   131

#define INTEGER24

   132

#define INTEGER32 long

   133

#define INTEGER40

   134

#define INTEGER48

   135

#define INTEGER56

   136

#define INTEGER64

   137

   138

// Unsigned integers

   139

#define UNS8   unsigned char

   140

#define UNS16  unsigned short

   141

#define UNS32  unsigned long

   142

#define UNS24

   143

#define UNS40

   144

#define UNS48

   145

#define UNS56

   146

#define UNS64 

   147

   148

// Whatever your microcontroller, the timer wont work if 

   149

// TIMEVAL is not at least on 32 bits

   150

#define TIMEVAL UNS32 

   151

   152

// The timer of the hcs12 counts from 0000 to 0xFFFF

   153

#define TIMEVAL_MAX 0xFFFF

   154

   155

// The timer is incrementing every 4 us.

   156

#define MS_TO_TIMEVAL(ms) (ms * 250)

   157

#define US_TO_TIMEVAL(us) (us>>2)

   158

   159

   160

// Reals

   161

#define REAL32	float

   162

#define REAL64 double

   163

   164

#include "can.h"

   165

   166

   167

/// Definition of MSG_ERR

   168

// ---------------------

   169

#ifdef DEBUG_ERR_CONSOLE_ON

   170

#    define MSG_ERR(num, str, val)            \

   171

          initSCI_0();                        \

   172

          printSCI_nbr(SCI0, num, ' ');       \

   173

          /* large printing on console  */    \

   174

          printSCI_str(SCI0, str);            \

   175

          printSCI_nbr(SCI0, val, '\n');      

   176

#else

   177

#    define MSG_ERR(num, str, val)

   178

#endif

   179

   180

/// Definition of MSG_WAR

   181

// ---------------------

   182

#ifdef DEBUG_WAR_CONSOLE_ON

   183

#    define MSG_WAR(num, str, val)          \

   184

        initSCI_0();                        \

   185

        printSCI_nbr(SCI0, num, ' ');       \

   186

        /* large printing on console  */    \

   187

        printSCI_str(SCI0, str);            \

   188

        printSCI_nbr(SCI0, val, '\n');      

   189

#else

   190

#    define MSG_WAR(num, str, val)

   191

#endif

   192

   193

   194

#endif

   195

   196