EBF Setup and Admin Guide

Table of Contents

Supported Operating Systems:

  • Debian 10/11
  • Ubuntu 16.04.6/18.04.5/20.04.2/22.04

Hardware Requirements

Desktop/Server machine with matching OR better(preferable) than below configuration

  1. CPU - 64-bit Machine with minimum 1.8 GHZ CPU frequency
  2. RAM - 8GB
  3. Storge - 100 GB

Ethernet cables:-

  1. EBF
  2. Three (3) per Zombie
  3. Two (2) per DUT/Board/Device

USB to Serial Cable:-

  1. One (1) per DUT/Board/Device

**Zombie connects DUT serial console using USB port only.

IT Requirements

  1. Three(3) reserved IP addresses not in use by any other machine in the Corporate/Lab Network.
  2. Internet connectivity for EBF Desktop/Server Machine ( for installation / upgrade only )

Installation Procedure for Debian 10

Debian download link: Then follow the steps below to install Debian on the target machine.
  1. Allocate at least 100GB of hard disk space.
  2. Choose Language,Location and Keyboard.
  3. Give the hostname for your Debian OS
  4. Leave blank for the domain name.
  5. Setup users and passwords.
  6. For partitioning options, we have taken all in a single partition.
  7. Select the disk you want to partition and click 'continue'.
  8. All files are in single partition and click 'continue'.
  9. Finish partitioning and write changes to disk
  10. Select 'Yes' and continue.
  11. Installation will start
  12. Select the debian archive mirror and configure the package manager. After that click 'continue'.

    Note: Make sure your machine has a working internet connection.
  13. Select following Software Packages and click 'continue'.
    1. Debian desktop Environment
    2. GNOME
    3. Print server
    4. SSH server
    5. Standard system utilities
  14. Install Grub bootloader to hard disk. This will completes Debian installation.

Installation Procedure for Debian 11

Debian download link: Then follow the steps below to install Debian on the target machine.
  1. Allocate at least 100GB of hard disk space.
  2. Leave blank for the domain name.
  3. For partitioning options, we have taken all in a single partition.
  4. Finish partitioning and write changes to disk
  5. Select the debian archive mirror and configure the package manager

    Note: Make sure your machine has a working internet connection.
  6. Select following Software Packages
    1. Debian desktop Environment
    2. GNOME
    3. SSH server
    4. Standard system utilities
  7. Install Grub bootloader to hard disk. This will completes Debian installation.

Installation Procedure for Ubuntu 16.04.6

Ubuntu download link:
  1. Allocate at least 100GB space of hard disk.
  2. Select the “Download updates while installing Ubuntu” option to start the installation of Ubuntu and click on the Continue button.
  3. On the next page, select the “Erase disk and install ubuntu” option as Installation type and click on Install Now button.
  4. A dialog box will appear on the screen asking for writing changes to disk, select Continue button.
  5. On the next page, the user will be asked for providing a username and password. Fill in all the required fields and click on the Continue button.

This completes Ubuntu 16.04.6 OS installation. After installation, the user will be asked to Restart the computer as per instructions.

Installation Procedure for Ubuntu 18.04.5

Ubuntu download link:
  1. Allocate at least 100GB space of hard disk.
  2. Select the "Install Ubuntu" option from the page.
  3. Select Keyboard Layout as per your preference and click on the continue button.
  4. Select the "Minimal Installation" & “Download updates while installing Ubuntu” option to start the installation of Ubuntu and click on the Continue button.
  5. On the next page, select the “Erase disk and install ubuntu” option as Installation type and click on Install Now button.
  6. A dialog box will appear on the screen asking for writing changes to disk, select Continue button.
  7. On the next page, the user will be asked for providing a username and password. Fill in all the required fields and click on the Continue button.

This completes Ubuntu 18.04 OS installation. After installation, the user will be asked to Restart the computer as per instructions.

Installation Procedure for Ubuntu 20.04.2

Ubuntu download link:
  1. Allocate at least 100GB of space of hard disk.
  2. Select the "Install Ubuntu" option from the page.
  3. Select Keyboard Layout as per your preference and click on the continue button.
  4. Select the "Minimal Installation" & “Download updates while installing Ubuntu” options to start the installation of Ubuntu and click on the Continue button.
  5. On the next page, select the “Erase disk and install ubuntu” option as Installation type and click on Install Now button.
  6. A dialog box will appear on the screen asking for writing changes to disk, select Continue button.
  7. On the next page, the user will be asked for providing a username and password. Fill in all the required fields and click on the Continue button.

This completes Ubuntu 20.04 OS installation. After installation, the user will be asked to Restart the computer as per instructions.

Installation Procedure for Ubuntu 22.04.2

Ubuntu download link:
  1. Allocate at least 100GB of space of hard disk.
  2. Select the "Install Ubuntu" option from the page.
  3. Select Keyboard Layout as per your preference and click on the continue button.
  4. Select "Minimal Installation" & “Download updates while installing Ubuntu” options to start the installation of Ubuntu and click on the Continue button.
  5. On the next page, select the “Erase disk and install ubuntu” option as Installation type and click on Install Now button.
  6. A dialog box will appear on the screen asking for writing changes to disk, select Continue button.
  7. On the next page, the user will be asked for providing a username and password. Fill in all the required fields and click on the Continue button.

This completes Ubuntu 22.04 OS installation. After installation, the user will be asked to Restart the computer as per instructions.

EBF Installation Steps

  1. Installer is compressed with 7z compression tool. Follow the below steps to install the 7z tool used to extract the installer files on a Linux machine.
    • sudo apt-get install p7zip-full
  2. Download the latest EBF installer from the download link mentioned below and extract it to the target machine(ubuntu/Debian). You must be login into LinuxLink
    https://linuxlink.timesys.com/ebf/download/ebf/EBF-Installer-V2.3.2.7z
    • 7z x EBF-Installer-<Version>.7z
  3. After extracting the downloaded folder, run the below command:
    • cd EBF-Installer-<Version>
    • sudo ./EBF-Installer.sh
      It will ask the user for New Installation or an Upgrade. Choose the New Installation option.
  4. Press ENTER to read the EULA.
  5. To accept the EULA terms, type yes or hit ENTER.
    • Do you accept the EULA terms [yes/no] ? [yes] >>>
  6. Hit Enter to disable the LAVA option on EBF.

    OR
    If you want to enable the LAVA option on EBF, enter 'Y'.
  7. Hit Enter to disable the HTTPS support.

    OR
    If you want to enable the HTTPS support, enter 'Y'.
  8. Would you like to specify the local private docker network [Y/N] ? [N] >>>
    if you choose yes then you need to set up the network range in the form of 172.16.0.0/16 and it will update the docker network range successfully. Or if you choose nothing to do in or 'N'. Then it will set the default network range or the last updated network range.
  9. Hit 'Enter' to generate the default certificate for 'HTTPS' support.

    OR
    • Open a new terminal window and run the following commands to generate the certificate:
      • $ cd /home/
      • $ openssl req -newkey rsa:2048 -nodes -keyout key.pem -x509 -days 365 -out certificate.pem
        Input all the details as asked.
      • When asked for input: 'Common Name (e.g. server FQDN or YOUR name) []:', enter the IP Address of the current machine (on which EBF is being installed).
      • $ cat certificate.pem key.pem > combined.pem
      • Copy the path of this 'combined.pem' file (/home/combined.pem) and paste it into the ongoing installation terminal window.
  10. Once the above steps get setup Installation will start.

EBF installation without HTTPS support.

EBF installation with HTTPS support.

EBF Upgrade Steps

  • Steps for Upgrade to the latest build
  1. Installer is compressed with 7z compression tool. Follow the below steps to install the 7z tool used to extract the installer files on a Linux machine.
    • sudo apt-get install p7zip-full
  2. Download the latest EBF installer folder from the download link mentioned below and extract it to the target machine(Ubuntu/Debian). You must be login into LinuxLink
    https://linuxlink.timesys.com/ebf/download/ebf/EBF-Installer-V2.3.2.7z
    • 7z x EBF-Installer-<Version>.7z (for EBF)
  3. After extracting the downloaded folder, run the below command.
    • cd EBF-Installer-<Version>
    • sudo ./EBF-Installer.sh
      It will ask the user for New Installation or an Upgrade. Choose the upgrade option.
  4. Press ENTER to read the EULA.
  5. To accept the EULA terms, type yes or hit ENTER.
    • Do you accept the EULA terms [yes/no] ? [yes] >>>
  6. Hit Enter to disable the LAVA option on EBF.

    OR
    If you want to enable the LAVA option on EBF, enter 'Y'.
  7. Hit Enter to disable the HTTPS support.

    OR
    If you want to enable the HTTPS support, enter 'Y'.
  8. Would you like to specify the local private docker network [Y/N] ? [N] >>>
    if you choose yes then you need to set up the network range in the form of 172.16.0.0/16 and it will update the docker network range successfully. Or if you choose nothing to do in or 'N'. Then it will set the default network range or the last updated network range.
  9. Hit 'Enter' to generate the default certificate for 'HTTPS' support.

    OR
    • Open a new terminal window and run the following commands to generate the certificate:
      • $ cd /home/
      • $ openssl req -newkey rsa:2048 -nodes -keyout key.pem -x509 -days 365 -out certificate.pem
        Input all the details as asked.
      • When asked for input: 'Common Name (e.g. server FQDN or YOUR name) []:', enter the IP Address of the current machine (on which EBF is being installed).
      • $ cat certificate.pem key.pem > combined.pem
      • Copy the path of this 'combined.pem' file (/home/combined.pem) and paste it into the ongoing installation terminal window.
  10. Once the above steps get setup Installation will start.

EBF Upgrade

EBF Backup Steps

Backup of current EBF Server data.
  1. Installer is compressed with 7z compression tool. Follow the below steps to install the 7z tool used to extract the installer files on a Linux machine.
    • sudo apt-get install p7zip-full
  2. Download the latest EBF installer folder from the download link mentioned below and extract it to the target machine(Ubuntu/Debian). You must be login into LinuxLink
    https://linuxlink.timesys.com/ebf/download/ebf/EBF-Installer-V2.3.2.7z
    • 7z x EBF-Installer-<Version>.7z
  3. After extracting the downloaded folder, run the below command
    • cd EBF-Installer-<Version>
    • sudo ./EBF-Installer.sh
  4. Select option 3 from the recommended option in order to back up the current EBF server.
  5. If you do not want to backup rootfs/kernel images, uploaded during image flashing then type [no] otherwise hit 'ENTER'.
  6. After successful backup the user will be able to see the confirmation message on the screen with the backup name.

Note: The user can restore these backups using restore functionality

EBF Restore Backup Steps

Restore the Backup of EBF Server
  1. Installer is compressed with 7z compression tool. Follow the below steps to install the 7z tool used to extract the installer files on a Linux machine.
    • sudo apt-get install p7zip-full
  2. Download the latest EBF installer folder from the download link mentioned below and extract it to the target machine(Ubuntu/Debian). You must be login into LinuxLink
    https://linuxlink.timesys.com/ebf/download/ebf/EBF-Installer-V2.3.2.7z
    • 7z x EBF-Installer-<Version>.7z
  3. After extracting the downloaded folder, run the below command.
    • cd EBF-Installer-<Version>
    • sudo ./EBF-Installer.sh
  4. Select option 4 from the recommended option in order to restore the backup.
  5. Select the backup from the backup list in order to restore the backup.
  6. if you want to backup the current ebf server then hit "Enter" otherwise type no and hit 'Enter'.
    • If you do not want to backup rootfs/kernel images, uploaded during image flashing then type [no] otherwise hit 'ENTER'.
  7. After successful restore the user will able to see the confirmation message on the screen with the backup name.

Change EBF IP address

  1. Installer is compressed with 7z compression tool. Follow the below steps to install the 7z tool used to extract the installer files on a Linux machine.
    • sudo apt-get install p7zip-full
  2. Download the latest EBF installer folder from the download link mentioned below and extract it to the target machine(Ubuntu/Debian). You must be login into LinuxLink
    https://linuxlink.timesys.com/ebf/download/ebf/EBF-Installer-V2.3.2.7z
    • 7z x EBF-Installer<Version>.7z
  3. After extracting the downloaded folder, run the below command.
    • cd EBF-Installer-<Version>
    • sudo ./EBF-Installer.sh
  4. Select option 5 from the recommended option to change EBF IP.
  5. After Selection of option no. 5 it will show you EBF current running IP/Domain name on the screen and asks for the new IP/Domain Name.
  6. Provide a New IP/Domain name and wait for confirmation.
  7. After a successful IP change a confirmation message will appear on the screen with a new IP address.

How to Login EBF with SSO

Refer Link

How to Set configurable EBF timeouts

Make changes in the settings.conf file:

  1. Go to the directory /data/timesys/ebf/setup. Edit settings.conf and set the below new config variables

    1. "CONSOLE_ACCESS_TIMEOUT": "" (By Default it is 5 Sec)
    2. "REQ_TIMEOUT": "" (for Zombie workers page - checking zombies are reachable or not)(By Default it is 15 Sec)

  2. You can change the timeouts as per your requirement.

Glossary

Embedded Board Farm (EBF): EBF is a tool for Embedded Hardware and/or Software Engineering teams for sharing hardware devices during a product development, maintenance or support cycle.

Basic Architecture

The main components of Timesys EBF are a centrally located Master with the necessary software that forms the core of EBF connected to various Zombies that are placed at various locations around the corporation, as long as the Zombie has network connectivity to the Master.

A Master supports multiple Zombies and each Zombie can support upto four independent Devices (under development/test).

Master: Master presents a web interface to corporate users for connecting to the remote device of their choice, presenting a device console locally on the users machine giving them full access and an experience as if the device is right next to them.

Zombie: This is a timesys supplied hardware. It is placed in remote locations, and comes to life when addressed by the Master. Zombie, normally will execute commands from the Master.

-Each Zombie can support four devices(DUT) that can be allocated to users for a particular duration of use.

IOCX - IO Controller and Expander is a hardware supplied by Timesys. It connects DUT to Zombie for providing SDMUX, Hotplug Ethernet and USB, user controlled GPIO pins and I2C bus.

Device (DUT): It is any physical hardware board, a device or system that a user needs to work on or test.

Device Boot:
The following boot methods are supported:
  • Netboot: This feature, when enabled, allows a device to boot itself from an image stored at a network location. The kernel,rfs and dtb files are files are downloaded to Zombie’s DUT folder by the user and DUT will boot using NFS mount. The kernel and DTB files are loaded using tftp and rfs is loaded using NFS mount.
    Please Note: For network boot, the root file system(rfs) must be on the network which is accessible from the device.
  • SD Card: To boot a board remotely thru SD Card to test new images without human intervention, Timesys has developed an IO Controller and Expander (IOCX) with SDMUX capability.It allows the user to switch the SD Card between Zombie and device through a toggle button available for SDMux. This allows the operation of uploading the images from the user to Zombie when sd card is connected to Zombie side through SDMux.
  • eMMC boot: Many devices support on board NAND and MMC interface.Either interface can be used for booting a system. NAND boot is raw boot, as it reads raw data and manipulate it. MMC boot is FAT boot, as it reads file from mmc sector and manipulated it. eMMC boot can be FAT boot or raw boot.

How to setup EBF

Hardware Connections

  1. Connect device with zombie.
    1. The 2 yellow dots are at ground in Timesys Zombie.
    2. The connections shown in upper image are for 1st DUT. Similar will be the connections for rest of the DUTs and IOCXs.

How to add new device type

Refer Link

How to add a new device

Refer Link

How to delete an available device

Refer Link

How to edit details of an available device

Refer Link

How to set device-dictionary fields

  1. How to Edit device dictionary
    Refer Link
  2. How to view device-dictionary field
    Refer Link

Manage Power Switch

Refer Link

How to add a Pseudo(Docker) Device

Follow this link to add a Pseudo(Docker) Device using Zombie
Follow this link add a Pseudo(Docker) Device using New Device

Add a Pseudo(Docker) Device using New Zombie

Whenever you add a new zombie on EBF server a pseudo device will automatically be added to the EBF.
  1. How to Add New Zombie on EBF Server.follow this section
  2. Select ‘All Device’ option from ‘Devices’ drop down list to view Automatically added Pseudo Device on EBF server.

Add a Pseudo(Docker) Device using New Device

Following are the steps to add more pseudo-device to the EBF-TAS server:
  1. Login to EBF home page/dashboard (find your URL from the administrator) through a web browser with your credentials
    Username : <username>
    Password : <password>
  2. This would open up EBF Dashboard.
  3. Select the ‘New Device’ option from the ‘Devices’ drop-down list.
  4. ‘Add New Device’ page will appear on the screen.

    Fill in the necessary fields available on the screen:

    A Newly added Pseudo/Docker Device will appear after submitting the data.

How to Configure E-mail for Test Job

  1. Login to EBF home page/dashboard (find your URL from the administrator) through the web browser with your credentials
    Username : <username>
    Password : <password>
  2. This would open up EBF Dashboard.
  3. Click on username ("admin") from the page.
  4. A Drop-down menu will be appear on the screen click on "Email (SMTP) Settings"
  5. Fill the required field to setup email settings and then click on submit button.
  6. After providing the above details reboot the machine

How to Update IOCX Hotplug Names

Following are the steps to Update the IOCX Hotplug Names:
  1. Login to EBF home page/dashboard (find your URL from the administrator) through the web browser with your credentials
    Username : <username>
    Password : <password>
  2. This would open up EBF Dashboard.
  3. Select 'Edit Device' option from the Devices Drop down.
  4. Select the device of which you want to update the IOCX hotplug names.
  5. Manage Device Dashboard would openup.
  6. Under Show Advanced Options: Fill the name of the hotplug you want to give. You can give all the 4 hotplug names or you can left as blank.

    For e.g.In this case I filled only 2 hotplugs Label: Hotplug Label 1(USB-HOTPLUG) and Hotplug Label 2(ETHERNET-hotplug)and keep the other two hotplug(Hotplug Label 3 and Hotplug Label 4)blank.
  7. After that, Click on the submit button.
  8. Following message will appear on the screen, on successful updation.
  9. You can check on the console screen to see the Updated hotplug names. Click on 'my devices' from the Devices drop down option.
  10. Click on the device console option to launch the console.
  11. Hotplug names are visible on the console screen.

    OR:
  12. Click on the device name on My Devices page.
  13. Click on the Launch Console button to launch the console.
  14. Hotplug names are visible on the console screen.

How to ADD a IOCX Power switch

Following are the steps for adding a IOCX Power Switch on EBF:

First, Add the Power Switch on the EBF Server.

To see, How to Add Power Switch, Please Refer Link

  1. After adding the power switch on the EBF-Server, Connect the IOCX main power to the Power switch configured.
  2. Go to ->Devices->Edit Devices
  3. Select Device
  4. On Manage Device Page->Show Advanced Options
  5. Checked the checkbox, (IOCX Power Switch Connected)
  6. Select the IOCX Power Switch
  7. Enter the IOCX power port no
  8. After that, Click on the Submit button.
  9. A confirmation message will appear on the screen, indicating that the device has been edited successfully.
  10. Go to ->Devices->My Devices
  11. Click on the 'Launch Console' from My Devices page.
  12. IOCX Power Switch is visible on the console page.

How to Add Users


Following are the steps to add users:
  1. Sign in to EBF homepage/dashboard using your credentials.
  2. Select the ‘Administration’ option from the ‘admin’ drop-down list.
  3. ‘Users‘ option is available under the Authentication and Authorization section on the Administration page.
  4. Select the ‘+Add’ option for adding a new user.
  5. Add user page will appear on the screen.
  6. Enter the username and password details of a new user.
    Username:<Username Required>
    Password:<password for new user>
  7. After filling in all the details, click on the 'Save and continue editing' button.
  8. Assign a group to the user from the list of the groups
  9. After entering all the details, click on the 'Save' button.
  10. The newly added user will be shown on the screen.

User Permissions

The following are the permissions w.r.t different user types:

Permissions Anonymous(Non-logged users) Developer Admin
View Home screen ✓ ✓ ✓
View Zombies ✓ ✓
View DUTs ✓ ✓
View Test Jobs (TAS only) ✓ ✓
View Test Job Results & Job definition YAML (TAS only) ✓ ✓
View Test Job execution Logs (TAS only) ✓ ✓
View Charts & Graphical Reports (TAS only) ✓ ✓
Launch DUT Console of allocated DUT ✓ ✓
Power control (On/Off/Reboot) of allocated DUT ✓ ✓
Upload SD card image on allocated DUT ✓ ✓
Allocate free DUT ✓ ✓
Release allocated DUT ✓ ✓
View all own allocated DUTs ✓ ✓
View all DUTs and current allocations ✓ ✓
Submit & Re-submit Test Job (TAS only) ✓ ✓
Download Test Results (TAS only) ✓ ✓
Add/Edit/Delete Charts (TAS only) ✓ ✓
Forced Release of allocated DUTs ✓ ✓
Add DUT ✓ ✓
View/Add/Edit/Delete Authorization tokens* ✓ ✓
Add Zombie ✓
Add Users ✓
Access to Admin interface ✓
Edit Zombie Description on Home screen ✓
Edit/Delete chart(s) created by any user ✓

There are three types of users with respect to their roles and permission. The admin has the access to add all types of users according to their respective permissions.

  1. Anonymous user is a non-logged user.
  2. Admin User
    For admin user, select the following options:
  3. Developer
    For selecting a user as a Developer, go to the Group section and select the ‘Developer’ option from the available user and move to chosen groups.

After selecting the user as per the permission, select the Save button available at the bottom of the page.

The new user is added and the new user can sign in to the EBF server with their respective credentials

Change user's permissions

Following are the steps to change user privileges assigned to any user:
  1. Sign in to EBF homepage/dashboard using admin credentials.
  2. Select the ‘Administration’ option from the ‘admin’ drop-down list.
  3. ‘Users‘ option is available under the Authentication and Authorization section on the Administration page.
  4. Select the ‘Change’ option for editing details of an available user.
  5. List of available users will be shown on the screen. Click on the name of the user whose details are to be edited.
  6. Change privileges of the user from the given Permissions section.
  7. Then click on the 'Save' button to save the changes.

How to Delete a user

Following are the steps to delete an available user:
  1. Sign in to EBF homepage/dashboard using admin credentials.
  2. Select the ‘Administration’ option from the ‘admin’ drop-down list.
  3. ‘Users‘ option is available under the Authentication and Authorization section on the Administration page.
  4. Select the ‘Change’ option for editing details of an available user.
  5. List of available users will be shown on the screen. Select the user whom you want to delete.
  6. Select 'Delete selected Users' option from the 'Actions' options.
  7. Confirm the delete.
  8. Selected users will be deleted.

How to Add Groups

Following are the steps to add groups:
  1. Sign in to EBF homepage/dashboard using your credentials.
  2. Select the ‘Administration’ option from the ‘admin’ drop-down list.
  3. ‘Groups‘ option is available under the Authentication and Authorization section on the Administration page.
  4. Select the ‘+Add’ option for adding a new group.
  5. Add group page will appear on the screen.
  6. Provide the name of the group in the name field.
  7. Select a user from the list and assign him/her to the group.
  8. Finally Click on the Save button to create a group.

How to assign/change User Group(s)

  1. Sign in to EBF homepage/dashboard using your credentials.
  2. Select the ‘Administration’ option from the ‘admin’ drop-down list.
  3. Assign group to the user in 2 ways:
    1. Select Option Groups under AUTHENTICATION AND AUTHORIZATION
    2. Select the Group which you want to assign it to the user. In this case, I have selected group as Group1
    3. Select the user to which you want to assign the group.
    4. After selecting the user,click on the Save button.
  1. Select Option Users under AUTHENTICATION AND AUTHORIZATION
    1. Select the User to whom you want to assign the Group. In this case, I have selected User as User1.
    2. Select the group to which you want to assign the user.
    3. After selecting the user,click on the Save button.

How to assign/change Device Group(s)

  1. Sign in to EBF homepage/dashboard using your credentials.
  2. Go to Devices option and select edit Devices option
  3. Select the device of which you want to assign/change the group
  4. Select the Group you want to assign to the device. In this case, I have selected Group as Group1.
  5. After selecting the group, click on the submit button.

How to assign/change Device Group(s) for SSH-Device

  1. Sign in to EBF homepage/dashboard using your credentials.
  2. Select the ‘Administration’ option from the ‘admin’ drop-down list.
    1. Select Option 'Groups' under AUTHENTICATION AND AUTHORIZATION
    2. Select the Group which you want to assign it to the user. In this case, I have selected group as Group1
  3. Select the SSH Device to which you want to assign the Group. In this case, I have selected SSH-DUT-CTL_Linuxbox1
  4. After selecting the device,Click on the Save button

How to add Golden Images(Admin Controlled)

Many a time EBF Users may leave board in a state where it is no longer in usable state for a new user who assigns the board. In order to avoid it, EBF software should bring the board back to a pristine state before a new user can access it.

Following are the steps to add Golden Images on EBF Server:
  1. Login to EBF home page/dashboard (find your URL from the administrator) through the web browser with your credentials
    Username : <username>
    Password : <password>
  2. This would open up EBF Dashboard.
  3. Go to Devices -> Golden Images Select Golden Image option from the menu.
  4. After selecting golden images option, golden image dashboard will appear on the screen. Click on click here option.
  5. Add Device Golden Image pop will appear on the screen.
    1. From Select device drop-down and choose device on which you want to add the golden image.
    2. Select the boot-media, SD-Card/USB Boot or Network Boot.
    3. Add the flash instructions which is optional.
    4. Click on +Add Image files which you want to add for the device.After selecting the image, click on Upload option to upload the file.
  6. After uploading the file,click on save button.
  7. After successfully uploading the golden image, details regarding image will appear under Device Golden Images(admin) Dashboard.
  8. If the golden image is successfully uploaded for the respective device then Yes will be visible under (Admin)Golden Image column on All Devices and MyDevices pages.
    1. Go to Devices -> All Devices
    2. Go to Devices -> My Devices

How to edit Golden Images(Admin Controlled)

Following are the steps to edit Golden Images on EBF Server:

  1. Login to EBF home page/dashboard (find your URL from the administrator) through the web browser with your credentials
    Username : <username>
    Password : <password>
  2. This would open up EBF Dashboard.
  3. Go to Devices-> Golden Images
  4. Golden Image Dashboard would open up.
  5. Click on the edit option, of the respective device of which you have uploaded the golden image.
  6. Enter the details you want to change regarding the golden image.
    1. Select the device if you want to change the device
    2. Select the boot-media, SD-Card/USB Boot or Network Boot.
    3. Add/Edit the flash instructions.
    4. If you want to remove the Previously uploaded files, click on the 'cross sign' and then Click on +Add Image Files to upload the new image.
    5. After selecting the image, click on Upload button to upload the file.
    6. After successfully uploading the file, click on the update option.
    7. Following message will appear on the screen on successful updation of the golden image.

How to Add Camera Device Resource Map and Resource Config

Steps to add Resource MAP:

  1. Sign in to EBF homepage/dashboard using your credentials.
  2. Select the ‘Administration’ option from the ‘admin’ drop-down list.
  3. Now from LAVA_Scheduler_APP click on Add(Button) corresponding to the Device Resource Map.
  4. Now add a device resource map for the camera. Enter the below information
    1. Resource Name: Enter a unique string representing this camera resource, for example, I have given CAM1
    2. Resource Type: The resource type should be “camera” because we are adding a camera resource
    3. Device name: The name of the Device (DUT) where the camera resources are connected. In my case, I have connected on rpi-demo(DUT)

Steps to add resource config for camera

  1. Now click on the +add(button) corresponding to the Resource config from the Lava_scheduler_APP page.
  2. Add the following information for the camera resource config.
    1. Resource name: Resources name should match one of the camera resource names in “Device resource maps”. For example, here I used added CAM1 as a resource name.
    2. Config name: enter text “IP-ADDRESS”.
    3. Config Value: IP address of the APP-Zombie where the camera is connected.
  3. Add the following information for the camera resource config.
  4. After filling all the details, click on the save button.

How to Add Audio Device Resource Map and Resource Config

Steps to add Resource MAP:

  1. Sign in to EBF homepage/dashboard using your credentials.
  2. Select the ‘Administration’ option from the ‘admin’ drop-down list.
  3. Now from LAVA_Scheduler_APP click on Add(Button) corresponding to the Device Resource Map.
  4. Now add a device resource map for the audio. Enter the below information.
    1. Resource Name: Enter a unique string representing this audio resource, for example, I have given AUDIO1.
    2. Resource type: The resource type should be “audio” because we are adding an audio resource.
    3. Device name: The name of the Device (DUT) where the audio resources are connected. In my case, I have connected on rpi-demo(DUT).

Steps to add resource config for audio

  1. Now click on add(button) corresponding to the Resource config from the Lava_scheduler_APP page.
  2. There are 3 audio resource configurations that should be added to the list for the audio. Once you reached the Add resource config page you need to fill in the following pieces of information.
    1. Resource name: Resources name should match one of the audio resource names in “Device resource maps”. For example, here I used added AUDIO1 as a resource name.
    2. Config name: Enter the following text for the config name (AUDIO-DEVICE, SAMPLE-RATE, SAMPLE-FORMAT).
    3. Config Value: Value for config name. find the below list to set up the Config value for each config name.



  3. After filling all the details, click on the Save button.

How to change any user's password in EBF

Following are the steps to change the password of any available user:
  1. Sign in to EBF homepage/dashboard using admin credentials.
  2. Select the ‘Administration’ option from the ‘admin’ drop-down list.
  3. ‘Users‘ option is available under the Authentication and Authorization section on the Administration page.
  4. Select the ‘Change’ option for editing details of an available user.
  5. List of available users will be shown on the screen. Click on the name of the user whose password you want to change.
  6. On this page, click on the 'this form' link in the Password section.
  7. Input the new password details and click on the 'Change Password' button.
  8. A 'Password changed successfully' notification message will be shown on the screen.

How to Retire and Activate Device

To Retire a device
  1. In order to retire an active device, the target device must not be allocated to anyone.
  2. Click on the 'Retire' icon present in the 'Actions' column adjacent to the target device that you want to retire.
  3. After the device is retired successfully, the 'Device Status' is changed to 'Retired' as shown in the below image.

    To Activate a retired device
  4. Click on the 'Activate' icon present in the 'Actions' column adjacent to the target device that you want to activate.
  5. The activated device is now ready to be assigned to any user.

How to Install Zombie

  1. Zombie image is compressed with 7z compression tool, follow the below steps to install and extract installer files on Linux machine.
    • sudo apt-get install p7zip-full
  2. Download the latest Zombie image from the link mentioned below: You must be login into LinuxLink
    https://linuxlink.timesys.com/ebf/download/zombie/Zombie_V2.3.2.img.7z
  3. Extract the image from the downloaded files by running the below command:
    • 7z x <file_name>.7z
  4. Flash the extracted image into a 32GB sd card.
    • dd if=./<file_name>.img of=/dev/sdX bs=4M status=progress conv=fsync

After flashing image into SD Card, boot the board using this newly created sd-card and login into Zombie E-Z Config with the default username and password to reconfigure the Zombie.

How to Upgrade Zombie

  1. To Upgrade Zombie to a newer version, prefer to take the backup of current settings. Refer Link
  2. Zombie image is compressed with 7z compression tool, follow the below steps to install and extract installer files on Linux machine.
    • sudo apt-get install p7zip-full
  3. Download the latest Zombie image from the link mentioned below: You must be login into LinuxLink
    https://linuxlink.timesys.com/ebf/download/zombie/Zombie_V2.3.2.img.7z
  4. Extract the image from the downloaded files by running the below command:
    • 7z x <file_name>.7z
  5. Flash the extracted image into a 32GB sd card.
    • dd if=./<file_name>.img of=/dev/sdX bs=4M status=progress conv=fsync
  6. After flashing image into SD Card, boot the board using this newly created sd-card and login into Zombie E-Z Config with the default username and password to reconfigure the Zombie.
  7. To restore Zombie settings to the last saved configuration, Refer Link

How to configure Zombie through Zombie E-Z Config

Following are the steps to start Hotspot part for Zombie E-Z Config application:
  1. Connect to wireless hotspot as set initially.
    Host id: TimesysZombie-Wifi
    Password: admin123
  2. Launch Zombie E-Z Config UI with URL 10.10.10.10
  3. If logging in for the first time, the default credentials are:
    Username: admin
    Password: admin123

    NOTE: Non-admin user can only view details of the page by selecting View Status option
  4. Zombie Network Settings page will appear on the screen. Also, the user can change the Zombie Timezone from this page.
  5. On Zombie Network Settings page, change 'Zombie Hostname', set 'Zombie IP Address' to any available IP Address and input all the other details.
  6. Then click on 'Save' button.
  7. Also from the left navigation, select the page in which the user wants to make any changes.
  8. Reboot the Zombie to apply all the changes.
    1. Zombie Status: Displays status of Zombie and connected devices.
    2. Zombie Network Settings: To configure a new Zombie with hostname, Zombie IP address, Gateway IP, Master IP address, follow these steps to update Network Settings page.
    3. Device Under Test (DUT): To change the serial settings of a page, follow these steps
    4. Advanced Settings: To change the path for TFTP, NFS directory, udev entries for serial port follow these steps.
    5. Create New User: Admin user can create a new user by following these steps.
    6. Maintenance: Backup/Import Zombie settings.
    7. Default Settings: Reset Zombie settings to initial shipped-in state.
    8. Reset Password: Admin user can change the password by following these steps.

How to Install APP Zombie

  1. APP Zombie image is compressed with 7z compression tool, follow the below steps to install and extract installer files on Linux machine.
    • sudo apt-get install p7zip-full
  2. Download the latest App-Zombie image from the link mentioned below: You must be login into LinuxLink
    https://linuxlink.timesys.com/ebf/download/appzombie/APP-Zombie_V2.3.2.img.7z
  3. Extract the image from the downloaded files by running the below command:
    • 7z x <file_name>.img
  4. Flash the extraced image into a 32GB sd card.
    • dd if=./<file_name>.img of=/dev/sdX bs=4M status=progress conv=fsync

After flashing image into the SD Card, boot the board using this newly created sd-card and login into APP Zombie E-Z Config with the default username and password to reconfigure the Zombie.

How to Upgrade APP Zombie.

Same steps as installation.

How to configure APP Zombie through APP-Zombie E-Z Config

Following are the steps to start the Hotspot part for the APP-Zombie E-Z Config application:
  1. Connect to wireless hotspot as it set initially.
    Host id: TimesysAPP-Wifi
    Password: admin123
  2. Launch Zombie E-Z Config UI with URL 10.10.10.10
  3. If logging in for the first time, the default credentials are:
    Username: admin
    Password: admin123

    NOTE: Non-admin user can only view details of the page by selecting the View Status option
  4. APP Network Settings page will appear on the screen. Also, the user can change the APP-Zombie Timezone from this page.
  5. On the App Network Settings page, change 'APP Hostname' and set 'APP IP Address' to any available IP Address, and input all the other details.
  6. Then click on the 'Save' button.
  7. From the left navigation, select the page in which the user wants to make any changes.
  8. Reboot APP Zombie to apply all the changes.
    1. App Zombie Status: Displays status of App-Zombie and connected devices.
    2. APP Network Settings: To configure a new APP Zombie with hostname, IP address, Gateway IP, Netmask, APP WiFi channel and Timezone.
    3. Live Streaming Settings: Here you can provide the resolution for streaming, the port number on which video will stream and the quality percentage.
    4. Image Capture Settings: Here you can provide the resolution of the image to be captured.
    5. Audio Settings: You can set the port on which the mic is connected.
    6. USB Device Sharing Settings: Here you can switch the USB device sharing tool between USB/IP and USB network gate.
    7. Create New User: Admin user can create a new user.
    8. Maintenance: Backup/Import Zombie settings.
    9. Default Settings: Reset Zombie settings to initial shipped-in state.
    10. Reset Password: Admin users can change the password.

APP-Zombie Security

Enable HTTPS

Following are the steps to enable HTTPS on APP-Zombie for Secure Video Streaming access:

If you are using EBF over HTTPS, Please upload the SSL key and certificate files here and reboot APP-Zombie to use the USB WebCam Video Streaming feature.

  • From the local machine terminal, run the following command:
    • $ sudo openssl req -newkey rsa:2048 -new -nodes -x509 -days 3650 -keyout pad.js.key -out pad.js.crt
    • Input all the details as asked.
    • In the field: 'Common Name (e.g. server FQDN or YOUR name) []:' ,enter the IP Address of the Zombie set in the previous step.
    • Now 2 files are generated, namely 'pad.js.crt' and 'pad.js.key'.
  • From the left navigation, click on 'Security' option.
  • The APP-Zombie Security page will be shown on the screen.
  • In the 'SSL Key File' section, click on the 'Choose file' button and upload '<file_name>.key' file.
  • In the 'SSL Certificate File' section, click on the 'Choose file' button and upload '<file_name>.crt' file.
  • After Successful file upload reboot APP-Zombie to use the USB WebCam Video Streaming feature.

How to add a New Zombie on EBF Server

Following are the steps to add a new Zombie on the EBF server:
  1. Login to EBF dashboard through web browser using admin credentials.
    Username : <username>
    Password : <password>
  2. EBF Dashboard will appear on the screen.
    1. Select the ‘New Zombie’ option from the ‘Zombies’ drop-down list.
  3. ‘Add New Zombie’ page will appear on the screen.
  4. Fill in the necessary fields available on the screen.
    • Zombie IP: <Zombie Corporate IP>
    • App Zombie IP: <App Zombie Corporate IP>
  5. After entering the details, click on the 'Submit' button.
    NOTE: Tick the Is Image Capture Web Camera Connected ? checkbox if a camera is connected to the AppZombie (Optional).
    NOTE: Tick the Is Streaming USB Web Camera Connected ? checkbox if a camera is connected to the AppZombie (Optional).
    NOTE: Tick the Is IP Camera Connected ? checkbox if a camera is connected to the AppZombie (Optional).
    NOTE: Tick Use Zombie Reverse Proxy (for hosted version) ? if reverse proxy configured (Optional).
    NOTE: Tick Use Use APP-Zombie Reverse Proxy (for hosted version) ? if reverse proxy configured (Optional).
  6. Give Zombie Reverse Proxy URL (for hosted version): if reverse proxy is setup.
  7. Give APP-Zombie Reverse Proxy URL (for hosted version): if reverse proxy is setup.
  8. A confirmation message will be displayed on the screen to confirm that a new Zombie has been added.

How to edit details of an existing Zombie

Following are the steps to edit the details of added Zombie on EBF server:
  1. Click on the ‘Edit Zombie’ option from the ‘Zombies’ drop-down list on EBF Dashboard to edit Zombie details.
  2. Select the Zombie from drop-down list on the ‘Select Zombie’ page to edit Zombie details.
  3. ‘Manage Zombie’ page will appear on the screen. Edit the Zombie details and click on the 'Submit' button.
    NOTE: Tick the web-cam checkbox, if a camera is connected to the AppZombie (Optional).
  4. A confirmation message of updated Zombie details will be displayed on the screen.

How to Power Control the Zombie

Following are the steps to Add Zombie Power Switch on EBF:

First, Add the Power Switch on the EBF Server.

To see, How to Add Power Switch, Please Refer Link

  1. After adding the power switch on the EBF-Server, Connect the zombie main power to the Power switch configured.
  2. Go to 'Zombies'->'Edit Zombie'
  3. Select the Zombie you want to edit
  4. On Manage Zombie page, Check the checkbox*(Is Power Switch Connected)*
  5. Select Power Switch
  6. Select Power Port on which zombie power is connected.
  7. After filling all the details, click on the 'Submit' button.
  8. On successful updation of zombie, a successful message will appear on the screen.
  9. Now, Go to 'Zombies'->'Zombie Workers'
  10. Power control(ON,OFF), power switch configure and power status options are visible to the corresponding zombie, on which you have added power switch.
  11. To Configure power switch for zombie, Select the Power Switch and Power Port.
  12. To Check the power status of the Zombie. 'Click on the 'Check power status of the zombie' option
  13. To Power 'ON' the Zombie, Click on the power on option.
  14. To Power 'OFF' the Zombie, Click on the power off option.

How to Delete an existing Zombie

Following are the steps to delete an existing Zombie on EBF server:
  1. Click on the ‘Zombie Workers’ option from the ‘Zombies’ drop-down list on EBF Dashboard to delete an existing zombie.
  2. Select the Zombie from Zombie workers list to delete the zombie.
  3. Click on the delete icon of the corresponding zombie, you want to delete.

Launch Zombie E-Z Config application

The following are the ways to launch the Zombie E-Z Config application:

  1. Click on the ‘Edit Zombie’ option from the ‘Zombies’ drop-down list on EBF Dashboard to edit Zombie details.
  2. Select the Zombie from the drop-down list on the ‘Select Zombie’ page to launch the Zombie E-Z config application of that Zombie.
  3. ‘Manage Zombie’ page will appear on the screen.
  4. Click on the 'Launch Zombie E-Z Config' button. In the new tab, the user is directed to the Zombie E-Z Config application of the selected Zombie.
  5. Enter Username and Password and select the Login button to login to the Zombie E-Z Config application.

OR

One can also "Launch Zombie E-Z config Application" from the Zombie workers page.

The following are the steps to launch the Zombie E-Z Config application:

  1. Click on the ‘Zombie Worker’ option from the ‘Zombies’ drop-down list on EBF Dashboard to edit Zombie details.
  2. After reaching the Zombie workers page. Click on any zombie name to reach to the particular zombie worker page.
  3. From the selected Zombie workers page. Click on 'Zombie E-Z Config' to reach the Zombie status page.
  4. From the Zombie status page. click on the arrow button to launch the Zombie E-Z Config application.
  5. Enter Username and Password and select the Login button to login to the Zombie E-Z Config application.

How to add SSH Zombie on EBF Server

SSH-Zombie feature provides the capability to use any General purpose machine as a Zombie with limited functionality.

Following are the steps to add SSH Zombie on the EBF server:
  1. Login to EBF dashboard through web browser using admin credentials.
    Username : <username>
    Password : <password>
  2. EBF Dashboard will appear on the screen.
  3. Select the ‘New Zombie’ option from the ‘Zombies’ drop-down list.
  4. ‘Add New Zombie’ page will appear on the screen. Select SSH Zombie from the drop down.
  5. Fill in the necessary fields available on the screen.
    Name, IP address/Hostname, SSH Username, SSH Password, SSH port of your machine that is going to add as a SSH-Zombie.
OR:
  1. You can also use ssh-key authentication instead of password and for how to set up ssh-key authentication, Click on 'Click here' option.
  2. Follow the instructions.
  1. After entering the details, click on the 'Test Connection' button. It will check whether the remote machine is up and the ssh server is running on the provided port.
  2. If the Test connection is successful then click on 'Ok' and then click on 'Submit' button.
  3. After click on submit button, ssh zombie added successfully message displayed on the screen.
  4. You can also check the newly added SSH Zombie on the Zombie workers page.
  5. Newly added SSH-Zombie is displayed on the zombie workers dashboard.

How to edit details of an existing SSH Zombie

Following are the steps to edit the details of added Zombie on EBF server:
  1. Click on the ‘Edit Zombie’ option from the ‘Zombies’ drop-down list on EBF Dashboard to edit Zombie details.
  2. Select the Zombie from drop-down list on the ‘Select Zombie’ page to edit Zombie details.
  3. ‘Manage Zombie’ page will appear on the screen. Edit the Zombie details and click on the 'Test Connection' button. If the test connection is successful,click on the 'Submit' button.
  4. A confirmation message of updated Zombie details will be displayed on the screen.

How to Delete an existing SSH Zombie

Following are the steps to delete the Existing SSH Zombie on EBF server:
  1. Click on the ‘Zombie Workers’ option from the ‘Zombies’ drop-down list on EBF Dashboard to delete an existing SSH Zombie.
  2. Select the Zombie from the ‘Workers’ page to delete SSH Zombie.
  3. Click on the 'Delete icon' of the coressponding zombie, of which you want to delete.
  4. A confirmation pop-up will come on the screen. Click on the 'OK' button to delete the Zombie.
  5. After deleting the zombie, zombie will no longer will be seen on the screen.

How to whitelist Zombie ports for port forwarding

Following are the steps to whitelist Zombie ports for port forwarding:
  1. Login to EBF home page/dashboard (find your URL from the administrator) through the web browser with your credentials
    Username : <username>
    Password : <password>
  2. This would open up EBF Dashboard.
  3. Select the zombie workers option from the 'zombie' option drop-down.
  4. Select port forwarding option of the respective zombie on which you want to add the port forwarding.
  5. Zombie port forwarding page would open up.
  6. Click on '+' to add the port.
  7. Enter port no. or you can also add port range. For e.g. I have added port range(1230-1234).After that, click on add button.
  8. Click on 'save' button.
  9. Port range is successfully added.

How to add a New Device Type

A device type is a generic description of a device and identifies different qualities of that device.
In EBF, a particular DUT is an instance of a device type. For example, if beaglebone-black is a device type, then it can have many device instances like bbb01, bbb02, BBB, etc that share the same device type with the same set of commands.

When adding a device, a device type needs to be added corresponding to the device to be added. The device type can be added only by the admin.

For example:
Following are the steps to add a new Device type on the EBF server:

  1. Login to EBF homepage/Dashboard through a web browser with credentials.
    Username : <Username>
    Password : <Password>
  2. This would open EBF home page. Select ‘New Device type’ option from ‘Devices’ drop down list.
  3. ‘Add New Device Type’ page will appear on the screen.
  4. Fill all the fields available on the screen.
    1. Name:<Device type name>
    2. Device Type Template: Valid definition for device type.

Must Parameters in Device type template

{% extends 'base-uboot.jinja2' %}
{% set device_type = "" %}

Specifications:

extends 'base-uboot.jinja2' - The device type extends base-uboot.jinja2 available in device-type folder.

set device_type = "" - Provide a unique name for device type in this section

After filling in all the fields click on the ‘Submit button.

The device type will be added to the EBF server.

How to edit details of a Device type

Following are the steps to edit the details of added Device type on the EBF server:
  1. Select the ‘Edit Device Type’ option from the ‘Devices’ drop-down list on the EBF dashboard to edit Device type details.
  2. Select Device type from the drop-down list on the ‘Select Device type’ page to edit Device type details.
  3. ‘Manage Device Type’ page will appear on the screen. Edit the Device type details.
  4. Click on the ‘Submit’ button and details of Device type is edited and saved.
  5. Device type details are saved and updated.

How to edit Device type Template

  1. Log into EBF server using a web browser through web credentials.
    Username: <admin username>
    Password:<password>
  2. Go to Devices -> Edit Device Type. Select the device type for which device type template needs to be edited. The device type page will appear on the screen.
  3. The device type template has the following parameters by default while adding a new device type.

    Must Parameters in Device type template
    {% extends 'base-uboot.jinja2' %}
{% set device_type = "am335x" %}

    Specifications:
    extends 'base-uboot.jinja2' - The device type extends base-uboot.jinja2 available in device-type folder.
    set device_type = "" - Provide a unique name for device type in this section
    Other optional parameters with example for reference
    {% set console_device = console_device|default('ttyS0') %}
{% set baud_rate = baud_rate|default(115200) %}
{% set bootloader_prompt = bootloader_prompt|default('U-Boot') %}
{% set bootm_kernel_addr = '0x82000000' %}
{% set bootm_ramdisk_addr = '0x81600000' %}
{% set bootm_dtb_addr = '0x88000000' %}
{% set bootz_kernel_addr = '0x82000000' %}
{% set bootz_ramdisk_addr = '0x83000000' %}
{% set bootz_dtb_addr = '0x88000000' %}
{% set uboot_mkimage_arch = 'arm' %}

    Specifications:
    Console device: The device serial port is defined in this console device section. For reference “ttyS0” is taken as console port in this example.
    set console_device = console_device|default('ttyS0')
    Baud Rate: Baud rate depends on the device used.For reference in this example, baud rate is set to 115200. Other “standard” baud are 1200, 2400, 4800, 9600, 19200, 38400 and 57600.
    set baud_rate = baud_rate|default(115200)
    Bootloader Prompt: The user can set bootloader prompt when board first boots up. What prompt does device gets bootloader, that needs to be mentioned here. Example: In this case, “U-boot” is used as bootloader prompt.
    set bootloader_prompt = bootloader_prompt|default('U-Boot')
    Bootm kernel address, ramdisk address, dtb address: Set device kernel address, dtb address and ramdisk address.
    Here Kernel file address needs to be mentioned for the device. bootm_kernel_addr is used when the kernel image type is uImage. This can be checked from the artifacts of the device build.
    set bootm_kernel_addr = '0x82000000'
    Here dtb file address needs to be mentioned for the device. bootm_dtb_addr is used when the kernel image type is uImage. This can be checked from the artifacts of the device build.
    set bootm_ramdisk_addr = '0x81600000'
    set bootm_dtb_addr = '0x88000000'
    Bootz kernel address, ramdisk address, dtb address: Set device kernel address, dtb address and ramdisk address.Here kernel file address needs to be mentioned for the device. bootz_dtb_addr is used when the kernel image type is zImage. This can be checked from the artifacts of the device build.
    set bootz_kernel_addr = '0x82000000'
    Here dtb file address needs to be mentioned for the device. bootz_dtb_addr is used when the kernel image type is zImage. This can be checked from the artifacts of the device build.
    set bootz_ramdisk_addr = '0x83000000'
    set bootz_dtb_addr = '0x88000000'
    Uboot_mkimage_arch: The uboot_mkimage_arch value will need to be set according to the requirements of the device.
    Most ARMv7 devices will use arm as the architecture and most ARMv8 devices will use arm64, but this is not always the case. For example, the APM Mustang is an arm64 device but the U-Boot build on the Mustang pre-dates arm64 support in mainline U-Boot. It uses:
    set uboot_mkimage_arch = 'arm'

How to create a new user in Zombie E-Z Config

A new user can be created by an Admin user. The admin user can create a new user using the following steps:

  1. Login to Zombie E-Z config using admin credentials.
    Username: <admin name>
    Password:<Admin Password>
  2. In the left navigation panel, select the 'Create New User' option to register a new user.
  3. Register New User page will appear on the screen. Provide Username and password for registering a new user. The username must be unique.
  4. After providing Username and password, click on the Register button. The new user is created successfully.
  5. After selecting the Register button, a message that the new User created successfully appears on the screen.

    NOTE: If a username already exists, then on selecting the Register button a message will appear on the screen.
  6. Re verify by logging in using new user credentials.

Reset Password of existing User in Zombie E-Z Config

The user can reset the password of their own or another user using the following steps:

  1. Login to Zombie E-Z config using user credentials.
    Username: <Username>
    Password:<User Password>
  2. In the left navigation pane, select Create New User option to Reset the password of an existing user.
  3. Select Reset Password radio button available on Register New User page.
  4. Enter existing Username and enter new password.
  5. A confirmation message of password changed will appear on the screen.
  6. Re verify the new password by logging in to the Zombie E-Z Config application.

How to Backup/Import Zombie Settings

When Zombie SD card is re-flashed Zombie settings are lost. To preserve and import them again, you can use this Backup and Import feature.

How to Backup Zombie Settings

  1. Login to Zombie E-Z config using user credentials.
    Username: <Username>
    Password:<User Password>
  2. Click on the 'Maintenance' link on the left navigation panel.
  3. Click on 'Backup Current Settings' button to preserve current Zombie EZ-config settings.
  4. A confirmation message of successful backup will be shown on the screen.

How to Import Zombie Settings

  1. Login to Zombie E-Z config using user credentials.
    Username: <Username>
    Password:<User Password>
  2. Click on the 'Maintenance' link on the left navigation panel
  3. Click on the 'Import Backedup Settings' button to load the historically preserved setting into Zombie EZ-config.
  4. Importing of settings will begin and a message is shown on the screen as follows:
  5. A confirmation message of successful import will be shown on the screen.
  6. You will be redirected to the 'Zombie Status' screen.
  7. Click on the 'Reboot' link on the left navigation panel for the imported settings to take effect.

How To setup Live Streaming

How to Connect an NC450 for Live Streaming

  1. Connect Local Lan of Zombie and APP-Zombie using an ethernet cable.
  2. Connect NC-450 Webcam LAN to local LAN of APP-Zombie.
  3. Connect Power Supply to NC-450 cam.
  4. After successfully getting the DHCP IP through local LAN NC450's LED light would turn “Green”.

How to Configure Video Streaming for (IP Camera/NC450)

One can configure an IP Camera while adding a new zombie or editing an existing zombie.

Following are the steps to configure the IP camera while adding a new Zombie on the EBF server:
  1. Login to EBF dashboard through a web browser using admin credentials.
    Username : <username>
    Password : <password>
  2. EBF Dashboard will appear on the screen.
    1. Select the ‘New Zombie’ option from the ‘Zombies’ drop-down list.
  3. ‘Add New Zombie’ page will appear on the screen.
  4. Fill in the necessary fields available on the screen.
    • Zombie IP: <Zombie Corporate IP>
    • App Zombie IP: <App Zombie Corporate IP>
    • Select the option (Is IP Camera Connected ?) if you want to connect it. Then enter the URL of the IP Camera.
  5. After entering the details, click on the 'Submit' button.
  6. A confirmation message will be displayed on the screen to confirm that a new Zombie has been added.

OR

Following are the steps to configure IP camera while editing an existing Zombie on the EBF server:
  1. Click on the ‘Edit Zombie’ option from the ‘Zombies’ drop-down list on EBF Dashboard to edit Zombie details.
  2. Select the Zombie from the drop-down list on the ‘Select Zombie’ page to edit Zombie details.
  3. ‘Manage Zombie’ page will appear on the screen. Edit the Zombie details and click on the 'Submit' button.
  4. Now click on (Is IP Camera Connected ?) and provide the URL for the streaming camera.
  5. Confirmation message will appear on the screen.
  6. Now go to device console page and click on Video Streaming(IP Cam)
  7. A pop-up will come and url of the IP camera will be visible.

How to Connect a USB webcam for live streaming

  1. Connect Local Lan of Zombie and APP-Zombie using an ethernet cable.
  2. Connect USB Webcam to USB port of APP-Zombie for live streaming.

How to Configure USB webcam for live streaming

NOTE: Camera model which supports Live Streaming:
  1. MicroSoft HD-3000
  2. Megapixel 10x Digital Zoom
  3. Quantum USB Camera(QHM-495LM)

Following are the steps to configure USB webcam on the EBF server:

  1. Login to EBF dashboard through a web browser using admin credentials.
    Username : <username>
    Password : <password>
  2. Click on the ‘Edit Zombie’ option from the ‘Zombies’ drop-down list on EBF Dashboard to edit Zombie details.
  3. Select the Zombie from the drop-down list on the ‘Select Zombie’ page to edit Zombie details.
  4. Tick the USB webcam checkbox if a camera is connected to the APP Zombie.
  5. A confirmation message of updated Zombie details will be displayed on the screen.
  6. Follow: How to access USB webcam Live Streaming.

How to Connect a USB webcam for Image Capture

  1. Connect Local Lan of Zombie and APP-Zombie using an ethernet cable.
  2. Connect USB Webcam to USB port of APP-Zombie for image capture.

How to Configure USB webcam for Image Capture

Following are the steps to configure a USB webcam on the EBF server:
  1. Login to EBF dashboard through a web browser using admin credentials.
    Username : <username>
    Password : <password>
  2. Click on the ‘Edit Zombie’ option from the ‘Zombies’ drop-down list on EBF Dashboard to edit Zombie details.
  3. Select the Zombie from the drop-down list on the ‘Select Zombie’ page to edit Zombie details.
  4. Tick the USB webcam checkbox for image capture, if a camera is connected to the APP Zombie then click on submit button.
  5. A confirmation message of updated Zombie details will be displayed on the screen.
  6. Follow: How to capture image from USB webcam

How To Setup USB Network Gate

Setup Network Gate on Zombie E-Z Config

  1. Launch the Zombie E-Z Config on any web browser(Chrome, Firefox, Edge) to do this and navigate to the following URL.
  2. Login to the Zombie E-Z Config application with the credentials:
    Username:<Admin Username>(admin)
    Password:<Password for Admin>(admin123)
  3. Now from the left navigation panel click on advance settings.
  4. On Next Page click on the 'Edit' check box to edit detail on Zombie E-Z Config.
  5. Now change the USB share tool from USB/IP to USB Network Gate and then after that save the settings.
  6. From the left navigation panel click on zombie status.
  7. On the status page go to the USB device section and click on the Un-Licensed.
  8. Now provide the registration name and activation code then click on activate button to activate the USB Network Gate licensed.
  9. After successful code activation you will able to share and un-share the USB device.

**NOTE only one device can be shared at a time.

Setup Network gate on APP-Zombie

  1. Launch the APP-Zombie E-Z Config on any web browser(CHROME, FIREFOX, EDGE) to do this and navigate to the following URL.
  2. Login to the APP-Zombie E-Z application with the credentials:
    Username:<Admin Username>(admin)
    Password:<Password for Admin>(admin123)
  3. Now from the left navigation panel click on the 'USB Device Sharing Settings'.
  4. Now change the USB share tool from USB/IP to USB Network Gate and then after that save the settings.
  5. On the status page go to the USB device section and click on the Un-Licensed.
  6. Now provide the registration name and activation code then click on activate button to activate the USB Network Gate license.
  7. Un-shared USB devices are available on the screen
  8. After successful code activation you will be able to share and un-share the USB device.

**NOTE only one device can be shared at a time.

How to Auto share USB/IP Devices On EBF

  1. Go to 'All Devcies'
  2. Select the Device from 'All Device' page.
  3. Select worker to view the Selected Worker.
  4. Select 'Zombie e-z config' to see the view the status page of the zombie.
  5. On this page, USB Devices are visible under the column 'USB Devices'.
  6. To 'Autoshare' the USB Device, the device must be in the shared state.
  7. Click on the 'Toggle' button to share the device.
  8. Check the Check-box to autoshare the device.

Enable KGDB Debugging

KGDB is a source-level debugger for the Linux kernel. This section will provide information about how a KGDB-enabled board can be debugged remotely using Timesys EBF.
We can achieve this functionality by using the USB-Over-IP feature of EBF and a one-time setup on your local Linux machine.

Steps to be performed on EBF and Zombie: Identify the board that you want to debug.
  1. Login to EBF homepage/dashboard (find the URL from the administrator) through a web browser with your credentials.
    Username : <username>
    Password : <password>
  2. After login, click on the 'ALL Devices' option under the 'Devices' dropdown.
  3. Click on the device name connected to the concerned Zombie that you want to debug.
  4. On the next page, select worker to view the zombie worker of the selected device.
  5. Select Zombie EZ-Config to view the status of zombies in detail.

    OR:
  6. Click on the 'View Zombie status' icon under the 'Actions' column of the concerned Zombie.
  7. Click on the 'Arrow' to go to the login page of E-Z config page.
  8. Now the user will be redirected to the Zombie login page.
  9. After successful login On this page, under the 'USB Devices' section, all the USB devices connected to that Zombie are listed.
  10. Identify your device and click on the 'Toggle' button.
  11. Device's status now gets changed to 'Shared'. Now the device is available to be accessed remotely.
  12. This is all you need to do on EBF and Zombie. Now you have to setup your local Linux machine to debug the board.
Steps to perform on Local Linux Machine: Follow the steps mentioned in the link on the Zombie status page.
  1. Follow the link as mentioned in the image below (present at the bottom of the Zombie Status page), and it will provide you all the information needed to install and use 'usbip'.
  2. Click on the link and follow all the steps mentioned.
  • Install usbip utility in your local Linux machine (from where you want to access the device connected on EBF).
  • After successfully attaching the remote device serial console to a local machine, it will start showing its entry in the system device tree.
  • Now you can access this device from your local machine.

USB/IP Management

We can achieve this functionality by using the USB-Over-IP feature of EBF and a one-time setup on your local Linux machine. Following are the steps to access a remote USB device on your local machine, given the USB is connected to any port of Zombie.

Steps to be performed on EBF and Zombie: Identify the USB device that you want to access remotely.
  1. Login to EBF homepage/dashboard (find the URL from the administrator) through a web browser with your credentials.
    Username : <username>
    Password : <password>
  2. After login, select the 'All devices' option under the 'Devices' dropdown.
  3. All Devices page will appear on the screen. Select the device name (rpi_demo is taken as reference) to view the Zombie worker.
  4. On the next page, select worker to view the zombie worker of the selected device.
  5. select Zombie EZ-Config to view the status of zombie's in detail.

    OR:
  6. Click on the 'Zombie' icon corresponding to the 'Zombie Status' to login into Zombie.
  7. Provide valid login credentials to login into zombie EZ-config.
  8. On this page, under the 'USB Devices' section, all the USB devices connected to that Zombie are listed.
  9. Then click on the 'Zombie Status' tab.
  10. Identify your USB and click on the 'Toggle' button.
  11. USB's status now gets changed to 'Shared'. Now the USB is available to be accessed remotely.
  12. This is all you need to do on EBF and Zombie. Now you have to setup your local Linux machine to access the USB.
    Steps to perform on Local Linux Machine: Follow the steps mentioned in the link on the Zombie status page.
  1. Follow the link as mentioned in the image below, and it will provide you all the information needed to install and use 'usbip'.
  2. Click on the link and follow all the steps mentioned.
  • Install usbip utility in your local Linux machine (from where you want to access the remote USB).
  • After successfully attaching the remote USB to the local machine, it will start showing its entry in the system device tree.
  • Now you can access this USB from your Local machine.
  • To free the USB device after the user, click on the 'Toggle' icon to un-share the target device.

NOTE: 1 USB Device can be accessed only by 1 user at a time.