Jsphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget /translations/zh_CN/fb/ep93xx-fbmodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget /translations/zh_TW/fb/ep93xx-fbmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget /translations/it_IT/fb/ep93xx-fbmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget /translations/ja_JP/fb/ep93xx-fbmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget /translations/ko_KR/fb/ep93xx-fbmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget /translations/sp_SP/fb/ep93xx-fbmodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhsection)}(hhh](htitle)}(h Driver for EP93xx LCD controllerh]h Driver for EP93xx LCD controller}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhh:/var/lib/git/docbuild/linux/Documentation/fb/ep93xx-fb.rsthKubh paragraph)}(hThe EP93xx LCD controller can drive both standard desktop monitors and embedded LCD displays. If you have a standard desktop monitor then you can use the standard Linux video mode database. In your board file::h]hThe EP93xx LCD controller can drive both standard desktop monitors and embedded LCD displays. If you have a standard desktop monitor then you can use the standard Linux video mode database. In your board file:}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh literal_block)}(hstatic struct ep93xxfb_mach_info some_board_fb_info = { .num_modes = EP93XXFB_USE_MODEDB, .bpp = 16, };h]hstatic struct ep93xxfb_mach_info some_board_fb_info = { .num_modes = EP93XXFB_USE_MODEDB, .bpp = 16, };}hhsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1hhhhK hhhhubh)}(h\If you have an embedded LCD display then you need to define a video mode for it as follows::h]h[If you have an embedded LCD display then you need to define a video mode for it as follows:}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hstatic struct fb_videomode some_board_video_modes[] = { { .name = "some_lcd_name", /* Pixel clock, porches, etc */ }, };h]hstatic struct fb_videomode some_board_video_modes[] = { { .name = "some_lcd_name", /* Pixel clock, porches, etc */ }, };}hhsbah}(h]h ]h"]h$]h&]hhuh1hhhhKhhhhubh)}(hNote that the pixel clock value is in pico-seconds. You can use the KHZ2PICOS macro to convert the pixel clock value. Most other values are in pixel clocks. See Documentation/fb/framebuffer.rst for further details.h]hNote that the pixel clock value is in pico-seconds. You can use the KHZ2PICOS macro to convert the pixel clock value. Most other values are in pixel clocks. See Documentation/fb/framebuffer.rst for further details.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hPThe ep93xxfb_mach_info structure for your board should look like the following::h]hOThe ep93xxfb_mach_info structure for your board should look like the following:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hstatic struct ep93xxfb_mach_info some_board_fb_info = { .num_modes = ARRAY_SIZE(some_board_video_modes), .modes = some_board_video_modes, .default_mode = &some_board_video_modes[0], .bpp = 16, };h]hstatic struct ep93xxfb_mach_info some_board_fb_info = { .num_modes = ARRAY_SIZE(some_board_video_modes), .modes = some_board_video_modes, .default_mode = &some_board_video_modes[0], .bpp = 16, };}hjsbah}(h]h ]h"]h$]h&]hhuh1hhhhK hhhhubh)}(hhThe framebuffer device can be registered by adding the following to your board initialisation function::h]hgThe framebuffer device can be registered by adding the following to your board initialisation function:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK'hhhhubh)}(h(ep93xx_register_fb(&some_board_fb_info);h]h(ep93xx_register_fb(&some_board_fb_info);}hj-sbah}(h]h ]h"]h$]h&]hhuh1hhhhK*hhhhubeh}(h] driver-for-ep93xx-lcd-controllerah ]h"] driver for ep93xx lcd controllerah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hVideo Attribute Flagsh]hVideo Attribute Flags}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjChhhhhK.ubh)}(hThe ep93xxfb_mach_info structure has a flags field which can be used to configure the controller. The video attributes flags are fully documented in section 7 of the EP93xx users' guide. The following flags are available:h]hThe ep93xxfb_mach_info structure has a flags field which can be used to configure the controller. The video attributes flags are fully documented in section 7 of the EP93xx users’ guide. The following flags are available:}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK0hjChhubhtable)}(hhh]htgroup)}(hhh](hcolspec)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jlhjiubjm)}(hhh]h}(h]h ]h"]h$]h&]colwidthK*uh1jlhjiubhtbody)}(hhh](hrow)}(hhh](hentry)}(hhh]h)}(hEP93XXFB_PCLK_FALLINGh]hEP93XXFB_PCLK_FALLING}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK6hjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(hcClock data on the falling edge of the pixel clock. The default is to clock data on the rising edge.h]hcClock data on the falling edge of the pixel clock. The default is to clock data on the rising edge.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK6hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(hEP93XXFB_SYNC_BLANK_HIGHh]hEP93XXFB_SYNC_BLANK_HIGH}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK:hjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(hGBlank signal is active high. By default the blank signal is active low.h]hGBlank signal is active high. By default the blank signal is active low.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK:hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(hEP93XXFB_SYNC_HORIZ_HIGHh]hEP93XXFB_SYNC_HORIZ_HIGH}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK=hjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(hMHorizontal sync is active high. By default the horizontal sync is active low.h]hMHorizontal sync is active high. By default the horizontal sync is active low.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK=hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(hEP93XXFB_SYNC_VERT_HIGHh]hEP93XXFB_SYNC_VERT_HIGH}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK@hj3ubah}(h]h ]h"]h$]h&]uh1jhj0ubj)}(hhh]h)}(hJVertical sync is active high. By default the vertical sync is active high.h]hJVertical sync is active high. By default the vertical sync is active high.}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK@hjJubah}(h]h ]h"]h$]h&]uh1jhj0ubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjiubeh}(h]h ]h"]h$]h&]colsKuh1jghjdubah}(h]h ]h"]h$]h&]uh1jbhjChhhhhNubh)}(hTThe physical address of the framebuffer can be controlled using the following flags:h]hTThe physical address of the framebuffer can be controlled using the following flags:}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKDhjChhubjc)}(hhh]jh)}(hhh](jm)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jlhjubjm)}(hhh]h}(h]h ]h"]h$]h&]colwidthK&uh1jlhjubj)}(hhh](j)}(hhh](j)}(hhh]h)}(hEP93XXFB_USE_SDCSN0h]hEP93XXFB_USE_SDCSN0}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKHhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h>Use SDCSn[0] for the framebuffer. This is the default setting.h]h>Use SDCSn[0] for the framebuffer. This is the default setting.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKHhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(hEP93XXFB_USE_SDCSN1h]hEP93XXFB_USE_SDCSN1}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h!Use SDCSn[1] for the framebuffer.h]h!Use SDCSn[1] for the framebuffer.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(hEP93XXFB_USE_SDCSN2h]hEP93XXFB_USE_SDCSN2}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKMhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h!Use SDCSn[2] for the framebuffer.h]h!Use SDCSn[2] for the framebuffer.}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKMhj-ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(hEP93XXFB_USE_SDCSN3h]hEP93XXFB_USE_SDCSN3}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKOhjMubah}(h]h ]h"]h$]h&]uh1jhjJubj)}(hhh]h)}(h!Use SDCSn[3] for the framebuffer.h]h!Use SDCSn[3] for the framebuffer.}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKOhjdubah}(h]h ]h"]h$]h&]uh1jhjJubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]colsKuh1jghjubah}(h]h ]h"]h$]h&]uh1jbhjChhhhhNubeh}(h]video-attribute-flagsah ]h"]video attribute flagsah$]h&]uh1hhhhhhhhK.ubh)}(hhh](h)}(hPlatform callbacksh]hPlatform callbacks}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKTubh)}(hXThe EP93xx framebuffer driver supports three optional platform callbacks: setup, teardown and blank. The setup and teardown functions are called when the framebuffer driver is installed and removed respectively. The blank function is called whenever the display is blanked or unblanked.h]hXThe EP93xx framebuffer driver supports three optional platform callbacks: setup, teardown and blank. The setup and teardown functions are called when the framebuffer driver is installed and removed respectively. The blank function is called whenever the display is blanked or unblanked.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKVhjhhubh)}(hThe setup and teardown devices pass the platform_device structure as an argument. The fb_info and ep93xxfb_mach_info structures can be obtained as follows::h]hThe setup and teardown devices pass the platform_device structure as an argument. The fb_info and ep93xxfb_mach_info structures can be obtained as follows:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK\hjhhubh)}(hstatic int some_board_fb_setup(struct platform_device *pdev) { struct ep93xxfb_mach_info *mach_info = pdev->dev.platform_data; struct fb_info *fb_info = platform_get_drvdata(pdev); /* Board specific framebuffer setup */ }h]hstatic int some_board_fb_setup(struct platform_device *pdev) { struct ep93xxfb_mach_info *mach_info = pdev->dev.platform_data; struct fb_info *fb_info = platform_get_drvdata(pdev); /* Board specific framebuffer setup */ }}hjsbah}(h]h ]h"]h$]h&]hhuh1hhhhK`hjhhubeh}(h]platform-callbacksah ]h"]platform callbacksah$]h&]uh1hhhhhhhhKTubh)}(hhh](h)}(hSetting the video modeh]hSetting the video mode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKjubh)}(h2The video mode is set using the following syntax::h]h1The video mode is set using the following syntax:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKlhjhhubh)}(hvideo=XRESxYRES[-BPP][@REFRESH]h]hvideo=XRESxYRES[-BPP][@REFRESH]}hjsbah}(h]h ]h"]h$]h&]hhuh1hhhhKnhjhhubh)}(hqIf the EP93xx video driver is built-in then the video mode is set on the Linux kernel command line, for example::h]hpIf the EP93xx video driver is built-in then the video mode is set on the Linux kernel command line, for example:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKphjhhubh)}(hvideo=ep93xx-fb:800x600-16@60h]hvideo=ep93xx-fb:800x600-16@60}hjsbah}(h]h ]h"]h$]h&]hhuh1hhhhKshjhhubh)}(hiIf the EP93xx video driver is built as a module then the video mode is set when the module is installed::h]hhIf the EP93xx video driver is built as a module then the video mode is set when the module is installed:}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKuhjhhubh)}(h modprobe ep93xx-fb video=320x240h]h modprobe ep93xx-fb video=320x240}hj6sbah}(h]h ]h"]h$]h&]hhuh1hhhhKxhjhhubeh}(h]setting-the-video-modeah ]h"]setting the video modeah$]h&]uh1hhhhhhhhKjubh)}(hhh](h)}(hScreenpage bugh]hScreenpage bug}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjLhhhhhK|ubh)}(hAt least on the EP9315 there is a silicon bug which causes bit 27 of the VIDSCRNPAGE (framebuffer physical offset) to be tied low. There is an unofficial errata for this bug at::h]hAt least on the EP9315 there is a silicon bug which causes bit 27 of the VIDSCRNPAGE (framebuffer physical offset) to be tied low. There is an unofficial errata for this bug at:}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK~hjLhhubh)}(h;https://marc.info/?l=linux-arm-kernel&m=110061245502000&w=2h]h;https://marc.info/?l=linux-arm-kernel&m=110061245502000&w=2}hjksbah}(h]h ]h"]h$]h&]hhuh1hhhhKhjLhhubh)}(hBy default the EP93xx framebuffer driver checks if the allocated physical address has bit 27 set. If it does, then the memory is freed and an error is returned. The check can be disabled by adding the following option when loading the driver::h]hBy default the EP93xx framebuffer driver checks if the allocated physical address has bit 27 set. If it does, then the memory is freed and an error is returned. The check can be disabled by adding the following option when loading the driver:}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjLhhubh)}(h ep93xx-fb.check_screenpage_bug=0h]h ep93xx-fb.check_screenpage_bug=0}hjsbah}(h]h ]h"]h$]h&]hhuh1hhhhKhjLhhubh)}(hIn some cases it may be possible to reconfigure your SDRAM layout to avoid this bug. See section 13 of the EP93xx users' guide for details.h]hIn some cases it may be possible to reconfigure your SDRAM layout to avoid this bug. See section 13 of the EP93xx users’ guide for details.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjLhhubeh}(h]screenpage-bugah ]h"]screenpage bugah$]h&]uh1hhhhhhhhK|ubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksjfootnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerjerror_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourceh _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}substitution_names}refnames}refids}nameids}(j@j=jjjjjIjFjju nametypes}(j@jjjIjuh}(j=hjjCjjjFjjjLu footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}Rparse_messages]transform_messages] transformerN include_log] decorationNhhub.