CHULTRABOOK CONFIGURATION PACKAGE
=================================

DESCRIPTION
-----------
This package provides essential configuration and utilities for running Linux on the HP G6 EE Chromebook (Braswell/snappy)  hardware, including:
- Audio hardware drivers
- Keyboard mapping for fn row
- MMC/SD card management for flaky mmc
- System synchronization services
- Kernel optimization settings (preventing oom)

QUICK START
-----------
1. Clone repository:
   git clone [url]/name.git
   cd [name]

2. Build and install:
   # Build DEB package
   sudo ./install.sh --install
   
   # Alternative TAR installation:
   sudo ./install.sh --package-type tar
   sudo tar -xvf chultrabook-config_1.2.tar -C /

OPERATIONS & OPTIONS
--------------------
Installation script options:
--package-type [deb|tar]  Build package format (default: deb)
--install                 Install generated DEB package
--pretend                 Simulation mode (no changes made)
--debug                   Enable verbose output
--help                    Show help message

FILE DESCRIPTIONS
-----------------
[Configuration Files]
etc/fstab.kubi                   - Custom filesystem mounts
etc/sysctl.d/70-kubuntu-snappy.conf - Kernel optimization settings

[Systemd Services]
mnt-mmc.*          - MMC/SD card mounting automation
mmc-reset.service  - MMC controller management

[Key Scripts]
usr/local/bin/mmc-reset.sh          - MMC hardware reset
usr/local/bin/mrchromebox-firmware-util.sh - Firmware management

DEPENDENCIES
------------
* REQUIRED *
- Linux Kernel 6.14+ (Chromebook audio ardware support)
- AVS Audio Module (Sound functionality)

* WHY THESE DEPENDENCIES? *
- WeirdTreeThings audio drivers require a new kernel
- Systemd (v249+) for service management

LICENSE
-------
BSD-3-Clause License

Contains components from:
- cros-keyboard-map-git (BSD-3)
- chromebook-linux-audio-git (BSD-3)

TROUBLESHOOTING
---------------
Common Issues:
* MMC Not Detected: Run 'sudo mmc-reset.sh'
* Audio Problems: Verify with 'lsmod | grep avs' or 
* Kernel Version: Check with 'uname -r'

SUPPORT
-------
For assistance, visit:
Chrultrabook Forum: https://forum.chrultrabook.com/
WeirdTreeThings Repos: https://github.com/WeirdTreeThing/ (Chromebook-audio and cros-keyboard both used)