linux/include/linux/mfd/dbx500-prcmu.h
<<
>>
Prefs
   1/* SPDX-License-Identifier: GPL-2.0-only */
   2/*
   3 * Copyright (C) ST Ericsson SA 2011
   4 *
   5 * STE Ux500 PRCMU API
   6 */
   7#ifndef __MACH_PRCMU_H
   8#define __MACH_PRCMU_H
   9
  10#include <linux/interrupt.h>
  11#include <linux/notifier.h>
  12#include <linux/err.h>
  13
  14#include <dt-bindings/mfd/dbx500-prcmu.h> /* For clock identifiers */
  15
  16/* Offset for the firmware version within the TCPM */
  17#define DB8500_PRCMU_FW_VERSION_OFFSET 0xA4
  18#define DBX540_PRCMU_FW_VERSION_OFFSET 0xA8
  19
  20/* PRCMU Wakeup defines */
  21enum prcmu_wakeup_index {
  22        PRCMU_WAKEUP_INDEX_RTC,
  23        PRCMU_WAKEUP_INDEX_RTT0,
  24        PRCMU_WAKEUP_INDEX_RTT1,
  25        PRCMU_WAKEUP_INDEX_HSI0,
  26        PRCMU_WAKEUP_INDEX_HSI1,
  27        PRCMU_WAKEUP_INDEX_USB,
  28        PRCMU_WAKEUP_INDEX_ABB,
  29        PRCMU_WAKEUP_INDEX_ABB_FIFO,
  30        PRCMU_WAKEUP_INDEX_ARM,
  31        PRCMU_WAKEUP_INDEX_CD_IRQ,
  32        NUM_PRCMU_WAKEUP_INDICES
  33};
  34#define PRCMU_WAKEUP(_name) (BIT(PRCMU_WAKEUP_INDEX_##_name))
  35
  36/* EPOD (power domain) IDs */
  37
  38/*
  39 * DB8500 EPODs
  40 * - EPOD_ID_SVAMMDSP: power domain for SVA MMDSP
  41 * - EPOD_ID_SVAPIPE: power domain for SVA pipe
  42 * - EPOD_ID_SIAMMDSP: power domain for SIA MMDSP
  43 * - EPOD_ID_SIAPIPE: power domain for SIA pipe
  44 * - EPOD_ID_SGA: power domain for SGA
  45 * - EPOD_ID_B2R2_MCDE: power domain for B2R2 and MCDE
  46 * - EPOD_ID_ESRAM12: power domain for ESRAM 1 and 2
  47 * - EPOD_ID_ESRAM34: power domain for ESRAM 3 and 4
  48 * - NUM_EPOD_ID: number of power domains
  49 *
  50 * TODO: These should be prefixed.
  51 */
  52#define EPOD_ID_SVAMMDSP        0
  53#define EPOD_ID_SVAPIPE         1
  54#define EPOD_ID_SIAMMDSP        2
  55#define EPOD_ID_SIAPIPE         3
  56#define EPOD_ID_SGA             4
  57#define EPOD_ID_B2R2_MCDE       5
  58#define EPOD_ID_ESRAM12         6
  59#define EPOD_ID_ESRAM34         7
  60#define NUM_EPOD_ID             8
  61
  62/*
  63 * state definition for EPOD (power domain)
  64 * - EPOD_STATE_NO_CHANGE: The EPOD should remain unchanged
  65 * - EPOD_STATE_OFF: The EPOD is switched off
  66 * - EPOD_STATE_RAMRET: The EPOD is switched off with its internal RAM in
  67 *                         retention
  68 * - EPOD_STATE_ON_CLK_OFF: The EPOD is switched on, clock is still off
  69 * - EPOD_STATE_ON: Same as above, but with clock enabled
  70 */
  71#define EPOD_STATE_NO_CHANGE    0x00
  72#define EPOD_STATE_OFF          0x01
  73#define EPOD_STATE_RAMRET       0x02
  74#define EPOD_STATE_ON_CLK_OFF   0x03
  75#define EPOD_STATE_ON           0x04
  76
  77/*
  78 * CLKOUT sources
  79 */
  80#define PRCMU_CLKSRC_CLK38M             0x00
  81#define PRCMU_CLKSRC_ACLK               0x01
  82#define PRCMU_CLKSRC_SYSCLK             0x02
  83#define PRCMU_CLKSRC_LCDCLK             0x03
  84#define PRCMU_CLKSRC_SDMMCCLK           0x04
  85#define PRCMU_CLKSRC_TVCLK              0x05
  86#define PRCMU_CLKSRC_TIMCLK             0x06
  87#define PRCMU_CLKSRC_CLK009             0x07
  88/* These are only valid for CLKOUT1: */
  89#define PRCMU_CLKSRC_SIAMMDSPCLK        0x40
  90#define PRCMU_CLKSRC_I2CCLK             0x41
  91#define PRCMU_CLKSRC_MSP02CLK           0x42
  92#define PRCMU_CLKSRC_ARMPLL_OBSCLK      0x43
  93#define PRCMU_CLKSRC_HSIRXCLK           0x44
  94#define PRCMU_CLKSRC_HSITXCLK           0x45
  95#define PRCMU_CLKSRC_ARMCLKFIX          0x46
  96#define PRCMU_CLKSRC_HDMICLK            0x47
  97
  98/**
  99 * enum prcmu_wdog_id - PRCMU watchdog IDs
 100 * @PRCMU_WDOG_ALL: use all timers
 101 * @PRCMU_WDOG_CPU1: use first CPU timer only
 102 * @PRCMU_WDOG_CPU2: use second CPU timer conly
 103 */
 104enum prcmu_wdog_id {
 105        PRCMU_WDOG_ALL = 0x00,
 106        PRCMU_WDOG_CPU1 = 0x01,
 107        PRCMU_WDOG_CPU2 = 0x02,
 108};
 109
 110/**
 111 * enum ape_opp - APE OPP states definition
 112 * @APE_OPP_INIT:
 113 * @APE_NO_CHANGE: The APE operating point is unchanged
 114 * @APE_100_OPP: The new APE operating point is ape100opp
 115 * @APE_50_OPP: 50%
 116 * @APE_50_PARTLY_25_OPP: 50%, except some clocks at 25%.
 117 */
 118enum ape_opp {
 119        APE_OPP_INIT = 0x00,
 120        APE_NO_CHANGE = 0x01,
 121        APE_100_OPP = 0x02,
 122        APE_50_OPP = 0x03,
 123        APE_50_PARTLY_25_OPP = 0xFF,
 124};
 125
 126/**
 127 * enum arm_opp - ARM OPP states definition
 128 * @ARM_OPP_INIT:
 129 * @ARM_NO_CHANGE: The ARM operating point is unchanged
 130 * @ARM_100_OPP: The new ARM operating point is arm100opp
 131 * @ARM_50_OPP: The new ARM operating point is arm50opp
 132 * @ARM_MAX_OPP: Operating point is "max" (more than 100)
 133 * @ARM_MAX_FREQ100OPP: Set max opp if available, else 100
 134 * @ARM_EXTCLK: The new ARM operating point is armExtClk
 135 */
 136enum arm_opp {
 137        ARM_OPP_INIT = 0x00,
 138        ARM_NO_CHANGE = 0x01,
 139        ARM_100_OPP = 0x02,
 140        ARM_50_OPP = 0x03,
 141        ARM_MAX_OPP = 0x04,
 142        ARM_MAX_FREQ100OPP = 0x05,
 143        ARM_EXTCLK = 0x07
 144};
 145
 146/**
 147 * enum ddr_opp - DDR OPP states definition
 148 * @DDR_100_OPP: The new DDR operating point is ddr100opp
 149 * @DDR_50_OPP: The new DDR operating point is ddr50opp
 150 * @DDR_25_OPP: The new DDR operating point is ddr25opp
 151 */
 152enum ddr_opp {
 153        DDR_100_OPP = 0x00,
 154        DDR_50_OPP = 0x01,
 155        DDR_25_OPP = 0x02,
 156};
 157
 158/*
 159 * Definitions for controlling ESRAM0 in deep sleep.
 160 */
 161#define ESRAM0_DEEP_SLEEP_STATE_OFF 1
 162#define ESRAM0_DEEP_SLEEP_STATE_RET 2
 163
 164/**
 165 * enum ddr_pwrst - DDR power states definition
 166 * @DDR_PWR_STATE_UNCHANGED: SDRAM and DDR controller state is unchanged
 167 * @DDR_PWR_STATE_ON:
 168 * @DDR_PWR_STATE_OFFLOWLAT:
 169 * @DDR_PWR_STATE_OFFHIGHLAT:
 170 */
 171enum ddr_pwrst {
 172        DDR_PWR_STATE_UNCHANGED     = 0x00,
 173        DDR_PWR_STATE_ON            = 0x01,
 174        DDR_PWR_STATE_OFFLOWLAT     = 0x02,
 175        DDR_PWR_STATE_OFFHIGHLAT    = 0x03
 176};
 177
 178#define DB8500_PRCMU_LEGACY_OFFSET              0xDD4
 179
 180#define PRCMU_FW_PROJECT_U8500          2
 181#define PRCMU_FW_PROJECT_U8400          3
 182#define PRCMU_FW_PROJECT_U9500          4 /* Customer specific */
 183#define PRCMU_FW_PROJECT_U8500_MBB      5
 184#define PRCMU_FW_PROJECT_U8500_C1       6
 185#define PRCMU_FW_PROJECT_U8500_C2       7
 186#define PRCMU_FW_PROJECT_U8500_C3       8
 187#define PRCMU_FW_PROJECT_U8500_C4       9
 188#define PRCMU_FW_PROJECT_U9500_MBL      10
 189#define PRCMU_FW_PROJECT_U8500_MBL      11 /* Customer specific */
 190#define PRCMU_FW_PROJECT_U8500_MBL2     12 /* Customer specific */
 191#define PRCMU_FW_PROJECT_U8520          13
 192#define PRCMU_FW_PROJECT_U8420          14
 193#define PRCMU_FW_PROJECT_U8420_SYSCLK   17
 194#define PRCMU_FW_PROJECT_A9420          20
 195/* [32..63] 9540 and derivatives */
 196#define PRCMU_FW_PROJECT_U9540          32
 197/* [64..95] 8540 and derivatives */
 198#define PRCMU_FW_PROJECT_L8540          64
 199/* [96..126] 8580 and derivatives */
 200#define PRCMU_FW_PROJECT_L8580          96
 201
 202#define PRCMU_FW_PROJECT_NAME_LEN       20
 203struct prcmu_fw_version {
 204        u32 project; /* Notice, project shifted with 8 on ux540 */
 205        u8 api_version;
 206        u8 func_version;
 207        u8 errata;
 208        char project_name[PRCMU_FW_PROJECT_NAME_LEN];
 209};
 210
 211#include <linux/mfd/db8500-prcmu.h>
 212
 213#if defined(CONFIG_UX500_SOC_DB8500)
 214
 215static inline void prcmu_early_init(void)
 216{
 217        return db8500_prcmu_early_init();
 218}
 219
 220static inline int prcmu_set_power_state(u8 state, bool keep_ulp_clk,
 221                bool keep_ap_pll)
 222{
 223        return db8500_prcmu_set_power_state(state, keep_ulp_clk,
 224                keep_ap_pll);
 225}
 226
 227static inline u8 prcmu_get_power_state_result(void)
 228{
 229        return db8500_prcmu_get_power_state_result();
 230}
 231
 232static inline int prcmu_set_epod(u16 epod_id, u8 epod_state)
 233{
 234        return db8500_prcmu_set_epod(epod_id, epod_state);
 235}
 236
 237static inline void prcmu_enable_wakeups(u32 wakeups)
 238{
 239        db8500_prcmu_enable_wakeups(wakeups);
 240}
 241
 242static inline void prcmu_disable_wakeups(void)
 243{
 244        prcmu_enable_wakeups(0);
 245}
 246
 247static inline void prcmu_config_abb_event_readout(u32 abb_events)
 248{
 249        db8500_prcmu_config_abb_event_readout(abb_events);
 250}
 251
 252static inline void prcmu_get_abb_event_buffer(void __iomem **buf)
 253{
 254        db8500_prcmu_get_abb_event_buffer(buf);
 255}
 256
 257int prcmu_abb_read(u8 slave, u8 reg, u8 *value, u8 size);
 258int prcmu_abb_write(u8 slave, u8 reg, u8 *value, u8 size);
 259int prcmu_abb_write_masked(u8 slave, u8 reg, u8 *value, u8 *mask, u8 size);
 260
 261int prcmu_config_clkout(u8 clkout, u8 source, u8 div);
 262
 263static inline int prcmu_request_clock(u8 clock, bool enable)
 264{
 265        return db8500_prcmu_request_clock(clock, enable);
 266}
 267
 268unsigned long prcmu_clock_rate(u8 clock);
 269long prcmu_round_clock_rate(u8 clock, unsigned long rate);
 270int prcmu_set_clock_rate(u8 clock, unsigned long rate);
 271
 272static inline int prcmu_get_ddr_opp(void)
 273{
 274        return db8500_prcmu_get_ddr_opp();
 275}
 276
 277static inline int prcmu_set_arm_opp(u8 opp)
 278{
 279        return db8500_prcmu_set_arm_opp(opp);
 280}
 281
 282static inline int prcmu_get_arm_opp(void)
 283{
 284        return db8500_prcmu_get_arm_opp();
 285}
 286
 287static inline int prcmu_set_ape_opp(u8 opp)
 288{
 289        return db8500_prcmu_set_ape_opp(opp);
 290}
 291
 292static inline int prcmu_get_ape_opp(void)
 293{
 294        return db8500_prcmu_get_ape_opp();
 295}
 296
 297static inline int prcmu_request_ape_opp_100_voltage(bool enable)
 298{
 299        return db8500_prcmu_request_ape_opp_100_voltage(enable);
 300}
 301
 302static inline void prcmu_system_reset(u16 reset_code)
 303{
 304        return db8500_prcmu_system_reset(reset_code);
 305}
 306
 307static inline u16 prcmu_get_reset_code(void)
 308{
 309        return db8500_prcmu_get_reset_code();
 310}
 311
 312int prcmu_ac_wake_req(void);
 313void prcmu_ac_sleep_req(void);
 314static inline void prcmu_modem_reset(void)
 315{
 316        return db8500_prcmu_modem_reset();
 317}
 318
 319static inline bool prcmu_is_ac_wake_requested(void)
 320{
 321        return db8500_prcmu_is_ac_wake_requested();
 322}
 323
 324static inline int prcmu_config_esram0_deep_sleep(u8 state)
 325{
 326        return db8500_prcmu_config_esram0_deep_sleep(state);
 327}
 328
 329static inline int prcmu_config_hotdog(u8 threshold)
 330{
 331        return db8500_prcmu_config_hotdog(threshold);
 332}
 333
 334static inline int prcmu_config_hotmon(u8 low, u8 high)
 335{
 336        return db8500_prcmu_config_hotmon(low, high);
 337}
 338
 339static inline int prcmu_start_temp_sense(u16 cycles32k)
 340{
 341        return  db8500_prcmu_start_temp_sense(cycles32k);
 342}
 343
 344static inline int prcmu_stop_temp_sense(void)
 345{
 346        return  db8500_prcmu_stop_temp_sense();
 347}
 348
 349static inline u32 prcmu_read(unsigned int reg)
 350{
 351        return db8500_prcmu_read(reg);
 352}
 353
 354static inline void prcmu_write(unsigned int reg, u32 value)
 355{
 356        db8500_prcmu_write(reg, value);
 357}
 358
 359static inline void prcmu_write_masked(unsigned int reg, u32 mask, u32 value)
 360{
 361        db8500_prcmu_write_masked(reg, mask, value);
 362}
 363
 364static inline int prcmu_enable_a9wdog(u8 id)
 365{
 366        return db8500_prcmu_enable_a9wdog(id);
 367}
 368
 369static inline int prcmu_disable_a9wdog(u8 id)
 370{
 371        return db8500_prcmu_disable_a9wdog(id);
 372}
 373
 374static inline int prcmu_kick_a9wdog(u8 id)
 375{
 376        return db8500_prcmu_kick_a9wdog(id);
 377}
 378
 379static inline int prcmu_load_a9wdog(u8 id, u32 timeout)
 380{
 381        return db8500_prcmu_load_a9wdog(id, timeout);
 382}
 383
 384static inline int prcmu_config_a9wdog(u8 num, bool sleep_auto_off)
 385{
 386        return db8500_prcmu_config_a9wdog(num, sleep_auto_off);
 387}
 388#else
 389
 390static inline void prcmu_early_init(void) {}
 391
 392static inline int prcmu_set_power_state(u8 state, bool keep_ulp_clk,
 393        bool keep_ap_pll)
 394{
 395        return 0;
 396}
 397
 398static inline int prcmu_set_epod(u16 epod_id, u8 epod_state)
 399{
 400        return 0;
 401}
 402
 403static inline void prcmu_enable_wakeups(u32 wakeups) {}
 404
 405static inline void prcmu_disable_wakeups(void) {}
 406
 407static inline int prcmu_abb_read(u8 slave, u8 reg, u8 *value, u8 size)
 408{
 409        return -ENOSYS;
 410}
 411
 412static inline int prcmu_abb_write(u8 slave, u8 reg, u8 *value, u8 size)
 413{
 414        return -ENOSYS;
 415}
 416
 417static inline int prcmu_abb_write_masked(u8 slave, u8 reg, u8 *value, u8 *mask,
 418        u8 size)
 419{
 420        return -ENOSYS;
 421}
 422
 423static inline int prcmu_config_clkout(u8 clkout, u8 source, u8 div)
 424{
 425        return 0;
 426}
 427
 428static inline int prcmu_request_clock(u8 clock, bool enable)
 429{
 430        return 0;
 431}
 432
 433static inline long prcmu_round_clock_rate(u8 clock, unsigned long rate)
 434{
 435        return 0;
 436}
 437
 438static inline int prcmu_set_clock_rate(u8 clock, unsigned long rate)
 439{
 440        return 0;
 441}
 442
 443static inline unsigned long prcmu_clock_rate(u8 clock)
 444{
 445        return 0;
 446}
 447
 448static inline int prcmu_set_ape_opp(u8 opp)
 449{
 450        return 0;
 451}
 452
 453static inline int prcmu_get_ape_opp(void)
 454{
 455        return APE_100_OPP;
 456}
 457
 458static inline int prcmu_request_ape_opp_100_voltage(bool enable)
 459{
 460        return 0;
 461}
 462
 463static inline int prcmu_set_arm_opp(u8 opp)
 464{
 465        return 0;
 466}
 467
 468static inline int prcmu_get_arm_opp(void)
 469{
 470        return ARM_100_OPP;
 471}
 472
 473static inline int prcmu_get_ddr_opp(void)
 474{
 475        return DDR_100_OPP;
 476}
 477
 478static inline void prcmu_system_reset(u16 reset_code) {}
 479
 480static inline u16 prcmu_get_reset_code(void)
 481{
 482        return 0;
 483}
 484
 485static inline int prcmu_ac_wake_req(void)
 486{
 487        return 0;
 488}
 489
 490static inline void prcmu_ac_sleep_req(void) {}
 491
 492static inline void prcmu_modem_reset(void) {}
 493
 494static inline bool prcmu_is_ac_wake_requested(void)
 495{
 496        return false;
 497}
 498
 499static inline int prcmu_config_esram0_deep_sleep(u8 state)
 500{
 501        return 0;
 502}
 503
 504static inline void prcmu_config_abb_event_readout(u32 abb_events) {}
 505
 506static inline void prcmu_get_abb_event_buffer(void __iomem **buf)
 507{
 508        *buf = NULL;
 509}
 510
 511static inline int prcmu_config_hotdog(u8 threshold)
 512{
 513        return 0;
 514}
 515
 516static inline int prcmu_config_hotmon(u8 low, u8 high)
 517{
 518        return 0;
 519}
 520
 521static inline int prcmu_start_temp_sense(u16 cycles32k)
 522{
 523        return 0;
 524}
 525
 526static inline int prcmu_stop_temp_sense(void)
 527{
 528        return 0;
 529}
 530
 531static inline u32 prcmu_read(unsigned int reg)
 532{
 533        return 0;
 534}
 535
 536static inline void prcmu_write(unsigned int reg, u32 value) {}
 537
 538static inline void prcmu_write_masked(unsigned int reg, u32 mask, u32 value) {}
 539
 540#endif
 541
 542static inline void prcmu_set(unsigned int reg, u32 bits)
 543{
 544        prcmu_write_masked(reg, bits, bits);
 545}
 546
 547static inline void prcmu_clear(unsigned int reg, u32 bits)
 548{
 549        prcmu_write_masked(reg, bits, 0);
 550}
 551
 552/* PRCMU QoS APE OPP class */
 553#define PRCMU_QOS_APE_OPP 1
 554#define PRCMU_QOS_DDR_OPP 2
 555#define PRCMU_QOS_ARM_OPP 3
 556#define PRCMU_QOS_DEFAULT_VALUE -1
 557
 558#ifdef CONFIG_DBX500_PRCMU_QOS_POWER
 559
 560unsigned long prcmu_qos_get_cpufreq_opp_delay(void);
 561void prcmu_qos_set_cpufreq_opp_delay(unsigned long);
 562void prcmu_qos_force_opp(int, s32);
 563int prcmu_qos_requirement(int pm_qos_class);
 564int prcmu_qos_add_requirement(int pm_qos_class, char *name, s32 value);
 565int prcmu_qos_update_requirement(int pm_qos_class, char *name, s32 new_value);
 566void prcmu_qos_remove_requirement(int pm_qos_class, char *name);
 567int prcmu_qos_add_notifier(int prcmu_qos_class,
 568                           struct notifier_block *notifier);
 569int prcmu_qos_remove_notifier(int prcmu_qos_class,
 570                              struct notifier_block *notifier);
 571
 572#else
 573
 574static inline unsigned long prcmu_qos_get_cpufreq_opp_delay(void)
 575{
 576        return 0;
 577}
 578
 579static inline void prcmu_qos_set_cpufreq_opp_delay(unsigned long n) {}
 580
 581static inline void prcmu_qos_force_opp(int prcmu_qos_class, s32 i) {}
 582
 583static inline int prcmu_qos_requirement(int prcmu_qos_class)
 584{
 585        return 0;
 586}
 587
 588static inline int prcmu_qos_add_requirement(int prcmu_qos_class,
 589                                            char *name, s32 value)
 590{
 591        return 0;
 592}
 593
 594static inline int prcmu_qos_update_requirement(int prcmu_qos_class,
 595                                               char *name, s32 new_value)
 596{
 597        return 0;
 598}
 599
 600static inline void prcmu_qos_remove_requirement(int prcmu_qos_class, char *name)
 601{
 602}
 603
 604static inline int prcmu_qos_add_notifier(int prcmu_qos_class,
 605                                         struct notifier_block *notifier)
 606{
 607        return 0;
 608}
 609static inline int prcmu_qos_remove_notifier(int prcmu_qos_class,
 610                                            struct notifier_block *notifier)
 611{
 612        return 0;
 613}
 614
 615#endif
 616
 617#endif /* __MACH_PRCMU_H */
 618