Difference between revisions of "Programming Tool"

From LORIX One - Wiki

Jump to: navigation, search
(Connect your device)
(Entering programming mode)
Line 77: Line 77:
 
When powered, the device will start the LORos system. Once started, you will be able to access it through SSH. At this time, the device "Status" LED will be blinking shortly two or three times every 2 seconds. Your device is typically represented in the Windows "Device Manager" under a serial port called "ELMO GMAS" (this name may vary depending the drivers installed on your computer):
 
When powered, the device will start the LORos system. Once started, you will be able to access it through SSH. At this time, the device "Status" LED will be blinking shortly two or three times every 2 seconds. Your device is typically represented in the Windows "Device Manager" under a serial port called "ELMO GMAS" (this name may vary depending the drivers installed on your computer):
  
 +
[[File:Programming-Tool_DeviceManager-NormalMode.png|none]]
  
 
This normal operating mode '''is not''' what we want for device programming.
 
This normal operating mode '''is not''' what we want for device programming.
Line 82: Line 83:
 
Instead, you have to enter "Programming Mode". To do so, as explained in the user manual (§5.1), you have to press shortly 3 times on the reset button and keep pressed the third time for at least 3 seconds (until the LED status flashes):
 
Instead, you have to enter "Programming Mode". To do so, as explained in the user manual (§5.1), you have to press shortly 3 times on the reset button and keep pressed the third time for at least 3 seconds (until the LED status flashes):
  
[[File:programmation_mode_image.png|none]]
 
  
If you successfully entered programming mode, the "Status" LED will not blink anymore at all. Your device is typically represented in the Windows "Device Manager" under a serial port called "Bossa Program Port" (this name may vary depending the drivers installed on your computer):
+
<div style='text-align: center;'>[[File:programmation_mode_image.png|none]]</div>
 +
If you successfully entered programming mode, the "Status" LED '''will not blink anymore''' at all. Your device is typically represented in the Windows "Device Manager" under a serial port called "Bossa Program Port" (this name may vary depending the drivers installed on your computer):
 +
 
 +
[[File:Programming-Tool_DeviceManager-ProgramingMode.png|none]]
 +
 
 +
 
  
 
===Program the device===
 
===Program the device===

Revision as of 10:12, 23 April 2019

Minimal configuration

Operation System

  • Windows 7 and later (32 or 64 bits)
  • Linux (64 bits)
    • Ubuntu 12.04 and later
    • Fedora 21 and later
    • Debian 8 and later

The programming tool is not available on mac OS.

Hardware

  • Intel Pentium 4 processor
  • 512 MB of RAM

Setup

Download

You can find the latest versions of the programming tool here : https://www.lorixone.io/devel/tools/programming-tool/.

Install

Windows

You have the choice of either the Setup version who will install the application or the Portable version.

During the setup, you can either install the application for all user or for yourself only. If installing for all users, you need administrative privileges.

Linux

The downloaded .AppImage file is an executable application. You may be asked to install the software automatically on some systems.

You may need to set the application as executable before you can start it.

TBD


The application must be run with elevated privileges to access the USB peripherals. If not, you will get a permanent warning at the top of the application.

Update

The program will automatically check for newer versions at start. You can manually check for updates in the 'about' menu.

Device programming

Overview

The programming tool has two main sections:

  • The first, called "Archive" allows you to load the archive of the image you want to program on the device and check the content of this archive.
  • The second, called "Devices programming" allows you to see devices available for programming and program them with the loaded archive.


Programming-Tool Overview.png

Load an archive

To load an archive, you can either drop the image into the dotted blue zone or chose on with the "Choose archive" button.


Programming-Tool Load-archive.png

The Programming Tool will then extract the images from the archive, read the included metadata and validate that the images are valid regarding the metadata description.

The archive will be extracted in the operating system temp folders. In Windows, the path is : %TMP%\wifx\lorix\programming-tool\archives.

Once loaded, you can check the archive content with the "Check" step. It will show you three section :

  • Archive information
  • List of supported products of this archive
  • Partitions details


Programming-Tool Archive-Check.png
If the archive has anything wrong, you will get informed with a warning message.

You may check that the loaded image supported the product you want to program by expanding the "Supported products" section:


Programming-Tool Archive-Check-Products.png

If everything is fine, you can go on with connecting your device.

The Programming Tool will not check that the image supports the product you try to program. Please be sure you use a correct archive otherwise the device will not be functioning.

Connect your device

To program the device, you need to connect it to your computer with the USB cable and power the device with the PoE (Ethernet) cable.

Entering programming mode

When powered, the device will start the LORos system. Once started, you will be able to access it through SSH. At this time, the device "Status" LED will be blinking shortly two or three times every 2 seconds. Your device is typically represented in the Windows "Device Manager" under a serial port called "ELMO GMAS" (this name may vary depending the drivers installed on your computer):

Programming-Tool DeviceManager-NormalMode.png

This normal operating mode is not what we want for device programming.

Instead, you have to enter "Programming Mode". To do so, as explained in the user manual (§5.1), you have to press shortly 3 times on the reset button and keep pressed the third time for at least 3 seconds (until the LED status flashes):


programmation mode image.png

If you successfully entered programming mode, the "Status" LED will not blink anymore at all. Your device is typically represented in the Windows "Device Manager" under a serial port called "Bossa Program Port" (this name may vary depending the drivers installed on your computer):

Programming-Tool DeviceManager-ProgramingMode.png


Program the device

Settings

About