{"id":692,"date":"2022-11-07T15:04:29","date_gmt":"2022-11-07T07:04:29","guid":{"rendered":"https:\/\/blog.cclo.idv.tw\/?p=692"},"modified":"2023-05-17T16:07:38","modified_gmt":"2023-05-17T08:07:38","slug":"rust-unit-like-struct-%e5%9c%a8-embedded-rust-%e4%b8%ad%e7%9a%84%e6%87%89%e7%94%a8","status":"publish","type":"post","link":"https:\/\/blog.cclo.idv.tw\/?p=692","title":{"rendered":"[Rust] Unit-Like Struct \u5728 Embedded Rust \u4e2d\u7684\u61c9\u7528"},"content":{"rendered":"

\u5728\u8655\u7406\u5d4c\u5165\u5f0f\u7cfb\u7d71\u6642\u5e38\u6703\u9700\u8981\u63a7\u5236 GPIO\u3002\u6240\u8b02\u7684 GPIO\uff08General-Purpose I\/O\uff09\uff0c\u5c31\u662f IC \u7684\u67d0\u4e9b pin \u8173\uff0c\u53ef\u4ee5\u900f\u904e\u8ed4\u9ad4\u8a2d\u5b9a\u70ba\u300cinput\uff08\u5075\u6e2c\u5916\u90e8\u7684\u8a0a\u865f\u662f\u9ad8\u96fb\u4f4d\u9084\u662f\u4f4e\u96fb\u4f4d\uff09\u300d\u6216\u662f\u300coutput\uff08\u5c0d\u5916\u8f38\u51fa\u9ad8\u96fb\u4f4d\u6216\u4f4e\u96fb\u4f4d\uff09\u300d\u72c0\u614b\u3002<\/p>\n

\u7406\u8ad6\u4e0a\u4f86\u8aaa\uff0c\u7576 GPIO \u8a2d\u5b9a\u70ba input \u72c0\u614b\u6642\uff0c\u53eb\u5b83\u300c\u8f38\u51fa\u9ad8\u96fb\u4f4d\u300d\u662f\u6c92\u6709\u610f\u7fa9\u7684\u3002\u53cd\u4e4b\uff0c\u8a2d\u5b9a\u70ba output \u6642\uff0c\u53bb\u8b80\u53d6 pin \u7684\u96fb\u4f4d\u72c0\u614b\u53ef\u80fd\u4e5f\u662f\u6c92\u610f\u7fa9\u7684\u3002\u56e0\u6b64\u5728\u8a2d\u8a08\u5b58\u53d6 GPIO \u7684 API \u6642\uff0c\u6700\u597d\u80fd\u6709\u9069\u7576\u7684\u9632\u5446\u6a5f\u5236\u3002<\/p>\n

<\/p>\n

\u6709\u4e00\u7a2e\u505a\u6cd5\uff0c\u662f\u5efa\u7acb\u4e00\u500b struct\uff0c\u4ee5 data \u7684\u65b9\u5f0f\u5132\u5b58\u6bcf\u6839 pin \u76ee\u524d\u7684\u72c0\u614b\u3002\u7136\u5f8c\u6bcf\u6b21\u8981\u547c\u53eb set_bit()<\/code> \u6216\u662f is_bit_set()<\/code> \u4e4b\u985e\u7684\u51fd\u5f0f\u6642\uff0c\u9032\u884c run-time checking\u3002\u4f46\u4e00\u4f86 run-time checking \u9700\u8981\u57f7\u884c\u6642\u9593\uff0c\u4e8c\u4f86\u5132\u5b58\u72c0\u614b\u9700\u8981\u7528\u5230\u8a18\u61b6\u9ad4\uff0c\u56e0\u6b64\u4e0d\u7b97\u5b8c\u7f8e\u7684\u89e3\u6c7a\u65b9\u6848\u3002<\/p>\n

\u800c Rust Embedded Book \u4e2d\u63d0\u51fa\u4e00\u500b\u65b9\u6848\uff08\u4e5f\u662f\u76ee\u524d\u76f8\u95dc crates \u4e2d\u63a1\u7528\u7684\u65b9\u6848\uff09\uff0c\u662f\u5229\u7528 generic type\uff0c\u5c07 GPIO \u7684\u4e0d\u540c\u72c0\u614b\u8a2d\u5b9a\u70ba\u4e0d\u540c\u7684\u578b\u5225\u53c3\u6578\uff0c\u7522\u751f\u4e0d\u540c\u7684\u578b\u5225\u3002\u7136\u5f8c\u518d\u91dd\u5c0d\u7279\u5316\u7248\u7684\u578b\u5225\uff0c\u63d0\u4f9b\u4e0d\u540c\u7684 methods\uff0c\u4ee5\u9632\u6b62 GPIO \u547c\u53eb\u5230\u4e0d\u8a72\u547c\u53eb\u5230\u7684 methods\u3002<\/p>\n

\u76f4\u63a5\u770b\u7a0b\u5f0f\u78bc\u53ef\u80fd\u6bd4\u8f03\u6e05\u695a\uff1a<\/p>\n

\/\/\/ GPIO interface\nstruct GpioConfig<ENABLED, DIRECTION> {\n    periph: GPIO_CONFIG,    \/\/ \u5be6\u969b\u7528\u4f86\u63a7\u5236\u786c\u9ad4\u66ab\u5b58\u5668\u7684\u754c\u9762\n    enabled: ENABLED,       \/\/ \u9019\u6839 GPIO \u662f\u5426\u555f\u7528\uff1f\n    direction: DIRECTION,   \/\/ \u8f38\u5165\u9084\u662f\u8f38\u51fa\uff1f\n}\n\n\/\/ \u53ef\u4ee5\u7528\u5728 GpioConfig \u6b04\u4f4d\u4e0a\u7684\u72c0\u614b\u578b\u5225\nstruct Disabled;\nstruct Enabled;\nstruct Output;\nstruct Input;\nstruct DontCare;\n\n\/\/\/ \u4e0d\u7ba1 GPIO \u7684\u72c0\u614b\u70ba\u4f55\uff0c\u90fd\u53ef\u4ee5\u4f7f\u7528\u9019\u500b\u7248\u672c\u7684\u5be6\u4f5c\nimpl<EN, DIR> GpioConfig<EN, DIR> {\n    \/\/ \u95dc\u9589\u9019\u6839 GPIO \u7684\u529f\u80fd\n    pub fn into_disabled(self) -> GpioConfig<Disabled, DontCare> {\n        \/*.. \u63a7\u5236\u786c\u9ad4\u66ab\u5b58\u5668\uff0c\u7565\u3002 ..*\/\n        GpioConfig {                \/\/ \u56de\u50b3\u65b0\u7684 GpioConfig \u5be6\u9ad4\n            periph: self.periph,\n            enabled: Disabled,      \/\/ enabled \u7684\u578b\u5225\u8a2d\u70ba Disabled.\n            direction: DontCare,    \/\/ \u53cd\u6b63\u90fd\u662f Disabled \u4e86\uff0c\u6240\u4ee5\u4e0d\u91cd\u8981\u3002\n        }\n    }\n\n    \/\/ \u6253\u958b\u9019\u6839 GPIO \u7684\u529f\u80fd\uff0c\u4e26\u5207\u63db\u5230 Input \u6a21\u5f0f\n    pub fn into_enabled_input(self) -> GpioConfig<Enabled, Input> {\n        \/*.. \u63a7\u5236\u786c\u9ad4\u66ab\u5b58\u5668\uff0c\u7565\u3002 ..*\/\n        GpioConfig {                \/\/ \u56de\u50b3\u65b0\u7684 GpioConfig \u5be6\u9ad4\n            periph: self.periph,\n            enabled: Enabled,       \/\/ enabled \u7684\u578b\u5225\u8a2d\u70ba Enabled.\n            direction: Input,       \/\/ direction \u7684\u578b\u5225\u8a2d\u70ba Input.\n        }\n    }\n\n    \/\/ \u6253\u958b\u9019\u6839 GPIO \u7684\u529f\u80fd\uff0c\u4e26\u5207\u63db\u5230 Output \u6a21\u5f0f\n    pub fn into_enabled_output(self) -> GpioConfig<Enabled, Output> {\n        \/*.. \u63a7\u5236\u786c\u9ad4\u66ab\u5b58\u5668\uff0c\u7565\u3002 ..*\/\n        GpioConfig {                \/\/ \u56de\u50b3\u65b0\u7684 GpioConfig \u5be6\u9ad4\n            periph: self.periph,\n            enabled: Enabled,       \/\/ enabled \u7684\u578b\u5225\u8a2d\u70ba Enabled.\n            direction: Output,      \/\/ direction \u7684\u578b\u5225\u8a2d\u70ba Ouput.\n        }\n    }\n}\n\n\/\/\/ \u53ea\u6709\u7279\u5316\u70ba Output \u6a21\u5f0f\u7684 GPIO \u624d\u80fd\u4f7f\u7528\u9019\u4e9b\u51fd\u5f0f\nimpl GpioConfig<Enabled, Output> {\n    \/\/ \u8a2d\u5b9a\u8f38\u51fa\u96fb\u4f4d\u70ba high \u6216 low\n    pub fn set_bit(&mut self, set_high: bool) {\n        \/*.. \u63a7\u5236\u786c\u9ad4\u66ab\u5b58\u5668\uff0c\u7565\u3002 ..*\/\n    }\n}\n\n\/\/\/ \u53ea\u6709\u7279\u5316\u70ba Input \u6a21\u5f0f\u7684 GPIO \u624d\u80fd\u4f7f\u7528\u9019\u4e9b\u51fd\u5f0f\nimpl GpioConfig<Enabled, Input> {\n    \/\/ \u6aa2\u67e5\u8f38\u5165\u96fb\u4f4d\u70ba high \u6216 low\n    pub fn bit_is_set(&self) -> bool {\n        \/*.. \u63a7\u5236\u786c\u9ad4\u66ab\u5b58\u5668\uff0c\u7565\u3002 ..*\/\n    }\n}\n\nfn gpio_example() {\n    \/\/ \u53d6\u5f97\u67d0\u500b\u5c1a\u672a\u8a2d\u5b9a\u7684 GPIO\n    let pin: GpioConfig<Disabled, _> = get_gpio();\n\n    \/\/ \u4e0b\u9762\u9019\u884c\u7de8\u8b6f\u4e0d\u6703\u904e\uff0c\u56e0\u70ba pin \u9084\u662f Disabled \u7684\u72c0\u614b\u3002\n    \/\/ let pin_status = pin.bit_is_set();\n\n    \/\/ \u628a pin \u8f49\u6210 Input\u3002\u57f7\u884c\u5b8c\u9019\u884c\u5f8c pin \u5c31\u4e0d\u80fd\u7528\u4e86\u3002\n    let input_pin = pin.into_enabled_input();\n\n    \/\/ \u6b64\u6642\u5c31\u53ef\u4ee5\u900f\u904e input_pin \u6aa2\u67e5\u72c0\u614b\u3002\n    let pin_status = input_pin.bit_is_set();\n\n    \/\/ \u8a66\u8457\u900f\u904e input_pin \u8a2d\u5b9a\u8f38\u51fa\u96fb\u4f4d\u3002\u7de8\u8b6f\u4e0d\u6703\u904e\u3002\n    \/\/ input_pin.set_bit(true);\n\n    \/\/ \u628a input_pin \u8f49\u6210 Output\u3002\u57f7\u884c\u5b8c\u5f8c input_pin \u4e5f\u4e0d\u80fd\u7528\u4e86\u3002\n    let output_pin = input_pin.into_enabled_output();\n\n    \/\/ \u900f\u904e output_pin \u8a2d\u5b9a\u8f38\u51fa\u96fb\u4f4d\u3002\n    output_pin.set_bit(true);\n}<\/code><\/pre>\n","protected":false},"excerpt":{"rendered":"
Rust \u63d0\u4f9b\u4e86 Unit-Like Struct \u9019\u6a23\u7684\u6a5f\u5236\u3002\u9019\u7a2e\u5b8c\u5168\u6c92\u6709\u8cc7\u6599\u5167\u5bb9\u7684 struct \u770b\u8d77\u4f86\u6c92\u4ec0\u9ebc\u7528\uff0c\u5be6\u969b\u4e0a\u642d\u914d Rust \u7684\u578b\u5225\u7cfb\u7d71\u80fd\u767c\u63ee\u5f37\u5927\u7684 zero-cost checking \u529f\u80fd\u3002\u4f8b\u5982 embedded Rust \u4e2d\u5c31\u6d3b\u7528\u4e86\u9019\u6a23\u7684\u529f\u80fd….<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"inline_featured_image":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":""},"categories":[13],"tags":[71,41],"table_tags":[],"class_list":["post-692","post","type-post","status-publish","format-standard","hentry","category--computer-science","tag-embedded-system","tag-rust"],"aioseo_notices":[],"jetpack_sharing_enabled":true,"jetpack_featured_media_url":"","jetpack-related-posts":[],"_links":{"self":[{"href":"https:\/\/blog.cclo.idv.tw\/index.php?rest_route=\/wp\/v2\/posts\/692","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blog.cclo.idv.tw\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.cclo.idv.tw\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.cclo.idv.tw\/index.php?rest_route=\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.cclo.idv.tw\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=692"}],"version-history":[{"count":4,"href":"https:\/\/blog.cclo.idv.tw\/index.php?rest_route=\/wp\/v2\/posts\/692\/revisions"}],"predecessor-version":[{"id":711,"href":"https:\/\/blog.cclo.idv.tw\/index.php?rest_route=\/wp\/v2\/posts\/692\/revisions\/711"}],"wp:attachment":[{"href":"https:\/\/blog.cclo.idv.tw\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=692"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.cclo.idv.tw\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=692"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.cclo.idv.tw\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=692"},{"taxonomy":"table_tags","embeddable":true,"href":"https:\/\/blog.cclo.idv.tw\/index.php?rest_route=%2Fwp%2Fv2%2Ftable_tags&post=692"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}