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

fix: in DataUpload, commented unused function & added docs #132

Open
wants to merge 7 commits into
base: main
Choose a base branch
from

Conversation

Tylody
Copy link
Contributor

@Tylody Tylody commented Nov 15, 2024

documented exitState, can_upload, initSuccess

documented exitState, can_upload, initSuccess
@Tylody Tylody linked an issue Nov 15, 2024 that may be closed by this pull request
6 tasks
@Tylody
Copy link
Contributor Author

Tylody commented Nov 15, 2024

lastConnectTime has no uses outside of this header file. Should I add a commit to remove lastConnectTime, or simply add documentation for it?

@Tylody Tylody self-assigned this Nov 15, 2024
@Tylody Tylody requested a review from ntlhui November 15, 2024 06:14
src/cellular/dataUpload.hpp Outdated Show resolved Hide resolved
src/cellular/dataUpload.hpp Outdated Show resolved Hide resolved
src/cellular/dataUpload.hpp Outdated Show resolved Hide resolved
src/cellular/dataUpload.hpp Outdated Show resolved Hide resolved
documented initSuccess, and canUpload
commented out exitState (unused function)
@Tylody Tylody changed the title docs: added documentation to private members of class DataUpload fix: in DataUpload, commented unused function & added docs Nov 22, 2024
@Tylody Tylody requested a review from ntlhui November 22, 2024 06:42
src/cellular/dataUpload.cpp Show resolved Hide resolved
src/cellular/dataUpload.hpp Outdated Show resolved Hide resolved
src/cellular/dataUpload.hpp Outdated Show resolved Hide resolved
@Tylody Tylody enabled auto-merge November 22, 2024 18:27
dataupload returns if data upload is possible, if we should go to
redeployment, or sleep, depending on if the recorder has data, if we are
connected to cloud services, if we are in water, and if battery has
sufficient voltage. illustrated in the docs via a truth table.
@Tylody Tylody requested a review from ntlhui January 10, 2025 08:15
@ntlhui
Copy link
Contributor

ntlhui commented Jan 10, 2025

This is not ready for review - please resolve merge conflicts before requesting review.

src/cellular/dataUpload.hpp Outdated Show resolved Hide resolved
@Tylody Tylody requested a review from ntlhui January 12, 2025 07:14
Comment on lines +78 to +81
* | | Return State | | |
* |----------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
* | | data upload is possible | smartfin redeploys | smartfin goes to sleep |
* | required conditions: | All of the following conditions must be met:<br><br>- Recorder has data is TRUE<br>- Connected to cloud is TRUE<br>- In water is FALSE<br>- Sufficient voltage is TRUE | All of the following conditions must be met:<br><br>- Recorder has data is TRUE<br>- Connected to cloud is TRUE<br>- In water is TRUE<br>- Sufficient voltage: TRUE or FALSE | Any one of the conditions are met:<br><br>- Recorder has data is FALSE<br>- Connected to cloud is FALSE<br>- In water is FALSE at the same time sufficient voltage is FALSE |
Copy link
Contributor

Choose a reason for hiding this comment

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

This table might not be the best way to display this information - keep in mind that sometimes we look at this from the IDE.

Consider a list of conditions which must be true for specific outputs to occur.

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.

docs: Data Upload
2 participants