/* * Lowlevel hardware access for the * Razer Copperhead mouse * * Important notice: * This hardware driver is based on reverse engineering only. * * Copyright (C) 2009-2016 Michael Buesch * * 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. */ #include "hw_copperhead.h" #include "razer_private.h" #include "buttonmapping.h" #include #include #include #include #include enum { /* Misc constants */ COPPERHEAD_NR_PROFILES = 5, COPPERHEAD_NR_DPIMAPPINGS = 4, }; /* The wire protocol data structures... */ enum copperhead_phys_button { /* Physical button IDs */ COPPERHEAD_PHYSBUT_LEFT = 0x01, /* Left button */ COPPERHEAD_PHYSBUT_RIGHT, /* Right button */ COPPERHEAD_PHYSBUT_MIDDLE, /* Middle button */ COPPERHEAD_PHYSBUT_LFRONT, /* Left side, front button */ COPPERHEAD_PHYSBUT_LREAR, /* Left side, rear button */ COPPERHEAD_PHYSBUT_RFRONT, /* Right side, front button */ COPPERHEAD_PHYSBUT_RREAR, /* Right side, rear button */ NR_COPPERHEAD_PHYSBUT = 7, /* Number of physical buttons */ }; struct copperhead_profcfg_cmd { le16_t packetlength; le16_t magic; le16_t profilenr; le16_t reply_packetlength; /* Only valid for read data */ le16_t reply_magic; /* Only valid for read data */ le16_t reply_profilenr; uint8_t dpisel; uint8_t freq; uint8_t buttonmap[48 * NR_COPPERHEAD_PHYSBUT - 4]; le16_t checksum; } _packed; #define COPPERHEAD_PROFCFG_MAGIC cpu_to_le16(0x0002) struct copperhead_buttons { struct razer_buttonmapping mapping[NR_COPPERHEAD_PHYSBUT]; }; struct copperhead_private { struct razer_mouse *m; uint16_t fw_version; /* The active profile. */ struct razer_mouse_profile *cur_profile; /* Profile configuration (one per profile). */ struct razer_mouse_profile profiles[COPPERHEAD_NR_PROFILES]; /* The active DPI mapping; per profile. */ struct razer_mouse_dpimapping *cur_dpimapping[COPPERHEAD_NR_PROFILES]; /* The possible DPI mappings. */ struct razer_mouse_dpimapping dpimappings[COPPERHEAD_NR_DPIMAPPINGS]; /* The active scan frequency; per profile. */ enum razer_mouse_freq cur_freq[COPPERHEAD_NR_PROFILES]; /* The active button mapping; per profile. */ struct copperhead_buttons buttons[COPPERHEAD_NR_PROFILES]; bool commit_pending; struct razer_event_spacing commit_spacing; }; /* A list of physical buttons on the device. */ static struct razer_button copperhead_physical_buttons[] = { { .id = COPPERHEAD_PHYSBUT_LEFT, .name = "Leftclick", }, { .id = COPPERHEAD_PHYSBUT_RIGHT, .name = "Rightclick", }, { .id = COPPERHEAD_PHYSBUT_MIDDLE, .name = "Middleclick", }, { .id = COPPERHEAD_PHYSBUT_LFRONT, .name = "Leftside front", }, { .id = COPPERHEAD_PHYSBUT_LREAR, .name = "Leftside rear", }, { .id = COPPERHEAD_PHYSBUT_RFRONT, .name = "Rightside front", }, { .id = COPPERHEAD_PHYSBUT_RREAR, .name = "Rightside rear", }, }; /* A list of possible button functions. */ static struct razer_button_function copperhead_button_functions[] = { BUTTONFUNC_LEFT, BUTTONFUNC_RIGHT, BUTTONFUNC_MIDDLE, BUTTONFUNC_PROFDOWN, BUTTONFUNC_PROFUP, BUTTONFUNC_DPIUP, BUTTONFUNC_DPIDOWN, BUTTONFUNC_DPI1, BUTTONFUNC_DPI2, BUTTONFUNC_DPI3, BUTTONFUNC_DPI4, BUTTONFUNC_DPI5, BUTTONFUNC_WIN5, BUTTONFUNC_WIN4, BUTTONFUNC_SCROLLUP, BUTTONFUNC_SCROLLDWN, }; static int copperhead_usb_write(struct copperhead_private *priv, int request, int command, int index, void *buf, size_t size) { int err; err = libusb_control_transfer( priv->m->usb_ctx->h, LIBUSB_ENDPOINT_OUT | LIBUSB_REQUEST_TYPE_CLASS | LIBUSB_RECIPIENT_OTHER, request, command, index, (unsigned char *)buf, size, RAZER_USB_TIMEOUT); if (err < 0 || (size_t)err != size) { razer_error("razer-copperhead: " "USB write 0x%02X 0x%02X 0x%02X failed: %d\n", request, command, index, err); return -EIO; } return 0; } static int copperhead_usb_read(struct copperhead_private *priv, int request, int command, int index, void *buf, size_t size) { int err; err = libusb_control_transfer( priv->m->usb_ctx->h, LIBUSB_ENDPOINT_IN | LIBUSB_REQUEST_TYPE_CLASS | LIBUSB_RECIPIENT_OTHER, request, command, index, (unsigned char *)buf, size, RAZER_USB_TIMEOUT); if (err < 0 || (size_t)err != size) { razer_error("razer-copperhead: " "USB read 0x%02X 0x%02X 0x%02X failed: %d\n", request, command, index, err); return -EIO; } return 0; } static int copperhead_read_fw_ver(struct copperhead_private *priv) { char buf[2]; uint16_t ver; buf[0]=0; //TODO buf[1]=0; ver = buf[0]; ver <<= 8; ver |= buf[1]; return ver; } static int copperhead_do_commit(struct copperhead_private *priv) { union { struct copperhead_profcfg_cmd profcfg; uint8_t chunks[64 * 6]; } _packed u; uint8_t *chunk; unsigned int i, j; int err; unsigned char value; BUILD_BUG_ON(sizeof(u) != 0x180); razer_event_spacing_enter(&priv->commit_spacing); /* Upload the profile config */ for (i = 0; i < COPPERHEAD_NR_PROFILES; i++) { memset(&u, 0, sizeof(u)); u.profcfg.packetlength = cpu_to_le16(sizeof(u.profcfg)); u.profcfg.magic = COPPERHEAD_PROFCFG_MAGIC; u.profcfg.profilenr = cpu_to_le16(i + 1); u.profcfg.reply_profilenr = u.profcfg.profilenr; switch (priv->cur_dpimapping[i]->res[RAZER_DIM_0]) { default: case RAZER_MOUSE_RES_400DPI: u.profcfg.dpisel = 4; break; case RAZER_MOUSE_RES_800DPI: u.profcfg.dpisel = 3; break; case RAZER_MOUSE_RES_1600DPI: u.profcfg.dpisel = 2; break; case RAZER_MOUSE_RES_2000DPI: u.profcfg.dpisel = 1; break; } switch (priv->cur_freq[i]) { default: case RAZER_MOUSE_FREQ_125HZ: u.profcfg.freq = 3; break; case RAZER_MOUSE_FREQ_500HZ: u.profcfg.freq = 2; break; case RAZER_MOUSE_FREQ_1000HZ: u.profcfg.freq = 1; break; } err = razer_create_buttonmap(u.profcfg.buttonmap, sizeof(u.profcfg.buttonmap), priv->buttons[i].mapping, ARRAY_SIZE(priv->buttons[i].mapping), 46); if (err) goto out; u.profcfg.checksum = razer_xor16_checksum(&u.profcfg, sizeof(u.profcfg) - 2); /* The profile config is committed in 64byte chunks */ chunk = &u.chunks[0]; for (j = 0; j < 6; j++, chunk += 64) { err = copperhead_usb_write(priv, LIBUSB_REQUEST_SET_CONFIGURATION, j + 1, 0, chunk, 64); if (err) goto out; } /* Commit the profile */ value = i + 1; copperhead_usb_write(priv, LIBUSB_REQUEST_SET_CONFIGURATION, 0x02, 3, &value, sizeof(value)); /* Read back the result */ BUILD_BUG_ON(0x156 + 6 != sizeof(u.profcfg)); memset(&u, 0, sizeof(u)); err = copperhead_usb_read(priv, LIBUSB_REQUEST_CLEAR_FEATURE, 0x01, 0, ((uint8_t *)&u.profcfg) + 6, sizeof(u.profcfg) - 6); if (err) goto out; if (razer_xor16_checksum(&u.profcfg, sizeof(u.profcfg))) { razer_error("hw_copperhead: Profile commit checksum mismatch\n"); err = -EIO; goto out; } } /* Select the profile */ value = priv->cur_profile->nr + 1; err = copperhead_usb_write(priv, LIBUSB_REQUEST_SET_CONFIGURATION, 0x02, 1, &value, sizeof(value)); if (err) goto out; err = 0; out: razer_event_spacing_leave(&priv->commit_spacing); return err; } static int copperhead_read_config_from_hw(struct copperhead_private *priv) { struct copperhead_profcfg_cmd profcfg; unsigned int i; unsigned char value; int err; /* Read the current profile number. */ err = copperhead_usb_read(priv, LIBUSB_REQUEST_CLEAR_FEATURE, 0x01, 0, &value, sizeof(value)); if (err) return err; if (value < 1 || value > COPPERHEAD_NR_PROFILES) { razer_error("hw_copperhead: Got invalid profile number: %u\n", (unsigned int)value); value = 1; } priv->cur_profile = &priv->profiles[value - 1]; /* Read the profiles config */ for (i = 0; i < COPPERHEAD_NR_PROFILES; i++) { BUILD_BUG_ON(0x156 + 6 != sizeof(profcfg)); /* Request profile config */ value = i + 1; err = copperhead_usb_write(priv, LIBUSB_REQUEST_SET_CONFIGURATION, 0x02, 3, &value, sizeof(value)); if (err) return err; /* Read profile config */ memset(&profcfg, 0, sizeof(profcfg)); err = copperhead_usb_read(priv, LIBUSB_REQUEST_CLEAR_FEATURE, 0x01, 0, ((uint8_t *)&profcfg) + 6, sizeof(profcfg) - 6); if (err) return err; if (razer_xor16_checksum(&profcfg, sizeof(profcfg))) { razer_error("hw_copperhead: Read profile data checksum mismatch\n"); continue; } if (le16_to_cpu(profcfg.reply_profilenr) != i + 1) { razer_error("hw_copperhead: Got invalid profile nr in " "profile config: %u\n", (unsigned int)le16_to_cpu(profcfg.reply_profilenr)); } switch (profcfg.dpisel) { case 4: priv->cur_dpimapping[i] = razer_mouse_get_dpimapping_by_res( priv->dpimappings, ARRAY_SIZE(priv->dpimappings), RAZER_DIM_0, RAZER_MOUSE_RES_400DPI); break; case 3: priv->cur_dpimapping[i] = razer_mouse_get_dpimapping_by_res( priv->dpimappings, ARRAY_SIZE(priv->dpimappings), RAZER_DIM_0, RAZER_MOUSE_RES_800DPI); break; case 2: priv->cur_dpimapping[i] = razer_mouse_get_dpimapping_by_res( priv->dpimappings, ARRAY_SIZE(priv->dpimappings), RAZER_DIM_0, RAZER_MOUSE_RES_1600DPI); break; case 1: priv->cur_dpimapping[i] = razer_mouse_get_dpimapping_by_res( priv->dpimappings, ARRAY_SIZE(priv->dpimappings), RAZER_DIM_0, RAZER_MOUSE_RES_2000DPI); break; default: razer_error("hw_copperhead: Got invalid DPI mapping selection\n"); break; } if (!priv->cur_dpimapping[i]) { razer_error("hw_copperhead: Internal error: No dpimapping\n"); return -ENODEV; } switch (profcfg.freq) { case 3: priv->cur_freq[i] = RAZER_MOUSE_FREQ_125HZ; break; case 2: priv->cur_freq[i] = RAZER_MOUSE_FREQ_500HZ; break; case 1: priv->cur_freq[i] = RAZER_MOUSE_FREQ_1000HZ; break; default: razer_error("hw_copperhead: Got invalid frequency selection\n"); break; } err = razer_parse_buttonmap(profcfg.buttonmap, sizeof(profcfg.buttonmap), priv->buttons[i].mapping, ARRAY_SIZE(priv->buttons[i].mapping), 46); if (err) razer_error("hw_copperhead: Failed to parse button map\n"); } return 0; } static int copperhead_get_fw_version(struct razer_mouse *m) { struct copperhead_private *priv = m->drv_data; return priv->fw_version; } static int copperhead_commit(struct razer_mouse *m, int force) { struct copperhead_private *priv = m->drv_data; int err = 0; if (!m->claim_count) return -EBUSY; if (priv->commit_pending || force) { err = copperhead_do_commit(priv); if (!err) priv->commit_pending = 0; } return err; } static struct razer_mouse_profile * copperhead_get_profiles(struct razer_mouse *m) { struct copperhead_private *priv = m->drv_data; return &priv->profiles[0]; } static struct razer_mouse_profile * copperhead_get_active_profile(struct razer_mouse *m) { struct copperhead_private *priv = m->drv_data; return priv->cur_profile; } static int copperhead_set_active_profile(struct razer_mouse *m, struct razer_mouse_profile *p) { struct copperhead_private *priv = m->drv_data; if (!priv->m->claim_count) return -EBUSY; priv->cur_profile = p; priv->commit_pending = 1; return 0; } static int copperhead_supported_resolutions(struct razer_mouse *m, enum razer_mouse_res **res_list) { enum razer_mouse_res *list; const int count = 4; list = zalloc(sizeof(*list) * count); if (!list) return -ENOMEM; list[0] = RAZER_MOUSE_RES_400DPI; list[1] = RAZER_MOUSE_RES_800DPI; list[2] = RAZER_MOUSE_RES_1600DPI; list[3] = RAZER_MOUSE_RES_2000DPI; *res_list = list; return count; } static int copperhead_supported_freqs(struct razer_mouse *m, enum razer_mouse_freq **freq_list) { enum razer_mouse_freq *list; const int count = 3; list = zalloc(sizeof(*list) * count); if (!list) return -ENOMEM; list[0] = RAZER_MOUSE_FREQ_125HZ; list[1] = RAZER_MOUSE_FREQ_500HZ; list[2] = RAZER_MOUSE_FREQ_1000HZ; *freq_list = list; return count; } static enum razer_mouse_freq copperhead_get_freq(struct razer_mouse_profile *p) { struct copperhead_private *priv = p->mouse->drv_data; if (p->nr >= ARRAY_SIZE(priv->cur_freq)) return -EINVAL; return priv->cur_freq[p->nr]; } static int copperhead_set_freq(struct razer_mouse_profile *p, enum razer_mouse_freq freq) { struct copperhead_private *priv = p->mouse->drv_data; if (!priv->m->claim_count) return -EBUSY; if (p->nr >= ARRAY_SIZE(priv->cur_freq)) return -EINVAL; priv->cur_freq[p->nr] = freq; priv->commit_pending = 1; return 0; } static int copperhead_supported_dpimappings(struct razer_mouse *m, struct razer_mouse_dpimapping **res_ptr) { struct copperhead_private *priv = m->drv_data; *res_ptr = &priv->dpimappings[0]; return ARRAY_SIZE(priv->dpimappings); } static struct razer_mouse_dpimapping * copperhead_get_dpimapping(struct razer_mouse_profile *p, struct razer_axis *axis) { struct copperhead_private *priv = p->mouse->drv_data; if (p->nr >= ARRAY_SIZE(priv->cur_dpimapping)) return NULL; return priv->cur_dpimapping[p->nr]; } static int copperhead_set_dpimapping(struct razer_mouse_profile *p, struct razer_axis *axis, struct razer_mouse_dpimapping *d) { struct copperhead_private *priv = p->mouse->drv_data; if (!priv->m->claim_count) return -EBUSY; if (p->nr >= ARRAY_SIZE(priv->cur_dpimapping)) return -EINVAL; priv->cur_dpimapping[p->nr] = d; priv->commit_pending = 1; return 0; } static int copperhead_supported_buttons(struct razer_mouse *m, struct razer_button **res_ptr) { *res_ptr = copperhead_physical_buttons; return ARRAY_SIZE(copperhead_physical_buttons); } static int copperhead_supported_button_functions(struct razer_mouse *m, struct razer_button_function **res_ptr) { *res_ptr = copperhead_button_functions; return ARRAY_SIZE(copperhead_button_functions); } static struct razer_button_function * copperhead_get_button_function(struct razer_mouse_profile *p, struct razer_button *b) { struct copperhead_private *priv = p->mouse->drv_data; struct copperhead_buttons *buttons; if (p->nr > ARRAY_SIZE(priv->buttons)) return NULL; buttons = &priv->buttons[p->nr]; return razer_get_buttonfunction_by_button( buttons->mapping, ARRAY_SIZE(buttons->mapping), copperhead_button_functions, ARRAY_SIZE(copperhead_button_functions), b); } static int copperhead_set_button_function(struct razer_mouse_profile *p, struct razer_button *b, struct razer_button_function *f) { struct copperhead_private *priv = p->mouse->drv_data; struct copperhead_buttons *buttons; struct razer_buttonmapping *mapping; if (!priv->m->claim_count) return -EBUSY; if (p->nr > ARRAY_SIZE(priv->buttons)) return -EINVAL; buttons = &priv->buttons[p->nr]; mapping = razer_get_buttonmapping_by_physid( buttons->mapping, ARRAY_SIZE(buttons->mapping), b->id); if (!mapping) return -ENODEV; mapping->logical = f->id; priv->commit_pending = 1; return 0; } int razer_copperhead_init(struct razer_mouse *m, struct libusb_device *usbdev) { struct copperhead_private *priv; unsigned int i; int err; BUILD_BUG_ON(sizeof(struct copperhead_profcfg_cmd) != 0x15C); priv = zalloc(sizeof(struct copperhead_private)); if (!priv) return -ENOMEM; priv->m = m; m->drv_data = priv; /* We need to wait some time between commits */ razer_event_spacing_init(&priv->commit_spacing, 250); err = razer_usb_add_used_interface(m->usb_ctx, 0, 0); err |= razer_usb_add_used_interface(m->usb_ctx, 1, 0); if (err) { err = -EIO; goto err_free; } priv->dpimappings[0].nr = 0; priv->dpimappings[0].res[RAZER_DIM_0] = RAZER_MOUSE_RES_400DPI; priv->dpimappings[0].dimension_mask = (1 << RAZER_DIM_0); priv->dpimappings[0].mouse = m; priv->dpimappings[1].nr = 1; priv->dpimappings[1].res[RAZER_DIM_0] = RAZER_MOUSE_RES_800DPI; priv->dpimappings[1].dimension_mask = (1 << RAZER_DIM_0); priv->dpimappings[1].mouse = m; priv->dpimappings[2].nr = 2; priv->dpimappings[2].res[RAZER_DIM_0] = RAZER_MOUSE_RES_1600DPI; priv->dpimappings[2].dimension_mask = (1 << RAZER_DIM_0); priv->dpimappings[2].mouse = m; priv->dpimappings[3].nr = 3; priv->dpimappings[3].res[RAZER_DIM_0] = RAZER_MOUSE_RES_2000DPI; priv->dpimappings[3].dimension_mask = (1 << RAZER_DIM_0); priv->dpimappings[3].mouse = m; for (i = 0; i < COPPERHEAD_NR_PROFILES; i++) { priv->profiles[i].nr = i; priv->profiles[i].get_freq = copperhead_get_freq; priv->profiles[i].set_freq = copperhead_set_freq; priv->profiles[i].get_dpimapping = copperhead_get_dpimapping; priv->profiles[i].set_dpimapping = copperhead_set_dpimapping; priv->profiles[i].get_button_function = copperhead_get_button_function; priv->profiles[i].set_button_function = copperhead_set_button_function; priv->profiles[i].mouse = m; priv->cur_dpimapping[i] = razer_mouse_get_dpimapping_by_res( priv->dpimappings, ARRAY_SIZE(priv->dpimappings), RAZER_DIM_0, RAZER_MOUSE_RES_400DPI); priv->cur_freq[i] = RAZER_MOUSE_FREQ_125HZ; } err = m->claim(m); if (err) { razer_error("hw_copperhead: " "Failed to initially claim the device\n"); goto err_free; } err = copperhead_read_fw_ver(priv); if (err) { razer_error("hw_copperhead: Failed to fetch firmware version number\n"); goto err_release; } err = copperhead_read_config_from_hw(priv); if (err) { razer_error("hw_copperhead: Failed to read config from hardware\n"); goto err_release; } m->type = RAZER_MOUSETYPE_COPPERHEAD; razer_generic_usb_gen_idstr(usbdev, NULL, "Copperhead", 1, NULL, m->idstr); m->get_fw_version = copperhead_get_fw_version; m->commit = copperhead_commit; m->nr_profiles = COPPERHEAD_NR_PROFILES; m->get_profiles = copperhead_get_profiles; m->get_active_profile = copperhead_get_active_profile; m->set_active_profile = copperhead_set_active_profile; m->supported_resolutions = copperhead_supported_resolutions; m->supported_freqs = copperhead_supported_freqs; m->supported_dpimappings = copperhead_supported_dpimappings; m->supported_buttons = copperhead_supported_buttons; m->supported_button_functions = copperhead_supported_button_functions; err = copperhead_do_commit(priv); if (err) { razer_error("hw_copperhead: Failed to commit initial config\n"); goto err_release; } m->release(m); return 0; err_release: m->release(m); err_free: free(priv); return err; } void razer_copperhead_release(struct razer_mouse *m) { struct copperhead_private *priv = m->drv_data; free(priv); }