diff --git a/MAX30102_1/LICENSE b/MAX30102_1/LICENSE new file mode 100644 index 0000000000000000000000000000000000000000..c0ee81299bd368b4c38a7947d1651a1e32348313 --- /dev/null +++ b/MAX30102_1/LICENSE @@ -0,0 +1,201 @@ + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "{}" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright {yyyy} {name of copyright owner} + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. diff --git a/MAX30102_1/README.md b/MAX30102_1/README.md new file mode 100644 index 0000000000000000000000000000000000000000..a10b0713a6180a06050a39b1956860c3915677a6 --- /dev/null +++ b/MAX30102_1/README.md @@ -0,0 +1,53 @@ +# MAX30102 + +## 案例演示 + +如图 + +手指未放置时,提示 + +手指放置,显示 + + + +## 物理连接 + +### 传感器选择 + +选用如图所示MAX0102心率传感器模组 + +### 接线 + +| Waffle Nano | 传感器 | +| ----------- | ------ | +| 3V3 | VIN | +| IO0 | SDA | +| IO1 | SCL | +| GND | GND | + + + +## 传感器库的使用 + +可以获取 将此库通过 的文件上传功能将此库上传到Waffle Nano上。 + +我们在可以在主函数中使用以下代码导入此库,在对象构造函数中,我们传入一个已经构造好的`IIC`对象,构造心率对象 + +``` +import max30102 +m = max30102.MAX30102(0,1,100) +``` + +我们使用心率传感器对象的`read()`方法读取出一个寄存器中的red红灯数据。 + +``` +red = m.read_fifo() #从传感器中获取红灯寄存器数据 +``` + + + +## 案例代码复现 + +可以获取 代码,将其内容复制到 编辑器上传输给Waffle Nano,以复现此案例。 + +案例相关细节说明详见代码注释 \ No newline at end of file diff --git a/MAX30102_1/code/main.py b/MAX30102_1/code/main.py new file mode 100644 index 0000000000000000000000000000000000000000..85a8b86a1155565e1a25b674924743ec8a769e2a --- /dev/null +++ b/MAX30102_1/code/main.py @@ -0,0 +1,34 @@ +#传感器模块 +from machine import I2C, Pin,SPI +import max30102 +from utime import sleep +import st7789 + +spi = SPI(0, baudrate=40000000, polarity=1, phase=0, bits=8, endia=0, sck=Pin(6), mosi=Pin(8)) + +display = st7789.ST7789(spi, 240, 240, reset=Pin(11, func=Pin.GPIO, dir=Pin.OUT), dc=Pin(7, func=Pin.GPIO, dir=Pin.OUT)) +display.init() +bgclr = st7789.color565(255, 255, 255) +display.fill(bgclr) + +m = max30102.Max30102(0,1,100) + +hr=70 +while True: + + red, ir = m.read_fifo() + R = red / ir + + if red < 20000: + print("please put your finger") + display.fill_rect(75, 0, 165, 70, bgclr) # 输出白屏达到清屏效果 + display.draw_string(50, 75, "place finger", size=3, color=st7789.color565(0, 0, 0)) + else: + hr = str(int(30 / 30000 * (red - 230000) + 60)) + spo2 = str(int(-45.060 * R * R + 30.354 * R + 94.845 + 22)) + + print(red, ir, spo2, hr) + + display.fill_rect(40, 70, 195, 30, bgclr) # 输出白屏达到清屏效果 + display.draw_string(75, 10, "H R %s " % hr, size=2, color=st7789.color565(0, 0, 0)) + display.draw_string(75, 50, "spO2 %s " % spo2, size=2, color=st7789.color565(0, 0, 0)) diff --git a/MAX30102_1/code/max30102.py b/MAX30102_1/code/max30102.py new file mode 100644 index 0000000000000000000000000000000000000000..79e45ac93d6f0a342f6848e67eadd88ee6756397 --- /dev/null +++ b/MAX30102_1/code/max30102.py @@ -0,0 +1,146 @@ +from machine import I2C, Pin +# i2c = I2C(1, sda=Pin(0), scl=Pin(1),freq=400000) +from utime import sleep +I2C_WRITE_ADDR = 0xAE +I2C_READ_ADDR = 0xAF + +# register address-es +REG_INTR_STATUS_1 = 0x00 +REG_INTR_STATUS_2 = 0x01 + +REG_INTR_ENABLE_1 = 0x02 +REG_INTR_ENABLE_2 = 0x03 + +REG_FIFO_WR_PTR = 0x04 +REG_OVF_COUNTER = 0x05 +REG_FIFO_RD_PTR = 0x06 +REG_FIFO_DATA = 0x07 +REG_FIFO_CONFIG = 0x08 + +REG_MODE_CONFIG = 0x09 +REG_SPO2_CONFIG = 0x0A +REG_LED1_PA = 0x0C + +REG_LED2_PA = 0x0D +REG_PILOT_PA = 0x10 +REG_MULTI_LED_CTRL1 = 0x11 +REG_MULTI_LED_CTRL2 = 0x12 + +REG_TEMP_INTR = 0x1F +REG_TEMP_FRAC = 0x20 +REG_TEMP_CONFIG = 0x21 +REG_PROX_INT_THRESH = 0x30 +REG_REV_ID = 0xFE +REG_PART_ID = 0xFF + +class Max30102(): + def __init__(self,sda_pin,scl_pin,fre): + # print("Channel: {0}, address: {1}".format(channel, address)) + self.i2c = I2C(1, sda=Pin(sda_pin), scl=Pin(scl_pin),freq=fre) + self.address = 87 + + self.reset() + + sleep(1) # wait 1 sec + + # read & clear interrupt register (read 1 byte) + reg_data = self.i2c.readfrom_mem(self.address, REG_INTR_STATUS_1, 1) + # print("[SETUP] reset complete with interrupt register0: {0}".format(reg_data)) + self.setup() + + def shutdown(self): + """ + Shutdown the device. + """ + self.i2c.write(87, b'\x09\x80') + + def reset(self): + """ + Reset the device, this will clear all settings, + so after running this, run setup() again. + """ + self.i2c.write(87, b'\x09\x40') + + + def setup(self): + """ + This will setup the device with the values written in sample Arduino code. + """ + # INTR setting + # 0xc0 : A_FULL_EN and PPG_RDY_EN = Interrupt will be triggered when + # fifo almost full & new fifo data ready + self.i2c.write(87, b' \x02\xc0') + self.i2c.write(87, b'\x03\xc0') + + # FIFO_WR_PTR[4:0] + self.i2c.write(87, b'\x04\xc0') + # OVF_COUNTER[4:0] + self.i2c.write(87, b'\x05\xc0') + # FIFO_RD_PTR[4:0] + self.i2c.write(87, b'\x06\xc0') + + # 0b 0100 1111 + # sample avg = 4, fifo rollover = false, fifo almost full = 17 + self.i2c.write(87, b'\x08\x4f') + + # 0x02 for read-only, 0x03 for SpO2 mode, 0x07 multimode LED + self.i2c.write(87, b'\x09\x03') + # 0b 0010 0111 + # SPO2_ADC range = 4096nA, SPO2 sample rate = 100Hz, LED pulse-width = 411uS + self.i2c.write(87, b'\x0A\x27') + + # choose value for ~7mA for LED1 + self.i2c.write(87, b'\x0C\x40') + # choose value for ~7mA for LED2 + self.i2c.write(87, b'\x0D\x40') + # choose value fro ~25mA for Pilot LED + self.i2c.write(87, b'\x10\x7f') + + def set_config(self, reg, value): + self.bus.write_i2c_block_data(self.address, reg, value) + + def get_data_present(self): + read_ptr = self.bus.read_byte_data(self.address, REG_FIFO_RD_PTR) + write_ptr = self.bus.read_byte_data(self.address, REG_FIFO_WR_PTR) + if read_ptr == write_ptr: + return 0 + else: + num_samples = write_ptr - read_ptr + # account for pointer wrap around + if num_samples < 0: + num_samples += 32 + return num_samples + + + def read_fifo(self): + """ + This function will read the data register. + """ + red_led = None + ir_led = None + + # read 1 byte from registers (values are discarded) + reg_INTR1 = self.i2c.readfrom_mem(87, REG_INTR_STATUS_1, 1) + reg_INTR2 = self.i2c.readfrom_mem(87, REG_INTR_STATUS_2, 1) + + # read 6-byte data from the device + d = self.i2c.readfrom_mem(87, REG_FIFO_DATA, 6) + # mask MSB [23:18] + red_led = (d[0] << 16 | d[1] << 8 | d[2]) & 0x03FFFF + ir_led = (d[3] << 16 | d[4] << 8 | d[5]) & 0x03FFFF + + return red_led, ir_led + + def read_sequential(self): + """ + This function will read the red-led and ir-led `amount` times. + This works as blocking function. + """ + red_buf = [] + ir_buf = [] + for i in range(100): + red, ir = self.read_fifo() + red_buf.append(red) + ir_buf.append(ir) + + return red_buf, ir_buf \ No newline at end of file diff --git a/MAX30102_1/image/hrspo2.jpg b/MAX30102_1/image/hrspo2.jpg new file mode 100644 index 0000000000000000000000000000000000000000..c397df64b700817f83e9082bab93d70694cec270 Binary files /dev/null and b/MAX30102_1/image/hrspo2.jpg differ diff --git a/MAX30102_1/image/max30102.jpg b/MAX30102_1/image/max30102.jpg new file mode 100644 index 0000000000000000000000000000000000000000..0082954da1ed3d151799b6e6a54f424c8c8f2c05 Binary files /dev/null and b/MAX30102_1/image/max30102.jpg differ diff --git a/MAX30102_1/image/pf.jpg b/MAX30102_1/image/pf.jpg new file mode 100644 index 0000000000000000000000000000000000000000..93b6c2aa6cf6cde9a1e86cd1be8c2c43110604a8 Binary files /dev/null and b/MAX30102_1/image/pf.jpg differ