Panorama

ReadMe for Panorama package version 1.17 If your system is using the SMP kernel then ACPI.PSD version 3.21.03 or later is required for optimal performance. The WarpIn installer will verify this for you. This WarpIn package will do a full install of the GRADD based Panorama Video driver. It will first copy files to a temporary directory and then install Panorama from there. The temporary directory can be deleted after installation. Installation using anything other than CMD.EXE as the default OS/2 shell may not work and is not supported. WarpIn cannot be used to uninstall Panorama. You can only change video drivers by installing a different driver. Copyright and License ===================== Copyright (c) 2011-2020 David Azarewicz <david@88watts.net> All rights reserved. Copyright (c) 2005-2009 eCo Software (c) Copyright IBM Corporation 1990,2000. All rights reserved. Binary programs and documentation for the Panorama Driver Software are licensed to and distributed by Arca Noae, LLC. Important! By downloading or using this software, you acknowledge that you have read and consent to the license agreement contained in the separate License.txt file, that you understand it, and that you agree to be bound by its terms. Getting Support and Reporting Problems ====================================== For more information and to report problems please visit: https://www.arcanoae.com and click on SUPPORT. Or go directly to the Panorama support wiki at: https://www.arcanoae.com/wiki/panorama/ A Note About Performance ======================== This version of the Panorama driver attempts to set write combining caching for the video display memory using MTRRs. This is preferred since using MTRRs affects all access to video memory from all drivers and all programs anywhere in the system. If your system does not support this type of MTRR change, the Panorama driver will use PAT to set write combine caching for its own video memory access. PAT is process specific and does not affect anything outside of the process that sets it. This means that any other interfaces or programs (such as DIVE) that do not access video memory through the Panorama driver will not have write combine caching enabled and will not have the performance improvement from this type of memory caching. Custom Resolutions ================== ** WARNING *** DO NOT CHANGE CUSTOM RESOLUTION SETTINGS UNLESS YOU FULLY UNDERSTAND WHAT EACH SETTING DOES. The default settings are correct for almost every system. You will not need to change ANY settings except in extremely rare cases. To get back to the default settings, open the Screen object, go to the Custom Resolutions page and click Default. *** WARNING *** The custom resolution feature is experimental and may not always work. This feature works by patching the mode table in the BIOS. Panorama can only patch newer Intel BIOS and ATI/ATOM BIOS. Panorama cannot patch Nvidia and Matrox BIOS. If you have a BIOS that cannot be patched, then you are stuck with whatever resolutions are provided by the BIOS. Patching the mode table does not work in every case. Some BIOS have additional limitations that do not allow certain resolutions to work even though the mode table has been patched. There is nothing that can be done in Panorama to fix this limitation in the BIOS. Patching the mode table requres changes to the memory controller to allow write access to the BIOS. This should work correctly on all modern AMD systems. Intel hardware is much more difficult to deal with and support must to be added for every individual CPU type. Support for most of the known Intel CPU types has been added. Any new CPUs added by Intel will not work until support is added for them. By default, the Panorama driver will query the display resolution via the Display Data Channel. If this succeeds, the Panorama driver will automatically add the native display resolution to the list of available resolutions that are displayed in the Screen Object settings. You can then select the desired resolution from the list. If the query of the display resolution (the EDID) fails you can manually specify a custom resolution. Look in the \var\log\vbe2grad.log file to see if the "Get EDID failed". If a manual custom resolution is set, the Panorama driver will attempt to modify one of the existing resolutions to the requested resolution. A manually set custom resolution overrides the automatic display detection. If a manual custom resolution is set, the Panorama driver will not even query the disply for its resolution. NOTE THAT IF YOUR DISPLAY PROVIDES THE RESOLUTION AND TIMING INFORMATION VIA DDC (THE EDID) THEN YOU SHOULD NOT SET THE RESOLUTION MANUALLY. If the display provides timing information along with the resolution, then that timing information is used rather than calculating the timings. Using the timings that the display provides is always best since the timings provided by the display are exactly what the display wants. If you manually specify a custom resolution or if the display (or controller) cannot provide the timings, then the Panorama driver will calculate the timings using the standard VESA timing formula for a 60Hz refresh rate. These standard timings may not be exactly what your display wants and may not work correctly or may not work at all. You can set a manual resolution using the "Custom Resolutions" tab in the screen object. Setting a manual custom resolution modifies entries for the PANORAMA application in OS2.INI. Once you have manually set a custom resolution, you must reboot to make it active so it will show up in the selection dialog in the Screen object settings. You can then select the resolution you want from the Screen object and reboot again. If you try a manual custom resolution and you happen to get something that your monitor cannot display, or if you have other problems with the custom resolution feature you can disable portions of this feature by using PanoUtil.exe. PanoUtil can be run from the CAD handler by typeing CTL-ALT-DEL and going to a command prompt. NOTE THAT ARCA NOAE CANNOT PROVIDE SUPPORT FOR MANUALLY SET CUSTOM RESOLUTIONS. SETTING IMPROPER CUSTOM RESOLUTIONS CAN DAMAGE YOUR HARDWARE. THE USER ASSUMES ALL RESPONSIBILITY FOR ATTEMPTING TO USE CUSTOM RESOLUTIONS. The custom resolution feature (automatic or manual) is not compatible with the wide screen enabler drivers and will not work if you have one of those drivers installed. Using PanoUtil.exe ================== PanoUtil can only be used when a compatible version of Panorama is installed and running. PanoUtil, like Panorama, is a Presentation Manager application and will not run unless Presentation Manager is running. You cannot run PanoUtil when booted to a command line. However, you can run PanoUtil from a command prompt from withing the CAD handler. Usage: PanoUtil [switches] function Switches: -v : verbose Functions: -i : display adapter information -q : query current MTRR settings -p [X Y] [d:] : Set PM resolution to XxY on drive d: (default 800x600) -r [d:] : Reset custom resolution to default on drive d: -d 0|1 [d:] : 0=Disable/1=Enable custom resolution logic on drive d: -c X Y [d:] : Set Custom resolution to X Y on drive d: -e 0|Clk,H,V,Hbl,Vbl,Hof,Hw,Vof,Vw [d:] : Set custom EDID on drive d: -s [d:] : Show custom resolution status on drive d: -n 0|1 [d:] : Enable/Disable Use Native Resolution on drive d: -m <base> <size> <flag> : Modify specific MTRR base is in hex size is in decimal and must have a k or m suffix flag is 0 for disable, 1 for enable example: PanoUtil -m d0000000 64m 1 Some common command usages: To set a manual custom resolution for 1920x1080 on your currently booted disk: PanuUtil -c 1920 1080 To remove a manual custom resolution on your currently booted disk: PanoUtil -r To completely disable all the custom resolution support on your currrently booted disk: PanoUtil -d 0 To enable the custom resolution support on your currently booted disk: PanoUtil -d 1 To reset the Presentation Manager selected resolution to 800x600 on drive d: PanoUtil -p d: To set the Presentation Manager selected resolution to 1280x1024 on drive d: PanoUtil -p 1280 1024 d: To set a custom EDID on your currently booted disk: PanoUtil -e Clk,H,V,Hbl,Vbl,Hof,Hw,Vof,Vw where Clk = Pixel clock in 10 khz units H = Horizontal width in pixels V = Vertical height in pixels Hbl = Horizontal blanking time in pixels Vbl = Vertical blanking time in pixels Hof = Horizontal sync offset in pixels Hw = Horizontal sync width in pixels Vof = Vertical sync offset in pixels Vw = Vertical sync width in pixels example: PanoUtil -e 10800,1280,1024,408,42,48,112,1,3 where Pixel clock is 108 MHz Horizontal width is 1280 pixels Vertical height is 1024 pixels Horizontal blanking time is 408 pixels Vertical blanking time is 42 pixels Horizontal sync offset is 48 pixels Horizontal sync width is 112 pixels Vertical sync offset is 1 pixel Vertical sync width is 3 pixels ARCA NOAE CANNOT PROVIDE SUPPORT FOR MANUALLY SET CUSTOM RESOLUTIONS OR CUSTOM EDID SETTINGS. SETTING IMPROPER CUSTOM RESOLUTIONS CAN DAMAGE YOUR HARDWARE. THE USER ASSUMES ALL RESPONSIBILITY FOR ATTEMPTING TO USE CUSTOM RESOLUTIONS OR CUSTOM EDID. Change Log ========== 1.17 - 03-Sep-2020 - David Azarewicz ------------------------------------ Change Custom Resolution module to patch unused mode line. Added VbePm module. 1.16 - 16-Aug-2020 - David Azarewicz ------------------------------------ Enhanced Custom Resolution module - Handle EDID with higher resolutions - More intelligently select mode line to patch - Automatically detect unidentified Intel BIOS 1.15 - 24-Aug-2019 - David Azarewicz ------------------------------------ Fixed problem with mode selection. Fixed MTRR setting issue. 1.14 - 03-Aug-2019 - David Azarewicz ------------------------------------ Added National Language Support for setup Changed to set WC for entire video aperture A new gradd.sys is included in this package. 1.13 - 25-Dec-2018 - David Azarewicz ------------------------------------ Restructured installer and packfiles. Added PANOPMI.DLL and svgadata.pmi Enhanced EDID v1.1 resolution detection. 1.12 - 10-Oct-2018 - David Azarewicz ------------------------------------ Enabled EDID v1.4 detection for custom resolutions. 1.11 - 03-Mar-2018 - David Azarewicz ------------------------------------ Fixed a problem where Panorama would hang with certain BIOS. Removed unused display settings page. 1.10 - 30-Nov-2017 - David Azarewicz ------------------------------------ Installer enhancements. Screen object enhancements. 1.09 - 26-Oct-2017 - David Azarewicz ------------------------------------ Added some Custom Resolution settings to the screen object. Automatically disable UseNativeRes if resolution is changed in the screen object. Fixed validation of EDID information from older displays. 1.08 - 18-Dec-2016 - David Azarewicz ------------------------------------ Removed some Warpin installer restrictions Added setup WPS class to package. Enhanced UseNativeRes functionality. Fixed installer to work on ArcaOS installations. Added test so that driver will not report resolutions or attempt to use video memory above that reported by the BIOS. 1.07 - David Azarewicz ---------------------- Fixed vram size calculation so Panorama claims the proper amount of memory. 1.06 - David Azarewicz ---------------------- Fixed support for custom resolutions for Intel type 2 BIOS. 1.05 - David Azarewicz ---------------------- Added a special native resolution feature for the demo CD. 1.04 - David Azarewicz --------------- Added sleep/wake support 1.03 - David Azarewicz --------------- Fixed a problem with setting custom resolutions in older type ATOM BIOS. 1.02 - David Azarewicz ---------------------- Fixed a problem with setting custom resolutions in ATOM BIOS. Some changes to the way PanoUtil works. 1.01 - David Azarewicz ---------------------- Added support for more Intel CPUs. Removed SetCustomRes.cmd and added that functionality to PanoUtil.exe Added an alternate way to detect Intel Type 1 ROMS. 1.00 - David Azarewicz ---------------------- Major code cleanup for all modules. Major reorganization and restructuring of GRADD.SYS. Fixed several bugs. Fixed the math in the MTRR routines to handle numbers >= 4Gib. Added code to reorganize certain incompatible MTRR tables. Added support for PAT when setting MTRR fails. Added experimental support for custom resolutions Previous Versions - eCo Software -------------------------------- The Panorama VESA video driver was originally created and maintained from 2005 through 2009 by eCo Software.