-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
PROD-1676 Signed-off-by: Ryan Erickson <[email protected]>
- Loading branch information
1 parent
c908ef8
commit 5e16272
Showing
1 changed file
with
12 additions
and
42 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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. |