═══════════════════════════════════════════════════════════════════════════════
QUICK START GUIDE
═══════════════════════════════════════════════════════════════════════════════

STEP 1: BUILD THE PACKAGE
--------------------------
Run the build script:
  ./build-debian-package.sh

This will:
  ✓ Check for required dependencies
  ✓ Compile all source code
  ✓ Create a debian package (.deb file)
  ✓ Generate checksums for verification

Expected output:
  linuxcnc-db-tool_1.0.0_amd64.deb (approx 60KB)

STEP 2: INSTALL THE PACKAGE
----------------------------
Install with dpkg:
  sudo dpkg -i linuxcnc-db-tool_1.0.0_amd64.deb

This installs:
  /usr/local/bin/db_tool           - Main daemon
  /usr/local/bin/db_tool_manager   - GUI manager
  /usr/local/bin/db_tool_monitor   - GUI viewer
  /usr/local/share/linuxcnc-db-tool/ - Documentation & examples

STEP 3: CONFIGURE LINUXCNC
---------------------------
Edit your LinuxCNC INI file and add:

  [EMCIO]
  DB_PROGRAM = db_tool /path/to/your/tool_table.tbl

Example:
  [EMCIO]
  DB_PROGRAM = db_tool /home/cnc/linuxcnc/configs/my_mill/tool.tbl

STEP 4: START LINUXCNC
-----------------------
Start LinuxCNC as normal. The tool database daemon will:
  ✓ Start automatically
  ✓ Launch the GUI manager (if enabled)
  ✓ Begin tracking tool usage

TROUBLESHOOTING:
----------------
GUI doesn't launch?
  • Check: pidof db_tool_manager
  • Check: /usr/local/bin/db_tool_manager exists
  • Check permissions: ls -l /usr/local/bin/db_tool_manager

Database not updating?
  • Check LinuxCNclog: ~/.linuxcnc_print.txt
  • Check db_tool is running: pidof db_tool
  • Verify DB_PROGRAM path in INI file

For detailed instructions, see:
  linuxcnc-db-tool-build/INSTALLATION_GUIDE.txt

═══════════════════════════════════════════════════════════════════════════════
