Improve repository structure and update documentation.
README.md: Update high-level overview, add clear instructions on setup, run, and contribution, include references to new directory structure, and add sections for hardware requirements, library status, HAL interface, running tests, contributing, and license.
docs/README.md: Update high-level overview, add clear instructions on setup, run, and contribution, include references to new directory structure, and add sections for hardware requirements, library status, HAL interface, running tests, contributing, and license.
Related to #63
Improve repository structure and update documentation.
For more details, open the Copilot Workspace session.