Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add CMakeLists.txt for Mbed CLI v2 #35

Open
wants to merge 3 commits into
base: master
Choose a base branch
from

Conversation

Oxore
Copy link

@Oxore Oxore commented Apr 18, 2021

No description provided.

@Oxore
Copy link
Author

Oxore commented Apr 18, 2021

Please let me know if there is something wrong with my approach of single CMakeLists.txt file or with the PR at all. I am ready to re-implement this another way if you suggest one.

@@ -0,0 +1,37 @@
add_library(mbed-mqtt INTERFACE)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please add a license header

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does this need to be an interface? I suspect STATIC would work for this library (no weak linking symbols) ?

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would this license header be sufficient? No names, just copyright, and SPDX identifier.

# Copyright (c) 2021 ARM Limited. All rights reserved.
# SPDX-License-Identifier: Apache-2.0

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does this need to be an interface? I suspect STATIC would work for this library (no weak linking symbols) ?

I think you are right. Give me a couple more days and I will figure it out how to make it compile being STATIC. I'm not really competent neither with cmake nor with mbed-os' CMakeLists.txt files organization.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've changed my mind. Here is the reason why I think this library should be declared as INTERFACE:

  1. When it is declared as STATIC, it anyways turns out to be built alongside with mbed-os in any project. Therefore it uses all the same macros passed to the compiler on invocation. Consider an example when I have mbedtls-config-changes.h file in the root of my project and I pass it as "MBEDTLS_USER_CONFIG_FILE=\"mbedtls-config-changes.h\"" in mbed_app.json. This MBEDTLS_USER_CONFIG_FILE macro is passed to mbed-mqtt sources too when it is being built and this config header file cannot be found, because mbed-mqtt is being built separately as a static library and it is not aware of my project's root directory where the file is located. To mitigate this error I have to declare something like this in my project's root CMakeLists.txt: target_include_directories(mbed-mqtt PRIVATE .). When mbed-mqtt declared as INTERFACE there is no such problems.

  2. When it is declared as STATIC, all mbed-mqtt dependencies are built separately from the project and number of files to be compiled becomes almost twice as many than if it was declared as INTERFACE - 868 files when INTERFACE vs 1717 when STATIC in my case. Basically the whole OS is being built twice. This is inconvenient.

  3. I have no evidence of any library for mbed-os declared as STATIC - they all are declared as INTERFACE. Why mbed-mqtt should not be declared as INTERFACE?

README.md Outdated
```
add_subdirectory(mbed-mqtt)

target_link_libraries(${APP_TARGET} mbed-mqtt)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

group them together to one target_link_libraries()

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Okay, I'll do it.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done. I've declared all dependencies explicitly, so this list has shrunk to just single entry mbed-mqtt.

README.md Outdated
target_link_libraries(${APP_TARGET} mbed-mqtt)
target_link_libraries(${APP_TARGET} mbed-mbedtls)
target_link_libraries(${APP_TARGET} mbed-nanostack)
target_link_libraries(${APP_TARGET} mbed-greentea)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

is greentea required? I dont think so (testing with greentea needs work to be enable with CMake)

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Technically it is required for now, because otherwise it won't compile. But if PR #34 would be merged, then it will no longer be required and mbed-mqtt will be compileable without greentea dependency.

README.md Outdated

target_link_libraries(${APP_TARGET} mbed-mqtt)
target_link_libraries(${APP_TARGET} mbed-mbedtls)
target_link_libraries(${APP_TARGET} mbed-nanostack)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

why nanostack is required , shouldn't this be up to a consumer of this library (mqtt) to choose a stack (netsockets/nanostack, etc) ?

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Well, it is up to a consumer here, since it is just a suggestion in README.md for a user. It provides an example of how you link all dependencies while linking against mbed-mqtt library.

It now fails to compile, though, when I began tinkering with STATIC declaration you've mentioned above: TCPSocket.h: No such file or directory. I need some time to figure out how properly declare dependency on a network stack.

Anyway, thank you very much for the review so far!

Copy link
Author

@Oxore Oxore May 18, 2021

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It now has mbed-netsocket explicitly declared as it's dependency.

@Oxore Oxore requested a review from 0xc0170 June 21, 2021 18:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants