Skip to content

TDM Edge Gateway Installation with Etcher

Jump to bottom
Luca Pireddu edited this page Feb 8, 2020 · 6 revisions

TDM Edge Gateway Installation with Etcher

REQUIREMENTS

The installation requirements are:

  • A PC with any of a Linux distribution, Microsoft Windows or Mac OS X and a SD/microSD card reader;
  • 'administrator' or ‘root’ privileges;
  • SD/microSD adapter;
  • Internet connection.

The current Edge Gateway version is composed by:

  • A Raspberry Pi 3;
  • power supply 220V/5V able to deliver at least 2.5A;
  • class 10 microSD (min 8GB, suggested 16GB);

The described installation procedure allow to:

  • Install the customized operating system on the Edge Gateway;

INSTALLATION OF THE OPERATING SYSTEM

Note: The power supply of the Raspberry Pi 3 must be able to deliver al least 2.5A to avoid malfunctioning and filesystem corruption.

WARNING: the following instructions will erase all filesystems on microSD. Every file will be deleted. Pay close attention to the names of the devices to which the commands are directed.

  1. Download the latest image for the TDM Edge Gateway from the Official Repository ;

  2. Download and install Balena Etcher . Follow the instructions on the home page;

  3. Insert the microSD to the SD card reader (use the adapter if needed);

  4. Launch Etcher and follow the steps:

    • Click on 'Select image' and select the file tdmimage-latest.img.xz previously downloaded (uncompress the xz file is not necessary);

    • Click on 'Select Drive' and select the SD Card Reader drive (be careful to choose the correct drive);

    • Click on 'Flash' and wait until it finishes.

  5. Remove the microSD form the adapter and insert it into the Edge Gateway microSD drive.

  6. Switch on the Edge Gateway and follow the steps from the TDM Edge Gateway first access and system configuration page.

ADVANCED USERS ON LINUX: Writing the image with dd

If you're already familiar with the Linux command line, you can skip installing Balena Etcher and user the standard Linux dd utility.

Warning: risk of losing all data on your computer!!

All the warnings from the previous section apply. In addition, Balena Etcher protects you from some destructive mistakes: with dd you don't have any protection. Make sure and double check your commands and the device to which you're writing.

  1. Download the latest image for the TDM Edge Gateway from the Official Repository.

  2. Insert the microSD to the SD card reader (use the adapter if needed); figure out the device corresponding to your SD card reader.

  3. Write the image. Make sure you have the write device for the SD card reader. Execute the following command:

    xzcat tdmimage-latest.img.xz | dd of=/dev/your_sd_card_reader bs=4M status=progress

You may need to run it as root to have appropriate privileges to write to the device.

  1. Continue from step 5 in the regular procedure above.

Tips

To find the device associated to your sd card reader, it may be of help to follow the messages the kernel prints as you plug in the card. Run dmesg --follow on the console and monitor its output as you plug in the SD card.

Clone this wiki locally