Embedded Board Farm User Guide

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 the Timesys EBF are a centrally located EBF SERVER 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 EBF Server.

A EBF SERVER supports multiple Zombies and each Zombie can support up to four independent Devices (under development/test).

EBF SERVER: EBF Server 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 Timesys supplied hardware. It is placed in remote locations and comes to life when addressed by the EBF Server. Normally, the Zombie normally will execute commands from the EBF Server.

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

IO-CX - The IO Controller and Expander is hardware supplied by Timesys. It connects the DUT to the 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.

Quick Start Guide

Device allocation

To access the device’s web console, the device must be allocated to the user first.

Follow this link for details

Port Forwarding

Follow this link for details

Power control features

There are three power control features to change the power state of the device.

Follow this link for details

Access web console

After device allocation to user, web console session must be accessed.

Follow this link for details

Download console Logs

Follow this link for details

Console Sharing

Follow this link for details

Hotplugs

Follow this link for details

Netboot

Once web console session is accessed, the device needs to be booted up for testing and other processes.

Follow this link for details

SD card boot

Follow this link for details

USB boot

Follow this link for details

Video Streaming

Follow this link for details

Capture Screenshot

Follow this link for details

Audio Streaming

Follow this link for details

Device release

The user must release the device after use.

Follow this link for details

How to allocate Device available on EBF server

Following are the steps to allocate board to the user available on the EBF server:

  1. Login to EBF homepage/dashboard (find the URL from the administrator) through a web browser with your credentials.
    Username : <username>
    Password : <password>
  2. EBF Dashboard will appear on the screen. Select the ‘All Devices’ option from the ‘Devices’ drop-down list.
  3. ‘All Devices’ page will appear on the screen with the list of all devices on the EBF server. Here both devices are available and could be allocated to any user for use.
  4. Click on the assign button corresponding to the device that the user wants to allocate for work. Once clicked, the device is allocated to the user for use.
    Example: Here 'demo1' is the user to whom device bbb_demo is allocated for use.
  5. Also, the logged in user can view the list of all devices that are allocated to him/her by clicking on 'My Devices' option under the 'Devices' link on the EBF Homepage as shown in the image below:

How to use port forwarding

EBF is providing the port forwarding feature in which you can forward any port of your DUT to your Zombie(Connected to the corporate network). By this feature, you can access any port of your DUT from a corporate network .e.g. ssh, telnet, etc.

Please follow the below steps for port forwarding.
  1. Go to Devices -> All Devices and you will see the list of all available devices.
  2. Select the >> Port Forwarding button of the device whose port you want to forward or you can see the Port Forwarding feature on the device configuration page.

    OR
    1. Go to Devices -> All Devices and you will see the list of all available devices.
    2. Now click on the device name whose port you want to forward.
    3. Now click on the port forward button.
  3. After clicking on any of the above-given options, you will see the Device Port Forwarding screen.
  4. In this, you have to provide details about your port forwarding rule i.e. device IP address, the port number of DUT that you want to forward on to Zombie, protocol, and a free Zombie port to forward to. After this, click on the Forward button.
  5. If the port of Zombie is free, then your port of DUT will forward to that port. Also, the ports will get non-editable, followed by the 'Remove' button as shown in the image below.
  6. Whenever you access the Device Port Forwarding screen, you will see the status of the current port forwarded details of that DUT and you can also remove the already forwarded port as well.

Power Control Feature

Through EBF Server, users can control the power state of the device connected to any Zombie.

There are three power switch options available:
  • Power On
  • Power Off
  • Reboot

These options are available on the device’s web console screen:

Once the user clicks on the Power On/Power Off/Reboot button, the power state of the board changes, and the color symbol is displayed on the screen.

Power On Confirmation:

When the color adjacent to the 'Power' label is Green, it means the Power is ON.

Power Off Confirmation:

When the color adjacent to the 'Power' label is Red, it means the Power is OFF.

Reboot Confirmation:

When the color of the 'Power' label switches from Red to Green, irrespective of the current color, it means the reboot is successful.

How to access a device's Web Console

Serial Console.

Following are the steps to access a serial web console:
  1. Login to EBF homepage/dashboard (find the URL from the administrator) through a web browser with your credentials.
    Username : <username>
    Password : <password>
  2. Select the ‘All Devices’ option from the ‘Devices’ drop-down list.
  3. Click on the assign button corresponding to the device selected (bbb_demo is taken as a reference here) to allocate the device to the user.
  4. Click on the 'Launch Console' button to go to Device's console page.
  5. The following window will appear after selecting the Launch Console option.
    NOTE: The following screen is visible with the IO-CX control panel when the IO-CX control panel is connected.

    OR
    Click on hostname (bbb_demo is taken as reference),

    and on the next page, select the Launch Console option.

    The following window will appear after selecting the Launch Console option.

SSH Console

Following are the steps to access the SSH web console:
  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, first you have to forward your DUT ssh port to any port of Zombie. Please refer to this section for more details on port forwarding.
  3. Select the ‘All Devices’ option from the ‘Devices’ drop-down list.
  4. You can launch the console of the target device.
  5. The following window will appear after selecting the Launch Console option.
    NOTE: The following screen is visible with the IO-CX control panel when the IO-CX control panel is connected.
  6. Now you need to click on the SSH option.
  7. Then you can configure the SSH username by clicking on the popup as highlighted in the image below:
  8. Now you can log in to the ssh by using the password on the console screen.
  9. After entering the correct ssh password you can access the ssh console.

ADB Console

Following are the steps to access ADB Console:
  1. Login to EBF homepage/dashboard (find the URL from the administrator) through a web browser with your credentials.
    Username : <username>
    Password : <password>
  2. Select the ‘All Devices’ option from the ‘Devices’ drop-down list.
  3. Now You can launch the console of the target device.
  4. The following window will appear after selecting the Launch Console option.
    NOTE: The following screen is visible with the IO-CX control panel when the IO-CX control panel is connected.
  5. Find the device IP address connected to the zombie network.
  6. Now click on the ADB option available in the left panel.
  7. The following popup appears on the screen enter the device IP connected to the zombie network.
  8. After a successful connection you can access adb console.

Side by Side Console of two devices

Following are the steps to launch the console of two devices simultaneously:
  1. Login to EBF homepage/dashboard (find the URL from the administrator) through a web browser with your credentials.
    Username : <username>
    Password : <password>
  2. Select ‘All Devices’ option from ‘Devices’ drop down list.
  3. Click on 'assign' icon corresponding to the devices selected (bbb_demo and adb_demo is taken as reference here) to allocate devices to the user.
  4. Click on Launch Side By Side Console button.
  5. Select Device_1 and Device_2 from the drop down list of assigned devices.
  6. The following window will appear after selecting the Device_2.

Download Console Logs

Following are the steps to access download Console Logs:
  1. Login to EBF homepage/dashboard (find the URL from the administrator) through a web browser with your credentials.
    Username : <username>
    Password : <password>
  2. Select the ‘All Devices’ option from the ‘Devices’ drop-down list.
  3. You can launch the console of the target device.
  4. The following window will appear after selecting the Launch Console option.
    NOTE: The following screen is visible with the IO-CX control panel when the IO-CX control panel is connected.
  5. In order to capture console logs you can perform some command or you can reboot the device to capture fresh logs.
  6. Now you need to click on the Download Logs option.
  7. you will be able to see the download logs file in the downloaded folder.

EBF File Manager On Console Page

Following are the steps to access EBF File Manager on Console Page:
  1. Login to EBF homepage/dashboard (find the URL from the administrator) through a web browser with your credentials.
    Username : <username>
    Password : <password>
  2. Select the ‘All Devices’ option from the ‘Devices’ drop-down list.
  3. You can launch the console of the target device.
  4. The following window will appear after selecting the Launch Console option.
    NOTE: The following screen is visible with the IO-CX control panel when the IO-CX control panel is connected.
  5. On the device console page click on EBF file manager from the left panel.
  6. EBF file manager page will appear on the screen. you can upload and download files on EBF server also you can create a new folder.

How to perform Console Sharing

To perform console sharing both users who are sharing the device console and users with whom the console is shared must belong to the same group. EBF Server admin users can assign/revoke groups of EBF users.

In this example, there are two different users' names as "Demo user1" and "Demo user2".

Following are the steps to share the Device console.
  1. Login to EBF server through a web browser using user1 credentials.
    Username: <Username>
    Password: <Password>
  2. Go to Devices -> All Devices.
  3. All Devices page will appear on the screen.
  4. Now click on 'share console icon' from an action column of the device.
  5. On the next popup, select a user with whom you want to share the device console and save.

Login with shared user

  1. Login to EBF server through a web browser using user2 credentials.
    Username: <Username>
    Password: <Password>
  2. on the next page, you can find the login user name on the top of the screen also you are able to see the shared device name on the screen.
  3. Launch device console for Demo user2.
  4. On the next screen you can see the shared console.

How to use Hotplugs

Refer to Hotplugs Guide

How to boot the device using Network Boot

Using this feature, a user can boot the DUT from a network rather than an SD card connected on SDMux.

Procedure to​​ copy​ BSP Files​ on to Zombie

Go to the concerned device's console and follow the steps given below to copy BSP Files. Follow these steps to Launch Console of the concerned device

  1. Select 'Network Boot' option shown on the console screen.
  2. Close the power off recommendation.
  3. Power of the device.
  4. Re-launch network boot from the console screen.
  5. Network boot page will be shown on the screen.

Transfer desired file need for booting DUT.

  1. Transfer a DTB file from local computer by selecting through select file drop down after that select transferring tool and give command argument if needed, then click on the check box "Delete file from EBF server after transfer" if you want to delete the file from ebf server otherwise unchecked it finally click on transfer file.
  2. Transfer status should appear on the screen after clicking over the transfer file.
  3. After successful image transfer, a success notification message will be shown on the screen.
  1. Transfer a rootfs file from local computer by selecting through select file drop down after that select transferring tool and give command argument if needed, then click on the check box "Delete file from EBF server after transfer" if you want to delete the file from ebf server otherwise unchecked and give extraction directory if you want to change extraction directory otherwise it will be extracted into fsroot directory finally click on transfer file.
  2. Transfer status should appear on the screen after clicking over the transfer file.
  3. After successful image transfer, a success notification message will be shown on the screen.
  1. Transfer a uImage file from local computer by selecting through select file drop down after that select transferring tool and give command argument if needed, then click on the check box "Delete file from EBF server after transfer" if you want to delete the file from ebf server otherwise unchecked it finally click on transfer file.
  2. Transfer status should appear on the screen after clicking over the transfer file.
  3. After successful image transfer, a success notification message will be shown on the screen.

View transferred image in network boot file manager.

  1. Select Network boot file manager from left panel to view the transferred file in network boot file manager list.
  2. File manger should have all transferred image

Booting DUT with New BSP

Once​ BSP​ files​​ are​ copied,​ follow​ steps​ mentioned below​ to​ boot DUT​ with​ new​ BSP​ files.

  1. Access​ ​device ​web console​ ​via​ EBF Server​.​ ​Go to​ ​U-boot​ prompt​ of​ DUT​ as​ shown​ ​below.

    Configure​ boot arguments in​​ u-boot​ prompt​ ​to​ boot​​ DUT​ from​​ NFS​ rootfs​ of​ Zombie.
    Execute​ following​ commands​ in​ u-boot​ prompt​ to​ perform​ this​ action
    => setenv serverip <Zombie IP>
    => setenv bootargs​ ​ console=<serial console>,<baud rate> ​ root=/dev/nfs​ ​ rw nfsroot=<Zombie IP>:<exact rootfs location>,tcp,hard,intr​ ​ip=dhcp
    Example:
    => ​ ​ setenv​ ​ serverip​ 192.168.111.1
    => ​ ​ setenv​ ​ bootargs​ ​ console=ttyS0,115200n8​ ​root=/dev/nfs​ ​rw nfsroot=192.168.111.1:/var/lib/lava/dispatcher/tmp/nfs/DUT2/fsroot,tcp,hard,intr​ ​ip=dhcp
    NOTE:Here​ replace​ DUT2​ with​​ your​ DUT​​ directory​ where​ you​ have​ copied​ BSP​ files and replace the directory name for extracted rootfs with your directory name.
  2. Now​ ​assign​ automatic​ IP​ address​ to​ DUT.​ By​​ executing​​ ‘dhcp’​ command on U-boot, ​DUT​ will​ be assigned a new​ IP address.
    => ​ ​ dhcp
  3. Once​​ DUT​​ is​ bound with​ IP​ address, load​​ kernel​ file​ from zombie TFTP​ to DUT by executing the following command:
    = > ​ ​ tftp​ ​ 0x82000000​ ​ ​ 192.168.111.1:upload/DUT2/<kernel_binary_file> = > ​ ​ tftp​ ​ 0x88000000 192.168.111.1:upload/DUT2/<dtb_file>
    Note-​ ​ Replace <kernel_binary_file> with your​ kernel​​ binary file name and Kernel address could​ ​ be​ different for your board. DUT2 should also be changed to your DUT directory where BSP files were uploaded.
  4. Once​ kernel​ file is loaded, then similarly​ load​ DTB​​ file​ . After loading DTB execute following command to boot DUT​ with​ new​​ BSP. = >booti​ <kerneladdr>​ ​- <dtbaddr>
    Example: =​ ​> booti​​ 0x82000000​​ - ​0x88000000
    Depending on Kernel image types, there are various boot options available:
    Example1: If kernel image type is Image
    => booti​​ 0x82000000​ - ​0x88000000
    Example2: If kernel image type is uImage = > bootm 0x82000000 - 0x88000000
    Example3: If kernel image type is zImage = > bootz 0x82000000 - 0x88000000
    The device is booted through network boot and is ready for testing and for performing other processes on the device. Monitor​ to see​ Login​ prompt​ of​ DUT​ to​ verify​ that​ DUT​ successfully​ booted​​ with new BSP. Verify​ to​ ​see​​ changes​ ​of​ ​New​ ​BSP​ ​and​ perform​ ​further​ ​test​ ​functionality.

How to flash a new image to Boot Media-SD card.

Following are the steps to flash a new image with the help of a boot media-SD card:
  1. Login to EBF home page/dashboard (find your URL from the administrator) through web browser with your credentials.
    Username : <username>
    Password : <password>
  2. After login successfully refer this section to perform console launch.
  3. The following Web Console session will appear on the screen if the IO-CX board is connected.

    NOTE: For SDCard Flash it's mandatory to have IOCX connected to the Device. If IOCX is not connected then the following Console screen appears on the screen and the user cannot access Boot Media-SDCard functionality.
  4. To upload an image on an SD card, first, turn off the power of the device(board) by clicking on the 'OFF' option. The 'SDMUX: Zombie' option will turn red as shown in the image below. Then click on the 'boot media-SDCard' option.
  5. Now the user will be redirected to the SDCard-boot page to Flash an Image.

    There are two ways to Flash an Image.
    1. Select image from local Computer.
    2. Select image from EBF server.
  6. Now flash an image Selecting Image from Local Computer.
    1. From Select file drop-down and choose "select from local computer".
    2. Now choose the desired file to flash into the SD card.
    3. From the SD card drop-down menu choose the target partition.
    4. Select flashing tool as per requirement(zcat + dd/gunzip + dd/dd/bmaptool/tar/unzip/cp). If you don't select, it will be auto-selected according to the file extension of the chosen file.
    5. Give command-line argument if needed.
    6. Check the "pre-format(mkfs)" check the box if want to format the partition before flashing an image otherwise unchecked.
    7. Check the "Delete file from EBF server after flash" check box if want to delete the file after flashing from ebf server otherwise unchecked.
    8. Now click on the flash file button to flash the image into the SD card.
    9. During flash the flash status of the image should be visible on the screen.
  7. After successful image upload, select the Launch console button to start the Console session.
  8. Now Go to SD card file manager and see the target partition where the file was flashed.
  9. Now flash an image Selecting Image from EBF Server.
    1. From Select file drop-down and choose "select from EBF Server".
    2. Now select the desired file to flash into the SD card.
    3. From the SD card drop-down menu choose the target partition.
    4. Select flashing tool as per requirement(zcat + dd/gunzip + dd/dd/bmaptool/tar/unzip/cp). If you don't select, it will be auto-selected according to the file extension of the chosen file.
    5. Give command-line argument if needed.
    6. Check the "pre-format(mkfs)" check the box if want to format the partition before flashing an image otherwise unchecked.
    7. Check the "Delete file from EBF server after flash" check box if want to delete the file after flashing from EBF server otherwise unchecked.
    8. Now click on the flash file button to flash the image into the SD card.
    9. During flash the flash status of the image should be visible on the screen.
  10. After successful image upload, select the Launch console button to start the Console session.
  11. Now Go to the SD card file manager and see the target partition where the file was flashed.

How to flash a new image to a USB

Following are the steps to flash a new image to USB with the help of USBMux:
  1. Login to EBF home page/dashboard (find your URL from the administrator) through web browser with your credentials.
    Username : <username>
    Password : <password>
  2. Select the ‘All Devices’ option from the ‘Devices’ drop down list.
  3. Go to the 'All Devices' page and verify the MUX mode of the device.
  4. Go to the Console page of the device. 'USBMux' option present on the page.
  5. To Switch USBMux to the Zombie side, click on the “USBMux” option in the control panel and on the respective Hotplug port. (As shown in the image below, USBMux and Hotplug1 will turn RED, meaning they are now connected to the Zombie side.)
  6. On the Console screen, click on the “Boot Media-USB” control in the control panel.
  7. USB Boot page will appear on the screen showing details of the memory card connected to the target device.
  8. There are two ways to Flash Image.
    1. Now flash an image from EBF Server.
      1. From Select file drop-down and choose "select from EBF Server".
      2. Now select the desired file to flash into the USB.
      3. From the USB drop-down menu choose the target partition.
      4. Select flashing tool as per requirement(zcat + dd/gunzip + dd/dd/bmaptool/tar/unzip/cp). If you don't select, it will be auto-selected according to the file extension of the chosen file.
      5. Give command-line argument if needed.
      6. Check the "pre-format(mkfs)" checkbox if want to format the partition before flashing an image otherwise unchecked.
      7. Check the "Delete file from EBF server after flash" check box if want to delete the file after flashing from the EBF server otherwise unchecked.
      8. Now click on the flash file button to flash the image into USB.
      9. During flash the flash status of the image should be visible on the screen.
      10. After successful image upload, select the Launch console button to start the Console session.
    2. Now flash an image Selecting Image from Local Computer.
      1. From Select file drop-down and choose "select from local computer".
      2. Now choose the desired file to flash into the USB.
      3. From the USB drop-down menu choose the target partition.
      4. Select flashing tool as per requirement(zcat + dd/gunzip + dd/dd/bmaptool/tar/unzip/cp). If you don't select, it will be auto-selected according to the file extension of the chosen file.
      5. Give command-line argument if needed.
      6. Check the "pre-format(mkfs)" checkbox if want to format the partition before flashing an image otherwise unchecked.
      7. Check the "Delete file from EBF server after flash" checkbox if want to delete the file after flashing from ebf server otherwise unchecked.
      8. Now click on the flash file button to flash the image into USB.
      9. During flash the flash status of the image should be visible on the screen.
      10. After successful image upload, select the Launch console button to start the Console session.
      11. Now Go to USB file manager and see the target partition where the file was flashed.

Image flashing using UUU

Following are the steps to flash Image using Uuu:
  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. Select the ‘All Devices’ option from the ‘Devices’ drop-down list.
  3. Go to the 'All Devices' page and launch the console of the target device.
  4. we are setting the serial download mode using the command "bmode usb" on the u-boot prompt.
  5. Launch the Boot Media SD-Card of the device from the console page.
  6. Continue without power off the device click on the Continue button on the popup menu.
  7. Setting up the tool for image flash.
    • Select a file from the local computer or EBF server.
    • Select the whole SD-card as the partition for the image flash.
    • Select uuu as the Flashing Tool for the image.
    • Pass the command line argument as -b sd bootloader (which means that uploading bootloader into sd card).
    • Now Click on Flash File to flash uuu image.
  8. Verify Before continuing make sure the device is powered up and is in Serial Download mode. if all these are verified click on the YES button.
  9. Now users can visit the console page and observe the uuu flash on the console.

How To Access webcam Live Streaming

How to view Live Streaming

  1. Download and install VLC player on your local system if not already installed.
  2. Launch VLC player and open Media > Open Network Stream... Menu
  3. On opened Media VLC popup window, go to Network tab
  4. Copy Streaming URL from APP-Zombie Status page and paste into the network URL text box of VLC.

  5. Select and click Play from the drop-down adjacent to the Cancel button.
  6. When prompted for streaming credentials, input admin/admin123

USB Web Camera Streaming

  1. Launch the console of the target device. Follow these steps to Launch Console of the concerned device
  2. Click on 'Video Streaming' option.
  3. After selecting the option, Live Streaming will start on the same page.
  4. Sometimes webcam couldn't stream the video; in that case, access the APP Zombie Config and select Re-connect Web Camera option.

How To Capture Image from webcam

  1. Launch the console of the target device. Follow these steps to Launch Console of the concerned device
  2. Click on the 'Capture Screenshot' button.
  3. Details of the captured image will be shown on the screen. Click on the 'here' link to view the last captured image.
  4. To view the list of all captured images, click on the 'Image Browser' option.

How To Hear audio from the connected mic

  1. Launch the console of the target device. Follow these steps to Launch Console of the concerned device
  2. Click on the 'Audio Streaming' button.
  3. List of all connected microphones will be shown on the screen. Chose the target audio source from the dropdown. The browser will start to stream the audio of the selected audio source.
  4. Sometimes audio source couldn't stream the audio; in that case, access the APP Zombie Config and edit the Streaming port.

How to release Device available on EBF server

Following are the steps to release device access on the EBF server:
  1. Login to EBF home page/dashboard (find the URL from administrator) through a web browser with your credentials.
    Username : <username>
    Password : <password>
  2. EBF Dashboard will appear on the screen. Select the ‘All Devices’ option from the ‘Devices’ drop-down list.
  3. ‘All Devices’ page will appear on the screen with a list of all devices on the EBF server. Here both the devices are allocated to user admin and are unavailable for use.
  4. Click on the 'Release' icon corresponding to the device which you want to release.
  5. Once clicked, the device is released from the last assigned user.

    Example: Here demo is the user to whom device bbb_demo was initially allocated for use. Once the Actions tag was selected, the device was released from the demo user.
  6. Click on the device which was released from the use by the user and on the next page, the user is prohibited from the device’s web console access.

    The above steps release the device from use.
    OR
    If the user is present on the Console page and the device is free from use, the user can release the device with the help of the “Release Device” button available on the Console page.

    The device is released and free for use for any user. The user can verify for the released device on Devices -> All Devices

Advance Features

EBF File Manager

User can list all the files that are present on the EBF Server using this interface. Follow the steps below to view this page.

  1. Login to EBF home page/dashboard (find the URL from administrator) through web browser with your credentials.
    Username : <username>
    Password : <password>
  2. EBF Dashboard will appear on the screen. Select ‘EBF File Manager’ from main menu.
  3. EBF File Manager page will be shown on the screen. All the files uploaded on to EBF Server will also be visible on this page.

EBF APIs

Refer EBF-API Guide

EBF-CLI

Refer EBF-CLI Guide

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 (bbb_demo is taken as reference) to view the Zombie worker.
  4. On the next page, select worker to view zombie worker of the selected device.
  5. select Zombie EZ-Config to view the status of zombie's in detail.
  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 (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 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.

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 zombie worker of the selected device.
  5. Select Zombie EZ-Config to view the status of zombie in detail.
  6. Click on the 'View Zombie status' icon under the 'Actions' column of the concerned Zombie.
  7. Now the user will be redirected to the Zombie login page.
  8. After successful login 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 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.

QNX OS Support

Refer EBF-QNX Guide

Appendix

How to change your login password

Following are the steps to change the password of the logged-in user:
  1. Sign in to EBF homepage/dashboard using valid credentials.
  2. Click on your username on the top and click on the 'Profile' link.
  3. User's profile details will be shown on the screen. Now click on the 'update' link.
  4. Enter the details and click on the 'Change' button to apply changes.
  5. A confirmation message is shown on the screen regarding a successful password update.

Troubleshooting

Unable to Network Boot the device

Go to device's console and perform below steps to troubleshoot the Network boot issue.
  1. Check if device's u-boot supports Network mount (nfs-mount).
    If yes, proceed to next step.
    If not, upgrade u-boot.
  2. Check if nfs-utils is installed on the device. Run the following command and observe its output:
    $ mount -t nfs ZombieIP:/directory /mnt
  3. Follow the steps below for the observed outputs.
  • nfs-utils: command not found: It means that nfs-utils is not installed on the device.
    There are 2 ways to install nfs-utils on the device:
    1. If the device supports apt-get, go to device's console and run the following command:
      $ apt-get install nfs-common
      OR
    2. Build a new BSP for the device containing nfs-utils.
  • No route to host: This can be caused by the RPC messages being filtered by either the host firewall, the client firewall, or a network switch. Verify if a firewall is active and if NFS traffic is allowed. As a quick test one can switch the firewall off by:
    $ service iptables stop
    on both the client and the server. Try mounting the NFS directory again. Do not forget to switch it back on and configure it correctly to allow NFS traffic/
  • mount clntudp_create: RPC: Port mapper failure – RPC: Unable to receive: Make sure that both the NFS service and the portmapper (RPC) service be running on both the client and the server. Check it like this:
    $ rpcinfo -p
    $ service portmap status
    $ portmap (pid 7428) is running... [portmap service is started.]
    If not, start it with the commands give below.
    $ chkconfig portmap on
    $ service portmap start