cpu_topology.h revision 1.2 1 1.2 skrll /* $NetBSD: cpu_topology.h,v 1.2 2020/02/15 08:16:11 skrll 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.2 skrll * Call arm_cpu_do_topology() in cpu_attach(). It will update the topology
40 1.2 skrll * view of relative speed.
41 1.1 mrg *
42 1.2 skrll * The CPU frontend can set the "capacity_dmips_mhz" property for this CPU,
43 1.2 skrll * and arm_cpu_do_topology() will update the system view of this and other
44 1.2 skrll * CPUs relative speeds
45 1.2 skrll *
46 1.2 skrll * arm_cpu_topology_set(cpuinfo, mpidr)
47 1.1 mrg *
48 1.1 mrg * arm_cpu_topology_set() is provided for locore and the boot CPU,
49 1.2 skrll * and application CPUs. It updates data for the current CPU.
50 1.1 mrg */
51 1.1 mrg
52 1.1 mrg #include <sys/param.h>
53 1.1 mrg #include <sys/cpu.h>
54 1.1 mrg
55 1.1 mrg void arm_cpu_do_topology(struct cpu_info * const);
56 1.2 skrll void arm_cpu_topology_set(struct cpu_info * const, mpidr_t);
57 1.1 mrg
58 1.1 mrg #endif /* _ARM_CPU_TOPOLOGY_H_ */
59