Skip to content

Latest commit

 

History

History
243 lines (167 loc) · 5.97 KB

README.md

File metadata and controls

243 lines (167 loc) · 5.97 KB
Raw

OSFV CLI

This script allows you to interact with devices setup in the Dasharo OSFV lab. You can use this script to retrieve information about assets, list used and unused assets, check out and check in assets, control power of the devices, flash firmware, and more.

This script is specific to the OSFV environment and Snipe-IT configuration, and as such, may not fit for other needs.

Installation

  1. Clone the repository to your local machine:

    git clone https://github.com/dasharo/osfv-scripts.git

  2. Create virtual environment and activate it:

    virtualenv venv
    source venv/bin/activate

  3. Navigate to the cloned repository:

    cd osfv-scripts/osfv_cli

  4. Install poetry:

    pip install poetry

  5. Build and install utility:

    make install

Usage

If you do not wish to use Snipe-IT, you can manually provide your device model name to the script via the --model parameter.

Customize the configuration

The ~/.osfv/snipeit.yml should be created automatically upon installing the utility as shown above.

  • Open ~/.osfv/snipeit.yml and provide your Snipe-IT API URL, API token, and user ID
    • api_url - typically should be left unchanged, please make sure you have correct DNS configuration or entry in /etc/hosts,
    • api_token - login to Snipe-IT, click on user icon, choose Manage API Keys, click Create New Token, use name osfv-scripts, use generated API token in config file
    • user_id is your Snipe-IT user id, which can be found by going to http://snipeit/users and showing column ID

To use the script, you can run it with different commands and options. The full list of commands and description of arguments is in the help message. Here are just some examples.

snipeit command

  • List all used assets:

    osfv_cli snipeit list_used

  • List all unused assets:

    osfv_cli snipeit list_unused

  • List all assets:

    osfv_cli snipeit list_all

  • Check out an asset (by asset ID):

    osfv_cli snipeit check_out --asset_id 123

  • Check in an asset (by asset ID):

    osfv_cli snipeit check_in --asset_id 123

  • Check out an asset (by RTE IP):

    osfv_cli snipeit check_out --rte_ip <rte_ip_address>

  • Check out an asset (by RTE IP):

    osfv_cli snipeit check_out --rte_ip <rte_ip_address>

  • Check in all your assets:

    osfv_cli snipeit check_in_my

    Replace <rte_ip_address> with the actual RTE IP address of the asset you want to check out. The script will identify the asset based on the RTE IP and perform the check-out process. Please note that the RTE IP should match the value stored in the asset's custom field named "RTE IP".

  • For more command options, you can use the --help flag.

sonoff command

  • Get Sonoff state:

    osfv_cli sonoff --sonoff_ip <sonoff_ip_address> get

  • Set Sonoff state to ON:

    osfv_cli sonoff --sonoff_ip <sonoff_ip_address> on

  • Set Sonoff state to OFF:

    osfv_cli sonoff --sonoff_ip <sonoff_ip_address> off

  • Toggle Sonoff state:

    osfv_cli sonoff --sonoff_ip <sonoff_ip_address> tgl

    Replace <sonoff_ip_address> with the IP address of correct Sonoff. You may also use --rte_ip instead, and Sonoff IP will be retrieved from Snipe-IT if found.

rte command

  • Toggle relay state:

    osfv_cli rte --rte_ip <rte_ip_address> rel tgl

  • Power on the platform (push power button)

    osfv_cli rte --rte_ip <rte_ip_address> pwr on

  • List state of controllable GPIOs:

    osfv_cli rte --rte_ip <rte_ip_address> gpio list

  • Enable SPI lines:

    osfv_cli rte --rte_ip <rte_ip_address> spi on

  • Connect to DUT serial port connected to RTE via telnet:

    osfv_cli rte --rte_ip <rte_ip_address> serial

  • Flash DUT with given firmware file:

    flash commands already take care of getting the platform in the correct power state, and setting correct flashing parameters for certain device model, as defined in the config files in osfv_cli/models

    osfv_cli rte --rte_ip <rte_ip_address> flash write --rom <path_to_fw_file>

    Replace <rte_ip_address> with the actual RTE IP address connected with the DUT.

Adding new platform configs

Platform configs hold information on power management, flash chip parameters, and whether CMOS needs to be reset after flashing. All currently available platform configs are located in the models directory. If you wish to expand the list, you can place your MODEL.yml with corresponding settings in the directory, following other configs' syntax. Available parameters are as follows:

  • flash_chip:

    • model - optional, needs to be set if flashrom detects more than one possible flash chip model - in other words, the -c parameter you use in flashrom.
    • voltage - required; chip supply voltage - most often "3.3V" or "1.8V"; should be discovered in appropriate datasheet.

  • programmer:

    • name- required; name of the programmer connected to the platform; supported values: rte_1_0, rte_1_1, ch341a

  • pwr_ctrl:

    • sonoff - required; true or false, whether you use sonoff power control.
    • relay - required; true or false, whether you use onboard RTE relay power control.
    • flashing_power_state - required; defines a power state the platform needs to be in for SPI flashing; supported values: "S5", "G3"

  • reset_cmos: - optional; true or false (false by default), whether CMOS reset is required after flashing.

  • disable_wp: - optional; true or false (false by default), whether flash WP is required before flashing.

Development

You can test local changes by running poetry shell first. Then, all osfv_cli calls will use the local files in repository, not installed package.