Toyota-AVC-LAN/vendor/jnk0le-AVR-UART-lib/usart_config.h

/*!
 * \brief
 *
 * \author Jan Oleksiewicz <jnk0le@hotmail.com>
 * \license SPDX-License-Identifier: MIT
 */

#ifndef USART_CONFIG_H_
#define USART_CONFIG_H_

// DO NOT DEFINE F_CPU, BUFFERS SIZES OR ANY OTHER SHARED MACROS IN 'main.c'
// CODE instead of this, define it in makefile (-D flag) or "Project Properties
// -> AVR C Compiler -> Symbols"

// #define NO_USART_RX // disable all receiver code and dependencies
// #define NO_USART_TX // disable all transmitter code and dependencies

// globally enable MPCM operation mode
// 9 bit data frame only
// always set frame format to 8 data bits
// #define USART_MPCM_MODE

// enables double speed for all available USART interfaces
#define USE_DOUBLE_SPEED

// echoes back received characters in getchar() function (for reading in
// scanf())
#define RX_STDIO_GETCHAR_ECHO
// #define RX_GETC_ECHO // echoes back received characters in getc() function

// allow for unix style (\n only) newline terminator in stored strings
// not included into putc_noblock
// #define PUTC_CONVERT_LF_TO_CRLF

// a lot of terminals sends only \r character as a newline terminator, instead
// of \r\n or even unix style \n (BTW PuTTY doesn't allow to change this) but in
// return requires \r\n terminator to show not broken text
// 0 - \r,  1 - \n,  2 - \r\n
#define RX_NEWLINE_MODE 1

// do not use prematures that might break compilers ABI (non-gcc calling
// conventions), compilers that are not forcing constant number of call-used
// registers might generate even better code
// #define USART_NO_ABI_BREAKING_PREMATURES

// use uppercase letters in uart_puthex() function
#define USART_PUTHEX_IN_UPPERCASE

// extend RX buffer by hardware 2/3 byte FIFO
// required for hardware and software RTS
// #define USART_EXTEND_RX_BUFFER

// skip FIFO procedure and write directly
// data to the UDR register when possible
// probably required for full bus utilization at highest speed (f_cpu/8)
// #define USART_PUTC_FAST_INSERTIONS

// do not allocate temporary buffers on stack for integer/float <-> asci
// conversions and use globally visible u_tmp_buff[] instead it have to be
// declared in application part and have to be at least of 6-17 bytes wide
// (depending on what is being converted)
// #define USART_NO_LOCAL_BUFFERS

// max 19 cycles of interrupt latency
// 3+PC bytes on stack
// will not interrupt itself
// #define USART_UNSAFE_TX_INTERRUPT

// max 23 cycles of interrupt latency
// 4+PC bytes on stack
// will not interrupt itself
// #define USART_UNSAFE_RX_INTERRUPT

// remap hardware registers of USART1/2/3 to USART0 if only one interface is
// used
// #define USART_REMAP_LAST_INTERFACE

// do not generate code for writing to ubrrh if calculated value is zero
// prematures out 2 bytes if ubrr is compile time constant
// #define USART_SKIP_UBRRH_IF_ZERO

// prematures out 4 cycles from every isr run
// requires one globally reserved lower register
#define USART_USE_GLOBALLY_RESERVED_ISR_SREG_SAVE

// prematures out 6 cycles from every isr run
// requires pair of globally reserved lower registers usage of globally reserved
// register for temporary storage in interrupts, should be combined with other
// interrupts for best results. special care have to be taken when doing so,
// since those registers can still be used by other compilation units (fixable
// in gcc by -ffixed-n flag, where n is a suppressed register), precompiled
// libraries (vprintf, vscanf, qsort, strtod, strtol, strtoul), or even assembly
// hardcoded libraries (fft, aes). registers r2-r7 should be used instead of the
// higher ones, since those are never used by gcc for eg. argument passing.
#define USART_USE_GLOBALLY_RESERVED_ISR_Z_SAVE

// have to be redeclared under the same name if the same registers are reused in
// other instances (libs)
#define USART_SREG_SAVE_REG_NAME G_sreg_save
#define USART_SREG_SAVE_REG_NUM  "r4"

// have to be redeclared under the same name if the same registers are reused in
// other instances (libs)
#define USART_Z_SAVE_REG_NAME G_z_save

// register pair rn and rn+1 (rn+1:rn gives "invalid register name")
#define USART_Z_SAVE_REG_NUM "r2"

// Size of the ring buffers, must be power of 2
// default 32
#define RX_BUFFER_SIZE 64

// Size of the ring buffers, must be power of 2
// default 32
#define TX_BUFFER_SIZE 128

/*******************config for multiple USART * mcu's*************************/

// #define NO_USART0 // disable usage of uart0
// #define NO_USART1 // disable usage of uart1
// #define NO_USART2 // disable usage of uart2
// #define NO_USART3 // disable usage of uart3

// #define RX0_BUFFER_SIZE 128
// #define TX0_BUFFER_SIZE 64

// #define RX1_BUFFER_SIZE 128
// #define TX1_BUFFER_SIZE 64

// #define RX2_BUFFER_SIZE 128
// #define TX2_BUFFER_SIZE 64

// #define RX3_BUFFER_SIZE 128
// #define TX3_BUFFER_SIZE 64

/****** Disable RX interrupts ******/
// removes whole receive code (including ISR) and frees RX0 pin
// combining with NO_USART_RX is not necessary
// #define NO_RX0_INTERRUPT

// removes whole receive code (including ISR) and frees RX1 pin
// #define NO_RX1_INTERRUPT

// removes whole receive code (including ISR) and frees RX2 pin
// #define NO_RX2_INTERRUPT

// removes whole receive code (including ISR) and frees RX3 pin
// #define NO_RX3_INTERRUPT

/****** Disable TX interrupts ******/
// removes whole transmit code (including ISR) and frees TX0 pin
// combining with NO_USART_TX is not necessary
// #define NO_TX0_INTERRUPT

// removes whole transmit code (including ISR) and frees TX1 pin
// #define NO_TX1_INTERRUPT

// removes whole transmit code (including ISR) and frees TX2 pin
// #define NO_TX2_INTERRUPT

// removes whole transmit code (including ISR) and frees TX3 pin
// #define NO_TX3_INTERRUPT

// #define USART0_U2X_SPEED // enables double speed for USART0
// #define USART1_U2X_SPEED // enables double speed for USART1
// #define USART2_U2X_SPEED // enables double speed for USART2
// #define USART3_U2X_SPEED // enables double speed for USART3

// #define RX0_GETC_ECHO
// #define RX1_GETC_ECHO
// #define RX2_GETC_ECHO
// #define RX3_GETC_ECHO

// #define PUTC0_CONVERT_LF_TO_CRLF
// #define PUTC1_CONVERT_LF_TO_CRLF
// #define PUTC2_CONVERT_LF_TO_CRLF
// #define PUTC3_CONVERT_LF_TO_CRLF

// #define USART0_EXTEND_RX_BUFFER
// #define USART1_EXTEND_RX_BUFFER
// #define USART2_EXTEND_RX_BUFFER
// #define USART3_EXTEND_RX_BUFFER

// #define USART0_PUTC_FAST_INSERTIONS
// #define USART1_PUTC_FAST_INSERTIONS
// #define USART2_PUTC_FAST_INSERTIONS
// #define USART3_PUTC_FAST_INSERTIONS

// #define USART0_MPCM_MODE
// #define USART1_MPCM_MODE
// #define USART2_MPCM_MODE
// #define USART3_MPCM_MODE

/***********************soft flow control * config*****************************/
// define IO instance to enable software CTS
// CTS handlers also have to be placed into INT/PCINT interrupt in the
// application code, see example(flow control).c

// #define CTS0_DDR // DDRB
// #define CTS0_PORT // PORTB
// #define CTS0_PIN // PINB
// #define CTS0_IONUM // 0 // pin number

// #define CTS1_DDR
// #define CTS1_PORT
// #define CTS1_PIN
// #define CTS1_IONUM

// #define CTS2_DDR
// #define CTS2_PORT
// #define CTS2_PIN
// #define CTS2_IONUM

// #define CTS3_DDR
// #define CTS3_PORT
// #define CTS3_PIN
// #define CTS3_IONUM

// define IO instance to enable software RTS

// #define RTS0_DDR // DDRB
// #define RTS0_PORT // PORTB
// #define RTS0_PIN // PINB
// #define RTS0_IONUM // 1 // pin number

// #define RTS1_DDR
// #define RTS1_PORT
// #define RTS1_PIN
// #define RTS1_IONUM

// #define RTS2_DDR
// #define RTS2_PORT
// #define RTS2_PIN
// #define RTS2_IONUM

// #define RTS3_DDR
// #define RTS3_PORT
// #define RTS3_PIN
// #define RTS3_IONUM

/*****************************RS 485 config***********************************/
// define IO instance to enable half duplex rs485 operation mode // used pin
// should be initially kept in low state before boot

// #define RS485_CONTROL0_DDR // DDRB
// #define RS485_CONTROL0_PORT // PORTB
// #define RS485_CONTROL0_PIN // PINB
// #define RS485_CONTROL0_IONUM // 2 // pin number

// #define RS485_CONTROL1_DDR
// #define RS485_CONTROL1_PORT
// #define RS485_CONTROL1_PIN
// #define RS485_CONTROL1_IONUM

// #define RS485_CONTROL2_DDR
// #define RS485_CONTROL2_PORT
// #define RS485_CONTROL2_PIN
// #define RS485_CONTROL2_IONUM

// #define RS485_CONTROL3_DDR
// #define RS485_CONTROL3_PORT
// #define RS485_CONTROL3_PIN
// #define RS485_CONTROL3_IONUM

/*****************************MPCM config***********************************/

#define MPCM0_ADDRESS 0x01
#define MPCM1_ADDRESS 0x02
#define MPCM2_ADDRESS 0x03
#define MPCM3_ADDRESS 0x04

// #define MPCM0_GCALL_ADDRESS 0x00
// #define MPCM1_GCALL_ADDRESS 0x00
// #define MPCM2_GCALL_ADDRESS 0x00
// #define MPCM3_GCALL_ADDRESS 0x00

// #define MPCM0_MASTER_ONLY // do not include slave code into RX ISR
// #define MPCM1_MASTER_ONLY // do not include slave code into RX ISR
// #define MPCM2_MASTER_ONLY // do not include slave code into RX ISR
// #define MPCM3_MASTER_ONLY // do not include slave code into RX ISR

// Optional macros for placing user-defined code that will be executed inside of
// USART interrupt handlers. Only inline asm and its input operand lists are
// allowed to be put here. Too large code may generate weird cryptic linker
// errors, what is caused by exceeded range of branch instructions.
// http://www.nongnu.org/avr-libc/user-manual/inline_asm.html

// example:
// #define STH_EVENT "nop \n\t"\                              //
//                  "ldi r31, %M[A_MASK] \n\t"\              //
//                  "out %M[TIMADDR], r31 \n\t"
// #define OPERAND_LIST [A_MASK] "M" (0x55),\                 //
//                     [TIMADDR]  "M" (_SFR_IO_ADDR(TCCR0A)),

// code executed on every ISR call, before feeding UDR (for this racing
// implementation only), can be placed here // r30 and r31 are free to use
#define TX0_EVERYCAL_EVENT "\n\t"

// code executed on every byte transmission, can be placed here // r30 and r31
// are free to use // r30 contains currently transmitted data byte
#define TX0_TRANSMIT_EVENT "\n\t"

#define TX0_INPUT_OPERAND_LIST

#if !defined(USART0_EXTEND_RX_BUFFER) // DO NOT CHANGE
  // code executed before reading UDR register can be placed here // r25 is free
  // to use // executed before enabling interrupts in unsafe mode
  #define RX0_FRAMING_EVENT "\n\t"

  // #define USART0_PUSH_BEFORE_RX // frees r30 an r31 for FRAMING_EVENT
#else
  // code executed before reading UDR register can be placed here // r25 and r31
  // are free to use
  #define RX0_FRAMING_EVENT "\n\t"
#endif

// code executed on every ISR call, can be placed here // r30 and r31 are free
// to use // r25 contains received data byte if 'extended buffer' mode is not
// used, free to use otherwise
#define RX0_EVERYCALL_EVENT "\n\t"

// code executed only when databyte was received, before buffer store, can be
// placed here // r31 is free to use // r25 contains received data byte, r30
// rxn_last_byte buffer index // MPCM ??
#define RX0_EARLY_RECEIVE_EVENT "\n\t"

// code executed only when databyte was received, can be placed here //
// r25,r30,r31 are free to use // r25 contains received data byte
#define RX0_LATE_RECEIVE_EVENT "\n\t"

#define RX0_INPUT_OPERAND_LIST

//************************************************

#define TX1_EVERYCAL_EVENT "\n\t"
#define TX1_TRANSMIT_EVENT "\n\t"

#define TX1_INPUT_OPERAND_LIST

#if !defined(USART1_EXTEND_RX_BUFFER) // DO NOT CHANGE
  #define RX1_FRAMING_EVENT "\n\t"
  // #define USART1_PUSH_BEFORE_RX
#else
  #define RX1_FRAMING_EVENT "\n\t"
#endif

#define RX1_EVERYCALL_EVENT     "\n\t"
#define RX1_EARLY_RECEIVE_EVENT "\n\t"
#define RX1_LATE_RECEIVE_EVENT  "\n\t"

#define RX1_INPUT_OPERAND_LIST

//************************************************

#define TX2_EVERYCAL_EVENT "\n\t"
#define TX2_TRANSMIT_EVENT "\n\t"

#define TX2_INPUT_OPERAND_LIST

#if !defined(USART2_EXTEND_RX_BUFFER) // DO NOT CHANGE
  #define RX2_FRAMING_EVENT "\n\t"
  // #define USART2_PUSH_BEFORE_RX
#else
  #define RX2_FRAMING_EVENT "\n\t"
#endif

#define RX2_EVERYCALL_EVENT     "\n\t"
#define RX2_EARLY_RECEIVE_EVENT "\n\t"
#define RX2_LATE_RECEIVE_EVENT  "\n\t"

#define RX2_INPUT_OPERAND_LIST

//************************************************

#define TX3_EVERYCAL_EVENT "\n\t"
#define TX3_TRANSMIT_EVENT "\n\t"

#define TX3_INPUT_OPERAND_LIST

#if !defined(USART3_EXTEND_RX_BUFFER) // DO NOT CHANGE
  #define RX3_FRAMING_EVENT "\n\t"
  // #define USART3_PUSH_BEFORE_RX
#else
  #define RX3_FRAMING_EVENT "\n\t"
#endif

#define RX3_EVERYCALL_EVENT     "\n\t"
#define RX3_EARLY_RECEIVE_EVENT "\n\t"
#define RX3_LATE_RECEIVE_EVENT  "\n\t"

#define RX3_INPUT_OPERAND_LIST

// events executed inside transmit complete interrupts (last byte has been
// transmitted, UDR buffer is empty) if USATRn_NO_NAKED_TXC_INTERRUPT is not
// defined then inline asm is required here // any modified regs have to be
// pushed first
// inline void TXCn_interrupt_event(void)
//{
//	asm volatile("\n\t"
//		"nop \n\t"
//		"lpm \n\t"
//		"st Z+, r0 \n\t"
//	:: );
//}
// mpcm ??

// #define USATR0_NO_NAKED_TXC_INTERRUPT
// #define USART0_USE_TXC_INTERRUPT // if rs485 is not used

inline void TXC0_interrupt_event(void) __attribute__((always_inline));
inline void TXC0_interrupt_event(void) {}

// #define USATR1_NO_NAKED_TXC_INTERRUPT
// #define USART1_USE_TXC_INTERRUPT

inline void TXC1_interrupt_event(void) __attribute__((always_inline));
inline void TXC1_interrupt_event(void) {}

// #define USATR2_NO_NAKED_TXC_INTERRUPT
// #define USART2_USE_TXC_INTERRUPT

inline void TXC2_interrupt_event(void) __attribute__((always_inline));
inline void TXC2_interrupt_event(void) {}

// #define USATR3_NO_NAKED_TXC_INTERRUPT
// #define USART3_USE_TXC_INTERRUPT

inline void TXC3_interrupt_event(void) __attribute__((always_inline));
inline void TXC3_interrupt_event(void) {}

#endif /* USART_CONFIG_H_ */