/* * core.h - core descriptor and associated access functions définition * * Authors Ghassan Almaless (2008,2009,2010,2011,2012) * Alain Greiner (2016,2017) * * Copyright (c) UPMC Sorbonne Universites * * This file is part of ALMOS-MKH. * * ALMOS-MKH is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License as published by * the Free Software Foundation; version 2.0 of the License. * * ALMOS-MKH 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 * General Public License for more details. * * You should have received a copy of the GNU General Public License * along with ALMOS-MKH; if not, write to the Free Software Foundation, * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA */ #ifndef _CORE_H_ #define _CORE_H_ #include #include #include #include #include /**** Forward declarations ****/ struct thread_s; struct chdev_s; /**************************************************************************************** * This structure defines the core descriptor. * - It contains an embedded private scheduler. * - It contains the three interrupt vectors, implemented as three arrays of pointers * on the source channel devices, for all IRQs allocated to the core. ***************************************************************************************/ typedef struct core_s { lid_t lid; /*! core local index in cluster */ gid_t gid; /*! core global identifier (hardware index) */ uint64_t cycles; /*! total number of cycles (from hard reset) */ uint32_t time_stamp; /*! previous time stamp (read from register) */ uint32_t ticks_nr; /*! number of elapsed ticks */ uint32_t ticks_period; /*! number of cycles between two ticks */ uint32_t usage; /*! cumulated busy_percent (idle / total) */ uint32_t spurious_irqs; /*! for instrumentation... */ struct thread_s * thread_rpc; /*! pointer on current RPC thread descriptor */ struct thread_s * thread_idle; /*! pointer on idle thread descriptor */ struct thread_s * fpu_owner; /*! pointer on current FPU owner thread */ uint32_t rand_last; /*! last computed random value */ uint32_t rpc_threads; /*! total number of RPC threads for this core */ list_entry_t rpc_free_list; /*! root of the list of free RPC threads */ scheduler_t scheduler; /*! embedded private scheduler */ struct chdev_s * hwi_vector[CONFIG_MAX_HWIS_PER_ICU]; /*! on source device */ struct chdev_s * pti_vector[CONFIG_MAX_PTIS_PER_ICU]; /*! on source device */ struct chdev_s * wti_vector[CONFIG_MAX_WTIS_PER_ICU]; /*! on source device */ } core_t; /*************************************************************************************** * This macro returns a pointer on the calling core descriptor. **************************************************************************************/ #define CURRENT_CORE (CURRENT_THREAD->core) /*************************************************************************************** * TODO this initialisation must be completed for the thread_idle field... [AG] * This function initializes a core descriptor from information found in arch_info. * It makes the association [gid] <=> [lid], as defined in arch_info, via the * boot_info_t structure build by the bootloader in each cluster. *************************************************************************************** * @ core : pointer on core descriptor to initialise. * @ lid : local core index * @ gid : global core identifier (hardware index) **************************************************************************************/ void core_init( core_t * core, lid_t lid, gid_t gid ); /*************************************************************************************** * This function returns a pseudo random number from the core descriptor * private random generator. *************************************************************************************** * @ core : pointer on core descriptor. * @ returns the pseudo random value. **************************************************************************************/ inline uint32_t core_get_rand( core_t * core ); /*************************************************************************************** * This function returns the current date (seconds & micro-seconds) from * the 64 bits calling core cycles counter. *************************************************************************************** * @ core : pointer on core descriptor. * @ tm_s : number of seconds. * @ tm_us : number of micro-seconds. **************************************************************************************/ void core_get_time( core_t * core, uint32_t * tm_s, uint32_t * tm_us ); /*************************************************************************************** * This function must be called at each TICK. * It updates the cycles and ticks counter in the calling core descriptor. * It handles all pending alarms depending on the ticks counter value. * It handles the scheduling, depending on the ticks counter value. * It handles the global DQDT update, depending on the ticks counter vakue. *************************************************************************************** * @ core : pointer on core descriptor. **************************************************************************************/ void core_clock( core_t * core ); /*************************************************************************************** * This function updates the usage statistics for the calling core descriptor, * based on the ratio between the idle_ticks and total_ticks. *************************************************************************************** * @ core : pointer on core descriptor. **************************************************************************************/ void core_compute_stats( core_t * core ); /*************************************************************************************** * This function reset the usage statistics. *************************************************************************************** * @ core : pointer on core descriptor. **************************************************************************************/ void core_reset_stats( core_t * core ); /*************************************************************************************** * This function set/reset a selected entry in one interrupt vector for a remote core. * The written value is an extended pointer on the "source" device (or the XPTR_NULL * value in case of reset). As it uses remote access, this function can be called by * any thread in any cluster. *************************************************************************************** * @ core : local pointer on the core descriptor. * @ irq_type : type of IRQ (HWI/WTI/PTI). * @ irq_id : index in the IRQ vector. * @ chdev : local pointer on the "source" chdev descriptor. **************************************************************************************/ void core_set_irq_vector_entry( core_t * core, uint32_t irq_type, uint32_t irq_id, struct chdev_s * chdev ); #endif /* _CORE_H_ */