/* * VBMouse - DOS mouse driver exec entry point * Copyright (C) 2022 Javier S. Pedro * * This program is free software; you can redistribute it and/or * modify it under the terms of the GNU General Public License * as published by the Free Software Foundation; either version 2 * of the License, or (at your option) any later version. * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program; if not, write to the Free Software * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. */ #include #include #include #include #include "kitten.h" #include "version.h" #include "dlog.h" #include "int33.h" #include "int21dos.h" #include "int15ps2.h" #include "vbox.h" #include "vmware.h" #include "dostsr.h" #include "mousetsr.h" static nl_catd cat; #if USE_WHEEL static bool detect_wheel(LPTSRDATA data) { // Do a quick check for a mouse wheel here. // The TSR will do its own check when it is reset anyway if (ps2m_detect_imps2()) { if (ps2m_detect_imex()) { data->num_wheels = 2; } else { data->num_wheels = 1; } printf(_(1, 0, "Wheel mouse found and enabled\n")); return true; } else { data->num_wheels = 0; return false; } } static int set_wheel(LPTSRDATA data, bool enable) { printf(_(1, 1, "Setting wheel support to %s\n"), enable ? _(1, 2, "enabled") : _(1, 3, "disabled")); data->usewheel = enable; if (data->usewheel) { if (!detect_wheel(data)) { fprintf(stderr, _(3, 0, "Could not find PS/2 wheel mouse\n")); } } else { // Force num_wheels to 0 even before the next mouse reset data->num_wheels = 0; } return 0; } static int set_wheel_key(LPTSRDATA data, const char *keyname) { if (!data->usewheel) { fprintf(stderr, _(3, 1, "Wheel not detected or support not enabled\n")); return EXIT_FAILURE; } if (keyname) { if (stricmp(keyname, "updn") == 0) { data->wheel_up_key = 0x48; data->wheel_down_key = 0x50; printf(_(1, 4, "Generate Up Arrow / Down Arrow key presses on wheel movement\n")); } else if (stricmp(keyname, "pageupdn") == 0) { data->wheel_up_key = 0x49; data->wheel_down_key = 0x51; printf(_(1, 5, "Generate PageUp / PageDown key presses on wheel movement\n")); } else { fprintf(stderr, _(3, 2, "Unknown key '%s'\n"), keyname); return EXIT_FAILURE; } } else { printf(_(1, 6, "Disabling wheel keystroke generation\n")); data->wheel_up_key = 0; data->wheel_down_key = 0; } return EXIT_SUCCESS; } #endif /* USE_WHEEL */ #if USE_VIRTUALBOX static int set_virtualbox_integration(LPTSRDATA data, bool enable) { if (enable) { int err; data->vbavail = false; // Reinitialize it even if already enabled err = vbox_init_device(&data->vb); if (err) { fprintf(stderr, _(3, 3, "Cannot find VirtualBox PCI device, err=%d\n"), err); return err; } err = vbox_init_buffer(&data->vb, VBOX_BUFFER_SIZE); if (err) { fprintf(stderr, _(3, 4, "Cannot lock buffer used for VirtualBox communication, err=%d\n"), err); return err; } err = vbox_report_guest_info(&data->vb, VBOXOSTYPE_DOS); if (err) { fprintf(stderr, _(3, 5, "VirtualBox communication is not working, err=%d\n"), err); return err; } printf(_(1, 7, "VirtualBox integration enabled\n")); data->vbavail = true; data->vbhaveabs = true; } else { if (data->vbavail) { vbox_set_mouse(&data->vb, false, false); vbox_release_buffer(&data->vb); printf(_(1, 8, "Disabled VirtualBox integration\n")); data->vbavail = false; data->vbhaveabs = false; } else { printf(_(1, 9, "VirtualBox integration already disabled or not available\n")); } } return 0; } static int set_virtualbox_host_cursor(LPTSRDATA data, bool enable) { printf(_(1, 10, "Setting host cursor to %s\n"), enable ? _(1, 2, "enabled") : _(1, 3, "disabled")); data->vbwantcursor = enable; return 0; } #endif #if USE_VMWARE static int set_vmware_integration(LPTSRDATA data, bool enable) { if (enable) { int32_t version; uint32_t status; uint16_t data_avail; data->vmwavail = false; version = vmware_get_version(); if (version < 0) { fprintf(stderr, _(3, 6, "Could not detect VMware, err=%ld\n"), version); return -1; } printf(_(1, 11, "Found VMware protocol version %ld\n"), version); vmware_abspointer_cmd(VMWARE_ABSPOINTER_CMD_ENABLE); status = vmware_abspointer_status(); if ((status & VMWARE_ABSPOINTER_STATUS_MASK_ERROR) == VMWARE_ABSPOINTER_STATUS_MASK_ERROR) { fprintf(stderr, _(3, 7, "VMware absolute pointer error, err=0x%lx\n"), status & VMWARE_ABSPOINTER_STATUS_MASK_ERROR); return -1; } vmware_abspointer_data_clear(); // TSR part will enable the absolute mouse when reset printf(_(1, 12, "VMware integration enabled\n")); data->vmwavail = true; } else { if (data->vmwavail) { vmware_abspointer_cmd(VMWARE_ABSPOINTER_CMD_REQUEST_RELATIVE); vmware_abspointer_cmd(VMWARE_ABSPOINTER_CMD_DISABLE); data->vmwavail = false; printf(_(1, 13, "Disabled VMware integration\n")); } else { printf(_(1, 14, "VMware integration already disabled or not available\n")); } } return 0; } #endif static int set_integration(LPTSRDATA data, bool enable) { if (enable) { int err = -1; #if USE_VIRTUALBOX // First check if we can enable the VirtualBox integration, // since it's a PCI device it's easier to check if it's not present err = set_virtualbox_integration(data, true); if (!err) return 0; #endif #if USE_VMWARE // Afterwards try VMWare integration err = set_vmware_integration(data, true); if (!err) return 0; #endif printf(_(1, 15, "Neither VirtualBox nor VMware integration available\n")); return err; } else { #if USE_VIRTUALBOX if (data->vbavail) { set_virtualbox_integration(data, false); } #endif #if USE_VMWARE if (data->vmwavail) { set_vmware_integration(data, false); } #endif return 0; } } static int set_host_cursor(LPTSRDATA data, bool enable) { #if USE_VIRTUALBOX if (data->vbavail) { return set_virtualbox_host_cursor(data, enable); } #endif printf(_(1, 16, "VirtualBox integration not available\n")); return -1; } static int configure_driver(LPTSRDATA data) { int err; // Configure the debug logging port dlog_init(); // Check for PS/2 mouse BIOS availability if ((err = ps2m_init(PS2M_PACKET_SIZE_STD))) { fprintf(stderr, _(3, 8, "Cannot init PS/2 mouse BIOS, err=%d\n"), err); // Can't do anything without PS/2 return err; } #if USE_WHEEL // Let's utilize the wheel by default data->usewheel = true; data->wheel_up_key = 0; data->wheel_down_key = 0; detect_wheel(data); // Prints message if wheel found #endif #if USE_INTEGRATION // Enable integration by default set_integration(data, true); #endif #if USE_VIRTUALBOX // Assume initially that we want host cursor data->vbwantcursor = data->vbavail; #endif return 0; } static int move_driver_to_umb(LPTSRDATA __far * data) { segment_t cur_seg = FP_SEG(*data); segment_t umb_seg = reallocate_to_umb(cur_seg, get_resident_size() + DOS_PSP_SIZE); if (umb_seg) { // Update the data pointer with the new segment *data = MK_FP(umb_seg, FP_OFF(*data)); return 0; } else { return -1; } } static __declspec(aborts) int install_driver(LPTSRDATA data, bool high) { const unsigned int resident_size = DOS_PSP_SIZE + get_resident_size(); // No more interruptions from now on and until we TSR. // Inserting ourselves in the interrupt chain should be atomic. _disable(); data->prev_int33_handler = _dos_getvect(0x33); _dos_setvect(0x33, data:>int33_isr); #if USE_WIN386 data->prev_int2f_handler = _dos_getvect(0x2f); _dos_setvect(0x2f, data:>int2f_isr); #endif printf(_(1, 17, "Driver installed\n")); // If we reallocated ourselves to UMB, // it's time to free our initial conventional memory allocation if (high) { finish_reallocation(_psp, FP_SEG(data)); } kittenclose(); _dos_keep(EXIT_SUCCESS, get_paragraphs(resident_size)); // Shouldn't reach this part return EXIT_FAILURE; } static bool check_if_driver_uninstallable(LPTSRDATA data) { void (__interrupt __far *cur_int33_handler)() = _dos_getvect(0x33); // Compare the segment of the installed handler to see if its ours // or someone else's if (FP_SEG(cur_int33_handler) != FP_SEG(data)) { fprintf(stderr, _(3, 9, "INT33 has been hooked by someone else, cannot safely remove\n")); return false; } #if USE_WIN386 { void (__interrupt __far *cur_int2f_handler)() = _dos_getvect(0x2f); if (FP_SEG(cur_int2f_handler) != FP_SEG(data)) { fprintf(stderr, _(3, 10, "INT2F has been hooked by someone else, cannot safely remove\n")); return false; } } #endif return true; } static int unconfigure_driver(LPTSRDATA data) { #if USE_INTEGRATION set_integration(data, false); #endif ps2m_enable(false); ps2m_set_callback(0); return 0; } static int uninstall_driver(LPTSRDATA data) { _dos_setvect(0x33, data->prev_int33_handler); #if USE_WIN386 _dos_setvect(0x2f, data->prev_int2f_handler); #endif // Find and deallocate the PSP (including the entire program), // it is always 256 bytes (16 paragraphs) before the TSR segment dos_free(FP_SEG(data) - (DOS_PSP_SIZE/16)); printf(_(1, 18, "Driver uninstalled\n")); return 0; } static int driver_reset(void) { printf(_(1, 19, "Reset mouse driver\n")); return int33_reset() == 0xFFFF; } static int driver_not_found(void) { fprintf(stderr, _(3, 11, "Driver data not found (driver not installed?)\n")); return EXIT_FAILURE; } static void print_help(void) { putchar('\n'); puts(_(0, 0, "Usage: ")); puts(_(0, 1, " VBMOUSE ")); putchar('\n'); puts(_(0, 2, "Supported actions and options:")); puts(_(0, 3, " install Install the driver (default).")); puts(_(0, 4, " low Install in conventional memory (otherwise UMB).")); puts(_(0, 5, " uninstall Uninstall the driver from memory.")); #if USE_WHEEL puts(_(0, 6, " wheel Enable/disable wheel API support.")); puts(_(0, 7, " wheelkey Emulate a specific keystroke on wheel scroll.")); puts(_(0, 8, " Supported keys: updn, pageupdn.")); #endif #if USE_INTEGRATION puts(_(0, 9, " integ Enable/disable VirtualBox integration.")); puts(_(0, 10, " hostcur Enable/disable mouse cursor rendering in the host.")); #endif puts(_(0, 11, " reset Reset mouse driver.")); } static int invalid_arg(const char *s) { fprintf(stderr, _(3, 12, "Invalid argument '%s'\n"), s); print_help(); return EXIT_FAILURE; } static int arg_required(const char *s) { fprintf(stderr, _(3, 13, "Argument required for '%s'\n"), s); print_help(); return EXIT_FAILURE; } static bool is_true(const char *s) { return stricmp(s, "yes") == 0 || stricmp(s, "y") == 0 || stricmp(s, "on") == 0 || stricmp(s, "true") == 0 || stricmp(s, "enabled") == 0 || stricmp(s, "enable") == 0 || stricmp(s, "1") == 0; } static bool is_false(const char *s) { return stricmp(s, "no") == 0 || stricmp(s, "n") == 0 || stricmp(s, "off") == 0 || stricmp(s, "false") == 0 || stricmp(s, "disabled") == 0 || stricmp(s, "disable") == 0 || stricmp(s, "0") == 0; } int main(int argc, const char *argv[]) { LPTSRDATA data = get_tsr_data(true); int err, argi = 1; cat = kittenopen("vbmouse"); printf(_(1, 20, "\nVBMouse %x.%x (reporting as MSMOUSE %x.%x)\n"), VERSION_MAJOR, VERSION_MINOR, REPORTED_VERSION_MAJOR, REPORTED_VERSION_MINOR); if (argi >= argc || stricmp(argv[argi], "install") == 0) { bool high = true; argi++; for (; argi < argc; argi++) { if (stricmp(argv[argi], "low") == 0) { high = false; } else if (stricmp(argv[argi], "high") == 0) { high = true; } else { return invalid_arg(argv[argi]); } } if (data) { printf(_(1, 21, "VBMouse already installed\n")); print_help(); return EXIT_SUCCESS; } data = get_tsr_data(false); if (high) { err = move_driver_to_umb(&data); if (err) high = false; // Not fatal } else { deallocate_environment(_psp); } err = configure_driver(data); if (err) { if (high) cancel_reallocation(FP_SEG(data)); return EXIT_FAILURE; } return install_driver(data, high); } else if (stricmp(argv[argi], "uninstall") == 0) { if (!data) return driver_not_found(); if (!check_if_driver_uninstallable(data)) { return EXIT_FAILURE; } err = unconfigure_driver(data); if (err) { return EXIT_FAILURE; } return uninstall_driver(data); #if USE_WHEEL } else if (stricmp(argv[argi], "wheel") == 0) { bool enable = true; if (!data) return driver_not_found(); argi++; if (argi < argc) { if (is_false(argv[argi])) enable = false; } return set_wheel(data, enable); } else if (stricmp(argv[argi], "wheelkey") == 0) { bool enable = true; const char *key = 0; if (!data) return driver_not_found(); argi++; if (argi < argc) { if (is_false(argv[argi])) enable = false; else key = argv[argi]; } if (enable) { if (!key) return arg_required("wheelkey"); return set_wheel_key(data, key); } else { return set_wheel_key(data, 0); } #endif #if USE_INTEGRATION } else if (stricmp(argv[argi], "integ") == 0) { bool enable = true; if (!data) return driver_not_found(); argi++; if (argi < argc) { if (is_false(argv[argi])) enable = false; } return set_integration(data, enable); } else if (stricmp(argv[argi], "hostcur") == 0) { bool enable = true; if (!data) return driver_not_found(); argi++; if (argi < argc) { if (is_false(argv[argi])) enable = false; } // Reset before changing this to ensure the cursor is not drawn int33_reset(); return set_host_cursor(data, enable); #endif } else if (stricmp(argv[argi], "reset") == 0) { return driver_reset(); } else { return invalid_arg(argv[argi]); } }