Setup

Flash Raspberry Pi OS Lite (Bullseye!) to the SD card and create/edit the following files. To flash the SD card use balenaEtcher or Raspberry Imager.

comment out otg_mode=1 and add dtoverlay=dwc2 at the end of the file

  [...]
# Uncomment this to enable infrared communication.
#dtoverlay=gpio-ir,gpio_pin=17
#dtoverlay=gpio-ir-tx,gpio_pin=18

# Additional overlays and parameters are documented /boot/overlays/README

# Enable audio (loads snd_bcm2835)
dtparam=audio=on

# Automatically load overlays for detected cameras
camera_auto_detect=1

# Automatically load overlays for detected DSI displays
display_auto_detect=1

# Enable DRM VC4 V3D driver
dtoverlay=vc4-kms-v3d
max_framebuffers=2

# Disable compensation for displays with overscan
disable_overscan=1

[cm4]
# Enable host mode on the 2711 built-in XHCI USB controller.
# This line should be removed if the legacy DWC2 controller is required
# (e.g. for USB device mode) or if USB support is not required.
#otg_mode=1

[all]

[pi4]
# Run as fast as firmware / board allows
arm_boost=1

[all]
dtoverlay=dwc2

add modules-load=dwc2,g_ether after rootwait

  console=serial0,115200 console=tty1 root=PARTUUID=4c4e106f-02 rootfstype=ext4 fsck.repair=yes rootwait modules-load=dwc2,g_ether quiet init=/usr/lib/raspberrypi-sys-mods/firstboot

generate password with openssl passwd -6 and add it to the file behind the username separated by a colon.

  jlehmann:$6$TvvJlvF5wGledImu$dPn2LwqjG0wxkk3KddbkUajof67yAlSqzhf9TstpUmSyXp5eb3iWdGyJ0B4MPTwiB4UHP3KsWxWk0nTtcmKfz1

wifi configuration for headless setup

  country=UK
ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
update_config=1

network={
    scan_ssid=1
    ssid="your_wifi_ssid"
    psk="your_wifi_password"
}

Connect to the Raspberry Pi via SSH ssh [email protected].

Install dependencies

Update the libraries and install Nodejs.

  sudo apt-get update
sudo apt-get upgrade -y
sudo apt-get install bluetooth bluez libbluetooth-dev libudev-dev

wget https://unofficial-builds.nodejs.org/download/release/v14.18.1/node-v14.18.1-linux-armv6l.tar.gz
tar -xzf node-v14.18.1-linux-armv6l.tar.gz
cd node-v14.18.1-linux-armv6l
sudo cp -R * /usr/local
node -v

Setup project directory

Create project folders and install node dependencies (for BLE).

  mkdir ~/projects && cd ~/projects
mkdir ble && cd ble
npm install @abandonware/noble # required for BLE