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 3 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
@@ -157,7 +157,10 @@ void DataUpload::exit(void)
}
}

// In smartfin-fw2/src/dataUpload::DataUpload::exitState(void), we return based on the water sensor state. If the system is in the water, we redeploy, otherwise we go to sleep.
Copy link
Contributor

Choose a reason for hiding this comment

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

Either format as docstring and comment out, or remove documentation comment

int initSuccess;
system_tick_t lastConnectTime;
STATES_e exitState(void);
//In smartfin-fw2/src/dataUpload::DataUpload::exitState(void), we return based on the water sensor state. If the system is in the water, we redeploy, otherwise we go to sleep.
Copy link
Contributor

Choose a reason for hiding this comment

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

Either format as docstring and comment out, or remove documentation comment

Comment on lines +58 to +59
* Returns that the data upload is possible if: the recorder has data, is connected to a cloud
* service, is not in water, and the battery has enough voltage for an upload. If the system is currently in water, we redeploy, otherwise we go to sleep.
Copy link
Contributor

Choose a reason for hiding this comment

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

Make this a table?

@Tylody Tylody enabled auto-merge November 22, 2024 18:27
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