Merge pull request #1692 from OPAE/aravuri/spec_rn

update opae2.0 spec file & release note
OFS · Sep 18, 2020 · dc237b9 · dc237b9
2 parents 82c344c + 9fdc830
commit dc237b9
Show file tree

Hide file tree

Showing 3 changed files with 138 additions and 27 deletions.
diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
@@ -2,7 +2,7 @@ Open Programmable Acceleration Engine (OPAE) is a software framework for managin
 
 -   OPAE Software Development Kit (OPAE SDK),
 
--   OPAE Linux driver for Intel(R) Xeon(R) CPU with Integrated FPGAs and Intel(R) PAC with Arria(R) 10 GX FPGA
+-   OPAE Linux DFL driver for Intel® FPGA Programmable Acceleration Card
 
 -   Basic Building Block (BBB) library for accelerating AFU
     development (not part of this release, but pre-release code is
@@ -17,22 +17,70 @@ OPAE\'s goal is to accelerate FPGA adoption. It is a community effort to simplif
 More information about OPAE can be found
 at http://01.org/OPAE.
 
-Open Programmable Acceleration Engine (OPAE) 1.4.0 Release Notes
------------------------------------------------------------------
 
-This document provides the Release Notes for the Open Programmable
-Acceleration Engine (OPAE) 1.4.0 release.
+
+Open Programmable Acceleration Engine (OPAE) 2.0.0 Release Notes
+----------------------------------------------------------------------------------------------------------------------
+
+OPAE 2.0.0 release provides SDK, tools, and Linux kernel driver.  The main feature of this release is to support Intel®  FPGA Programmable Acceleration Card N3000 series.
 
 System Compatibility
 --------------------
+-   Hardware: Tightly coupled FPGA products and programmable FPGA  acceleration cards for Intel(R) Xeon(R) processors:
+- IntelÂ® FPGA Programmable Acceleration Card N3000-2 Production Release
+- IntelÂ® FPGA Programmable Acceleration Card N3000-V Production Release
+- IntelÂ® FPGA Programmable Acceleration Card N3000-3 Production Release
+
+
+Major Changes from 1.4.1 to 2.0.0
+---------------------------------
+- Added support to FPGA Linux kernel Device Feature List (DFL) driver.
+- Added support to PAC card N3000 series.
+- Added PACSign, bitstream_info, fpgasudpate, rsu, fpgaotsu, fpgaport  python tools.
+- Added ethernet tools for PAC card N3000.
+- Various bug fixes
+- Various Static code scan bug fixes
+- Added python3 support.
+- OPAE USMG API are deprecated.
+- Updated OPAE documentation.   
+
+-   Operating System: Tested on Fedora 31 with Linux Kernel 5.8 version.
+
+Source Code:
+------------
+-   FPGA DFL Linux driver source code:  tag  2.0.0-1
+- https://github.com/OPAE/linux-dfl/tree/fpga-upstream-dev-5.8.0
+
+-   SDK and tools source code:  tag 2.0.0-1
+- https://github.com/OPAE/opae-sdk/tree/release/2.0.0
+- https://github.com/OPAE/opae-libs/tree/release/2.0.0
+- https://github.com/OPAE/opae-legacy/tree/release/2.0.0
+- https://github.com/OPAE/opae-sim/tree/release/2.0.0
+- https://github.com/OPAE/opae-test/tree/release/2.0.0
+
+Notes/Known Issues
+------------------
+- FPGA DFL kernel driver upstreaming to Linux kernel is on going
+- OPAE 2.0 is not compatible with Intel previous production FPGA driver.
+
+
+Major Changes from 1.4.0 to 2.0.0
+----------------------------------
+
+- Added support to FPGA Linux kernel Device Feature List (DFL) driver patch set3,set4 and set5.
+- Added support to both PAC card N3000 & D5005 cards.
+- Added pacsingn, bitstreaminfo, fpgasudpate, rsu  python tools.
+- Added ethernet tools for PAC card N3000.
+- Various bug fixes
+- Various memory leak fixes
+- Various Static code scan bug fixes
+
+- OPAE 2.0.0 tested on Fedora 31  with Linux Kernel 5.8 version.
+
+- FPGA DFL Linux driver source code available in Linux 5.8 kernel
+   - https://github.com/OPAE/linux-dfl/tree/fpga-upstream-dev-5.8.0
 
--   Hardware: tightly coupled FPGA products and programmable FPGA
-    acceleration cards for Intel(R) Xeon(R) processors:
-    - Intel(R) PAC with Arria(R) 10 GX FPGA (PCI ID: 0x09c4) FIM version 1.1.2-1 (1.2 Production)
-    - Intel(R) Xeon with Integrated FPGA (PCI ID: 0xbcc0) FIM version 6.4.0
-    - Intel® FPGA Programmable Acceleration Card N3000 (PCI ID: 0x0b30) FIM version D.1.0.13 (1.0 Production)
 
--   Operating System: Tested on RedHat 7.6, CentOS 7.6  with Linux Kernel 3.10 and the community 4.19 LTS kernels.
 
 Major Changes from 1.3.0 to 1.4.0
 ----------------------------------

diff --git a/opae.spec b/opae.spec
@@ -1,6 +1,6 @@
 Summary:        Open Programmable Acceleration Engine (OPAE) SDK
 Name:           opae
-Version:        1.4.0
+Version:        2.0.0
 Release:        1%{?dist}
 License:        BSD
 ExclusiveArch:  x86_64
@@ -28,6 +28,7 @@ BuildRequires:  tbb-devel
 BuildRequires:  git
 BuildRequires:  python3-pip
 BuildRequires:  python3-virtualenv
+BuildRequires:  systemd-rpm-macros
 
 %description
 Open Programmable Acceleration Engine (OPAE) is a software framework
@@ -64,7 +65,7 @@ rm -rf _build
 mkdir _build
 cd _build
 
-%cmake .. -DCMAKE_INSTALL_PREFIX=/usr -B $PWD
+%cmake .. -DCMAKE_INSTALL_PREFIX=/usr  -DOPAE_PRESERVE_REPOS=ON -DOPAE_BUILD_LEGACY=ON -B $PWD
 
 %make_build  opae-c \
          bitstream \
@@ -90,7 +91,10 @@ cd _build
          nlb0\
          nlb3\
          nlb7\
-         mmlink 
+         mmlink\
+         fpgad\
+         fpgad-api\
+         fpgad-vc\
 
 
 %install
@@ -157,7 +161,9 @@ DESTDIR=%{buildroot}  cmake -DCOMPONENT=opaecxxutils -P cmake_install.cmake
 DESTDIR=%{buildroot}  cmake -DCOMPONENT=opaecxxnlb -P cmake_install.cmake
 DESTDIR=%{buildroot}  cmake -DCOMPONENT=toolfpgadiagapps -P cmake_install.cmake
 DESTDIR=%{buildroot}  cmake -DCOMPONENT=toolfpgadiag -P cmake_install.cmake
-
+DESTDIR=%{buildroot}  cmake -DCOMPONENT=toolfpgad -P cmake_install.cmake
+DESTDIR=%{buildroot}  cmake -DCOMPONENT=toolfpgad_api -P cmake_install.cmake
+DESTDIR=%{buildroot}  cmake -DCOMPONENT=toolfpgad_vc -P cmake_install.cmake
 
 prev=$PWD
 pushd %{_topdir}/BUILD/opae/python/opae.admin/
@@ -168,26 +174,35 @@ pushd %{_topdir}/BUILD/opae/python/pacsign
 %{__python3} setup.py install --single-version-externally-managed --root=%{buildroot} --record=$prev/INSTALLED_PACSIGN_FILES
 popd
 
-pushd %{_topdir}/BUILD/opae/tools/extra/fpgadiag/
-%{__python3} setup.py install --single-version-externally-managed --root=%{buildroot} --record=$prev/INSTALLED_FPGADIAG_FILES
+pushd %{_topdir}/BUILD/opae/scripts
+install -m 755 eth_group_mdev.sh %{buildroot}/usr/bin/eth_group_mdev.sh
 popd
 
+%post
+%systemd_post fpgad.service
+
+%preun
+%systemd_preun fpgad.service
+
+%postun
+%systemd_postun_with_restart fpgad.service
+
 %files
 %dir %{_datadir}/opae
 %doc %{_datadir}/opae/RELEASE_NOTES.md
 %license %{_datadir}/opae/LICENSE
 %license %{_datadir}/opae/COPYING
 
 %{_libdir}/libopae-c.so.%{version}
-%{_libdir}/libopae-c.so.1
+%{_libdir}/libopae-c.so.2
 %{_libdir}/libbitstream.so.%{version}
-%{_libdir}/libbitstream.so.1
+%{_libdir}/libbitstream.so.2
 %{_libdir}/libopae-cxx-core.so.%{version}
-%{_libdir}/libopae-cxx-core.so.1
+%{_libdir}/libopae-cxx-core.so.2
 %{_libdir}/libopae-c++-utils.so.%{version}
-%{_libdir}/libopae-c++-utils.so.1
+%{_libdir}/libopae-c++-utils.so.2
 %{_libdir}/libopae-c++-nlb.so.%{version}
-%{_libdir}/libopae-c++-nlb.so.1
+%{_libdir}/libopae-c++-nlb.so.2
 
 
 %files devel
@@ -248,14 +263,36 @@ popd
 %{_bindir}/fpga_dma_N3000_test
 %{_bindir}/fpga_dma_test
 %{_bindir}/PACSign
+%{_bindir}/fpgad
+/etc/opae/fpgad.cfg
+/etc/sysconfig/fpgad.conf
+%{_libdir}/libfpgad-api.so*
+%{_libdir}/opae/libfpgad-vc.so*
+/usr/lib/systemd/system/fpgad.service
+%{_bindir}/eth_group_mdev.sh
+
 
 %{_usr}/share/opae/*
 /usr/lib/python*
 %{_datadir}/doc/opae.admin/LICENSE
-%{_libdir}/python*
+
 
 
 %changelog
+* Thu Sep 17 2020  Ananda Ravuri <ananda.ravuri@intel.com> 2.0.0-1
+- Various Static code scan bug fixes
+- Added support to FPGA Linux kernel Device Feature List (DFL) driver.
+- Added support to PAC card N3000 series.
+- Added PACSign, bitstream_info, fpgasudpate, rsu, fpgaotsu, fpgaport  python tools.
+- Added ethernet tools for PAC card N3000.
+- Various bug fixes
+- Various memory leak fixes.
+- Various Static code scan bug fixes
+- Added python3 support.
+- OPAE USMG API are deprecated.
+- Updated OPAE documentation.  
+
+
 * Tue Dec 17 2019 Korde Nakul <nakul.korde@intel.com> 1.4.0-1
 - Added support to FPGA Linux kernel Device Feature List (DFL) driver patch set2.
 - Increased test cases and test coverage

diff --git a/scripts/create-rpms.sh b/scripts/create-rpms.sh
@@ -22,6 +22,13 @@ BUILD_DIR=${PWD}
 
 echo ${PWD}
 
+cd .. 
+rm -rf _build
+mkdir _build
+cd _build
+cmake .. -DOPAE_BUILD_LEGACY=ON  -DOPAE_BUILD_TESTS=ON
+
+
 cd ../..
 tar --transform='s/opae-sdk/opae/' \
   --exclude=.git \
@@ -31,21 +38,40 @@ tar --transform='s/opae-sdk/opae/' \
   --exclude=opae.spec.in \
   --exclude=opae.spec \
   --exclude=opae-libs/external \
-  --exclude=opae-libs/tests \
   --exclude=opae-libs/plugins/ase \
   --exclude=opae-libs/cmake/config/libopae-all.spec.in \
   --exclude=opae-libs/cmake/config/run_coverage_test.sh.in \
   --exclude=opae-libs/cmake/config/run_coverage_test_local.sh.in\
-  --exclude=external \
+  --exclude=external/opae-legacy/tests \
+  --exclude=external/opae-legacy/scripts \
+  --exclude=external/opae-legacy/tools/coreidle \
+  --exclude=external/opae-legacy/tools/hssi \
   --exclude=platforms \
   --exclude=samples/base \
   --exclude=samples/hello_afu \
   --exclude=samples/dummy_afu \
   --exclude=samples/hello_mpf_afu \
   --exclude=samples/intg_xeon_nlb \
   --exclude=samples/base \
-  --exclude=scripts \
-  --exclude=tests \
+  --exclude=scripts/build-documentation.sh \
+  --exclude=scripts/build-pypi.sh \
+  --exclude=scripts/build-tests-default.sh \
+  --exclude=scripts/coverage-gtapi-mock-drv.sh  \
+  --exclude=scripts/cover-ase.sh  \
+  --exclude=scripts/cover-py.sh  \
+  --exclude=scripts/cover.sh \
+  --exclude=scripts/create-rpms.sh \
+  --exclude=scripts/docker_rpm.sh \
+  --exclude=scripts/index_generator.py \
+  --exclude=scripts/test-build.sh \
+  --exclude=scripts/test-codingstyle-all.sh \
+  --exclude=scripts/test-codingstyle-cpp.sh \
+  --exclude=scripts/test-gtapi-mock-drv.sh \
+  --exclude=scripts/unit-tests.sh \
+  --exclude=scripts/valgrind \
+  --exclude=scripts/.gitignore \
+  --exclude=scripts/bat \
+  --exclude=scripts/push-documentation.sh \
   --exclude=tools/extra/ras \
   --exclude=tools/extra/pac_hssi_config \
   --exclude=tools/extra/pyfpgadiag \