ArduinoMenu下载ArduinoMenu源代码下载

ArduinoMenu

网站数据

v4.21.4

下载

Arduinomenu 4

Arduino框架的通用菜单/交互性系统

目的

完整的自动化或用户代码驱动的导航系统。使用此系统，您可以定义菜单，子菜单，输入字段和其他涉及所有输入/输出的迭代对象，并且可以通过用户迭代而调用用户定义的处理程序。用户函数可以作为单个操作，在单击/输入上或事件驱动的函数响应焦点IN/OUT或ENTER/ESC事件。该系统被设计为非阻止投票系统，允许并发任务运行。可选的系统可以在半自动化模式下操作，从用户代码发出导航命令。

看到Wiki

简单示例

# include < menu.h >
# include < menuIO/serialOut.h >
# include < menuIO/chainStream.h >
# include < menuIO/serialIn.h >

using namespace Menu ;

# define LEDPIN LED_BUILTIN
# define MAX_DEPTH 1

unsigned int timeOn= 10 ;
unsigned int timeOff= 90 ;

MENU (mainMenu, " Blink menu " , Menu::doNothing, Menu::noEvent, Menu::wrapStyle
  ,FIELD(timeOn, " On " , " ms " , 0 , 1000 , 10 , 1 , Menu::doNothing, Menu::noEvent, Menu::noStyle)
  ,FIELD(timeOff, " Off " , " ms " , 0 , 10000 , 10 , 1 ,Menu::doNothing, Menu::noEvent, Menu::noStyle)
  ,EXIT( " <Back " )
);

serialIn serial (Serial);
MENU_INPUTS (in,&serial);

MENU_OUTPUTS (out,MAX_DEPTH
  ,SERIAL_OUT(Serial)
  ,NONE // must have 2 items at least
);

NAVROOT (nav,mainMenu,MAX_DEPTH,in,out);

void setup () {
  pinMode (LEDPIN, OUTPUT);
  Serial. begin ( 115200 );
  while (!Serial);
  Serial. println ( " Menu 4.x " );
  Serial. println ( " Use keys + - * / " );
  Serial. println ( " to control the menu navigation " );
}

bool blink ( int timeOn, int timeOff) { return millis ()%( unsigned long )(timeOn+timeOff)<( unsigned long )timeOn;}

void loop () {
  nav. poll ();
  digitalWrite (LEDPIN, blink (timeOn,timeOff));
}

特征

在RAM上使用Progmem在可用的系统上使用Progmem的小占地面积。
支持各种输入/输出设备。
易于定义菜单（宏）。
简约的用户代码库。
字段编辑值连接到现有程序变量（参考）。
每个字符验证编辑文本字段。
字段可以编辑任何类型（模板）的数字变量。
反身字段，显示菜单系统之外完成的可变更改。
数值字段编辑和范围验证。
数字和非数字类型的枚举字段
可自定义（颜色和光标）。
能够在串行流IO作为基础级别上工作。
并行支持多个输入和输出。
RAM的静态分配，避免了堆积的碎片，在程序启动时分配了定义菜单结构所需的所有RAM。
可用于菜单和提示的活动
只需在无需输入而不需要绘制时返回即可。
懒惰的图纸，只有在更改时才能绘制，避免了时间消耗和闪烁。
同步/异步导航API功能
无状态客户端的异步导航（作为网络）
Web界面（实验）
可以局限于显示区域（数字字段仍然可以溢出该区域，用户应考虑到它们）
在Arduino AVR的ARM，Teensy，ESP8266，ESP32，NRF52，STM32上测试

视频

插件

插件是特定的菜单组合或项目自定义行为和/或图纸。

某些插件可能是特定于平台的，也可能需要一些硬件。

Barfield-在LCD上显示数字字段的栏
Cancelfield-允许恢复Escape上的先前数值。
SDMENU-使用标准Arduino SD Lib，完整的自动化SD卡文件选择器。
SDFATMENU-使用标准SDFAT（https://github.com/greiman/sdfat）完整自动化SD卡文件选择器。

申请

一些使用Arduinomenu（当前和旧版本）的应用程序/教程。
你有另一个吗？请让我在吉特（Gitter）或给我发电子邮件。

温度传感器和计时器的Arduino脚本。它允许打开加热器并相应地安排
https://github.com/vikulin/lcd_lat

Project-GlasskilnController电加热窑，用于制作“温暖玻璃”
https://arduinoinfo.mywikis.net/wiki/project-glasskilncontroller

Arduinomenu Demo ttgo t-display很棒的教程。
https://sites.google.com/site/jmaathuis/arduino/lilygo-ttgo-ttgo-t-display-esp32/arduinomenu-demo-demo-ttgo-t-display

MVC接口Arduinomenu教程
https://zaragozamakerspace.com/index.php/courses/mvc-interface/

Arduino自动铜胶带切割器
https://www.thingiverse.com/thing:3557719

重新加载粉末料斗水平量表和警报
https://github.com/nathandarnell/reloading-powder-hopper-level-gauge-and-alarm

Servobox伺服测试仪和显示器
https://github.com/jarkman/servobox

Panobot A Panorama机器人
https://github.com/robertfach/panobot

基于Teensy-Midi-looper微控制器MIDI Performance Sequencer
https://github.com/newdigate/teensy-midi-looper

放大器Concontrol自动化程序，以打开/关闭放大器和肯伍德的频段解码
https://github.com/petrlab/amplifiercontrol

SPNA Arduino单端口网络分析仪（SPNA）
https://github.com/tczerwonka/spna

Lrduino在汽车多量规系统中-STM32，SSD1306，MAX31856，ADXL345，ELM327
https://github.com/bennehboy/lrduino

汽车多规格系统中的Lrduinotd5 -STM32，SSD1306，Max31856，ADXL345，L9637D，TD5 ECU
https://github.com/bennehboy/lrduinotd5

Thom-Radio Internet Radio Build
https://github.com/evfool/thom-radio

MIDI_DRUMS 7 CHANEL PIEZO MIDI鼓盒，菜单上的菜单
https://github.com/sobollion/midi_drums

Beallincingrobot
https://github.com/slbarker/balancingrobot

SWATILI 50L水表带阀门控制，LCD，按钮，RTC和Hall效应脉冲阅读器
https://github.com/daniel-leonard-robinson/swatili

Fielduino硬件PWM生成器使用菜单选择频率和DUTTY。
https://github.com/neu-rah/fielduino

硬件设备的arduinomultidesktop多侧ktop概念
https://github.com/dontsovcmc/arduinomultidesktop

SmartGreenhouse
https://github.com/dontsovcmc/smartgreenhouse/tree/master/src

Console.Arduino便携式串行调试控制台使用ILI9341
https://github.com/malachib/console.arduino

平台

ATMEL AVR，ATMEL SAM，ESPRESSIF 32，ESPRESSIF 8266，INTEL ARC32，MICROCHIP PIC32，NORDIC NRF51，NORDIC NRF52，ST STM32，TIENSY，TIENSY，TI MSP430

安装

Arduino IDE-使用图书馆管理器（Arduinomenu Library -Rui Azevedo）安装

Platformio -http：//platformio.org/lib/show/1468/arduinomenu%20library

IO设备

输出设备

系列

https://www.arduino.cc/en/reference/serial

串行监视器。

标准Arduino LCD图书馆

https://www.arduino.cc/en/reference/liquidcrystal

HD44780

f Malpartida的LCD

https://bitbucket.org/fmalpartida/new-liquidcrystal/wiki/home

HD44780直接
HD44780 I2C
HD44780 SPI

Matthias Hertel PCF8574驱动程序

https://github.com/mathertel/liquidcrystal_pcf8574

HD44780

Arduino TFT设备

https://www.arduino.cc/en/guide/tft

SSD13061

https://github.com/greiman/ssd1306ascii

基于SSD1306控制器的OLED屏幕

TFT_ESPI

ESP8266和ESP32的Arduino IDE兼容图形和字体库
https://github.com/bodmer/tft_espi

ILI9341，ILI9163，ST7735，S6D02A1，ILI9481，ILI9486，ILI9488，HX8357D，ST7789，ILI9486
WaveShare 2和3彩色SPI epaper显示器

TFT_HX8357驱动程序

https://github.com/bodmer/tft_hx8357

HX8357B，HX8357C，ILI9481和ILI9486

Adafruit的GFX设备

https://github.com/adafruit/adafruit-gfx-library

RGBMATRIXPANEL，16x32和32x32 RGB LED矩阵面板。
Adafruit_tftlcd，2.8“ TFT LCD触摸屏突破和Arduino的TFT触摸屏。
ADAFRUIT_HX8340B，2.2“带有microSD的TFT显示屏。
ADAFRUIT_ST7735，1.8“带有microSD的TFT显示屏。
Adafruit_pcd8544，用于诺基亚5110/3310单色LCD。
Adafruit-Graphic-VFD-Display-library，用于128x64图形VFD。
Adafruit-SSD1331- old-old-driver-library-for-arduino用于0.96“ 16位颜色w/microSD持有人。
单色128x64和128x32 OLED的AdaFruit_SSD1306。

UTFT设备

http://www.rinkydinklectronics.com/library.php?id=51

ITDB02系列 - Itead Studio
TFT01系列 - 电子
RGB LCD -NKC电子。

U8GLIB设备

https://github.com/olikraus/u8glib_arduino

SSD1306，128x64，SSD1306，128x32，SSD1306，64x48，SSD1309，128X64，SSD1322，256x64，SSD1325，128x64 UC1608，240x64，UC1610，160x104，UC1611，240x64，UC1611，240x128，uc1701，128x64，uc1701，102x64，102x64，sT7565，128x64，128x64，128x64，ST7565，128565，1289999999999999999999999999999999999999999999.9999,9999999999933岁零售店 192x32, ST7920, 202x32, LD7032, 60x32, PCD8544, 84x48, TLS8204 , 84x48, PCF8812 , 96x65, KS0108 , 128x64, T6963, 128x64, T6963, 128x128, T6963, 240x64, T6963，240x128，SBN1661，122x32，LC7981，160x80，LC7981，240x64，LC7981，240x128，LC7981，320x64

U8G2和U8X8设备

https://github.com/olikraus/u8g2_arduino

SSD1305 128X32_NONAME，SSD1305 128x32_noname，SSD1305 128x64_ADAFRUIT，SSD1305 128X64_ADAFRUIT，SSD1306 128X64_NONAME，SSD1306 128X664_VCOMENNAME SSD1306 128X64_NONAME，SSD1306 128X64_VCOMH0，SSD1306 128X64_ALT0，SH1106 128X64_NONAME，SH1106 128X64_VCOMH0 128X64_VCOMH0, SH1106 128X64_WINSTAR, SH1106 72X40_WISE, SH1106 72X40_WISE, SH1106 64X32, SH1106 64X32, SH1107 64X128, SH1107 64X128, SH1107 SEEED_96X96, SH1107 SEEED_96X96, SH1107 128X128，SH1107 128X128，SH1122 256X64，SH1122 256X64，SSD1306 128X32_UNIVISION，SSD1306 128X32_UNIVISY，SSD1306 64X48_ER，SSD48_ER，SSD1306 6448_448_448_4348_4348_48__ER，SSD66648__ER，SSD.SDSD，，，，，，，，，第136件348_，， 48x64_winstar，SSD1306 48X64_WINSTAR，SSD1306 64X32_NONAME，SSD1306 64x32_1F，SSD1306 64X32_NONANE SSD1309 128X64_NONAME2，SSD1309 128X64_NONAME2，SSD1309 128X64_NONAME0，SSD1309 128x64_noname0，SSD1325 NHD1325 NHD_128X64，SSD13264，SSD1325 NHD_128X64，SSD_128X64，SSD_128X64，SSD_1264，SSD_1264，SSD_1264，SSD_1264，SSD_1264，SSD_1264，SSD_1264，SSD_1264， ER_256X32，SSD1326 ER_256X32，SSD1327 SEEED_96X96，SSD1327 SEEED_96X96，SSD1327 MIDAS_128X128 60x32，LD7032 60x32，ST7920 192x32，ST7920 192X32，ST7920 192X32，ST7920 128X64，ST7920 128X64，ST7920 128X64，128X64 MINI12864, PCD8544 84X48, PCF8812 96X65, HX1230 96X68, UC1604 JLX19264, UC1604 JLX19264, UC1608 ERC24064, UC1608 ERC24064, UC1608 ERC240120, UC1608 ERC240120, UC1608 240X128, UC1608 240X128, UC1638 160X128, UC1610 EA_DOGXL160, UC1610 EA_DOGXL160, UC1611 EA_DOGM240, UC1611 EA_DOGM240, UC1611 EA_DOGXL240，UC1611 EA_DOGXL240，UC1611 EW50850，UC1611 EW50850，ST7565 EA_DOGM128，ST7565 64128N，St7565 ST7565 ERC12864, ST7565 NHD_C12864, ST7565 JLX12864, ST7565 NHD_C12832, UC1601 128X32, UC1601 128X32, ST7565 EA_DOGM132, ST7567 PI_132X64, ST7567 JLX12864，ST7567 ENH_DG128064，ST7567 ENEN_DG128064I，ST7588 JLX12864，ST7588 JLX12864，ST75256 ST75256 JLX256160，ST75256 JLX240160，ST75256 JLX240160，ST75256 JLX25664，ST75256 JLX25664 TG12864R，IST3020 ERC19264，SBN1661 122X32，SED1520 122X32，KS0108 128X64，KS0108 ERM19264，LC7981 160X80 T6963 240x64，T6963 256x64，T6963 128x64，SSD1322 NHD_256X64，SSD1322 NHD_128X64，SSD1606 172X72，SSD1607 20072007200X200X200XD1607200件事296x128，IL3820 V2_296x128，SED1330 240x128，RA8835 NHD_240X128，RA8835 320X240，MAX7219 3219 32X8，A2PRINTER 384X240

UCGLIB设备

https://github.com/olikraus/ucglib_arduino

ST7735，ILI9163，ILI9325，ILI9341，ILI9486，LD50T6160，PCF8833，SEPS225，SSD1331，SSD1331，SSD1351，HX8352C，HX8352C

串行ANSI终端

https://github.com/neu-rah/ansistream

UNIX终端

格罗夫RGB LCD I2C 2x16

https://wiki.seeedstudio.com/grove-lcd_rgb_backlight/

Web浏览器

ESP8266（内置）

网络JSON

ESP8266（内置）

Websocket

ESP8266（内置）

注意： ESP8266即使不使用Web界面也需要一个流库，以及#include <menuIO/esp8266Out.h>

根据您的输出驱动程序，它可能是之一（可以同时安装）

https://github.com/neu-rah/streamflow
https://github.com/scottdky/streaming

输入设备

序列https://www.arduino.cc/en/reference/serial

Quadencoder-使用PCINT（内置）的通用编码器

按钮 - 简单的数字键盘（内置）

通用键盘（无PCINT） - 可为数字或模拟键盘配置（内置）

模拟操纵杆

ClickEncoder https://github.com/0xpit/encoder

矩阵键盘
http://playground.arduino.cc/code/keypad https://github.com/nullkraft/keypad

PCF8574基于I2C矩阵键盘https://github.com/whatnick/i2ckeypad

用户定义的输入调用菜单导航API

使用ESP设备时网络浏览器（实验）

依赖性

该库取决于以下库：

溪流https://github.com/neu-rah/streamflow（在调试模式下）

根据输入或输出的类型，可能需要其他库。本质上，您的设备所需的任何库。

极限

使用宏时，菜单仅限于16个选项（当前的宏观limnit）。
菜单使用宏建造时必须至少有2个选项。
最多127个选项。
快速访问（数字键）仅支持9个选项（1至9）
提示可以在面板上溢出少于4个字符的宽度
菜单系统是基于字符的，因此请选择单位字体以获得最佳结果，它将与任何字体一起使用，但文本可能会溢出。

根据

基于角色的信息显示。
基于行的菜单组织。
流IO +专业。

信息

更多信息

Wiki页面，问题或r-site.net

错误 / subentions

请报告错误，问题或增强想法，我会提出反馈。谢谢。

关于问题报告，请指定输入和输出驱动程序或设备以及目标平台。

笔记

现在需要在设置（2.x）上调用begin（）

输入是从通用流中读取的，其中包括用于编码器和键盘的简单流 - 提供的编码器驱动程序使用内部上拉和反向逻辑

多个流动包装以用于输入以将编码器流与编码器键盘混合（通常为1或2个键）

历史

4.0

SDFAT插件和示例
Esccontrol审查
支持BODMER/TFT_ESPI
sdcard文件拾取器插件
允许虚拟/动态数据自定义菜单
具有显式销钉模式的替代关键驱动器
更多例子
带有验证 *的文本编辑字段 *
垫子样式菜单（水平清单）
内联垫菜单可以输入自定义格式，例如IP/日期/时间，实验性和仅适用于可以放置光标的设备
插件，替代菜单项可能特定于设备的菜单项
允许多个并发菜单
支持UCGLIB显示
支持U8X8显示
支持Arduino TFT
支持PCF8574 I2C LCD
支持模拟操纵杆输入
添加了输入爆发配置选项
ValueObj宏，用户分配的值
菜单输入菜单类（允许设备字段逆转） *
一些选项已分发给其他一些类
即使是AVR的动态菜单构造（RAM）

* API更改

选项

~~删除了InvertFieldKeys选项，现在由特定的菜单对象支持反转。~~

回归：仍然需要简化简单的输入案例。

numValueInput移动到菜单对象

navroot额外选项，以前在全球选项对象上

 bool nav2D= false ; // not used
bool canExit= true ; // v4.0 moved from global options
bool useUpdateEvent= false ; // if false, use enterEvent when field value is changed.
idx_t inputBurst= 1 ; // limit of inputs that can be processed before output

串行输入

串行不再直接接受为输入，而是使用serialin

及时基础API

printto成员函数从以下方式更改：

Used printTo (navRoot&, bool ,menuOut&, idx_t , idx_t );

到

Used printTo (navRoot&, bool ,menuOut&, idx_t , idx_t , idx_t = 0 );

这只会影响定制的组件

输入现在来自类菜单，从流派出，但包括每个输入类的字段轴反转的标志功能。

3.0

菜单控制系统的完整修订
- 菜单结构在RAM对象和Flash对象中分开
- 使用单独的导航控制对象navnode
- 中央导航控制对象navroot
- 使用所有菜单对象的事件（聚焦，模糊，输入，退出）。
- 多个面板
- 基础列表的颜色枚举
- 并行多个输出设备
- 将出口定义为常规选项
- 限制文本宽度以防止溢出