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

[device]修改i2c读写函数返回类型为rt_ssize_t #7029

Merged
merged 4 commits into from
Mar 10, 2023

Conversation

ZosCat1
Copy link
Contributor

@ZosCat1 ZosCat1 commented Mar 8, 2023

拉取/合并请求描述:(PR description)

[

为什么提交这份PR (why to submit this PR)

[修改i2c读写函数返回类型为rt_ssize_t]

你的解决方案是什么 (what is your solution)

[修改i2c读写函数返回类型为rt_ssize_t]

在什么测试环境下测试通过 (what is the test environment)

]

当前拉取/合并请求的状态 Intent for your PR

必须选择一项 Choose one (Mandatory):

  • 本拉取/合并请求是一个草稿版本 This PR is for a code-review and is intended to get feedback
  • 本拉取/合并请求是一个成熟版本 This PR is mature, and ready to be integrated into the repo

代码质量 Code Quality:

我在这个拉取/合并请求中已经考虑了 As part of this pull request, I've considered the following:

  • 已经仔细查看过代码改动的对比 Already check the difference between PR and old code
  • 代码风格正确,包括缩进空格,命名及其他风格 Style guide is adhered to, including spacing, naming and other styles
  • 没有垃圾代码,代码尽量精简,不包含#if 0代码,不包含已经被注释了的代码 All redundant code is removed and cleaned up
  • 所有变更均有原因及合理的,并且不会影响到其他软件组件代码或BSP All modifications are justified and not affect other components or BSP
  • 对难懂代码均提供对应的注释 I've commented appropriately where code is tricky
  • 代码是高质量的 Code in this PR is of high quality
  • 已经使用formatting等源码格式化工具确保格式符合RT-Thread代码规范 This PR complies with RT-Thread code specification

@mysterywolf mysterywolf changed the title [修改i2c读写函数返回类型为rt_ssize_t] [device]修改i2c读写函数返回类型为rt_ssize_t Mar 9, 2023
@mysterywolf mysterywolf added the in progress PR/issue in progress. label Mar 9, 2023
@mysterywolf mysterywolf merged commit c8b30bf into RT-Thread:master Mar 10, 2023
@ZosCat1 ZosCat1 deleted the soft_i2c branch March 29, 2023 03:47
@@ -118,16 +118,16 @@ rt_size_t rt_i2c_master_send(struct rt_i2c_bus_device *bus,

ret = rt_i2c_transfer(bus, &msg, 1);

return (ret > 0) ? count : ret;
return ret;
Copy link
Contributor

Choose a reason for hiding this comment

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

Not back-compatible. It SHOULD return byte count value if sent an I2C message successfully.

@@ -138,11 +138,5 @@ rt_size_t rt_i2c_master_recv(struct rt_i2c_bus_device *bus,

ret = rt_i2c_transfer(bus, &msg, 1);

return (ret > 0) ? count : ret;
return ret;
Copy link
Contributor

Choose a reason for hiding this comment

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

Not back-compatible. It SHOULD return byte count value if received an I2C message successfully.

Copy link
Member

Choose a reason for hiding this comment

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

5.0.0不考虑向前兼容的问题,一些历史包袱需要在这个版本中逐步得到解决,返回值改为:如果返回值>=0 为成功传输的长度,<0为传输出现错误并返回错误码

Copy link
Contributor

Choose a reason for hiding this comment

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

如果返回值>=0 为成功传输的长度

所以這兩個 APIs 應該回傳成功传输 "byte count" 長度; 而不是"message number"。對嗎?
Caller 提交的是 send/receive byte length; 而成功回傳的是 message count。 不太合理。
這一改,又一堆 3rd contributed packages NG 了。

Copy link
Member

Choose a reason for hiding this comment

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

噢噢 我理解你的意思了 这个地方有问题 返回应该是成功传输的长度,而不是message number。我落实下去来改。

Copy link
Contributor

Choose a reason for hiding this comment

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

Thanks Meco.

@wosayttn wosayttn mentioned this pull request May 9, 2023
9 tasks
mysterywolf pushed a commit that referenced this pull request May 9, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
in progress PR/issue in progress.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants