invalid-bitting-generator

Overview

The Invalid Bitting Generator is a specialized tool designed for creating terminally invalid key bittings that cannot be further etched into valid keys. This project focuses on thorough research and analysis of key manufacturing constraints, enabling users to understand and generate invalid configurations effectively.

Latest Enhancements

• Modeling for Manufacturer Constraints: Enhanced modeling takes into account additional factors, including forbidden stations, station-specific depth ceilings, and variations in stop types (e.g., shoulder vs. tip).
• Preset Configurations: Introduced presets for various key systems including:
  • U.S. Standard
  • Euro
  • Kwikset SmartKey 6-key (5-pin plug)
  • Schlage Everest (full-size and SL tip-read)
  • BEST A2 tip and Yale KeyMark conventions.

Research Findings and Citations

The project details key findings from various lock manufacturer manuals and guides:

• Kwikset SmartKey: Specific constraints for 5-pin plugs when gauging 6-pin keys.
• Schlage Everest: Detailed OEM data regarding manufacturing tolerances and cutting guidance.
• Yale KeyMark: Specifications for A2 pinning, including critical depth and spacing tolerances.
• ASSA ABLOY: Guidelines indicating that keys are cut from tip to bow, along with conventional standards.

Examples of Usage: To check for terminal invalid configurations, commands can be executed as follows:

python3 tool.py check --preset kwikset_6in5 --seq 2,1,1,1,1,1

Further Functionality

• Repair and Validation: The tool provides functionality to validate and repair key sequences by adhering to manufacturer specifications, ensuring no cutting errors occur based on various constraints.
• CLI Features: Various command line interface commands for showing presets, checking configurations, and generating terminal examples are available to aid in usage.
  • Show presets: python3 tool.py presets
  • Enumerate configurations: python3 tool.py enumerate --preset euro --pins 4 --max-repeat 4

Key Model Fields

The model includes essential fields to support validation and generation of terminally invalid key bittings:

• stop_type: Identifies the nature of the stop (shoulder or tip).
• min_first_station_index: Indicates the earliest permissible station for cuts.
• no_cut_mask: Boolean values indicating disallowed cutting stations.
• station_max_ceiling: Defines maximum depths per station.

Conclusion

The Invalid Bitting Generator serves as a vital resource for locksmiths and security professionals, providing insights into terminal invalidity within key manufacturing constraints. Users are encouraged to explore its diverse functionality to enhance their understanding and application in practical scenarios.