drivers/parisc/led.c

   1 // SPDX-License-Identifier: GPL-2.0-or-later
   2 /*
   3  *      Chassis LCD/LED driver for HP-PARISC workstations
   4  *
   5  *      (c) Copyright 2000 Red Hat Software
   6  *      (c) Copyright 2000 Helge Deller <hdeller@redhat.com>
   7  *      (c) Copyright 2001 Randolph Chung <tausq@debian.org>
   8  *      (c) Copyright 2000-2023 Helge Deller <deller@gmx.de>
   9  *
  10  *      The control of the LEDs and LCDs on PARISC machines has to be done
  11  *      completely in software.
  12  *
  13  *      The LEDs can be configured at runtime in /sys/class/leds/
  14  */
  15
  16 #include <linux/module.h>
  17 #include <linux/init.h>
  18 #include <linux/types.h>
  19 #include <linux/ioport.h>
  20 #include <linux/utsname.h>
  21 #include <linux/capability.h>
  22 #include <linux/delay.h>
  23 #include <linux/reboot.h>
  24 #include <linux/uaccess.h>
  25 #include <linux/leds.h>
  26 #include <linux/platform_device.h>
  27
  28 #include <asm/io.h>
  29 #include <asm/processor.h>
  30 #include <asm/hardware.h>
  31 #include <asm/param.h>          /* HZ */
  32 #include <asm/led.h>
  33 #include <asm/pdc.h>
  34
  35 #define LED_HAS_LCD 1
  36 #define LED_HAS_LED 2
  37
  38 static unsigned char led_type;          /* bitmask of LED_HAS_XXX */
  39 static unsigned char lastleds;          /* LED state from most recent update */
  40 static unsigned char lcd_new_text;
  41 static unsigned char lcd_text[20];
  42 static unsigned char lcd_text_default[20];
  43 static unsigned char lcd_no_led_support; /* KittyHawk doesn't support LED on its LCD */
  44
  45 struct lcd_block {
  46         unsigned char command;  /* stores the command byte      */
  47         unsigned char on;       /* value for turning LED on     */
  48         unsigned char off;      /* value for turning LED off    */
  49 };
  50
  51 /* Structure returned by PDC_RETURN_CHASSIS_INFO */
  52 /* NOTE: we use unsigned long:16 two times, since the following member
  53    lcd_cmd_reg_addr needs to be 64bit aligned on 64bit PA2.0-machines */
  54 struct pdc_chassis_lcd_info_ret_block {
  55         unsigned long model:16;         /* DISPLAY_MODEL_XXXX */
  56         unsigned long lcd_width:16;     /* width of the LCD in chars (DISPLAY_MODEL_LCD only) */
  57         unsigned long lcd_cmd_reg_addr; /* ptr to LCD cmd-register & data ptr for LED */
  58         unsigned long lcd_data_reg_addr; /* ptr to LCD data-register (LCD only) */
  59         unsigned int min_cmd_delay;     /* delay in uS after cmd-write (LCD only) */
  60         unsigned char reset_cmd1;       /* command #1 for writing LCD string (LCD only) */
  61         unsigned char reset_cmd2;       /* command #2 for writing LCD string (LCD only) */
  62         unsigned char act_enable;       /* 0 = no activity (LCD only) */
  63         struct lcd_block heartbeat;
  64         struct lcd_block disk_io;
  65         struct lcd_block lan_rcv;
  66         struct lcd_block lan_tx;
  67         char _pad;
  68 };
  69
  70
  71 /* LCD_CMD and LCD_DATA for KittyHawk machines */
  72 #define KITTYHAWK_LCD_CMD  F_EXTEND(0xf0190000UL)
  73 #define KITTYHAWK_LCD_DATA (KITTYHAWK_LCD_CMD + 1)
  74
  75 /* lcd_info is pre-initialized to the values needed to program KittyHawk LCD's
  76  * HP seems to have used Sharp/Hitachi HD44780 LCDs most of the time. */
  77 static struct pdc_chassis_lcd_info_ret_block
  78 lcd_info __attribute__((aligned(8)))  =
  79 {
  80         .model =                DISPLAY_MODEL_NONE,
  81         .lcd_width =            16,
  82         .lcd_cmd_reg_addr =     KITTYHAWK_LCD_CMD,
  83         .lcd_data_reg_addr =    KITTYHAWK_LCD_DATA,
  84         .min_cmd_delay =        80,
  85         .reset_cmd1 =           0x80,
  86         .reset_cmd2 =           0xc0,
  87 };
  88
  89 /* direct access to some of the lcd_info variables */
  90 #define LCD_CMD_REG     lcd_info.lcd_cmd_reg_addr
  91 #define LCD_DATA_REG    lcd_info.lcd_data_reg_addr
  92 #define LED_DATA_REG    lcd_info.lcd_cmd_reg_addr       /* LASI & ASP only */
  93
  94 /* ptr to LCD/LED-specific function */
  95 static void (*led_func_ptr) (unsigned char);
  96
  97
  98 static void lcd_print_now(void)
  99 {
 100         int i;
 101         char *str = lcd_text;
 102
 103         if (lcd_info.model != DISPLAY_MODEL_LCD)
 104                 return;
 105
 106         if (!lcd_new_text)
 107                 return;
 108         lcd_new_text = 0;
 109
 110         /* Set LCD Cursor to 1st character */
 111         gsc_writeb(lcd_info.reset_cmd1, LCD_CMD_REG);
 112         udelay(lcd_info.min_cmd_delay);
 113
 114         /* Print the string */
 115         for (i = 0; i < lcd_info.lcd_width; i++) {
 116                 gsc_writeb(*str ? *str++ : ' ', LCD_DATA_REG);
 117                 udelay(lcd_info.min_cmd_delay);
 118         }
 119 }
 120
 121 /**
 122  *      lcd_print()
 123  *
 124  *      @str: string to show on the LCD. If NULL, print current string again.
 125  *
 126  *      Displays the given string on the LCD-Display of newer machines.
 127  */
 128 void lcd_print(const char *str)
 129 {
 130         /* copy display string to buffer for procfs */
 131         if (str)
 132                 strscpy(lcd_text, str, sizeof(lcd_text));
 133         lcd_new_text = 1;
 134
 135         /* print now if LCD without any LEDs */
 136         if (led_type == LED_HAS_LCD)
 137                 lcd_print_now();
 138 }
 139
 140 #define LED_DATA        0x01    /* data to shift (0:on 1:off) */
 141 #define LED_STROBE      0x02    /* strobe to clock data */
 142
 143 /**
 144  *      led_ASP_driver() - LED driver for the ASP controller chip
 145  *
 146  *      @leds: bitmap representing the LED status
 147  */
 148 static void led_ASP_driver(unsigned char leds)
 149 {
 150         int i;
 151
 152         leds = ~leds;
 153         for (i = 0; i < 8; i++) {
 154                 unsigned char value;
 155                 value = (leds & 0x80) >> 7;
 156                 gsc_writeb( value,               LED_DATA_REG );
 157                 gsc_writeb( value | LED_STROBE,  LED_DATA_REG );
 158                 leds <<= 1;
 159         }
 160 }
 161
 162 /**
 163  *      led_LASI_driver() - LED driver for the LASI controller chip
 164  *
 165  *      @leds: bitmap representing the LED status
 166  */
 167 static void led_LASI_driver(unsigned char leds)
 168 {
 169         leds = ~leds;
 170         gsc_writeb( leds, LED_DATA_REG );
 171 }
 172
 173 /**
 174  *      led_LCD_driver() - LED & LCD driver for LCD chips
 175  *
 176  *      @leds: bitmap representing the LED status
 177  */
 178 static void led_LCD_driver(unsigned char leds)
 179 {
 180         static const unsigned char mask[4] = {
 181                 LED_HEARTBEAT, LED_DISK_IO,
 182                 LED_LAN_RCV, LED_LAN_TX };
 183
 184         static struct lcd_block * const blockp[4] = {
 185                 &lcd_info.heartbeat,
 186                 &lcd_info.disk_io,
 187                 &lcd_info.lan_rcv,
 188                 &lcd_info.lan_tx
 189         };
 190         static unsigned char latest_leds;
 191         int i;
 192
 193         for (i = 0; i < 4; ++i) {
 194                 if ((leds & mask[i]) == (latest_leds & mask[i]))
 195                         continue;
 196
 197                 gsc_writeb( blockp[i]->command, LCD_CMD_REG );
 198                 udelay(lcd_info.min_cmd_delay);
 199
 200                 gsc_writeb( leds & mask[i] ? blockp[i]->on :
 201                                 blockp[i]->off, LCD_DATA_REG );
 202                 udelay(lcd_info.min_cmd_delay);
 203         }
 204         latest_leds = leds;
 205
 206         lcd_print_now();
 207 }
 208
 209
 210 /**
 211  *      lcd_system_halt()
 212  *
 213  *      @nb: pointer to the notifier_block structure
 214  *      @event: the event (SYS_RESTART, SYS_HALT or SYS_POWER_OFF)
 215  *      @buf: pointer to a buffer (not used)
 216  *
 217  *      Called by the reboot notifier chain at shutdown. Stops all
 218  *      LED/LCD activities.
 219  */
 220 static int lcd_system_halt(struct notifier_block *nb, unsigned long event, void *buf)
 221 {
 222         const char *txt;
 223
 224         switch (event) {
 225         case SYS_RESTART:       txt = "SYSTEM RESTART";
 226                                 break;
 227         case SYS_HALT:          txt = "SYSTEM HALT";
 228                                 break;
 229         case SYS_POWER_OFF:     txt = "SYSTEM POWER OFF";
 230                                 break;
 231         default:                return NOTIFY_DONE;
 232         }
 233
 234         lcd_print(txt);
 235
 236         return NOTIFY_OK;
 237 }
 238
 239 static struct notifier_block lcd_system_halt_notifier = {
 240         .notifier_call = lcd_system_halt,
 241 };
 242
 243 static void set_led(struct led_classdev *led_cdev, enum led_brightness brightness);
 244
 245 struct hppa_led {
 246         struct led_classdev     led_cdev;
 247         unsigned char           led_bit;
 248 };
 249 #define to_hppa_led(d) container_of(d, struct hppa_led, led_cdev)
 250
 251 typedef void (*set_handler)(struct led_classdev *, enum led_brightness);
 252 struct led_type {
 253         const char      *name;
 254         set_handler     handler;
 255         const char      *default_trigger;
 256 };
 257
 258 #define NUM_LEDS_PER_BOARD      8
 259 struct hppa_drvdata {
 260         struct hppa_led leds[NUM_LEDS_PER_BOARD];
 261 };
 262
 263 static void set_led(struct led_classdev *led_cdev, enum led_brightness brightness)
 264 {
 265         struct hppa_led *p = to_hppa_led(led_cdev);
 266         unsigned char led_bit = p->led_bit;
 267
 268         if (brightness == LED_OFF)
 269                 lastleds &= ~led_bit;
 270         else
 271                 lastleds |= led_bit;
 272
 273         if (led_func_ptr)
 274                 led_func_ptr(lastleds);
 275 }
 276
 277
 278 static int hppa_led_generic_probe(struct platform_device *pdev,
 279                                   struct led_type *types)
 280 {
 281         struct hppa_drvdata *p;
 282         int i, err;
 283
 284         p = devm_kzalloc(&pdev->dev, sizeof(*p), GFP_KERNEL);
 285         if (!p)
 286                 return -ENOMEM;
 287
 288         for (i = 0; i < NUM_LEDS_PER_BOARD; i++) {
 289                 struct led_classdev *lp = &p->leds[i].led_cdev;
 290
 291                 p->leds[i].led_bit = BIT(i);
 292                 lp->name = types[i].name;
 293                 lp->brightness = LED_FULL;
 294                 lp->brightness_set = types[i].handler;
 295                 lp->default_trigger = types[i].default_trigger;
 296                 err = led_classdev_register(&pdev->dev, lp);
 297                 if (err) {
 298                         dev_err(&pdev->dev, "Could not register %s LED\n",
 299                                lp->name);
 300                         for (i--; i >= 0; i--)
 301                                 led_classdev_unregister(&p->leds[i].led_cdev);
 302                         return err;
 303                 }
 304         }
 305
 306         platform_set_drvdata(pdev, p);
 307
 308         return 0;
 309 }
 310
 311 static int platform_led_remove(struct platform_device *pdev)
 312 {
 313         struct hppa_drvdata *p = platform_get_drvdata(pdev);
 314         int i;
 315
 316         for (i = 0; i < NUM_LEDS_PER_BOARD; i++)
 317                 led_classdev_unregister(&p->leds[i].led_cdev);
 318
 319         return 0;
 320 }
 321
 322 static struct led_type mainboard_led_types[NUM_LEDS_PER_BOARD] = {
 323         {
 324                 .name           = "platform-lan-tx",
 325                 .handler        = set_led,
 326                 .default_trigger = "tx",
 327         },
 328         {
 329                 .name           = "platform-lan-rx",
 330                 .handler        = set_led,
 331                 .default_trigger = "rx",
 332         },
 333         {
 334                 .name           = "platform-disk",
 335                 .handler        = set_led,
 336                 .default_trigger = "disk-activity",
 337         },
 338         {
 339                 .name           = "platform-heartbeat",
 340                 .handler        = set_led,
 341                 .default_trigger = "heartbeat",
 342         },
 343         {
 344                 .name           = "platform-LED4",
 345                 .handler        = set_led,
 346                 .default_trigger = "panic",
 347         },
 348         {
 349                 .name           = "platform-LED5",
 350                 .handler        = set_led,
 351                 .default_trigger = "panic",
 352         },
 353         {
 354                 .name           = "platform-LED6",
 355                 .handler        = set_led,
 356                 .default_trigger = "panic",
 357         },
 358         {
 359                 .name           = "platform-LED7",
 360                 .handler        = set_led,
 361                 .default_trigger = "panic",
 362         },
 363 };
 364
 365 static int platform_led_probe(struct platform_device *pdev)
 366 {
 367         return hppa_led_generic_probe(pdev, mainboard_led_types);
 368 }
 369
 370 MODULE_ALIAS("platform:platform-leds");
 371
 372 static struct platform_driver hppa_mainboard_led_driver = {
 373         .probe          = platform_led_probe,
 374         .remove         = platform_led_remove,
 375         .driver         = {
 376                 .name   = "platform-leds",
 377         },
 378 };
 379
 380 static struct platform_driver * const drivers[] = {
 381         &hppa_mainboard_led_driver,
 382 };
 383
 384 static struct platform_device platform_leds = {
 385         .name = "platform-leds",
 386 };
 387
 388 /**
 389  *      register_led_driver()
 390  *
 391  *      @model: model type, one of the DISPLAY_MODEL_XXXX values
 392  *      @cmd_reg: physical address of cmd register for the LED/LCD
 393  *      @data_reg: physical address of data register for the LED/LCD
 394  *
 395  *      Registers a chassis LED or LCD which should be driven by this driver.
 396  *      Only PDC-based, LASI- or ASP-style LEDs and LCDs are supported.
 397  */
 398 int __init register_led_driver(int model, unsigned long cmd_reg, unsigned long data_reg)
 399 {
 400         if (led_func_ptr || !data_reg)
 401                 return 1;
 402
 403         /* No LEDs when running in QEMU */
 404         if (running_on_qemu)
 405                 return 1;
 406
 407         lcd_info.model = model;         /* store the values */
 408         LCD_CMD_REG = (cmd_reg == LED_CMD_REG_NONE) ? 0 : cmd_reg;
 409
 410         switch (lcd_info.model) {
 411         case DISPLAY_MODEL_LCD:
 412                 LCD_DATA_REG = data_reg;
 413                 pr_info("led: LCD display at %#lx and %#lx\n",
 414                         LCD_CMD_REG , LCD_DATA_REG);
 415                 led_func_ptr = led_LCD_driver;
 416                 if (lcd_no_led_support)
 417                         led_type = LED_HAS_LCD;
 418                 else
 419                         led_type = LED_HAS_LCD | LED_HAS_LED;
 420                 break;
 421
 422         case DISPLAY_MODEL_LASI:
 423                 LED_DATA_REG = data_reg;
 424                 led_func_ptr = led_LASI_driver;
 425                 pr_info("led: LED display at %#lx\n", LED_DATA_REG);
 426                 led_type = LED_HAS_LED;
 427                 break;
 428
 429         case DISPLAY_MODEL_OLD_ASP:
 430                 LED_DATA_REG = data_reg;
 431                 led_func_ptr = led_ASP_driver;
 432                 pr_info("led: LED (ASP-style) display at %#lx\n",
 433                     LED_DATA_REG);
 434                 led_type = LED_HAS_LED;
 435                 break;
 436
 437         default:
 438                 pr_err("led: Unknown LCD/LED model type %d\n", lcd_info.model);
 439                 return 1;
 440         }
 441
 442         platform_register_drivers(drivers, ARRAY_SIZE(drivers));
 443
 444         return register_reboot_notifier(&lcd_system_halt_notifier);
 445 }
 446
 447 /**
 448  *      early_led_init()
 449  *
 450  *      early_led_init() is called early in the bootup-process and asks the
 451  *      PDC for an usable chassis LCD or LED. If the PDC doesn't return any
 452  *      info, then a LED might be detected by the LASI or ASP drivers later.
 453  *      KittyHawk machines have often a buggy PDC, so that we explicitly check
 454  *      for those machines here.
 455  */
 456 static int __init early_led_init(void)
 457 {
 458         struct pdc_chassis_info chassis_info;
 459         int ret;
 460
 461         snprintf(lcd_text_default, sizeof(lcd_text_default),
 462                 "Linux %s", init_utsname()->release);
 463         strcpy(lcd_text, lcd_text_default);
 464         lcd_new_text = 1;
 465
 466         /* Work around the buggy PDC of KittyHawk-machines */
 467         switch (CPU_HVERSION) {
 468         case 0x580:             /* KittyHawk DC2-100 (K100) */
 469         case 0x581:             /* KittyHawk DC3-120 (K210) */
 470         case 0x582:             /* KittyHawk DC3 100 (K400) */
 471         case 0x583:             /* KittyHawk DC3 120 (K410) */
 472         case 0x58B:             /* KittyHawk DC2 100 (K200) */
 473                 pr_info("LCD on KittyHawk-Machine found.\n");
 474                 lcd_info.model = DISPLAY_MODEL_LCD;
 475                 /* KittyHawk has no LED support on its LCD, so skip LED detection */
 476                 lcd_no_led_support = 1;
 477                 goto found;     /* use the preinitialized values of lcd_info */
 478         }
 479
 480         /* initialize the struct, so that we can check for valid return values */
 481         chassis_info.actcnt = chassis_info.maxcnt = 0;
 482
 483         ret = pdc_chassis_info(&chassis_info, &lcd_info, sizeof(lcd_info));
 484         if (ret != PDC_OK) {
 485 not_found:
 486                 lcd_info.model = DISPLAY_MODEL_NONE;
 487                 return 1;
 488         }
 489
 490         /* check the results. Some machines have a buggy PDC */
 491         if (chassis_info.actcnt <= 0 || chassis_info.actcnt != chassis_info.maxcnt)
 492                 goto not_found;
 493
 494         switch (lcd_info.model) {
 495         case DISPLAY_MODEL_LCD:         /* LCD display */
 496                 if (chassis_info.actcnt <
 497                         offsetof(struct pdc_chassis_lcd_info_ret_block, _pad)-1)
 498                         goto not_found;
 499                 if (!lcd_info.act_enable) {
 500                         /* PDC tells LCD should not be used. */
 501                         goto not_found;
 502                 }
 503                 break;
 504
 505         case DISPLAY_MODEL_NONE:        /* no LED or LCD available */
 506                 goto not_found;
 507
 508         case DISPLAY_MODEL_LASI:        /* Lasi style 8 bit LED display */
 509                 if (chassis_info.actcnt != 8 && chassis_info.actcnt != 32)
 510                         goto not_found;
 511                 break;
 512
 513         default:
 514                 pr_warn("PDC reported unknown LCD/LED model %d\n",
 515                        lcd_info.model);
 516                 goto not_found;
 517         }
 518
 519 found:
 520         /* register the LCD/LED driver */
 521         return register_led_driver(lcd_info.model, LCD_CMD_REG, LCD_DATA_REG);
 522 }
 523 arch_initcall(early_led_init);
 524
 525 /**
 526  *      register_led_regions()
 527  *
 528  *      Register_led_regions() registers the LCD/LED regions for /procfs.
 529  *      At bootup - where the initialisation of the LCD/LED often happens
 530  *      not all internal structures of request_region() are properly set up,
 531  *      so that we delay the led-registration until after busdevices_init()
 532  *      has been executed.
 533  */
 534 static void __init register_led_regions(void)
 535 {
 536         switch (lcd_info.model) {
 537         case DISPLAY_MODEL_LCD:
 538                 request_mem_region((unsigned long)LCD_CMD_REG,  1, "lcd_cmd");
 539                 request_mem_region((unsigned long)LCD_DATA_REG, 1, "lcd_data");
 540                 break;
 541         case DISPLAY_MODEL_LASI:
 542         case DISPLAY_MODEL_OLD_ASP:
 543                 request_mem_region((unsigned long)LED_DATA_REG, 1, "led_data");
 544                 break;
 545         }
 546 }
 547
 548 static int __init startup_leds(void)
 549 {
 550         if (platform_device_register(&platform_leds))
 551                 printk(KERN_INFO "LED: failed to register LEDs\n");
 552         register_led_regions();
 553         return 0;
 554 }
 555 device_initcall(startup_leds);