### Run BGP Router Example

Source: https://github.com/mc36/freertr/blob/master/readme.md

Starts a BGP routing example and connects to its control interfaces. This is part of the initial setup for testing routing protocols.

```shell
./tw.sh rout-bgp001
telnet 127.0.0.1 20001
telnet 127.0.0.1 20002
telnet 127.0.0.1 20003
telnet 127.0.0.1 20004
```

--------------------------------

### Compile and Run P4 Dataplane Example

Source: https://github.com/mc36/freertr/blob/master/readme.md

Compiles the project, sets up a P4-based dataplane, and starts a router configuration. This is used for testing with P4 programmable dataplanes.

```shell
./c.sh
./cn.sh
./twd.sh p4lang-rout001
telnet 127.0.0.1 20001
telnet 127.0.0.1 20003
telnet 127.0.0.1 20004
telnet 127.0.0.1 20005
telnet 127.0.0.1 20006
```

--------------------------------

### Cisco IOS XR: Initial Setup and Installation

Source: https://github.com/mc36/freertr/blob/master/misc/image/deploy.txt

Commands for configuring hardware settings, copying the OVA, and installing the virtual service on Cisco IOS XR.

```cisco-xr
!!! set platform hardware rom-monitor virtualization rp active
!!! set platform hardware rom-monitor virtualization rp standby
copy http://dl.nop.hu/rtr-x86_64.ova harddisk:rtr-x86_64.ova
conf t
virtual-service
signing level unsigned
end
virtual-service install name rtr package harddisk:rtr-x86_64.ova media harddisk:
show virtual-service list
!!! wait until status changes to installed
```

--------------------------------

### Install Nix

Source: https://github.com/mc36/freertr/blob/master/misc/p4bf/profiles/optimize.txt

Installs Nix as a regular user. Log out and back in after execution.

```bash
$ bash <(curl -L https://nixos.org/nix/install) --daemon </dev/null
```

--------------------------------

### Install P4XDP on OpenWrt Device

Source: https://github.com/mc36/freertr/blob/master/misc/openwrt-p4xdp/depoly.txt

Commands to install P4XDP and its dependencies on the target OpenWrt device. Ensure the 'gre' package is installed first.

```bash
apk add  gre
apk add --allow-untrusted  p4xdp*
```

--------------------------------

### Installing P4Emu on the OpenWrt Device

Source: https://github.com/mc36/freertr/blob/master/misc/openwrt-p4emu/depoly.txt

Commands to install the gre module and the P4Emu package on the target OpenWrt device.

```bash
apk add gre
apk add --allow-untrusted p4emu*
```

--------------------------------

### system.DMAstart

Source: https://github.com/mc36/freertr/blob/master/misc/vm/vm.html

Starts a specified DMA channel with given parameters for transfer.

```APIDOC
## system.DMAstart

### Description
Starts a DMA channel with specified parameters for data transfer.

### Parameters
- **w** (word) - The DMA channel number to start
- **d** (dword) - The physical address for the transfer
- **a** (dword) - The count of bytes to transfer
- **c** (word) - The mode for the DMA transfer:
  - 0: demand mode
  - 1: single mode
  - 2: block mode
  - 3: cascade mode
  - 00h: verify mode
  - 10h: card to memory
  - 20h: memory to card
```

--------------------------------

### VirtualBox Deployment Commands

Source: https://github.com/mc36/freertr/blob/master/misc/image/deploy.txt

Commands to import, start, connect to, and power off an RTR virtual machine in VirtualBox.

```bash
vboxmanage import rtr-x86_64.ova
vboxmanage startvm rtr-dsk --type headless
socat - unix-connect:/tmp/rtr-dsk
vboxmanage controlvm rtr poweroff
```

--------------------------------

### Cross-compiling P4Emu on OpenWrt

Source: https://github.com/mc36/freertr/blob/master/misc/openwrt-p4emu/depoly.txt

Steps to set up the OpenWrt build environment, install P4Emu, and compile the package for cross-deployment.

```bash
tar xvf openwrt-sdk*
cd openwrt*
./scripts/feeds update -a
./scripts/feeds install -a
mkdir package/p4emu
ln -s ../../package/p4emu feeds/base/p4emu
cp -r ../misc/native package/p4emu/
cp ../misc/openwrt-p4emu/* package/p4emu/
make package/p4emu/compile
ARCH=`ls bin/packages/`
mv bin/packages/$ARCH/base/* ../$ARCH-
```

--------------------------------

### QEMU Deployment Commands

Source: https://github.com/mc36/freertr/blob/master/misc/image/deploy.txt

Commands to extract an OVA image and start an RTR virtual machine using QEMU.

```bash
tar xvf rtr-x86_64.ova
qemu-system-x86_64 -enable-kvm -m 1024 -netdev user,id=a1 -device virtio-net-pci,netdev=a1 -no-reboot -monitor none -serial stdio -nographic -hda rtr-x86_64.qcow2
```