Home | History | Annotate | Line # | Download | only in include
cpu_topology.h revision 1.1 
      1  1.1  mrg /*	$NetBSD: cpu_topology.h,v 1.1 2020/01/15 08:34:04 mrg Exp $	*/
      2  1.1  mrg 
      3  1.1  mrg /*
      4  1.1  mrg  * Copyright (c) 2020 Matthew R. Green
      5  1.1  mrg  * All rights reserved.
      6  1.1  mrg  *
      7  1.1  mrg  * Redistribution and use in source and binary forms, with or without
      8  1.1  mrg  * modification, are permitted provided that the following conditions
      9  1.1  mrg  * are met:
     10  1.1  mrg  * 1. Redistributions of source code must retain the above copyright
     11  1.1  mrg  *    notice, this list of conditions and the following disclaimer.
     12  1.1  mrg  * 2. Redistributions in binary form must reproduce the above copyright
     13  1.1  mrg  *    notice, this list of conditions and the following disclaimer in the
     14  1.1  mrg  *    documentation and/or other materials provided with the distribution.
     15  1.1  mrg  * 3. The name of the author may not be used to endorse or promote products
     16  1.1  mrg  *    derived from this software without specific prior written permission.
     17  1.1  mrg  *
     18  1.1  mrg  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
     19  1.1  mrg  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
     20  1.1  mrg  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
     21  1.1  mrg  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
     22  1.1  mrg  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
     23  1.1  mrg  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
     24  1.1  mrg  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
     25  1.1  mrg  * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
     26  1.1  mrg  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
     27  1.1  mrg  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
     28  1.1  mrg  * SUCH DAMAGE.
     29  1.1  mrg  */
     30  1.1  mrg 
     31  1.1  mrg #ifndef _ARM_CPU_TOPOLOGY_H_
     32  1.1  mrg #define _ARM_CPU_TOPOLOGY_H_
     33  1.1  mrg 
     34  1.1  mrg /*
     35  1.1  mrg  * ARMv7 and ARMv8 compatible CPU topology support.
     36  1.1  mrg  *
     37  1.1  mrg  * arm_cpu_do_topology(cpuinfo)
     38  1.1  mrg  *
     39  1.1  mrg  * Call arm_cpu_do_topology() in cpu_attach() after making sure that
     40  1.1  mrg  * arm_cpu_mpidr() will work for this CPU, and it will split up
     41  1.1  mrg  * package/core/smt IDs.
     42  1.1  mrg  *
     43  1.1  mrg  * The CPU frontend can set the "capacity_dmips_mhz" property for
     44  1.1  mrg  * this CPU device, and arm_cpu_set_topology() will calculate the
     45  1.1  mrg  * best way to call cpu_topology_set() for the known system.
     46  1.1  mrg  *
     47  1.1  mrg  * arm_cpu_topology_set(cpuinfo, mpidr, slow)
     48  1.1  mrg  *
     49  1.1  mrg  * arm_cpu_topology_set() is provided for locore and the boot CPU,
     50  1.1  mrg  * and only works for the current CPU.
     51  1.1  mrg  */
     52  1.1  mrg 
     53  1.1  mrg #include <sys/param.h>
     54  1.1  mrg #include <sys/cpu.h>
     55  1.1  mrg 
     56  1.1  mrg void arm_cpu_do_topology(struct cpu_info * const);
     57  1.1  mrg void arm_cpu_topology_set(struct cpu_info * const, uint64_t, bool);
     58  1.1  mrg 
     59  1.1  mrg #endif /* _ARM_CPU_TOPOLOGY_H_ */
     60