doc: add crosscompile_with_multiarch #24629

Kumataro · 2023-12-01T10:46:30Z

Add cross compile tutorial for ubuntu/debian.
( I'm sorry to my poor English. )

Pull Request Readiness Checklist

See details at https://github.com/opencv/opencv/wiki/How_to_contribute#making-a-good-pull-request

I agree to contribute to the project under Apache 2 License.
To the best of my knowledge, the proposed patch is not based on a code under GPL or another license that is incompatible with OpenCV
The PR is proposed to the proper branch
There is a reference to the original bug report and related work
There is accuracy test, performance test and test data in opencv_extra repository, if applicable
Patch to opencv_extra has the same branch name.
The feature is well documented and sample code can be built with the project CMake

asmorkalov

Sounds great! Very useful tutorial. Also it'll be very useful, if you mention Jetson or Raspbery Pi and how to select proper host system for cross build. jetson OS is based on Ubuntu and Pi os is Debian based.

doc/tutorials/introduction/crosscompilation/crosscompile_with_multiarch.markdown

asmorkalov · 2023-12-01T11:17:45Z

doc/tutorials/introduction/crosscompilation/crosscompile_with_multiarch.markdown

+
+cmake      --build   build4-full_armhf
+sudo cmake --install build4-full_armhf
+```


As the last step please describe execution on cross-compilation target: you need to install the same versions of 3rdparty packages, etc.

I agree with you, I will note section tomorrow, thank you very much !

I separate (a) install external libraries, and (b) install opencv which is cross-compile. And I added warning comment that libraries version between compiling and running should be same. Thank you !!

doc/tutorials/introduction/crosscompilation/crosscompile_with_multiarch.markdown

dkurt · 2023-12-01T12:21:37Z

doc/tutorials/introduction/crosscompilation/crosscompile_with_multiarch.markdown

+```
+[Host]
+$ sudo dpkg  --add-architecture arm64
+$ sudo dpkg  --add-architecture armhf


There is a mix of terminal snippets - starting with $ and without. Prefer avoid $ as documentation does not support copy-to-clipboard option.

I was worried about how to distinguish between lines input by the user and lines output by the program. So I added a $ sign to the beginning of each line.

However, it becomes a problem when copying and pasting. These have been removed.

[Host] and [Target] to indicate the execution environment also seem to get in the way... I think I'll remove this tomorrow too. Thank you !

Yes, I fixed them. In recent document I think it is suitable to copy and paste ! Thank you for your point!

Maybe something like this?

Step3) Update dpkg setting

Update dpkg settings to support foreign architectures.

Execute dpkg --add-architecture with a target architecture:

sudo dpkg --add-architecture arm64 sudo dpkg --add-architecture armhf

And the following comand shows what foreign architectures are supported.

sudo dpkg --print-architecture

arm64 armhf

Yes, I split bach script and its result, thank you for your suggestion.

(It was also used for ldd command to detect dependency section.)

Kumataro · 2023-12-02T06:34:26Z

Most of the renovations have been completed, but the remaining parts will take a little more time. This is an interim report.

Executing cross compiling with FFmpeg libraries is succeeded.
Enabling python binding is failed.

I wanted to use the python3-numpy package provided by apt package manager(same as x86-64 host).
But python3-numpy:arm64 requires python3-minimum:arm64.
It seems to conflict with python3-minimum:amd64 on host.

Maybe, numpy should be installed with pip.

Kumataro · 2023-12-03T06:46:20Z

I believe that I have been fixed all points and applied suggestions.

Thank you very much !!

I believe this tutorial is very helpful to challenge cross-compile.

Kumataro · 2023-12-04T20:16:27Z

Test is not passed, however it may be misjudge I think.

https://pullrequest.opencv.org/buildbot/builders/precommit_windows64/builds/103670/steps/test_videoio/logs/tests%20summary

doc/tutorials/introduction/crosscompilation/crosscompile_with_multiarch.markdown

- Installing runtime packages instead of dev packages in target. - Add warning for apt package naming. - Add command to confirm python3 wrapper.

asmorkalov

Great job! 👍

Kumataro · 2023-12-11T20:20:52Z

Thank you very much for fixing many problems that I missed !!

dkurt · 2023-12-13T09:51:21Z

doc/tutorials/introduction/crosscompilation/crosscompile_with_multiarch.markdown

+
+@code{.bash}
+sudo apt install -y \
+    python3-dev \


Why not python3-minimal?

Thank you for your comment, it is same as "Install OpenCV-Python in Ubuntu".

https://docs.opencv.org/4.x/d2/de6/tutorial_py_setup_in_ubuntu.html

to support python3:
sudo apt-get install python3-dev python3-numpy

python3-dev might conflict with libpython3-dev:aarch64

OK, I created new issue #24695 to commit fix. Thank you !!

…ultiarch doc: add crosscompile_with_multiarch opencv#24629 Add cross compile tutorial for ubuntu/debian. ( I'm sorry to my poor English. ) Fix opencv#24628 ### Pull Request Readiness Checklist See details at https://github.com/opencv/opencv/wiki/How_to_contribute#making-a-good-pull-request - [x] I agree to contribute to the project under Apache 2 License. - [x] To the best of my knowledge, the proposed patch is not based on a code under GPL or another license that is incompatible with OpenCV - [x] The PR is proposed to the proper branch - [x] There is a reference to the original bug report and related work - [ ] There is accuracy test, performance test and test data in opencv_extra repository, if applicable Patch to opencv_extra has the same branch name. - [ ] The feature is well documented and sample code can be built with the project CMake

doc: add crosscompile_with_multiarch

7a8e081

asmorkalov added category: documentation Documentation fix or update category: build/install labels Dec 1, 2023

asmorkalov self-requested a review December 1, 2023 10:50

asmorkalov added this to the 4.9.0 milestone Dec 1, 2023

remove new blank line at EOF

bb33a91

asmorkalov reviewed Dec 1, 2023

View reviewed changes

dkurt reviewed Dec 1, 2023

View reviewed changes

doc/tutorials/introduction/crosscompilation/crosscompile_with_multiarch.markdown Show resolved Hide resolved

dkurt reviewed Dec 1, 2023

View reviewed changes

doc/tutorials/introduction/crosscompilation/crosscompile_with_multiarch.markdown Outdated Show resolved Hide resolved

dkurt reviewed Dec 1, 2023

View reviewed changes

doc/tutorials/introduction/crosscompilation/crosscompile_with_multiarch.markdown Outdated Show resolved Hide resolved

dkurt reviewed Dec 1, 2023

View reviewed changes

fix for review

2d2c3a6

Kumataro added 2 commits December 2, 2023 22:22

add -C option for tar extra command

13d52f8

fix for review, and add supporting python3 binding

39f0d75

fix for doxygen warning, replaced to code command

5cb32db

opencv-alalek added the feature label Dec 4, 2023

fix typo and split bash script anda its result

261074e

asmorkalov reviewed Dec 10, 2023

View reviewed changes

doc/tutorials/introduction/crosscompilation/crosscompile_with_multiarch.markdown Outdated Show resolved Hide resolved

doc/tutorials/introduction/crosscompilation/crosscompile_with_multiarch.markdown Outdated Show resolved Hide resolved

Replace from "ubuntu/debian" to "Ubuntu/Debian".

62078d1

- Installing runtime packages instead of dev packages in target. - Add warning for apt package naming. - Add command to confirm python3 wrapper.

asmorkalov approved these changes Dec 11, 2023

View reviewed changes

Grammar and formatting fixes.

4f6d215

asmorkalov self-assigned this Dec 11, 2023

asmorkalov merged commit b6b40a8 into opencv:4.x Dec 11, 2023
25 of 26 checks passed

dkurt reviewed Dec 13, 2023

View reviewed changes

This was referenced Dec 13, 2023

doc: python3-dev might conflict with libpython3-dev:aarch64 #24695

Closed

aarch64-linux 交叉 freetype模块失败 opencv/opencv_contrib#3553

Open

asmorkalov mentioned this pull request Jan 19, 2024

5.x merge 4.x #24862

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

doc: add crosscompile_with_multiarch #24629

doc: add crosscompile_with_multiarch #24629

Kumataro commented Dec 1, 2023

asmorkalov left a comment

asmorkalov Dec 1, 2023

Kumataro Dec 2, 2023

Kumataro Dec 3, 2023

dkurt Dec 1, 2023

Kumataro Dec 2, 2023

Kumataro Dec 3, 2023

dkurt Dec 4, 2023

Kumataro Dec 4, 2023

Kumataro commented Dec 2, 2023

Kumataro commented Dec 3, 2023

Kumataro commented Dec 4, 2023

asmorkalov left a comment

Kumataro commented Dec 11, 2023

dkurt Dec 13, 2023

Kumataro Dec 13, 2023

dkurt Dec 13, 2023

Kumataro Dec 13, 2023

doc: add crosscompile_with_multiarch #24629

doc: add crosscompile_with_multiarch #24629

Conversation

Kumataro commented Dec 1, 2023

Pull Request Readiness Checklist

asmorkalov left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Step3) Update dpkg setting

Choose a reason for hiding this comment

Kumataro commented Dec 2, 2023

Kumataro commented Dec 3, 2023

Kumataro commented Dec 4, 2023

asmorkalov left a comment

Choose a reason for hiding this comment

Kumataro commented Dec 11, 2023

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment