TS-4900 Bookworm Getting Started

From embeddedTS Manuals

This Debian release is available in 3 flavors with various packages. See our Debian releases in the Software Images section for links to the latest images available.

Image Description
X11
  • Linux kernel built with more featured defconfig
  • Base Debian with common utilities
  • Common embedded tools (i2c-tools, can-utils, gpiod, libiio-utils, setserial, picocom, etc.)
  • Includes full hardware support
  • Networking tools (nftables, wireless-tools, wpasupplicant, bridge-utils, bluetoothctl, etc.)
  • Includes Development tools (build-essential, make, cmake, python, libraries, etc.)
  • Includes X11 that launches matchbox and xterm on startup
  • Includes touchscreen support
Headless
  • Linux kernel built with more featured defconfig
  • Base Debian with common utilities
  • Common embedded tools (i2c-tools, can-utils, gpiod, libiio-utils, setserial, picocom, etc.)
  • Includes full hardware support
  • Networking tools (nftables, wireless-tools, wpasupplicant, bridge-utils, bluetoothctl, etc.)
  • Includes Development tools (build-essential, make, cmake, python, libraries, etc.)
Minimal
  • Linux kernel built with the minimal defconfig variation
  • Includes base Debian root filesystem with basic wired networking, minimal hardware support, no development tools, etc.

The default login for all images is root with no password.


We recommend using the Image Replicator tool for writing images to bootable median on the platform itself. However, a bootable microSD card can also easily be prepared from a Linux workstation. To write any of the compatible images to a microSD card, first partition the microSD card to have one large ext3, or ext4 partition. See the guide here for more information. Once, formatted, extract the desired tarball to the microSD card.

The following example assumes a microSD card connected to a workstation as /dev/sdc and already has an MBR partition table set up with a single partition: 

mkfs.ext3 /dev/sdc1
mkdir /mnt/sd/
sudo mount /dev/sdc1 /mnt/sd/
sudo tar --numeric-owner -xjf <image file>.tar.bz2 -C /mnt/sd
sudo umount /mnt/sd
sync


The onboard eMMC can also be written via the Image Replicator tool. It is also possible to write the eMMC when booted from microSD by repeating the instructions above to format and extract a tarball to the eMMC. Note that the eMMC cannot be rewritten if the system is currently booted to it or if it is actively mounted and used elsewhere. When booted from microSD, the eMMC can be formatted with the following: 

mkfs.ext3 /dev/mmcblk2p1
mkdir /mnt/emmc
mount /dev/mmcblk2p1 /mnt/emmc
wget -qO- <image URL from Software Images> | tar --numeric-owner -xj -C /mnt/emmc/
umount /mnt/emmc
sync


Note: The ext4 filesystem can be used instead of ext3, but it may require additional options. U-Boot does not support the 64-bit addressing added as the default behavior in recent revisions of mkfs.ext4. If using e2fsprogs 1.43 or newer, the options -O ^64bit,^metadata_csum must be used with ext4 for proper compatibility. Older versions of e2fsprogs do not need these options passed for ext4 support nor are they needed for ext3.
Retrieved from "http://docs.embeddedts.com/index.php?title=TS-4900_Bookworm_Getting_Started&oldid=18734"