#+TITLE: BootSpkr
#+AUTHOR: Harish
#+OPTIONS: toc:nil

A Linux kernel module that plays a melody through the PC speaker during boot.

Uses the legacy x86 PIT (8253/8254) and PC speaker interface to generate tones directly from kernel space.

This project exists mostly for fun and as a learning exercise covering:

- Kernel Workqueues
- Hardware I/O ports
- PIT programming
- PC speaker control

* Features

- Plays a hardcoded melody on module load
- Asynchronous playback
- Uses the classic PC speaker interface
- No userspace daemon required

** Building

#+begin_src sh
make
#+end_src

** Installation

#+begin_src sh
sudo make install
#+end_src

The install target:

- Installs the module
- Updates module dependencies
- Configures automatic loading at boot

** Usage

Load immediately:

#+begin_src sh
sudo modprobe bootspkr
#+end_src

Unload:

#+begin_src sh
sudo rmmod bootspkr
#+end_src