หน้าแรก>แหล่งข้อมูลการสร้างเว็บไซต์>ซอร์สโค้ดแฟลช
ดาวน์โหลด

Library flashstorage_samd สำหรับ Arduino

สารบัญ

  • การเปลี่ยนแปลงที่สำคัญจาก v1.3.0
  • ทำไมเราต้องใช้ไลบรารี flashstorage_samd นี้
    • คุณสมบัติ
    • บอร์ดที่ได้รับการสนับสนุนในปัจจุบัน
  • การเปลี่ยนแปลง
  • ข้อกำหนดเบื้องต้น
  • การติดตั้ง
    • ใช้ Arduino Library Manager
    • การติดตั้งด้วยตนเอง
    • VS Code & Platformio
  • แพทช์แพคเกจ
    • 1. สำหรับบอร์ด Arduino SAMD
      • สำหรับเวอร์ชันหลัก v1.8.10+
      • สำหรับเวอร์ชันหลัก v1.8.9-
    • 2. สำหรับบอร์ด Adafruit SAMD
    • 3. สำหรับกระดาน Seeeduino SAMD
    • 4. สำหรับบอร์ด SPARKFUN SAMD
  • วิธีแก้ไข Multiple Definitions จำกัดความของตัวเชื่อมโยง
  • จำนวนเขียน จำกัด
  • การใช้งาน
    • ใช้วัตถุ FlashStorage โดยตรง
    • ใช้ API ที่มีลักษณะคล้าย EEPROM ทางเลือก
  • ตัวอย่าง
    • 1. EEPROM_CLEAR
    • 2. EEPROM_CRC
    • 3. eeprom_get
    • 4. EEPROM_ITERATION
    • 5. EEPROM_PUT
    • 6. EEPROM_READ
    • 7. EEPROM_UPDATE
    • 8. EEPROM_WRITE
    • 9. Emulateeeprom
    • 10. flashstoreandretrieve
    • 11. storenameandsurname
    • 12. MultifileProject ใหม่
  • ตัวอย่างจากห้องสมุดอื่น ๆ
    • 1. ห้องสมุด blynkethernet_wm
    • 2. ห้องสมุด blynk_esp8266at_wm
    • 3. ห้องสมุด blynk_wifinina_wm
    • 4. ห้องสมุด esp_at_wifimanager
    • 5. ห้องสมุด esp_at_wm_lite
    • 6. ห้องสมุด wifimanager_nina_lite
    • 7. ห้องสมุด doubleresetdetector_generic
    • 8. ไลบรารี MultiresetDetector_Generic
  • ตัวอย่าง storenameandsurname
  • ตัวอย่างเอาต์พุตเทอร์มินัลดีบัก
    • 1. W5500_BLYNK บน ADAFRUIT SAMD51 ITSYBITSY_M4 โดยใช้ W5500 Ethernet Shield
    • 2. StorenameAndsurname บน SAMD21 SEEED_XIAO_M0
      • 2.1. ไม่มีข้อมูลอินพุตจากนั้นบันทึก
      • 2.2. การเก็บข้อมูลหลังจากรีเซ็ต
    • 3. EEPROM_CLEAR บน SAMD21 SEEED_XIAO_M0
    • 4. eeprom_get บน samd21 seeed_xiao_m0
  • คำถามที่พบบ่อย
    • ฉันสามารถใช้วัตถุเดียวเพื่อเก็บสิ่งของเพิ่มเติมได้หรือไม่?
    • เนื้อหาของ FlashStorage จะถูกลบทุกครั้งที่อัปโหลดร่างใหม่หรือไม่?
    • คุณแนะนำให้ใช้แฟลชแทน EEPROM หรือไม่?
  • การแก้ไขปัญหา
  • ปัญหา
  • สิ่งที่ต้องทำ
  • เสร็จแล้ว
  • ผลงานและขอบคุณ
  • การบริจาค
  • ใบอนุญาต
  • ลิขสิทธิ์

การเปลี่ยนแปลงที่สำคัญจาก v1.3.0

โปรดดูวิธีแก้ไข Multiple Definitions จำกัดความของ linker

ทำไมเราต้องใช้ไลบรารี flashstorage_samd นี้

คุณสมบัติ

ไลบรารี FlashStorage_samd ซึ่งใช้และแก้ไขจาก FlashStorage ของ Cristian Maglie เป็นวิธีที่สะดวกในการจัดเก็บและดึงข้อมูลของผู้ใช้โดยใช้ Emulated-EEPROM จากหน่วยความจำแฟลชที่ไม่ระเหยของบอร์ด SAMD21/SAMD51

หน่วยความจำแฟลชโดยทั่วไปใช้ในการจัดเก็บรหัสเฟิร์มแวร์สามารถใช้ในการจัดเก็บ / ดึงข้อมูลของผู้ใช้มากขึ้นและเร็วกว่าจาก EEPROM ต้องขอบคุณ การเขียนและการอ่านข้อมูลบัฟเฟอร์ เวลาการเข้าถึงแฟลชจะลดลงอย่างมากเพื่อ เพิ่มอายุการใช้งานของแฟลช

บอร์ดที่ได้รับการสนับสนุนในปัจจุบัน

  • Arduino SAMD21 (ศูนย์, MKR, Nano_33_iot ฯลฯ )
  • Adafruit SAM21 (Itsy-Bitsy M0, Metro M0, Feather M0, Gemma M0 ฯลฯ )
  • Adafruit SAM51 (Itsy-Bitsy M4, Metro M4, Grand Central M4, Feather M4 Express, ฯลฯ )
  • SEEEDUINO SAMD21/SAMD51 บอร์ด (SEEED_WIO_TERMINAL, SEEED_FEMTO_M0, SEEED_XIAO_M0, WIO_LITE_MG126, WIO_GPS_BOARD, SEEEDUINO_ZERO
  • อุตสาหกรรม DG21
  • อุตสาหกรรม 420maker
  • บอร์ด SparkFun Samd21 เช่น SparkFun_redboard_turbo, SparkFun_qwiic_Micro ฯลฯ
  • sparkfun samd51 บอร์ด เช่น Sparkfun_samd51_thing_plus, SparkFun_samd51_micromod ฯลฯ

ข้อกำหนดเบื้องต้น

  1. Arduino IDE 1.8.19+ สำหรับ Arduino
  2. Arduino SAMD core 1.8.13+ สำหรับ SAMD ARM Cortex-M0+ บอร์ด
  3. Adafruit SAMD core 1.7.11+ สำหรับ SAMD ARM Cortex-M0+ และ M4 บอร์ด (Nano 33 IoT ฯลฯ )
  4. Seeeduino SAMD core 1.8.3+ สำหรับบอร์ด SAMD21/SAMD51 (Xiao M0, Wio Terminal ฯลฯ )
  5. IndustruinoSAMD core 1.0.3+ สำหรับบอร์ด SAMD21 (อุตสาหกรรม DG21 ฯลฯ )
  6. IndustruinoSAML core 1.0.0+ สำหรับบอร์ด SAML21 (อุตสาหกรรม 420maker ฯลฯ )
  7. Sparkfun SAMD core 1.8.4+ สำหรับบอร์ด SAMD21/SAMD51 (SparkFun_redboard_turbo, SparkFun_Samd51_thing_plus ฯลฯ )

การติดตั้ง

ใช้ Arduino Library Manager

วิธีที่ดีที่สุดและง่ายที่สุดคือใช้ Arduino Library Manager ค้นหา flashstorage_samd จากนั้นเลือก / ติดตั้งเวอร์ชันล่าสุด

การติดตั้งด้วยตนเอง

อีกวิธีในการติดตั้งคือ:

  1. นำทางไปยังหน้า flashstorage_samd
  2. ดาวน์โหลดรุ่นล่าสุด FlashStorage_SAMD-master.zip
  3. แยกไฟล์ zip ไปยังไดเรกทอรี FlashStorage_SAMD-master
  4. คัดลอกทั้งหมด
  • โฟลเดอร์ FlashStorage_SAMD-master ไปยังไดเรกทอรีของ Arduino Libraries เช่น ~/Arduino/libraries/

VS Code & Platformio

  1. ติดตั้งรหัส VS
  2. ติดตั้ง platformio
  3. ติดตั้งไลบรารี flashstorage_samd โดยใช้ Library Manager ค้นหา flashstorage_samd ในไลบรารีของ Platform.io Author
  4. ใช้ไฟล์ platformio.ini รวมจากตัวอย่างเพื่อให้แน่ใจว่าไลบรารีที่ขึ้นอยู่กับทั้งหมดจะติดตั้งโดยอัตโนมัติ กรุณาเยี่ยมชมเอกสารสำหรับตัวเลือกและตัวอย่างอื่น ๆ ที่ไฟล์กำหนดค่าโครงการ

แพทช์แพคเกจ

1. สำหรับบอร์ด Arduino SAMD

เพื่อให้สามารถรวบรวมได้โดยไม่มีข้อผิดพลาดและตรวจจับและแสดง board_name โดยอัตโนมัติบนบอร์ด Arduino SAMD (Nano-33-Iot ฯลฯ ) คุณต้องคัดลอกไดเรกทอรี ARDUINO SAMD ทั้งหมด _Patches ทั้งหมดลงในไดเรกทอรี Arduino SAMD (~/.Arduino15/แพ็คเกจ

สำหรับเวอร์ชันหลัก v1.8.10+

สมมติว่าเวอร์ชัน Arduino SAMD คือ 1.8.13 ตอนนี้จะต้องคัดลอกไฟล์เดียวลงในไดเรกทอรี:

  • ~/.arduino15/packages/arduino/hardware/samd/1.8.13/platform.txt

เมื่อใดก็ตามที่ติดตั้งเวอร์ชันใหม่อย่าลืมคัดลอกไฟล์นี้ลงในไดเรกทอรีเวอร์ชันใหม่ ตัวอย่างเช่นเวอร์ชันใหม่คือ x.yy.zz

ไฟล์นี้จะต้องคัดลอกลงในไดเรกทอรี:

  • ~/.arduino15/packages/arduino/hardware/samd/x.yy.zz/platform.txt

สำหรับเวอร์ชันหลัก v1.8.9-

สมมติว่าเวอร์ชัน Arduino SAMD คือ 1.8.9 ไฟล์เหล่านี้จะต้องถูกคัดลอกลงในไดเรกทอรี:

  • ~/.arduino15/packages/arduino/hardware/samd/1.8.9/platform.txt
  • ~/.arduino15/packages/arduino/hardware/samd/1.8.9/cores/arduino/Arduino.h

เมื่อใดก็ตามที่ติดตั้งเวอร์ชันใหม่อย่าลืมคัดลอกไฟล์เหล่านี้ลงในไดเรกทอรีเวอร์ชันใหม่ ตัวอย่างเช่นเวอร์ชันใหม่คือ x.yy.z

ไฟล์เหล่านี้จะต้องถูกคัดลอกลงในไดเรกทอรี:

  • ~/.arduino15/packages/arduino/hardware/samd/x.yy.z/platform.txt
  • ~/.arduino15/packages/arduino/hardware/samd/x.yy.z/cores/arduino/Arduino.h

นี่เป็นข้อบังคับในการแก้ไข ข้อผิดพลาดของคอมไพเลอร์ Arduino SAMD ที่มีชื่อเสียง ดูปรับปรุงความเข้ากันได้ของ Arduino กับ STL (Min และ Max Macro) 

 ...arm-none-eabiincludec++7.2.1bitsstl_algobase.h:243:56: error: macro "min" passed 3 arguments, but takes just 2
     min(const _Tp& __a, const _Tp& __b, _Compare __comp)

เมื่อใดก็ตามที่ปัญหาข้อผิดพลาดของคอมไพเลอร์ที่กล่าวถึงข้างต้นได้รับการแก้ไขด้วยการเปิดตัว Arduino SAMD ใหม่คุณไม่จำเป็นต้องคัดลอกไฟล์ Arduino.h อีกต่อไป

2. สำหรับบอร์ด Adafruit SAMD

เพื่อให้สามารถรวบรวมได้โดยไม่มีข้อผิดพลาดและตรวจจับและแสดง board_name โดยอัตโนมัติบนบอร์ด Adafruit Samd (itsy-bitsy m4 ฯลฯ ) คุณต้องคัดลอกไฟล์ในแพ็คเกจ Adafruit SAMD_Patches ลงในไดเรกทอรี Adafruit SAMD (~/.ArduIno15/แพ็คเกจ

สมมติว่า Adafruit SAMD Core เวอร์ชันคือ 1.7.11 ไฟล์นี้จะต้องคัดลอกลงในไดเรกทอรี:

  • ~/.arduino15/packages/adafruit/hardware/samd/1.7.11/platform.txt
  • ~/.arduino15/packages/adafruit/hardware/samd/1.7.11/cores/arduino/Print.h
  • ~/.arduino15/packages/adafruit/hardware/samd/1.7.11/cores/arduino/Print.cpp

เมื่อใดก็ตามที่ติดตั้งเวอร์ชันใหม่อย่าลืมคัดลอกไฟล์นี้ลงในไดเรกทอรีเวอร์ชันใหม่ ตัวอย่างเช่นเวอร์ชันใหม่คือ x.yy.zz ไฟล์นี้จะต้องคัดลอกลงในไดเรกทอรี:

  • ~/.arduino15/packages/adafruit/hardware/samd/x.yy.zz/platform.txt
  • ~/.arduino15/packages/adafruit/hardware/samd/x.yy.zz/cores/arduino/Print.h
  • ~/.arduino15/packages/adafruit/hardware/samd/x.yy.zz/cores/arduino/Print.cpp

3. สำหรับกระดาน Seeeduino SAMD

เพื่อให้สามารถรวบรวมได้โดยไม่มีข้อผิดพลาดและตรวจจับและแสดง board_name โดยอัตโนมัติบนบอร์ด Seeeduino Samd (Xiao M0, Wio Terminal, ฯลฯ ) คุณต้องคัดลอกไฟล์ใน SeeDuino SAMD Packages_Patches ลงในไดเรกทอรี Seeeduino SAMD (~/.Arduino15

สมมติว่ารุ่นหลักของ Seeeduino SAMD คือ 1.8.3 ไฟล์นี้จะต้องคัดลอกลงในไดเรกทอรี:

  • ~/.arduino15/packages/Seeeduino/hardware/samd/1.8.3/platform.txt
  • ~/.arduino15/packages/Seeeduino/hardware/samd/1.8.3/cores/arduino/Arduino.h
  • ~/.arduino15/packages/Seeeduino/hardware/samd/1.8.3/cores/arduino/Print.h
  • ~/.arduino15/packages/Seeeduino/hardware/samd/1.8.3/cores/arduino/Print.cpp

เมื่อใดก็ตามที่ติดตั้งเวอร์ชันใหม่อย่าลืมคัดลอกไฟล์นี้ลงในไดเรกทอรีเวอร์ชันใหม่ ตัวอย่างเช่นเวอร์ชันใหม่คือ x.yy.zz ไฟล์นี้จะต้องคัดลอกลงในไดเรกทอรี:

  • ~/.arduino15/packages/Seeeduino/hardware/samd/x.yy.zz/platform.txt
  • ~/.arduino15/packages/Seeeduino/hardware/samd/x.yy.zz/cores/arduino/Arduino.h
  • ~/.arduino15/packages/Seeeduino/hardware/samd/x.yy.zz/cores/arduino/Print.h
  • ~/.arduino15/packages/Seeeduino/hardware/samd/x.yy.zz/cores/arduino/Print.cpp

4. สำหรับบอร์ด SPARKFUN SAMD

เพื่อให้สามารถรวบรวมได้โดยไม่มีข้อผิดพลาดและตรวจจับและแสดง board_name โดยอัตโนมัติบน SparkFun Samd (Xiao Sparkfun_redboard_turbo, sparkfun_samd51_thing_plus, ฯลฯ ) บอร์ด คุณต้องคัดลอก SparkFun SAMD/PACKAGES)

สมมติว่า SparkFun SAMD Core เวอร์ชันคือ 1.8.3 ไฟล์นี้จะต้องคัดลอกลงในไดเรกทอรี:

  • ~/.arduino15/packages/SparkFun/hardware/samd/1.8.3/cores/arduino/Print.h
  • ~/.arduino15/packages/SparkFun/hardware/samd/1.8.3/cores/arduino/Print.cpp
  • ~/.arduino15/packages/SparkFun/hardware/samd/1.8.3/cores/arduino51/Print.h
  • ~/.arduino15/packages/SparkFun/hardware/samd/1.8.3/cores/arduino51/Print.cpp

เมื่อใดก็ตามที่ติดตั้งเวอร์ชันใหม่อย่าลืมคัดลอกไฟล์นี้ลงในไดเรกทอรีเวอร์ชันใหม่ ตัวอย่างเช่นเวอร์ชันใหม่คือ x.yy.zz ไฟล์นี้จะต้องคัดลอกลงในไดเรกทอรี:

  • ~/.arduino15/packages/SparkFun/hardware/samd/x.yy.zz/cores/arduino/Print.h
  • ~/.arduino15/packages/SparkFun/hardware/samd/x.yy.zz/cores/arduino/Print.cpp
  • ~/.arduino15/packages/SparkFun/hardware/samd/x.yy.zz/cores/arduino51/Print.h
  • ~/.arduino15/packages/SparkFun/hardware/samd/x.yy.zz/cores/arduino51/Print.cpp

วิธีแก้ไข Multiple Definitions จำกัดความของตัวเชื่อมโยง

การใช้งานไลบรารีปัจจุบันโดยใช้ xyz-Impl.h แทน xyz.cpp มาตรฐานอาจสร้างข้อผิดพลาดที่เชื่อมโยง Multiple Definitions บางอย่างในบางกรณีการใช้งาน

คุณสามารถรวมไฟล์ .hpp นี้ได้ 

 // Can be included as many times as necessary, without `Multiple Definitions` Linker Error
# include " FlashStorage_SAMD.hpp "     // https://github.com/khoih-prog/FlashStorage_SAMD

ในหลาย ๆ ไฟล์ แต่อย่าลืมใช้ไฟล์ .h ต่อไปนี้ ในไฟล์เพียง 1 .h , .cpp หรือ .ino ซึ่งจะต้อง ไม่รวมอยู่ในไฟล์อื่น Multiple Definitions 

 // To be included only in main(), .ino with setup() to avoid `Multiple Definitions` Linker Error
# include " FlashStorage_SAMD.h "           // https://github.com/khoih-prog/FlashStorage_SAMD

ตรวจสอบตัวอย่าง MultifileProject ใหม่สำหรับการสาธิต HOWTO

ดูการอภิปรายในพฤติกรรมที่แตกต่างกันโดยใช้ src_cpp หรือ src_h lib #80

จำนวนเขียน จำกัด

หน่วยความจำแฟลชมีรอบการเขียนจำนวน จำกัด ความทรงจำของแฟลชทั่วไปสามารถดำเนินการประมาณ 10,000 เขียนวัฏจักรไปยังบล็อกแฟลชเดียวกันก่อนที่จะเริ่ม "เสื่อมสภาพ" และเริ่มสูญเสียความสามารถในการเก็บข้อมูล

ดังนั้น ระวัง: การใช้ห้องสมุดนี้อย่างไม่เหมาะสมสามารถทำลายหน่วยความจำแฟลชของไมโครของคุณได้อย่างรวดเร็วและถาวร โดยเฉพาะอย่างยิ่งคุณควรหลีกเลี่ยงการเรียกใช้ฟังก์ชั่น write() บ่อยเกินไปและตรวจสอบให้แน่ใจว่าในชีวิตทั้งหมดของไมโครจำนวนการโทรที่จะ write ดีต่ำกว่าขีด จำกัด ของ 10,000

ต้องใช้ความระมัดระวังแบบเดียวกันหากคุณใช้ EEPROM API Emulation (ดูด้านล่าง) กับฟังก์ชัน EEPROM.commit()

การใช้งาน

ใช้วัตถุ FlashStorage โดยตรง

ก่อนอื่นคุณต้องประกาศวัตถุ FlashStorage ทั่วโลกสำหรับแต่ละข้อมูลที่คุณตั้งใจจะจัดเก็บในหน่วยความจำแฟลช

ตัวอย่างเช่นหากคุณต้องการจัดเก็บอายุของบุคคลคุณต้องประกาศ age_storage เช่นนี้: 

 FlashStorage (age_storage, int );

คำสั่งนี้หมายถึง "สร้าง FlashStorage เพื่อจัดเก็บตัวแปร int และเรียกมันว่า age_storage " ตอนนี้คุณสามารถใช้ age_storage เป็นสถานที่จัดเก็บจำนวนเต็มได้อย่างปลอดภัย: 

 void readAndStoreUserAge () 
{
  Serial. println ( " Please enter your age: " );
  String age = Serial. readStringUntil ( ' n ' );

  age_storage. write (age. toInt ());  // <-- save the age
}

หลังจากรีเซ็ตไมโครคอนโทรลเลอร์เพื่อดึงอายุที่เก็บไว้ที่คุณสามารถใช้ได้: 

 int user_age = age_storage.read();

ใช้ API ที่มีลักษณะคล้าย EEPROM ทางเลือก

รวม FlashStorage_SAMD.h เพื่อรับการจำลอง Eeprom ด้วยหน่วยความจำแฟลชภายใน

ดูตัวอย่าง Emulateeeprom สำหรับตัวอย่าง

API นั้นคล้ายกับ API API Arduino Eeprom API ที่รู้จักกันดี แต่มี 4 ฟังก์ชั่นเพิ่มเติม:

  • bool isValid() ส่งคืน true ถ้าข้อมูลใน emulated-eEprom นั้นถูกต้อง (ข้อมูลที่เขียนเพื่อแฟลชอย่างน้อยหนึ่งครั้งโดย EEPROM.commit() หรือ EEPROM.put() ) ข้อมูล emulated-eeprom เป็น "ไม่ได้กำหนด" และฟังก์ชั่นส่งคืน false
  • void commit() เก็บข้อมูล EEPROM ใน Flash ใช้สิ่งนี้ด้วยความระมัดระวัง: การโทรทุกครั้งจะเขียนข้อมูลที่สมบูรณ์แบบ-EEPROM เพื่อแฟลช สิ่งนี้จะช่วยลดการเขียนแฟลช-เขียนวารสารที่เหลืออยู่ อย่าเรียกวิธีการนี้ในวงวนหรือคุณจะฆ่าแฟลชของคุณเร็ว ๆ นี้
  • void setCommitASAP(bool value = true) เพื่อตั้งค่าหรือล้างตัวแปรส่วนตัว _commitASAP (ค่าเริ่มต้นเป็น true เพื่อความปลอดภัย) หาก _commitasap เป็นเท็จการเรียกใช้ EEPROM.put() จะไม่บังคับ EEPROM.commit() เพื่อยืดอายุแฟลช คุณจะต้องจำไว้ว่าให้โทร EEPROM.commit() ด้วยตนเองเพื่อบันทึกข้อมูล EMOULD-EEPROM ลงในแฟลชหรือข้อมูลจะหายไป
  • bool getCommitASAP() เพื่อส่งคืนค่าปัจจุบันของ _commitASAP

ตัวอย่าง

  1. eeprom_clear
  2. eeprom_crc
  3. eeprom_get
  4. eeprom_iteration
  5. eeprom_put
  6. eeprom_read
  7. eeprom_update
  8. eeprom_write
  9. Emulateeeprom
  10. FlashStoreDretrieve
  11. storenameandsurname
  12. MultifileProject ใหม่

ตัวอย่างจากห้องสมุดอื่น ๆ

1. ห้องสมุด blynkethernet_wm

  1. AM2315_W5500
  2. DHT11_W5500
  3. enc28j60_blynk
  4. enc28j60_blynk_email
  5. enc28j60_wm_config
  6. ethernetenc_blynk_samd
  7. w5500_blynk
  8. W5500_BLYNK_EMAIL
  9. W5500_WM_CONFIG
  10. W5500_BLYNK_EMAIL_SAMD
  11. W5500_BLYNK_SAMD
  12. W5500_WM_CONFIG_SAMD

2. ห้องสมุด blynk_esp8266at_wm

  1. SAMD_ESP8266SHIELD

3. ห้องสมุด blynk_wifinina_wm

  1. samd_wifinina_wm

4. ห้องสมุด esp_at_wifimanager

  1. การเชื่อมต่ออัตโนมัติ
  2. autoconnectWithFeedback
  3. configonstartup
  4. configonswitch

5. ห้องสมุด esp_at_wm_lite

  1. SAMD_ESP8266SHIELD

6. ห้องสมุด wifimanager_nina_lite

  1. samd_wifinina
  2. samd_wifinina_mqtt

7. ห้องสมุด doubleresetdetector_generic

  1. น้อยที่สุด

8. ไลบรารี MultiresetDetector_Generic

  1. น้อยที่สุด

ตัวอย่าง storenameandsurname

flashstorage_samd/ตัวอย่าง/storenameandsurname/storenameandsurname.ino

บรรทัดที่ 26 ถึง 128 ใน 102e13e

// สาธิตวิธีการใช้ flashstorage_samd กับ API ที่คล้ายกับไลบรารี EEPROM เพื่อจัดเก็บและดึงข้อมูลที่มีโครงสร้าง
// #define eeprom_emulation_size (4 * 1024)
// ใช้ 0-2 ใหญ่ขึ้นสำหรับข้อความการดีบักเพิ่มเติม
# กำหนด flash_debug 0
// จะรวมอยู่ใน main (), .ino ที่มีการตั้งค่า () เพื่อหลีกเลี่ยงข้อผิดพลาดของ linker หลายคำจำกัดความ
# รวม < flashstorage_samd.h >
const int written_signature = 0xBeefDeed ;
// สร้างโครงสร้างที่ใหญ่พอที่จะมีชื่อ
// และนามสกุล ตัวแปร "ถูกต้อง" ถูกตั้งค่าเป็น "จริง" หนึ่งครั้ง
// โครงสร้างเต็มไปด้วยข้อมูลจริงเป็นครั้งแรก
typedef struct
-
ชื่อ ถ่าน [ 100 ];
นามสกุล ถ่าน [ 100 ];
} บุคคล;
การตั้ง ค่าโมฆะ ()
-
อนุกรม เริ่มต้น ( 115200 );
ในขณะที่ (! อนุกรม);
ความล่าช้า ( 200 );
อนุกรม พิมพ์ ( f ( " n start storenameandsurname บน " ));
อนุกรม println (board_name);
อนุกรม println (flash_storage_samd_version);
อนุกรม พิมพ์ ( " ความยาว EEPROM: " );
อนุกรม println (eeprom. length ());
// ตรวจสอบลายเซ็นตามที่อยู่ 0
int ลายเซ็น;
// สร้างตัวแปร "บุคคล" และเรียกมันว่า "เจ้าของ"
uint16_t storedaddress = 0 ;
เจ้าของบุคคล;
Eeprom รับ (storedaddress, ลายเซ็น);
// ถ้า EEPROM ว่างเปล่าก็ไม่มีการเขียน _Signature
if (signature == written_signature)
-
Eeprom รับ (storedaddress + sizeof (ลายเซ็น), เจ้าของ);
// ทักทายผู้ใช้ที่ส่งคืน!
อนุกรม พิมพ์ ( " สวัสดี " );
อนุกรม พิมพ์ (เจ้าของ. ชื่อ );
อนุกรม พิมพ์ ( " " );
อนุกรม พิมพ์ (เจ้าของ. นามสกุล );
อนุกรม println ( " ยินดีที่ได้พบคุณอีกครั้ง :-) " );
อนุกรม println ( " การล้าง written_signature สำหรับการลองครั้งต่อไป " );
Eeprom ใส่ ( 0 , 0 );
อนุกรม println ( " ทำลายเซ็นการล้างลงใน Eeprom ที่เลียนแบบคุณสามารถรีเซ็ตได้แล้ว " );
-
อื่น
-
อนุกรม println ( " EEPROM ว่างเปล่าเขียน Writing_Signature และข้อมูลตัวอย่าง: " );
Eeprom ใส่ (storedaddress, written_signature);
// ... ในกรณีนี้เราขอข้อมูลผู้ใช้
อนุกรม Settimeout ( 30000 );
อนุกรม พิมพ์ ( " แทรกชื่อของคุณ: " );
ชื่อสตริง = อนุกรม readstringuntil ( ' n ' );
อนุกรม println (ชื่อ);
อนุกรม พิมพ์ ( " แทรกนามสกุลของคุณ: " );
นามสกุลสตริง = อนุกรม readstringuntil ( ' n ' );
อนุกรม println (นามสกุล);
// เติมโครงสร้าง "เจ้าของ" ด้วยข้อมูลที่ป้อนโดยผู้ใช้ ...
ชื่อ. Tochararray (เจ้าของ. ชื่อ , 100 );
นามสกุล. Tochararray (เจ้าของ. นามสกุล , 100 );
// ... และในที่สุดก็บันทึกทุกอย่างลงใน Emulated-eEprom
Eeprom ใส่ (storedaddress + sizeof (ลายเซ็น), เจ้าของ);
ถ้า (! eeprom. getCommitasap ())
-
อนุกรม println ( " commitasap ไม่ได้ตั้งค่าต้องการ commit () " );
Eeprom ให้สัญญา ();
-
// พิมพ์การยืนยันข้อมูลที่แทรก
อนุกรม พิมพ์ ( " << ชื่อของคุณ: " );
อนุกรม พิมพ์ (เจ้าของ. ชื่อ );
อนุกรม พิมพ์ ( " . นามสกุลของคุณ: " );
อนุกรม พิมพ์ (เจ้าของ. นามสกุล );
อนุกรม println ( " >> ได้รับการบันทึกแล้วขอบคุณ! " );
อนุกรม println ( " คุณสามารถรีเซ็ตเพื่อตรวจสอบการเก็บรักษาข้อมูล emulated-eEprom " );
-
-
เป็นโมฆะ ลูป ()
-
// ไม่ทำอะไรเลย ...
-

ตัวอย่างเอาต์พุตเทอร์มินัลดีบัก

1. W5500_BLYNK บน ADAFRUIT SAMD51 ITSYBITSY_M4 โดยใช้ W5500 Ethernet Shield

ต่อไปนี้เป็นเอาต์พุตเทอร์มินัลตัวอย่างเมื่อเรียกใช้ตัวอย่าง W5500_BLYNK บน ADAFRUIT SAMD51 ITSYBITSY_M4 โดยใช้ W5500 Ethernet Shield

1.1. ไม่มีข้อมูลการกำหนดค่าที่มี load_default_config_data = false => config portal ไม่โหลดข้อมูลรับรองเริ่มต้น 

Start W5500_Blynk on ITSYBITSY_M4
[ 936 ] ChkCrR:CrCCSum= 0xaf50 ,CrRCSum= 0xffffffff
[ 936 ] CCSum= 0x0 ,RCSum= 0x0
[ 936 ] Invalid Stored Dynamic Data. Load default from Sketch
[ 937 ] SaveEEPROM,Sz= 1024 ,DataSz= 0 ,WCSum= 0x1d4d
[ 944 ] CrCCSum= 0x29a6
[ 944 ] MAC:FE-A8- 80 -C6-CE-A3
_pinCS = 0
W5100 init, using SS_PIN_DEFAULT = 10 , new ss_pin = 10 , W5100Class::ss_pin = 1
W5100::init: W5500, SSIZE = 8192
[ 2632 ] IP: 192.168.2.153
[ 2633 ] b:Stay in CfgPortal:No CfgDat
[ 2633 ] CfgIP= 192.168.2.153
F
Your stored Credentials :
MQTT Server = default -mqtt-server
Port = 1883
MQTT UserName = default -mqtt-username
MQTT PWD = default -mqtt-password
Subs Topics = default -mqtt-SubTopic
Pubs Topics = default -mqtt-PubTopic
FFFFF
[ 339285 ] SaveEEPROM,Sz= 1024 ,DataSz= 0 ,WCSum= 0x2e89
[ 339292 ] CrCCSum= 0x219f

1.2. อินพุตข้อมูลรับรองที่ถูกต้องด้วย load_default_config_data = false คลิก Save => รีบูต 

Start W5500_Blynk on ITSYBITSY_M4
[ 1547 ] ChkCrR:CrCCSum= 0x219f ,CrRCSum= 0x219f
[ 1547 ] CCSum= 0x0 ,RCSum= 0x0
[ 1548 ] CrCCSum= 0x219f ,CrRCSum= 0x219f
[ 1548 ] ======= Start Stored Config Data =======
[ 1548 ] Hdr=W5X00,BName=Seeeduino_W5500_BlynkWM
[ 1548 ] Svr=account.duckdns.org,Tok=new_token1
[ 1549 ] Svr1=account.ddns.net,Tok1=new_token2
[ 1549 ] Prt= 8080 ,SIP= 192.168.2.220
[ 1549 ] connectEthernet: Use static_IP= 192.168.2.220
[ 1549 ] MAC:FE-A1-D4-BC- E8 -CB

W5100 init, using SS_PIN_DEFAULT = 10 , new ss_pin = 10 , W5100Class::ss_pin = 1
W5100::init: W5500, SSIZE = 8192
[ 3131 ] IP: 192.168.2.220
[ 3131 ] bg:ECon.TryB
[ 3131 ] 
    ___  __          __
   / _ )/ /_ _____  / /__
  / _  / / // / _ /  '_/
 /____/_/_, /_ // _/_/_
        /___/ v0.6.1 on Arduino Zero

[ 3132 ] BlynkArduinoClient.connect: Connecting to account.duckdns.org: 8080
[ 3244 ] Ready (ping: 6ms).
[ 3311 ] Connected to BlynkServer=account.duckdns.org,Token=new_token1
[ 3311 ] bg:EBCon
Conn2Blynk: server = account.duckdns.org, port = 8080
Token = new_token1, IP = 192.168.2.220
B
Your stored Credentials :
MQTT Server = new -mqtt-server
Port = 1883
MQTT UserName = new -mqtt-username
MQTT PWD = new -mqtt-password
Subs Topics = new -mqtt-SubTopic
Pubs Topics = new -mqtt-PubTopic
BBBBBBBBB BBBBBBBBBB BBBBBBBBBB BBBBBBBBBB BBBBBBBBBB BBBBBBBBBB BBBBBBBBBB

2. StorenameAndsurname บน SAMD21 SEEED_XIAO_M0

2.1. ไม่มีข้อมูล => อินพุตจากนั้นบันทึก 

Start StoreNameAndSurname on SEEED_XIAO_M0
FlashStorage_SAMD v1 .3.2
EEPROM length: 1024
EEPROM is empty, writing WRITTEN_SIGNATURE and some example data:
Insert your name : John

Insert your surname : Doe

<< Your name: John. Your surname: Doe >> have been saved. Thank you!
You can reset to check emulated-EEPROM data retention.

2.2. การเก็บข้อมูลหลังจากรีเซ็ต 

Start StoreNameAndSurname on SEEED_XIAO_M0
FlashStorage_SAMD v1 .3.2
EEPROM length: 1024
Hi John Doe, nice to see you again :-)
Clearing WRITTEN_SIGNATURE for next try
Done clearing signature in emulated EEPROM. You can reset now

3. EEPROM_CLEAR บน SAMD21 SEEED_XIAO_M0

3.1. 1ms เพื่อล้าง 1K ไบต์ emulated-eEprom 

Start EEPROM_Clear on SEEED_XIAO_M0
FlashStorage_SAMD v1 .3.2

Emulated EEPROM length (bytes) = 1024

Done clearing emulated EEPROM. Time spent (ms) = 11

3.2. 22ms เพื่อล้าง 2K ไบต์ emulated-eeprom 

Start EEPROM_Clear on SEEED_XIAO_M0
FlashStorage_SAMD v1 .3.2
Emulated EEPROM length (bytes) = 2048
Done clearing emulated EEPROM. Time spent (ms) = 22

3.3. 42ms เพื่อล้าง 4K ไบต์จำลอง-EEPROM 

Start EEPROM_Clear on SEEED_XIAO_M0
FlashStorage_SAMD v1 .3.2
Emulated EEPROM length (bytes) = 4096
Done clearing emulated EEPROM. Time spent (ms) = 42

4. eeprom_get บน samd21 seeed_xiao_m0

4.1. ไม่มีข้อมูลที่ถูกต้องเขียนลายเซ็นและข้อมูล 

Start EEPROM_get on SEEED_XIAO_M0
FlashStorage_SAMD v1 .3.2
EEPROM length: 1024
EEPROM doesn ' t store valid data, writing WRITTEN_SIGNATURE and some example data
Float written to EEPROM: 123.456
Done writing custom object to EEPROM: 
===============
Field1: 3.14159
Field2: 65
Name: Working!
===============
Reset to see how you can retrieve the values by using EEPROM_get!

4.2. ลายเซ็นและข้อมูลที่ถูกต้องอ่านข้อมูล 

Start EEPROM_get on SEEED_XIAO_M0
FlashStorage_SAMD v1 .3.2
EEPROM length: 1024
EEPROM has valid data with WRITTEN_SIGNATURE. Now read some example data
Read float from EEPROM: 123.456
Read custom object from EEPROM: 
===============
Field1: 3.14159
Field2: 65
Name: Working!
===============

คำถามที่พบบ่อย

ฉันสามารถใช้วัตถุเดียวเพื่อเก็บสิ่งของเพิ่มเติมได้หรือไม่?

ใช่คุณสามารถประกาศ struct ที่มีฟิลด์เพิ่มเติมและเรียก EEPROM.put() เพื่อจัดเก็บโครงสร้างทั้งหมด ดู storenameandsurname สำหรับวิธีการทำ

เนื้อหาของ FlashStorage จะถูกลบทุกครั้งที่อัปโหลดร่างใหม่หรือไม่?

ใช่ทุกครั้งที่คุณอัปโหลดร่างใหม่เนื้อหาก่อนหน้าของ FlashStorage จะถูกลบ

คุณแนะนำให้ใช้แฟลชแทน EEPROM หรือไม่?

ไม่ได้หากคณะกรรมการของคุณมีการรวมเข้าด้วยกันขอแนะนำให้ใช้สิ่งนั้นเนื่องจาก EEPROM มีอายุการใช้งานนานขึ้นจำนวนวัฏจักรการเขียน ฯลฯ )

ในกรณีที่ไม่มีตัวตนแบบรวมหรือขนาดเล็กเกินไปสำหรับกรณีการใช้งานของคุณคุณสามารถใช้ไลบรารีนี้เพื่อใช้หน่วยความจำแฟลชส่วนเล็ก

การแก้ไขปัญหา

หากคุณได้รับข้อผิดพลาดในการรวบรวมบ่อยกว่านั้นคุณอาจต้องติดตั้ง Core รุ่นใหม่สำหรับบอร์ด Arduino

บางครั้งไลบรารีจะทำงานได้ก็ต่อเมื่อคุณอัปเดตแกนบอร์ดเป็นเวอร์ชันล่าสุดเพราะฉันใช้ฟังก์ชั่นที่เพิ่มขึ้นใหม่

ปัญหา

ส่งปัญหาไปยัง: ปัญหา flashstorage_samd

สิ่งที่ต้องทำ

  1. ค้นหาข้อผิดพลาดและการปรับปรุง
  2. คุณสมบัติที่คล้ายกันสำหรับบอร์ด Arduino ที่เหลืออยู่

เสร็จแล้ว

  1. Emulated-EEPROM ขั้นพื้นฐานสำหรับ SAMD21/SAMD51
  2. เพิ่มฟังก์ EEPROM.put() และ EEPROM.get() เพื่ออ่าน/เขียนโครงสร้างทั้งหมดใน emulated-eeprom
  3. คุณสมบัติที่คล้ายกันสำหรับ STM32F/L/H/G/WB/MP1
  4. เพิ่มสารบัญ
  5. เพิ่มการสนับสนุนอุตสาหกรรม SAMD21 DG21 และ Industruino SAML21 420Maker Boards
  6. เพิ่มการรองรับ บอร์ด SPARKFUN SAMD21 และ SAMD51
  7. แก้ไขข้อผิดพลาดของ Linker multiple-definitions
  8. เพิ่มการสนับสนุนให้กับบอร์ดอื่น ๆ อีกมากมายเช่น SAMD21E1xA , SAMD21G1xA และ SAMD21J1xA
  9. ทำความสะอาดโดยการลดจำนวนไฟล์ไลบรารี
  10. ทำให้เข้ากันได้กับห้องสมุดและรหัสเก่า

ผลงานและขอบคุณ

  1. ขึ้นอยู่กับและแก้ไขจาก FlashStorage ของ Cristian Maglie เครดิตส่วนใหญ่ไปที่ Cristian Maglie
cmaglie
Cristian Maglie

การบริจาค

หากคุณต้องการมีส่วนร่วมในโครงการนี้:

  • รายงานข้อบกพร่องและข้อผิดพลาด
  • ขอการปรับปรุง
  • สร้างปัญหาและดึงคำขอ
  • บอกคนอื่นเกี่ยวกับห้องสมุดนี้

ใบอนุญาต

  • ห้องสมุดได้รับอนุญาตภายใต้ LGPLV3
ขยาย
ข้อมูลเพิ่มเติม
แอปที่เกี่ยวข้อง
แนะนำสำหรับคุณ
ข้อมูลที่เกี่ยวข้อง ทั้งหมด