Go to file
Emran Billah 12023866ee
Create and publish a Docker image / build-and-push-image (push) Successful in 5m28s Details
Adde xbnet as submodule
2024-09-10 16:36:32 -03:00
.copier Testing build pipeline 2024-09-10 14:10:18 -03:00
.github/workflows Adding docker build pipeline 2024-09-10 13:54:15 -03:00
scripts Refactored environment vars into docker compose instead of using env vars, working on ssh and bridging wifi to xbnet, reviewing with Giovanni 2024-09-05 10:11:34 -03:00
tests Working on automating build and deploy steps 2024-08-09 16:21:47 -03:00
xbnet@00478432eb Adde xbnet as submodule 2024-09-10 16:36:32 -03:00
.env Added production quality docker compose file with environment vars set in the docker compose file, without using env vars, updated docs, separated out run-single and run-multiple 2024-09-04 14:26:59 -03:00
.gitignore Testing env vars in docker compose 2024-09-03 10:09:03 -03:00
.gitmodules Adde xbnet as submodule 2024-09-10 16:36:32 -03:00
Dockerfile Refactored environment vars into docker compose instead of using env vars, working on ssh and bridging wifi to xbnet, reviewing with Giovanni 2024-09-05 10:11:34 -03:00
README.md Added docker run cmd to README.md for intergrating with TX2 2024-09-04 14:43:25 -03:00
docker-compose-run-multiple-dev.yml Added production quality docker compose file with environment vars set in the docker compose file, without using env vars, updated docs, separated out run-single and run-multiple 2024-09-04 14:26:59 -03:00
docker-compose-run-single-dev.yml Added production quality docker compose file with environment vars set in the docker compose file, without using env vars, updated docs, separated out run-single and run-multiple 2024-09-04 14:26:59 -03:00
docker-compose.yml Fixed small errors 2024-09-06 17:07:40 -03:00
run-single.sh Testing env vars in docker compose 2024-09-03 10:09:03 -03:00

README.md

This repo is currently a work in progress

  • The README.md will be fully updated once the repo is in a stable state

TODO

  • Need to automate Rust project (xbnet)
    • Configure (looks good)
    • Build
    • Deploy
      • On Ubuntu for testing
      • On Linux for Tegra for TX2
      • On Jetson Orin
  • Working on setup_host_device.sh
    • Issues with bridging interfaces
  • Need to add setup_end_device.sh
  • Need to dockerize service
  • Possibly may need to bridge docker xbnet network with local wifi interface as well
  • Make a submodule of xbnet, or copy over raw files, depending on future decisions

   

SERVICES-XBEE_NET

This project contains a Dockerized setup to create and manage an XBee network using the xbnet utility. The network interface is bridged with a host Wi-Fi interface, enabling internet access for connected devices.

Note: This project uses the tap xbnet protocol, which is a layer 2 protocol. This supports full ethernet pipeline. For a simple IP level protocol support, the tun xbnet protocol can be used.

File Structure

services-xbee_net/
├── scripts/
│   ├── entrypoint.sh                   # Entrypoint script for Docker container
│   ├── get_connected_wifi_info.sh      # Script to fetch connected Wi-Fi device information
│   ├── health_check.sh                 # Script to perform health checks on the container
|   ├── debug/                          # Directory for testing-related scripts and files|   ├── create_tap_device.sh        # Create a tap device directly on an OS |   ├── destroy_tap_device.sh       # Destroy a tap device directly on an OS |   ├── enable_host_macvlan.sh      # Destroy a tap device directly on an OS |   ├── host_setup.sh               # Script to set up Masquerade bridge docker0 network with active wifi |   ├── test.sh                     # Script to run tests
├── tests/                              # Directory for testing-related scripts and files
├── xbnet/                              # The xbnet source code directory
├── .env                                # Environment variables for the Docker setup
├── .gitignore                          # Git ignore file
├── docker-compose-run-multiple.yml     # Docker Compose file to run multiple instances
├── docker-compose.yml                  # Main Docker Compose file
├── Dockerfile                          # Dockerfile to build the Docker image
├── README.md                           # Project documentation
└── run-single.sh                       # Script to set up env vars and start a docker service with a single xbnet node

Prerequisites

Ensure Docker and Docker Compose are installed on your machine.

Getting Started

1. Clone the Repository

git clone https://git.spirirobotics.com/Spiri/services-xbee_net
cd services-xbee_net

2. To run the project in PRODUCTION mode, use the following cmd:

  • docker-compose -f docker-compose.yml up --build

  • Configure the project for user specs, modify the docker-compose.yml file for the following parameters:

    environment:
        - XBEE_INDEX=1
        - XBEE_BAUDRATE=230400
        - XBEE_PORT=/dev/ttyUSB0
        - XBNET_BASE_SUBNET=2.2.2
        - XBNET_INTERFACE_TYPE=router     # ["router" | "gateway"]
        - XBNET_PROTO=tap                 # ["tap" | "tun"]
    
  • This can also be run using the docker run cmd shown below.

    docker run -d --name xbnet_node \
        --privileged \
        -e XBEE_INDEX=1 \
        -e XBEE_BAUDRATE=230400 \
        -e XBEE_PORT=/dev/ttyUSB0 \
        -e XBNET_BASE_SUBNET=2.2.2 \
        -e XBNET_INTERFACE_TYPE=router \
        -e XBNET_PROTO=tap \
        xbnet_node bash /entrypoint.sh
    

3. To run a single xbnet node in DEVELOPEMENT mode, use the following cmd:

  • Router mode: sh ./run-single.sh --subnet=7.7.7 --serial-speed=230400 --port=/dev/ttyUSB0 --interface-type=router
  • Gateway mode: sh ./run-single.sh --subnet=7.7.7 --serial-speed=230400 --port=/dev/ttyUSB0 --interface-type=gateway

OR Manually build and Start the Docker Container

NOTE: This will require the config .env to be manually modified, based on user needs.

  • Configure a single xbnet net service using:

    # Configuration for xbnet0
    XBEE_PORT=/dev/ttyUSB0
    XBEE_BAUDRATE=230400
    XBEE_NET_SRC_IP=192.168.1.100   # Ensure this IP matches the network range
    XBEE_NET_IFACE_NAME=xbnet0
    
    # Default Gateway
    DEFAULT_GATEWAY=192.168.1.1
    

4. To run a multiple xbnet nodes in DEVELOPEMENT mode, use the following cmd:

  • Router 1: sh ./run-multiple.sh --index=1 --subnet=7.7.7 --serial-speed=230400 --port=/dev/ttyUSB0 --interface-type=router
  • Router 2: sh ./run-multiple.sh --index=2 --subnet=7.7.7 --serial-speed=230400 --port=/dev/ttyUSB0 --interface-type=router
  • Gateway: sh ./run-multiple.sh --subnet=7.7.7 --serial-speed=230400 --port=/dev/ttyUSB0 --interface-type=gateway

NOTE: This will require the config .env to be manually modified, based on user needs.

  • Configure multiple xbnet net services using:

    # Configuration for xbnet0 (REQUIRED: minimum config to run a single xbnet node)
    XBEE0_PORT=/dev/ttyUSB0               # The serial port for the XBee device
    XBEE0_BAUDRATE=230400                 # Baud rate for the XBee device
    XBEE0_NET_SRC_IP=192.168.1.100        # Source IP for the XBee network
    XBEE0_NET_IFACE_NAME=xbnet0           # Interface name for the XBee network
    
    # Configuration for xbnet1 (OPTIONAL: only required for multi node xbnets)
    XBEE1_PORT=/dev/ttyUSB1
    XBEE1_BAUDRATE=230400
    XBEE1_NET_SRC_IP=192.168.1.101
    XBEE1_NET_IFACE_NAME=xbnet1
    
    # Default Gateway (REQUIRED: part of minimum concifg to run a single xbnet node)
    DEFAULT_GATEWAY=192.168.1.1
    

This will build the Docker image and start the container with the XBee network and the required setup.

5. Health Check and Container Management

The container includes a health check that pings the XBee network interface to ensure it is functioning properly.
The container is configured to restart automatically if the health check fails.

6. Troubleshooting

Ensure the XBee devices are connected to the correct serial ports.
Verify the network interfaces using ip a inside the container.
The container logs can be viewed using:

docker logs xbee_node