musikcube Documentation

To build PDCurses for the Win32 graphics mode (WinGUI), select the appropriate makefile for your compiler and run the build command.

Available Makefiles

• Makefile.bcc: Borland C++ 4.0.2+
• Makefile.dmc: Digital Mars
• Makefile.lcc: LCC-Win32
• Makefile.mng: MinGW, Cygnus GNU Compiler
• Makefile.vc: Microsoft Visual C++ 2.0+ or later & Intel(R) compiler
• Makefile.wcc: Watcom 10.6+ or OpenWATCOM

Build Commands

Use make -f <makefile> to build. Note that Watcom users should use wmake and MSVC users should use nmake.

Build Options

• Wide-character (Unicode) support: Add WIDE=Y.
• UTF-8 support: Add UTF8=Y (requires WIDE=Y to be set).
• Build as DLL: Add DLL=Y (supported with Visual C++, MinGW, or Cygwin).
• 32-bit code (MSVC/Intel): Add IX86=Y (defaults to 64-bit for Makefile.vc).
• Intel(R) compiler: Use Makefile.vc and add ICC=Y.
• 64-bit code (Linux cross-compiling): Add _w64=1 (defaults to 32-bit).

This guide outlines how to create an architectural chroot environment for faster compilation and deployment on a Raspberry Pi using a Debian Buster ARMHF image. This involves downloading a disk image, expanding its partitions, mounting it via loopback, and using qemu-arm-static to allow execution of ARM binaries on an x86 host.

1. Install Dependencies

Install the necessary tools for image manipulation and QEMU emulation:

sudo apt install qemu-kvm qemu-user-static binfmt-support qemu-utils kpartx e2fsprogs

2. Prepare the Disk Image

1. Create a working directory:

   mkdir rpi-buster-chroot

2. **Download and extract the image:**
   ```bash
# Download (example URL)
wget https://downloads.raspberrypi.org/raspios_oldstable_lite_armhf/images/raspios_oldstable_lite_armhf-2023-05-03/2023-05-03-raspios-buster-armhf-lite.img.xz

# Extract
xz -d -v 2023-05-03-raspios-buster-armhf-lite.img.xz

3. Expand the image file size:

   qemu-img resize -f raw 2023-05-03-raspios-buster-armhf-lite.img 16G

4. **Expand the partition within the image:**
   Use `fdisk` to recreate the Linux partition with the new space:
   - `fdisk 2023-05-03-raspios-buster-armhf-lite.img`
   - `p` (Print table; note the 'Start' value of partition #2)
   - `d` (Delete)
   - `2` (Select partition #2)
   - `n` (New)
   - `p` (Primary)
   - `2` (Partition number)
   - `<START_VALUE>` (Enter the start value noted earlier)
   - `<ENTER>` (Accept default end value)
   - `N` (Do **NOT** remove the ext4 signature)
   - `w` (Write changes)

### 3. Mount and Configure the Chroot
1. **Mount the partitions:**
   ```bash
mkdir os-mount
sudo kpartx -a -v 2023-05-03-raspios-buster-armhf-lite.img

# Identify the mapper device (e.g., /dev/mapper/loop4p2) from kpartx output
sudo mount /dev/mapper/loop4p2 ./os-mount

# Resize the filesystem to fill the new partition size
sudo /sbin/resize2fs /dev/mapper/loop4p2

2. Inject QEMU and bind system directories:

   sudo cp /usr/bin/qemu-arm-static ./os-mount/usr/bin
   sudo mount -o bind /dev ./os-mount/dev
   sudo mount -o bind /proc ./os-mount/proc
   sudo mount -o bind /sys ./os-mount/sys

3. **Register the ARM interpreter:**
   You must run this as root (not via `sudo` for the echo command to work correctly on the proc filesystem):
   ```bash
su
echo ':arm:M::\x7fELF\x01\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x28\x00:\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff:/usr/bin/qemu-arm-static:' > /proc/sys/fs/binfmt_misc/register
exit

4. Usage and Cleanup

Enter the chroot:

sudo chroot ./os-mount /usr/bin/qemu-arm-static /usr/bin/bash
# If /usr/bin/bash is not found, try:
# sudo chroot ./os-mount /usr/bin/qemu-arm-static /bin/bash

Shutdown and Unmount:

sudo umount ./os-mount/dev
sudo umount ./os-mount/proc
sudo umount ./os-mount/sys
sudo umount ./os-mount
sudo kpartx -d -v 2023-05-03-raspios-buster-armhf-lite.img