1 /* 2 * LCD device support. 3 * 4 * Copyright (C) 2018, 2020, 2023, 2024 Paul Boddie <paul@boddie.org.uk> 5 * 6 * This program is free software; you can redistribute it and/or 7 * modify it under the terms of the GNU General Public License as 8 * published by the Free Software Foundation; either version 2 of 9 * the License, or (at your option) any later version. 10 * 11 * This program is distributed in the hope that it will be useful, 12 * but WITHOUT ANY WARRANTY; without even the implied warranty of 13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 14 * GNU General Public License for more details. 15 * 16 * You should have received a copy of the GNU General Public License 17 * along with this program; if not, write to the Free Software 18 * Foundation, Inc., 51 Franklin Street, Fifth Floor, 19 * Boston, MA 02110-1301, USA 20 */ 21 22 #pragma once 23 24 #include <l4/devices/dma.h> 25 #include <l4/devices/lcd/activation_interface.h> 26 #include <l4/devices/lcd.h> 27 28 #include <l4/re/c/video/view.h> 29 #include <l4/sys/types.h> 30 31 32 33 #ifdef __cplusplus 34 35 #include <l4/re/c/dataspace.h> 36 #include <l4/re/c/dma_space.h> 37 38 class Lcd_device 39 { 40 protected: 41 /* LCD peripheral abstraction. */ 42 43 Lcd_chip *_chip; 44 45 /* Display server abstraction. */ 46 47 Activation *_display; 48 49 /* Framebuffer region providing virtual and physical addresses plus the memory 50 capability for the framebuffer. */ 51 52 struct dma_region _fb_region; 53 54 /* Display operations. */ 55 56 virtual void disable_display(); 57 virtual void enable_display(); 58 59 public: 60 /* Initialise a device with a controller and display object reference. */ 61 62 Lcd_device(Lcd_chip *chip, Activation *display) 63 : _chip(chip), _display(display) 64 { 65 /* Subclasses must set up any memory. */ 66 67 _fb_region.vaddr = 0; 68 _fb_region.mem = L4_INVALID_CAP; 69 } 70 71 /* Framebuffer operations. */ 72 73 virtual l4_addr_t get_framebuffer() 74 { 75 return _fb_region.vaddr; 76 } 77 78 virtual l4re_ds_t get_framebuffer_cap() 79 { 80 return _fb_region.mem; 81 } 82 83 /* Querying operations. */ 84 85 virtual l4_size_t get_framebuffer_size() = 0; 86 virtual void get_view_info(l4re_video_view_info_t *view_info) = 0; 87 88 /* Device operations. */ 89 90 virtual void disable() = 0; 91 virtual void enable() = 0; 92 93 /* Device access. */ 94 95 static Lcd_device *get_device(); 96 }; 97 98 #endif 99 100 101 102 /* C language interface. */ 103 104 EXTERN_C_BEGIN 105 106 void *lcd_get_device(void); 107 l4_addr_t lcd_get_framebuffer(void *lcd); 108 l4_size_t lcd_get_framebuffer_size(void *lcd); 109 void lcd_get_view_info(void *lcd, l4re_video_view_info_t *view_info); 110 void lcd_disable(void *lcd); 111 void lcd_enable(void *lcd); 112 113 EXTERN_C_END