Skip to content

Commit

Permalink
Update the readme
Browse files Browse the repository at this point in the history
PROD-1676

Signed-off-by: Ryan Erickson <[email protected]>
  • Loading branch information
rerickson1 committed Nov 14, 2023
1 parent c908ef8 commit 5e16272
Showing 1 changed file with 12 additions and 42 deletions.
54 changes: 12 additions & 42 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,59 +1,29 @@
# Vela IF820 EZ-Serial Host
# Vela IF820 Firmware

This repository contains samples and tests that demonstrate how a host can control the Vela IF820 module using the EZ-Serial API and serial protocol.

## Prerequisites

- A host with Python 3.x installed
- IF820 DVK(s)
- BT900 DVK(s) - Only for samples or tests involving the BT900
- Install Python 3.9 to 3.11. Python 3.12 is not supported.
- One or two IF820 DVKs. The second DVK is only required for samples and tests requiring two DVKs.
- One BT900 DVK - Only for samples or tests involving the BT900

## Setup

### Python Samples

Before running any samples, be sure to install the Python dependencies:
### Checkout the Firmware

```
pip3 install --user -r requirements.txt
git clone --recurse-submodules https://github.com/LairdCP/Vela_IF820_Firmware.git
```

All python samples require command line arguments to at least specify the serial port to use. For example:
### Python Samples and Tests

Before running any samples or tests, be sure to install the Python dependencies:

```
python3 sample_ping.py -c COM3
pip3 install -r requirements.txt
```

### Robot Tests

It is recommended to use [Visual Studio Code (VS Code)](https://code.visualstudio.com/) for easy Robot Framework setup and for running the tests.

First install the following extensions for VS Code:

1. [Robocorp Code](https://marketplace.visualstudio.com/items?itemName=robocorp.robocorp-code)
2. [Robot Framework Language Server](https://marketplace.visualstudio.com/items?itemName=robocorp.robotframework-lsp)

Lastly, open the repository folder with VS Code or open the [workspace](if820_ezserial.code-workspace).

Once opened, VS Code will automatically setup Robot Framework and its dependencies. It can take a few minutes for this to complete.

## Running Tests

The first step before running the robot tests is to create a .vscode/settings.json file. To create the file copy and rename [.vscode/example_settings.json](.vscode/example_settings.json) to `.vscode/settings.json`.

The settings.json file is used to configure the COM ports and other settings used to communicate with the dev boards. This allows custom configuration without the need to change the robot test files.

If running tests that only require one IF820 device, set the COM port setting for the device1 (`comport_IF820_device1`). All tests that run and test a single IF820 device will use the device1 COM port setting.

The [tests/robot.yaml](tests/robot.yaml) file specifies all tests that can be run. Using the VS Code extension, you can run or debug the tests.

![Robot Tests](docs/images/robot_tests.png)
_Robot Tests_

## BT900 Setup
## Documentation

1. Install UWFlashX from here (non-ssl version): https://github.com/LairdCP/UwFlashX/releases
2. Download the latest BT900 firmware from here: https://www.lairdconnect.com/documentation/firmware-version-911214zip-0
3. Use these instructions to program the firmware on the BT900: https://github.com/LairdCP/UwFlashX/wiki/Upgrading-BT900-firmware
4. Download the BT900 command manager (cmd.manager.sb) sample app from here: https://github.com/LairdCP/BT900-Applications
5. Use these instructions to run the command manager sample app on the BT900: https://www.lairdconnect.com/documentation/application-note-multiple-concurrent-spp-and-vsp-connections-command-managerpdf
Please see the [Vela IF820 Software User Guide](https://lairdcp.github.io/guides/vela_if820_user_guide/1.0/introduction.html) for all documentation.

0 comments on commit 5e16272

Please sign in to comment.