diff --git a/Readme.md b/Readme.md index b602b03..d2cad11 100644 --- a/Readme.md +++ b/Readme.md @@ -1,22 +1,30 @@ # Raspberry Pi Initial Setup -This repository is about the latest procedure for configuring Raspberry Pi boards in 2026. The reported procedure can be used on any Raspberry Pi board. +This repository is about the latest procedure for configuring Raspberry Pi boards in 2026. The reported procedure can be used with any Raspberry Pi board. -The procedure is about flashing the OS image, make ssh connection, both Wi-Fi and USB (Gadget-Mode), and finally upgrading the OS packages. +The procedure covers flashing the OS image, establishing an SSH connection via Wi-Fi or USB (Gadget Mode), and finally upgrading the OS packages. + +# Requirements + +- A comfortable shell | bash (cmd or PS) terminal emulator +- Python 3 +- Micro SD card and its adapter # Flashing the OS image **Note: This guide is recommended only for the latest OS image or newer; the Trixi image is used in this guide.** -First you need to download the file `create_local_json.py`; it is recommended to download the file as a repository to organize your data. Then, open a terminal and change the path to the repository or file location: +First, you need to download the file `create_local_json.py`. It is recommended to download it to a local repository or an empty folder to organize your data. + +Then, open a terminal and change the path to the repository or file location: ```sh cd /path/to/the/file ``` -now, the file should be visible using listing commands -like `ls` command-. +Now, the file should be visible when listing with commands like `ls`. -The file must be have executable permission, therefore run: +The file must have executable permission; therefore, run: ```sh chmod +x ./create_local_json.py @@ -36,33 +44,23 @@ Wrote 184 images to os_list_local.rpi-imager-manifest Now, you have a new RPi-imager file that will allow us to set up the gadget mode. -**Note: you must double-click to open `Raspberry Pi Imager` App or right-click open with `Raspberry Pi Imager`; the recommended version is `v2.0.7` or newer.** +**Note: you must double-click the `os_list_local.rpi-imager-manifest` file to open the `Raspberry Pi Imager` app, or right-click and open it with `Raspberry Pi Imager`; the recommended version is `v2.0.7` or newer.** ![Open the file with the Raspberry Pi Imager](imager.jpg) -Now, you can select your device, the OS type -desktop or lite-, and make the image customization —user, Wi-Fi, remote access (ssh), Pi Connect, and gadget mode—; **particularly, if you want to use Gadget mode, you must turn on remote access and gadget mode.** +Now, you can select your board, the OS type -desktop or lite-, and customize the image —user, Wi-Fi, remote access (SSH), Pi Connect, and gadget mode—; **particularly, if you want to use Gadget mode, you must turn on remote access and gadget mode.** ![Select your device](device.jpg) -![Select your device](gadget.jpg) +![During customisation enabel the USB Gadget Mode](gadget.jpg) -Finally, you must write the image on the micro-SD and get a customization like this: +Finally, you must write the image to the microSD card and get an image customazed like this: ![Image customization](custom.jpg) -After RPi-Imager has finished, insert the micro-SD card into your device and connect it with a USB to micro-USB cable using the USB port; the other port must be used for only supply mode: +After RPi-Imager has finished, insert the microSD card into your device and connect it with a USB-to-micro-USB cable using the port labeled as USB; the other port must be used for supply mode only; see the picture. ![USB port for gadget mode](usb.jpg) - - - - - - - - - -