# sai-plugin

**Repository Path**: powerwind/sai-plugin

## Basic Information

- **Project Name**: sai-plugin
- **Description**: This repository contains SAI implementation for Centec Chips.
- **Primary Language**: C
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2019-06-18
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Overview
   The Switch Abstraction Interface(SAI) defines the API to provide a vendor-independent way of controlling forwarding elements, such as a switching ASIC, an NPU or a software switch in a uniform manner.

   This repository contains SAI implementation for Centec switching ASICs. Customers can configure Centec switching ASICs by SAI APIs in SONiC or other networking OS. This software release is Centec's
 contribution to the open community of its implementation of the SAI 1.4.1 as specified on the SAI Github at https://github.com/opencomputeproject/SAI,and the SAI release supports the Centec CTC8096, CTC7148 and CTC7132.

# Features
| SAI Module     | Supported   | SAI Module     | Supported   |
|----------------|-------------|----------------|-------------|
| ACL            |     Y       | Schedulergroup |     Y       |
| Buffer         |     Y       | STP            |     Y       |
| Fdb            |     Y       | Switch         |     Y       |
| Hash           |     Y       | Tunnel         |     Y       |
| HostIntf       |     Y       | UDF            |     Y       |
| Lag            |     Y       | Vlan           |     Y       |
| Mirror         |     Y       | WRED           |     Y       |
| Multicast      |     Y       | Ipmc           |     Y       |
| Neighbor       |     Y       | Ipmcgroup      |     Y       |
| Nexthop        |     Y       | L2mc           |     Y       |
| Nexthopgroup   |     Y       | L2mcgroup      |     Y       |
| Policer        |     Y       | Mcastfdb       |     Y       |
| Port           |     Y       | Rpfgroup       |     Y       |
| QoSmaps        |     Y       | Mpls           |     Y       |
| Queue          |     Y       | Warmboot       |     Y       |
| Route          |     Y       | Segmentroute   |     N       |
| Router         |     Y       | BFD            |     Planed  |
| RouterIntf     |     Y       | TAM            |     Planed  |
| Samplepacket   |     Y       | Dtel           |     Planed  |
| Scheduler      |     Y       | 
# Testing
The Centec SAI use PTF framework to do testing. The PTF Tests have more than 300 cases, include more than 250 cases from CentecNetworks, and 56 cases from official SAI project,More detail information r
efer to [PTF Tests](https://github.com/CentecNetworks/sai-plugin/wiki/PTF-Tests)

# Contact us

Website: [http://www.centecnetworks.com]<BR>
Issue tracker: [https://github.com/CentecNetworks/sai-plugin/issues]<BR>
Support email: support@centecnetworks.com<BR>
Sales email: sales@centecnetworks.com<BR>

# Release Log
## 2018-07-16
### Feauture Added:
    Support CTC7148 & CTC8096 Chips
    Support SAI 1.2.4 & V1.3
    Support Switch/Bridge/Port/Lag
    Support L2/L3
    Support L2/L3 Mcast
    Support SamplePacket/Mirror
    Support MPLS
    Support Tunnel
    Support Buffer/QosMaps/Queue/Policer/Scheduler
    Support HostInterface
    Support Warmboot
### Dependencies
 This pakage depends on Centec SDK V5.3.0

## 2019-05-09
### Feauture Added:
    Support CTC8096, CTC7148 and CTC7132
    Support SAI1.4.0
    Change from sai_{module_name}_stats_t to sai_stats_id_t
    Add support to saiisolationgroup.h
    Remove saiuburst.h
    Fix bugs
### Dependencies
 This pakage depends on Centec SDK V5.5.1RC

## 2019-05-21
### Feauture Added:
    Support SAI 1.4.1
    Fix bugs
### Dependencies
 This pakage depends on Centec SDK V5.5.1RC

# How to compile

## 1. Preparation
- This SAI plugin requires Centec SDK support, so first step, you need to get Centec SDK for your switch chip, and copy them to $SAI\_SOURCE\_DIR/ctcsdk
- To get SDK, please contect Centec.
- Prepare nessary directories: $SAI\_SOURCE\_DIR/lib/$chipname, and copy compiled libctcsdk.so to the directories.

$SAI\_SOURCE\_DIR/ctcsdk like this:

    [centec@sw1 ctcsdk]$ ls
    app  core         ctc_shell          dkits  driver     Makefile         Makefile.one_lib  sal        torvars.bat
    cfg  compile.bat  ctccli  dal        docs   libctccli  Makefile.kernel  Makefile.user     mk         script

## 2. Edit CMakeLists.txt and make
We provide a compile script called ***autoCompile.sh***, run this script and follow the prompt, you can get it.

    centec@centec-OSP:~/sai-plugin$ ./autoCompile.sh 
    Which switch chip you want to use:
    1. CTC7148
    2. CTC8096
    Your choice:2
    Please give your SDKHOME path:/home/centec/sai-plugin/ctcsdk
    Do you need to compile SDK?(yes/no)yes
    Do you want to enable warmboot feature?(yes/no)no

Or you can modify the CMakeLists.txt by yoursefl, following here:
First we need to edit $SAI\_SOURCE\_DIR/**CMakeLists.txt**, which located in this folder. With this file, cmake can generate Makefile automatically. Here we give a example, which provides a switch box with x86 CPU and Centec CTC7148(duet2) switch chip:

    SET(ARCH "board")
    SET(CHIPNAME "duet2")
    SET(SDKHOME "$SAI_SOURCE_DIR/ctcsdk/")

If you want ot enable warmboot feature, you will be need redis support,and set this 

    ADD_DEFINITIONS(-DCONFIG_DBCLIENT)

After this, let us enter folder ***build/***, and run these command:

    [centec@sw0 build]$ rm -rf *
    [centec@sw0 build]$ cmake ../

Then you can see we have ***Makefile*** now, and let us make it:

    [centec@sw0 build]$ ls
    app  centec  CMakeCache.txt  CMakeFiles  cmake_install.cmake  db  Makefile
    [centec@sw0 build]$ make   

## 3. Get your sai-plugin
Enter into lib/chipname/ folder, you can see these files here:

    [centec@sw0 duet2]$ ls 
    libctcsdk.so libdb.so.1 libsai.so.1