kinetis_common.cpp File Reference

Detailed Description

Low level common Kinetis code.

Date

Mar 28, 2019

Author

andreika prome.nosp@m.theu.nosp@m.s.pcb.nosp@m.@gma.nosp@m.il.co.nosp@m.m

Definition in file kinetis_common.cpp.

Functions
brain_pin_e	getAdcChannelBrainPin (const char *msg, adc_channel_e hwChannel)
adc_channel_e	getAdcChannel (brain_pin_e pin)
bool	adcIsMuxedInput (adc_channel_e hwChannel)
adc_channel_e	adcMuxedGetParent (adc_channel_e hwChannel)
int	getAdcInternalChannel (ADC_TypeDef *adc, adc_channel_e hwChannel)
adc_channel_e	getHwChannelForAdcInput (ADC_TypeDef *adc, size_t hwIndex)
ioportid_t	getAdcChannelPort (const char *msg, adc_channel_e hwChannel)
int	getAdcChannelPin (adc_channel_e hwChannel)
void	jump_to_bootloader ()
int	getRemainingStack (thread_t *otp)

Function Documentation

adcIsMuxedInput()

bool adcIsMuxedInput

(

adc_channel_e

hwChannel

)

Definition at line 112 of file kinetis_common.cpp.

                                              {
    return false;
}

adcMuxedGetParent()

adc_channel_e adcMuxedGetParent

(

adc_channel_e

hwChannel

)

Definition at line 116 of file kinetis_common.cpp.

{
    return hwChannel;
}

getAdcChannel()

adc_channel_e getAdcChannel

(

brain_pin_e

pin

)

Definition at line 73 of file kinetis_common.cpp.

                                             {
    switch (pin) {
    case Gpio::A2:
        return EFI_ADC_0;
    case Gpio::A3:
        return EFI_ADC_1;
    //case Gpio::A2:
    //  return EFI_ADC_2;
    case Gpio::D3:
        return EFI_ADC_3;
    //case Gpio::A4:
    //  return EFI_ADC_4;
    //case Gpio::A5:
    //  return EFI_ADC_5;
    //case Gpio::A6:
    //  return EFI_ADC_6;
    case Gpio::B12:
        return EFI_ADC_7;
    case Gpio::B13:
        return EFI_ADC_8;
    //case Gpio::B1:
    //  return EFI_ADC_9;
    case Gpio::E2:
        return EFI_ADC_10;
    //case Gpio::C1:
    //  return EFI_ADC_11;
    case Gpio::C14:
        return EFI_ADC_12;
    case Gpio::C15:
        return EFI_ADC_13;
    case Gpio::C16:
        return EFI_ADC_14;
    case Gpio::C17:
        return EFI_ADC_15;
    default:
        return EFI_ADC_ERROR;
    }
}

getAdcChannelBrainPin()

brain_pin_e getAdcChannelBrainPin	(	const char *	msg,
		adc_channel_e	hwChannel
	)

Definition at line 30 of file kinetis_common.cpp.

                                                                            {
    static_assert(EFI_ADC_NONE == ADC_CHANNEL_NONE);
 
    // todo: replace this with an array :)
    switch (hwChannel) {
    case EFI_ADC_0:
        return Gpio::A2;
    case EFI_ADC_1:
        return Gpio::A3;
    case EFI_ADC_2:
        return Gpio::Invalid;
    case EFI_ADC_3:
        return Gpio::D3;
    case EFI_ADC_4:
        return Gpio::Invalid;
    case EFI_ADC_5:
        return Gpio::Invalid;
    case EFI_ADC_6:
        return Gpio::Invalid;
    case EFI_ADC_7:
        return Gpio::B12;
    case EFI_ADC_8:
        return Gpio::B13;
    case EFI_ADC_9:
        return Gpio::Invalid;
    case EFI_ADC_10:
        return Gpio::E2;
    case EFI_ADC_11:
        return Gpio::Invalid;
    case EFI_ADC_12:
        return Gpio::C14;
    case EFI_ADC_13:
        return Gpio::C15;
    case EFI_ADC_14:
        return Gpio::C16;
    case EFI_ADC_15:
        return Gpio::C17;
    default:
        firmwareError(ObdCode::CUSTOM_ERR_ADC_UNKNOWN_CHANNEL, "Unknown hw channel %d [%s]", hwChannel, msg);
        return Gpio::Invalid;
    }
}

Referenced by getAdcChannelPin(), and getAdcChannelPort().

Here is the call graph for this function:

Here is the caller graph for this function:

getAdcChannelPin()

int getAdcChannelPin

(

adc_channel_e

hwChannel

)

Definition at line 140 of file kinetis_common.cpp.

                                              {
    return getHwPin("get_pin", getAdcChannelBrainPin("get_pin", hwChannel));
}

Here is the call graph for this function:

getAdcChannelPort()

ioportid_t getAdcChannelPort	(	const char *	msg,
		adc_channel_e	hwChannel
	)

Definition at line 135 of file kinetis_common.cpp.

                                                                       {
    return getHwPort(msg, getAdcChannelBrainPin(msg, hwChannel));
}

Here is the call graph for this function:

getAdcInternalChannel()

int getAdcInternalChannel	(	ADC_TypeDef *	adc,
		adc_channel_e	hwChannel
	)

Definition at line 121 of file kinetis_common.cpp.

                                                                     {
    (void)adc;
 
    return (hwChannel - EFI_ADC_0);
}

getHwChannelForAdcInput()

adc_channel_e getHwChannelForAdcInput	(	ADC_TypeDef *	adc,
		size_t	hwIndex
	)

Definition at line 127 of file kinetis_common.cpp.

{
    (void)adc;
 
    return (EFI_ADC_0 + hwIndex);
}

getRemainingStack()

int getRemainingStack

(

thread_t *

otp

)

Of note is that interrupts are NOT serviced on the stack of the thread that was running when the interrupt occurred. The only thing that happens on that thread's stack is that its registers are pushed (by hardware) when an interrupt occurs, just before swapping the stack pointer out for the main stack (currently 0x400=1024 bytes), where the ISR actually runs. see also main_stack_size see also process_stack_size

see also http://www.chibios.org/dokuwiki/doku.php?id=chibios:kb:stacks

In the firmware we are using 'extern *Engine' - in the firmware Engine is a singleton

On the other hand, in order to have a meaningful unit test we are passing Engine * engine as a parameter

Definition at line 159 of file kinetis_common.cpp.

                                     {
    // todo: would stm32 code actually work here since similar Cortex?
    return 888888;
}

jump_to_bootloader()

void jump_to_bootloader

(

)

Definition at line 148 of file kinetis_common.cpp.

                          {
    typedef void (*bootloader_start_t)(void * arg);
    // Read the function address from the ROM API tree and turn it into a function pointer
    bootloader_start_t bootloaderStart = (bootloader_start_t)(**(uint32_t **)BOOTLOADER_LOCATION);
    // Call the function!
    bootloaderStart(NULL);
    // Will not return from here
    NVIC_SystemReset();
}

Go to the source code of this file.