Startup

Contains API prototype for the Startup Task Manager. More...

Files
file	task_manager_startup.c
	Implements API for Startup Task Manager.

Functions
void	TM_Startup (const scheduleEntry_t appStartupSchedule[], uint8_t scheduleLength)
	Manages and synchronizes safety system and application startup Tasks.

Detailed Description

Contains API prototype for the Startup Task Manager.

Version

1.0.0-alpha.1

The Startup Task Manager is responsible for running Tasks required for initializing and diagnosing the safety system, including application specific startup and diagnostic Tasks, before exiting the Safe State and transitioning to Mission Mode.

Copyright

© 2025 Microchip Technology Inc. and its subsidiaries.

Subject to your compliance with these terms, you may use Microchip software and any derivatives exclusively with Microchip products. It is your responsibility to comply with third party license terms applicable to your use of third party software (including open source software) that may accompany Microchip software.

THIS SOFTWARE IS SUPPLIED BY MICROCHIP "AS IS". NO WARRANTIES, WHETHER EXPRESS, IMPLIED OR STATUTORY, APPLY TO THIS SOFTWARE, INCLUDING ANY IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY, AND FITNESS FOR A PARTICULAR PURPOSE.

IN NO EVENT WILL MICROCHIP BE LIABLE FOR ANY INDIRECT, SPECIAL, PUNITIVE, INCIDENTAL OR CONSEQUENTIAL LOSS, DAMAGE, COST OR EXPENSE OF ANY KIND WHATSOEVER RELATED TO THE SOFTWARE, HOWEVER CAUSED, EVEN IF MICROCHIP HAS BEEN ADVISED OF THE POSSIBILITY OR THE DAMAGES ARE FORESEEABLE. TO THE FULLEST EXTENT ALLOWED BY LAW, MICROCHIP'S TOTAL LIABILITY ON ALL CLAIMS IN ANY WAY RELATED TO THIS SOFTWARE WILL NOT EXCEED THE AMOUNT OF FEES, IF ANY, THAT YOU HAVE PAID DIRECTLY TO MICROCHIP FOR THIS SOFTWARE.

UML Class Diagrams

UML Sequence Diagrams

Function Documentation

TM_Startup()

void TM_Startup	(	const scheduleEntry_t	appStartupSchedule[],
		uint8_t	scheduleLength )

Manages and synchronizes safety system and application startup Tasks.

This function executes safety system and application-specific startup Tasks with fixed durations. Durations for the safety system startup Tasks are configured using DUR_RUN_STARTUP_DIAGNOSTICS, DUR_START_MISSION_MODE, and DUR_UNTIL_FIRST_SCHEDULE.

After initializing the hardware safety mechanisms and running startup diagnostics, all application startup Tasks are executed in sequence before starting Mission Mode (exiting Safe State). See tips_and_tricks watchdog sections for how to extend timeout duration if the amount of application startup task demands it.

Parameters

appStartupSchedule	Array of schedule entries with a Task function pointer and duration in system clock cycles. Any Task set to a NULL pointer is skipped. Duration is limited to a 24-bit value.
scheduleLength	Number of entries in appStartupSchedule. A value of '0' indicates an empty schedule and no application startup Tasks will run.

Warning

An invalid Task function pointer in appStartupSchedule leads to undefined behavior.

Passing a scheduleLength larger than the size of appStartupSchedule results in undefined behavior.

Definition at line 33 of file task_manager_startup.c.