//----------------------------------------------------------------------------- // Copyright (C) 2010 iZsh // // This code is licensed to you under the terms of the GNU GPL, version 2 or, // at your option, any later version. See the LICENSE.txt file for the text of // the license. //----------------------------------------------------------------------------- // Low frequency HID commands (known) // // Useful resources: // RF interface, programming a T55x7 clone, 26-bit HID H10301 encoding: // http://www.proxmark.org/files/Documents/125%20kHz%20-%20HID/HID_format_example.pdf // // "Understanding Card Data Formats" // https://www.hidglobal.com/sites/default/files/hid-understanding_card_data_formats-wp-en.pdf // // "What Format Do You Need?" // https://www.hidglobal.com/sites/default/files/resource_files/hid-prox-br-en.pdf //----------------------------------------------------------------------------- #include "cmdlfhid.h" #include #include #include "comms.h" #include "ui.h" #include "graph.h" #include "cmdparser.h" #include "cmddata.h" //for g_debugMode, demodbuff cmds #include "lfdemod.h" // for HIDdemodFSK #include "parity.h" // for parity #include "util.h" // for param_get8,32,64 static int CmdHelp(const char *Cmd); /** * Packs an HID ID from component parts. * * This only works with 26, 34, 35, 37, and 48 bit card IDs. * * Returns false on invalid inputs. */ bool pack_hid(/* out */ uint32_t *hi2, /* out */ uint32_t *hi, /* out */ uint32_t *lo, /* in */ const hid_info *info) { uint32_t higher = 0, high = 0, low = 0; switch (info->fmtLen) { case 26: // HID H10301 low |= (info->cardnum & 0xffff) << 1; low |= (info->fc & 0xff) << 17; if (info->parityValid) { // Calculate parity low |= oddparity32((low >> 1) & 0xfff) & 1; low |= (evenparity32((low >> 13) & 0xfff) & 1) << 25; } break; case 34: // H10306 low |= (info->cardnum & 0xffff) << 1; low |= (info->fc & 0x7fff) << 17; high |= (info->fc & 0x8000) >> 15; if (info->parityValid) { // Calculate parity high |= (evenparity32((high & 0x00000001) ^ (low & 0xFFFE0000)) & 1) << 1; low |= (oddparity32(low & 0x0001FFFE) & 1); } break; case 35: // (Corporate 1000 35-bit) low |= (info->cardnum & 0xfffff) << 1; low |= (info->fc & 0x7ff) << 21; high |= (info->fc & 0x800) >> 11; if (info->parityValid) { // Calculate parity high |= (evenparity32((high & 0x00000001) ^ (low & 0xB6DB6DB6)) & 1) << 1; low |= (oddparity32( (high & 0x00000003) ^ (low & 0x6DB6DB6C)) & 1); high |= (oddparity32( (high & 0x00000003) ^ (low & 0xFFFFFFFF)) & 1) << 2; } break; case 37: //H10304 low |= (info->cardnum & 0x7ffff) << 1; low |= (info->fc & 0xfff) << 20; high |= (info->fc & 0xf000) >> 12; if (info->parityValid) { // Calculate parity high |= (evenparity32((high & 0x0000000F) ^ (low & 0xFFFC0000)) & 1) << 4; low |= (oddparity32(low & 0x0007FFFE) & 1); } break; case 48: // Corporate 1000 48-bit low |= (info->cardnum & 0x7FFFFF) << 1; low |= (info->fc & 0xff) << 24; high |= (info->fc & 0x3FFF00) >> 8; if (info->parityValid) { // Calculate parity high |= (evenparity32((high & 0x00001B6D) ^ (low & 0xB6DB6DB6)) & 1) << 14; low |= (oddparity32( (high & 0x000036DB) ^ (low & 0x6DB6DB6C)) & 1); high |= (oddparity32( (high & 0x00007FFF) ^ (low & 0xFFFFFFFF)) & 1) << 15; } break; default: // Invalid / unsupported length return false; } // Set the format length bits if (info->fmtLen < 37) { // Bit 37 is always set high |= 0x20; // Set the bit corresponding to the length. if (info->fmtLen < 32) low |= 1 << info->fmtLen; else high |= 1 << (info->fmtLen - 32); } else if (info->fmtLen > 37){ if (info->fmtLen < 64) high |= 1 << (info->fmtLen - 32); else higher |= 1 << (info->fmtLen - 64); } // Return result only if successful. *hi2 = higher; *hi = high; *lo = low; return true; } /** * Unpacks an HID ID into its component parts. * * This only works with 26, 34, 35, 37, and 48 bit card IDs. * * Returns false on invalid inputs. */ bool unpack_hid(hid_info *out, uint32_t hi2, uint32_t hi, uint32_t lo) { memset(out, 0, sizeof(hid_info)); uint8_t fmtLen = 0; uint32_t hFmt; // for calculating card length if ((hi2 & 0x000FFFFF) > 0) { // > 64 bits hFmt = hi2 & 0x000FFFFF; fmtLen = 64; } else if ((hi & 0xFFFFFFC0) > 0) { // < 63-38 bits hFmt = hi & 0xFFFFFFC0; fmtLen = 32; } else if ((hi & 0x00000020) == 0) { // 37 bits hFmt = 0; fmtLen = 37; } else if ((hi & 0x0000001F) > 0){ // 36-32 bits hFmt = hi & 0x0000001F; fmtLen = 32; } else { // <32 bits hFmt = lo; fmtLen = 0; } while (hFmt > 1) { hFmt >>= 1; fmtLen++; } out->fmtLen = fmtLen; switch (out->fmtLen) { case 26: // HID H10301 out->cardnum = (lo >> 1) & 0xFFFF; out->fc = (lo >> 17) & 0xFF; if (g_debugMode) { PrintAndLog("oddparity : input=%x, calculated=%d, provided=%d", (lo >> 1) & 0xFFF, oddparity32((lo >> 1) & 0xFFF), lo & 1); PrintAndLog("evenparity: input=%x, calculated=%d, provided=%d", (lo >> 13) & 0xFFF, evenparity32((lo >> 13) & 0xFFF) & 1, (lo >> 25) & 1); } out->parityValid = (oddparity32((lo >> 1) & 0xFFF) == (lo & 1)) && ((evenparity32((lo >> 13) & 0xFFF) & 1) == ((lo >> 25) & 1)); break; case 34: // HID H10306 out->cardnum = (lo >> 1) & 0xFFFF; out->fc = ((hi & 1) << 15) | (lo >> 17); out->parityValid = ((evenparity32((hi & 0x00000001) ^ (lo & 0xFFFE0000)) & 1) == ((hi >> 1) & 1)) && ((oddparity32(lo & 0x0001FFFE) & 1) == ((lo & 1))); break; case 35: // HID Corporate 1000-35 out->cardnum = (lo >> 1) & 0xFFFFF; out->fc = ((hi & 1) << 11) | (lo >> 21); out->parityValid = (evenparity32((hi & 0x00000001) ^ (lo & 0xB6DB6DB6)) == ((hi >> 1) & 1)) && (oddparity32( (hi & 0x00000003) ^ (lo & 0x6DB6DB6C)) == ((lo >> 0) & 1)) && (oddparity32( (hi & 0x00000003) ^ (lo & 0xFFFFFFFF)) == ((hi >> 2) & 1)); if (g_debugMode) { PrintAndLog("Parity check: calculated {%d, %d, %d}, provided {%d, %d, %d}", evenparity32((hi & 0x00000001) ^ (lo & 0xB6DB6DB6)), oddparity32( (hi & 0x00000003) ^ (lo & 0x6DB6DB6C)), oddparity32( (hi & 0x00000003) ^ (lo & 0xFFFFFFFF)), ((hi >> 1) & 1), ((lo >> 0) & 1), ((hi >> 2) & 1) ); } break; case 37: // HID H10304 out->fmtLen = 37; out->cardnum = (lo >> 1) & 0x7FFFF; out->fc = ((hi & 0xF) << 12) | (lo >> 20); out->parityValid = (evenparity32((hi & 0x0000000F) ^ (lo & 0xFFFC0000)) == ((hi >> 4) & 1)) && (oddparity32( lo & 0x0007FFFE) == (lo & 1)); break; case 48: // HID Corporate 1000-48 out->cardnum = (lo >> 1) & 0x7FFFFF; //Start 24, 23 length out->fc = ((hi & 0x3FFF) << 8 ) | (lo >> 24); //Start 2, 22 length out->parityValid = (evenparity32((hi & 0x00001B6D) ^ (lo & 0xB6DB6DB6)) == ((hi >> 14) & 1)) && (oddparity32( (hi & 0x000036DB) ^ (lo & 0x6DB6DB6C)) == ((lo >> 0) & 1)) && (oddparity32( (hi & 0x00007FFF) ^ (lo & 0xFFFFFFFF)) == ((hi >> 15) & 1)); if (g_debugMode) { PrintAndLog("Parity check: calculated {%d, %d, %d}, provided {%d, %d, %d}", evenparity32((hi & 0x00001B6D) ^ (lo & 0xB6DB6DB6)), oddparity32( (hi & 0x000036DB) ^ (lo & 0x6DB6DB6C)), oddparity32( (hi & 0x00007FFF) ^ (lo & 0xFFFFFFFF)), ((hi >> 14) & 1), ((lo >> 0) & 1), ((hi >> 15) & 1) ); } break; default: return false; } return true; } /** * Converts a hex string to component "hi2", "hi" and "lo" 32-bit integers, one nibble * at a time. * * Returns the number of nibbles (4 bits) entered. */ int hexstring_to_int96(/* out */ uint32_t* hi2,/* out */ uint32_t* hi, /* out */ uint32_t* lo, const char* str) { // TODO: Replace this with param_gethex when it supports arbitrary length // inputs. int n = 0, i = 0; while (sscanf(&str[i++], "%1x", &n ) == 1) { *hi2 = (*hi2 << 4) | (*hi >> 28); *hi = (*hi << 4) | (*lo >> 28); *lo = (*lo << 4) | (n & 0xf); } return i - 1; } //by marshmellow (based on existing demod + holiman's refactor) //HID Prox demod - FSK RF/50 with preamble of 00011101 (then manchester encoded) //print full HID Prox ID and some bit format details if found int CmdFSKdemodHID(const char *Cmd) { //raw fsk demod no manchester decoding no start bit finding just get binary from wave uint32_t hi2=0, hi=0, lo=0; uint8_t BitStream[MAX_GRAPH_TRACE_LEN]={0}; size_t BitLen = getFromGraphBuf(BitStream); if (BitLen==0) return 0; //get binary from fsk wave int waveIdx = 0; int idx = HIDdemodFSK(BitStream,&BitLen,&hi2,&hi,&lo, &waveIdx); if (idx<0){ if (g_debugMode){ if (idx==-1){ PrintAndLog("DEBUG: Just Noise Detected"); } else if (idx == -2) { PrintAndLog("DEBUG: Error demoding fsk"); } else if (idx == -3) { PrintAndLog("DEBUG: Preamble not found"); } else if (idx == -4) { PrintAndLog("DEBUG: Error in Manchester data, SIZE: %d", BitLen); } else { PrintAndLog("DEBUG: Error demoding fsk %d", idx); } } return 0; } if (hi2==0 && hi==0 && lo==0) { if (g_debugMode) PrintAndLog("DEBUG: Error - no values found"); return 0; } hid_info card_info; bool ret = unpack_hid(&card_info, (uint32_t)hi2, (uint32_t)hi, (uint32_t)lo); if (hi2 != 0) PrintAndLog("HID Prox TAG ID: %x%08x%08x (%d) - Format Len: %u bits - FC: %u - Card: %u", (unsigned int) hi2, (unsigned int) hi, (unsigned int) lo, (unsigned int) (lo>>1) & 0xFFFF, card_info.fmtLen, card_info.fc, card_info.cardnum); else PrintAndLog("HID Prox TAG ID: %x%08x (%d) - Format Len: %u bits - FC: %u - Card: %u", (unsigned int) hi, (unsigned int) lo, (unsigned int) (lo>>1) & 0xFFFF, card_info.fmtLen, card_info.fc, card_info.cardnum); if (card_info.fmtLen == 26 || card_info.fmtLen == 35 || card_info.fmtLen == 48) { PrintAndLog("Parity: %s", card_info.parityValid ? "valid" : "invalid"); } if (!ret) { PrintAndLog("Invalid or unsupported tag length."); } setDemodBuf(BitStream,BitLen,idx); setClockGrid(50, waveIdx + (idx*50)); if (g_debugMode){ PrintAndLog("DEBUG: idx: %d, Len: %d, Printing Demod Buffer:", idx, BitLen); printDemodBuff(); } return 1; } int CmdHIDReadFSK(const char *Cmd) { int findone=0; if(Cmd[0]=='1') findone=1; UsbCommand c={CMD_HID_DEMOD_FSK}; c.arg[0]=findone; SendCommand(&c); return 0; } int CmdHIDSim(const char *Cmd) { uint32_t hi2 = 0, hi = 0, lo = 0; hexstring_to_int96(&hi2, &hi, &lo, Cmd); if (hi >= 0x40 || hi2 != 0) { PrintAndLog("This looks like a long tag ID. Use 'lf simfsk' for long tags. Aborting!"); return 0; } PrintAndLog("Emulating tag with ID %x%08x", hi, lo); PrintAndLog("Press pm3-button to abort simulation"); UsbCommand c = {CMD_HID_SIM_TAG, {hi, lo, 0}}; SendCommand(&c); return 0; } int CmdHIDClone(const char *Cmd) { unsigned int hi2 = 0, hi = 0, lo = 0; UsbCommand c; hexstring_to_int96(&hi2, &hi, &lo, Cmd); if (hi >= 0x40 || hi2 != 0) { PrintAndLog("Cloning tag with long ID %x%08x%08x", hi2, hi, lo); c.d.asBytes[0] = 1; } else { PrintAndLog("Cloning tag with ID %x%08x", hi, lo); c.d.asBytes[0] = 0; } c.cmd = CMD_HID_CLONE_TAG; c.arg[0] = hi2; c.arg[1] = hi; c.arg[2] = lo; SendCommand(&c); return 0; } int CmdHIDPack(const char *Cmd) { uint32_t hi2 = 0, hi = 0, lo = 0; if (strlen(Cmd)<3) { PrintAndLog("Usage: lf hid pack "); PrintAndLog(" sample: lf hid pack 26 123 4567"); return 0; } uint8_t fmtLen = param_get8(Cmd, 0); hid_info card_info; card_info.fmtLen = fmtLen; card_info.fc = param_get32ex(Cmd, 1, 0, 10); card_info.cardnum = param_get64ex(Cmd, 2, 0, 10); card_info.parityValid = true; bool ret = pack_hid(&hi2, &hi, &lo, &card_info); if (ret) { if (hi2 != 0) { PrintAndLog("HID Prox TAG ID: %x%08x%08x (%d) - Format Len: %u bits - FC: %u - Card: %u", (unsigned int) hi2, (unsigned int) hi, (unsigned int) lo, (unsigned int) (lo>>1) & 0xFFFF, card_info.fmtLen, card_info.fc, card_info.cardnum); } else { PrintAndLog("HID Prox TAG ID: %x%08x (%d) - Format Len: %u bits - FC: %u - Card: %u", (unsigned int) hi, (unsigned int) lo, (unsigned int) (lo>>1) & 0xFFFF, card_info.fmtLen, card_info.fc, card_info.cardnum); } } else { PrintAndLog("Invalid or unsupported tag length."); } return 0; } int CmdHIDUnpack(const char *Cmd) { uint32_t hi2 = 0, hi = 0, lo = 0; if (strlen(Cmd)<1) { PrintAndLog("Usage: lf hid unpack "); PrintAndLog(" sample: lf hid unpack 2006f623ae"); return 0; } hexstring_to_int96(&hi2, &hi, &lo, Cmd); hid_info card_info; bool ret = unpack_hid(&card_info, hi2, hi, lo); if (hi2 != 0) { PrintAndLog("HID Prox TAG ID: %x%08x%08x (%d) - Format Len: %u bits - FC: %u - Card: %u", (unsigned int) hi2, (unsigned int) hi, (unsigned int) lo, (unsigned int) (lo>>1) & 0xFFFF, card_info.fmtLen, card_info.fc, card_info.cardnum); } else { PrintAndLog("HID Prox TAG ID: %x%08x (%d) - Format Len: %u bits - FC: %u - Card: %u", (unsigned int) hi, (unsigned int) lo, (unsigned int) (lo>>1) & 0xFFFF, card_info.fmtLen, card_info.fc, card_info.cardnum); } PrintAndLog("Parity: %s", card_info.parityValid ? "valid" : "invalid"); if (!ret) { PrintAndLog("Invalid or unsupported tag length."); } return 0; } static command_t CommandTable[] = { {"help", CmdHelp, 1, "This help"}, {"demod", CmdFSKdemodHID, 1, "Demodulate HID Prox from GraphBuffer"}, {"read", CmdHIDReadFSK, 0, "['1'] Realtime HID FSK Read from antenna (option '1' for one tag only)"}, {"sim", CmdHIDSim, 0, " -- HID tag simulator"}, {"clone", CmdHIDClone, 0, " -- Clone HID to T55x7 (tag must be in antenna)"}, {"pack", CmdHIDPack, 1, " -- packs an HID ID from its length, facility code and card number"}, {"unpack", CmdHIDUnpack, 1, " -- unpacks an HID ID to its length, facility code and card number"}, {NULL, NULL, 0, NULL} }; int CmdLFHID(const char *Cmd) { CmdsParse(CommandTable, Cmd); return 0; } int CmdHelp(const char *Cmd) { CmdsHelp(CommandTable); return 0; }