EasyFlash скачать - загрузка исходного кода EasyFlash

EasyFlash

ФЛЕШ-исходный код

Easy

Скачать

Easyflash

1. Введение (английский)

Совет : После Easyflash v4.1 был официально запущен проект FlashDB с открытым исходным кодом, недавно разработанный и разработан на основе EasyFlash. Он имеет вновь интегрированные функции, такие как база данных TIME, управление несколькими частями и несколько экземпляров базы данных, что также в определенной степени улучшила общую производительность. Добро пожаловать: https://github.com/armink/flashdb. В то же время существующий EasyFlash будет продолжать поддерживать.

EasyFlash - это легкая библиотека встроенной флэш -памяти с открытым исходным кодом, которая облегчает разработчикам реализацию общей разработки приложений на основе флэш -памяти. Он очень подходит для умного дома, носимого, промышленного контроля, медицинского обслуживания, Интернета вещей и других продуктов, которые требуют функций хранения отключения. Он имеет чрезвычайно низкое использование ресурсов и поддерживает различную память MCU. Эта библиотека в основном включает в себя три практические функции :

ENV быстро сохраняет параметры продукта, поддерживает баланс записи (баланс износа) и функции защиты от питания

EasyFlash может не только реализовать функцию хранилища внизу информации, такую как настройка параметров или запуск журналов продуктов, но также инкапсулировать простые методы добавления, удаления, изменения и запроса , уменьшая сложность разработчиков при обработке параметров продукта и обеспечения лучшей масштабируемости продукта в более поздних обновлениях. Сделайте Flash малой базой данных хранения клавиш, которая превращает Flash в модель NOSQL (нереляционная база данных).

Онлайн -обновление IAP больше не сложно

Эта библиотека инкапсулирует обычно используемый интерфейс функции IAP (программирование в приложении), поддерживает проверку CRC32 и поддерживает обновления загрузчика и приложений.

Журнал не требует файловой системы, журналы можно хранить непосредственно на Flash

Он идеально подходит для небольших продуктов без файловых систем, что облегчает разработчикам быстро определять местонахождение и найти причины сбоев системы или сбоев. В то же время он используется с easylogger (мой высокопроизводительный промежуток с открытым исходным кодом, высокоэффективная библиотека C, которая обеспечивает беспроблемный интерфейс с EasyFlash) и легко реализует функцию хранения флэш-памяти журналов C.

1.1 Два режима ENV

В настоящее время существует два основных режима функции ENV, один из них - режим NG , приведенный в v4.0, а другой - это устаревший режим, который продолжает v3.0

1.1.1, режим NG, введенный в v4.0

Соответствующий файл исходного кода: ef_env.c

С момента весеннего фестиваля в 2019 году EasyFlash наконец -то выпустил V.4.0 версию после более чем 4 лет итерации и в сочетании с потребностями и предложениями многих разработчиков. Функция ENV в этой версии называется режим NG (Next Generation). Это совершенно рефакторная новая версия со следующими новыми функциями:

Меньшее использование ресурсов, почти 0 использования памяти; (Предыдущие версии V4.0 будут использовать дополнительную оперативную память для кеша)
Тип значения Env поддерживает любой тип и любую длину, что эквивалентно направлению переменной Memcpy на Flash; (До v4.0 были поддержаны только строки)
Эффективность работы ENV выше, чем у предыдущих режимов, в полном использовании оставшихся областей холостого хода, а количество сборов и время работы значительно снижается;
Нативная поддержка баланса износа и защиты от питания (до v4.0 требуются дополнительные сектора вспышки);
ENV поддерживает инкрементные обновления , и ENV также поддерживает обновления после обновлений прошивки;
Поддерживает режим хранения больших данных, неограниченную длину и данные, которые могут быть последовательно храниться в нескольких секторах флэш -секторов. Ресурсы, такие как программы сценариев и аудио, которые занимают более 1 сектора Flash, также могут храниться в ENV (в ближайшее время он будет поддержан в V4.2);
Поддерживает шифрование данных , улучшает безопасность хранения и является необходимой функцией в эпоху Интернета вещей (он будет поддерживаться в скорости V4.3);
Поддерживает сжатие данных и уменьшает использование вспышки (оно будет поддерживаться в скорости V4.4);

V4.0 Дизайн и внутренние принципы, Руководство по миграции v4.0 и многое другое, пожалуйста, продолжайте читать следующее раздел документации

Примечание . Некоторые вспышки не могут быть записаны в обратном порядке, например, на Chip Flash STM32L4, поэтому режим NG не может быть использован. В этом случае рекомендуется использовать устаревший режим v3.0.

1.1.2. Продолжить режим устаревшего v3.0

Соответствующие файлы исходного кода: ef_env_legacy.c и ef_env_legacy_wl.c

Legacy Mode также обладает функциями баланса и износа. По сравнению с режимом V 4,0 нг, использование устаревшего режима требует дополнительного пространства ОЗУ для временного кэширования каждой ENV, и, наконец, вызов интерфейса сохранения, равномерно стирайте сектора, а затем храните их на вспышке.

1.1.3 Сравнение режима ENV

	V4.0 ng Режим	V3.0 устаревший режим
Использование ресурсов RAM	Низкий	высокий
Поддержать всестороннюю всестороннюю	Некоторая вспышка ограничена: например, STM32L4 In-Chip	Более всеобъемлющий
Требуется ли сборку мусора GC?	Требуется GC, что приводит к замедлению скорости записи, когда GC запускается	ненужный
предел типа значения	Неограниченный	Он поддерживает лучшие типы строк
Защита от включения	поддерживать	поддерживать
Носить баланс	поддерживать	поддерживать
Повышенное обновление	поддерживать	поддерживать

1.2. Ресурсная занятия

最低要求： ROM: 6K bytes     RAM: 0.1K bytes

1.3. Платформа поддержки

В настоящее время аппаратные платформы были пересажены включают в себя вспышку серии stm32f10x и stm32f4xx , а также Flash Off-Chip SPI (на основе SFUD), которые также являются платформами, используемыми продуктами автора. Портирование других платформ не сложно. В начале проекта проекта были рассмотрены проблемы адаптивности для всех платформ (кроме 64-битных), поэтому все портовые интерфейсы были зарезервированы. Для порта вам нужно только изменить файл easyflashportef_port.c чтобы реализовать функции стирания, написания, чтения и печати.

Добро пожаловать в Fork и запрос на вытягивание (GitHub | Oschina | Кодирование). Если вы думаете, что этот проект с открытым исходным кодом великолепен, вы можете щелкнуть Star в правом верхнем углу домашней страницы проекта и порекомендовать его больше друзей.

2. Процесс

2.1. Env: переменные среды (база данных KV)

Следующий рисунок является общим интерфейсом для вызова переменных среды через консоль (терминал). Он демонстрирует следующий процесс, который поддерживает прямые вызовы при приложении.

1. Создать переменную среды «температуры» с именем temp и назначить значение 123 ;
2. Сохраните «температуру» в вспышку и перезапуск (каждая операция в V4.0 автоматически сохраняется после ее завершения, дополнительная экономия не требуется);
3. Проверьте, была ли «температура» успешно храниться;
4. Измените значение «температуры» до 456 и сохранить и перезапустить;
5. Проверьте, была ли «температура» успешно изменена;
6. Удалить переменную среды «температуры».

easy_flash_env

2.2. IAP: онлайн -обновление

На следующем рисунке демонстрируется процесс обновления программного обеспечения IAP через консоль. Он использует интерфейс функции IAP, который поставляется с библиотекой, а демонстрация использует протокол последовательного порта + Ymodem. Вы также можете реализовать обновления удаленных сети через Can, 485, Ethernet и другие автобусы.

easy_flash_iap

2.3. Журнал: хранилище журнала

Приведенный ниже процесс должен вывести журнал через консоль и сохранить выходной флэш -флэш. Перезапустите и прочитайте последний сохраненный журнал и, наконец, очистите журнал Flash.

easy_flash_log

3. Документация

Документация API: docszhapi.md
Миграционная документация: docszhport.md
V4.0 Руководство по миграции: docszhv4_migrate.md
V4.0 Env Function Design и реализация: docszhdesign.md

Обязательно используйте его после прочтения документа .

4. Поддержка

Поддерживать

Если easyflash решит вашу проблему, вы можете также сканировать QR -код выше, чтобы пригласить меня на чашку кофе ~

5. Лицензия

Используйте протокол MIT с открытым исходным кодом. Пожалуйста, прочитайте содержимое файла лицензии в проекте для получения подробной информации.

1 Введение

EasyFlash - это легкая библиотека встроенной флэш -памяти с открытым исходным кодом. Он обеспечивает удобный интерфейс применения для MCU (Micro Control Unit). Разработчики могут достичь более эффективной и общей разработки приложений на основе флэш -памяти. Библиотека в настоящее время предоставляет три полезные функции :

Env (переменные среды) быстро сохраняет параметры продукта. Поддержите режим баланса записи (выравнивание износа) и защиту отказа от мощности .

EasyFlash может хранить параметры настройки или запуск журналов и другую информацию, которую вы хотите сохранить после питания. Он содержит добавление, удаление, модифицировать и запросить методы. Это помогает разработчику обработать параметры продукта и убедиться, что продукт имеет лучшую масштабируемость после обновления. Включает вспышку в небольшую модель NOSQL (нереляционные базы данных) и базу данных для ключей.

IAP : онлайн -обновление больше не является сложной вещью.

Библиотека инкапсулирует общий интерфейс IAP (программирование в области применения). Поддержка контрольной суммы CRC32. При поддержке загрузчика и обновления приложений.

Журнал : Журналы могут хранить в Flash Product, которая не имеет файловой системы.

Он очень подходит для малых без продуктов файловой системы. Разработчик может легко найти проблему и запрашивать проблему при сбое системы или замораживает. Вы можете использовать EasyLogger (супер-легкий, высокопроизводительный библиотеку C Log, которая откроет меня. Он обеспечивает бесшовный интерфейс с EasyFlash) одновременно. Таким образом, так легко хранить журналы, чтобы вспыхивать.

1.1 Потребление ресурсов

 Minimum : ROM: 6K bytes     RAM: 0.2K bytes

1.2 Поддерживаемые платформы

Аппаратная платформа была портированной SPI Flash, stm32f10x и stm32f4xx серии встроенной вспышки. Это мои платформы для продуктов. Сложность портирования платформы мало. Для порта он просто изменить easyflashportef_port.c файл. Реализуйте стирание, записать, читать, печатать функцию.

Добро пожаловать всем, чтобы покинуть и потянуть запрос (GitHub | Oschina | Кодирование). Если вы думаете, что этот проект с открытым исходным кодом потрясающий. Вы можете нажать звезду в правом верхнем углу домашней страницы Project и рекомендовать ее больше друзей.

2 потока

2.1 Env (база данных KV)

На рисунке ниже показан общий интерфейс Env, который можно назвать консолью (терминал). Эти интерфейсы поддерживаются приложением, вызванным.

1. Создайте переменную температурную среду. Его имя temp , а значение - 123 ;
2. Получите температуру, чтобы вспыхивать и перезагрузить;
3. Проверьте температуру успешно сэкономила;
4. Совместите значение температуры до 456 и сохраните, перезагрузите;
5. Проверьте температуру успешно изменилась;
6. Удалить переменную температуру.

easy_flash_env

2.2 IAP

На рисунке ниже показан процесс обновления программного обеспечения через консоль с помощью IAP. Использует эту библиотеку с интерфейсом функции IAP. Он использует режим протокола последовательного порта + Ymodem. Вы также можете быть достигнуты с помощью Can, 485, Ethernet Bus до онлайн -обновления.

easy_flash_iap

2.3 Журнал

Следующим рисунком является вывод процесса журнала через консоль. Журналы сохраняются, чтобы вспыхивать в режиме реального времени. Затем доска перезагружается, и журналы обратно читаются от Flash. На последних журналах будут стерты.

easy_flash_log