No description, website, or topics provided.
Switch branches/tags
Nothing to show
Clone or download
Latest commit 5a5cf0a Jan 6, 2017
Permalink
Failed to load latest commit information.
doc update example version and doc Jan 6, 2017
examples update example version and doc Jan 6, 2017
html add gpio and rtc example Dec 8, 2016
latex add gpio and rtc example Dec 8, 2016
NexButton.cpp Organize the annotation Oct 11, 2016
NexButton.h Organize the annotation Oct 11, 2016
NexCheckbox.cpp Organize the annotation again Oct 11, 2016
NexCheckbox.h Organize the annotation Oct 11, 2016
NexConfig.h add note for arduino example Aug 24, 2015
NexCrop.cpp keep origin API Sep 30, 2016
NexCrop.h keep origin API Sep 30, 2016
NexDualStateButton.cpp Organize the annotation Oct 11, 2016
NexDualStateButton.h Organize the annotation Oct 11, 2016
NexGauge.cpp Organize the annotation Oct 11, 2016
NexGauge.h Organize the annotation Oct 11, 2016
NexGpio.cpp add gpio and rtc function Nov 28, 2016
NexGpio.h update doc Dec 1, 2016
NexHardware.cpp Update NexHardware.cpp Nov 2, 2016
NexHardware.h add note for arduino example Aug 24, 2015
NexHotspot.cpp Update doc. Aug 14, 2015
NexHotspot.h Update docs. Aug 14, 2015
NexNumber.cpp Organize the annotation Oct 11, 2016
NexNumber.h Organize the annotation Oct 11, 2016
NexObject.cpp add note for arduino example Aug 24, 2015
NexObject.h add note for arduino example Aug 24, 2015
NexPage.cpp Update doc. Aug 14, 2015
NexPage.h Update docs. Aug 14, 2015
NexPicture.cpp keep origin API Sep 30, 2016
NexPicture.h keep origin API Sep 30, 2016
NexProgressBar.cpp Organize the annotation Oct 11, 2016
NexProgressBar.h Organize the annotation Oct 11, 2016
NexRadio.cpp Organize the annotation Oct 11, 2016
NexRadio.h Organize the annotation Oct 11, 2016
NexRtc.cpp add gpio and rtc function Nov 28, 2016
NexRtc.h update doc Dec 1, 2016
NexScrolltext.cpp Organize the annotation Oct 11, 2016
NexScrolltext.h Organize the annotation Oct 11, 2016
NexSlider.cpp Organize the annotation Oct 11, 2016
NexSlider.h Organize the annotation Oct 11, 2016
NexText.cpp add gpio and rtc function Nov 28, 2016
NexText.h add gpio and rtc function Nov 28, 2016
NexTimer.cpp Organize the annotation Oct 11, 2016
NexTimer.h Organize the annotation Oct 11, 2016
NexTouch.cpp Update doc. Aug 14, 2015
NexTouch.h Update docs. Aug 14, 2015
NexUpload.cpp modify library name to upload Apr 20, 2016
NexUpload.h updata class index Oct 10, 2016
NexVariable.cpp Add functions for new items based on the IDE. Sep 27, 2016
NexVariable.h Organize the annotation Oct 11, 2016
NexWaveform.cpp Organize the annotation Oct 11, 2016
NexWaveform.h Organize the annotation Oct 11, 2016
Nextion.h add gpio and rtc function Nov 28, 2016
doxygen.doxy updata class index Oct 10, 2016
doxygen.h add note for arduino example Aug 24, 2015
license.md Add a proper "AS IS" MIT License (MIT) Oct 11, 2016
readme.md Update readme.md to use proper "AS IS" MIT License (MIT) Oct 11, 2016
release_notes.md Added Release Notes for v0.9.0 Oct 11, 2016
version.txt Version 0.9.0 Oct 11, 2016

readme.md

@mainpage Home Page

Nextion


Introduction

Nextion Arduino library provides an easy-to-use way to manipulate Nextion serial displays. Users can use the libarry freely, either in commerical projects or open-source prjects, without any additional condiitons.

For more information about the Nextion display project, please visit the wiki。
The wiki provdies all the necessary technical documnets, quick start guide, tutorials, demos, as well as some useful resources.

To get your Nextion display, please visit iMall.

To discuss the project? Request new features? Report a BUG? please visit the Forums

Download Source Code

Latest version is unstable and a mass of change may be applied in a short time without any notification for users. Commonly, it is for developers of this library.

Release version is recommanded for you, unless you are one of developers of this library.

Release notes is at https://github.com/itead/ITEADLIB_Arduino_Nextion/blob/master/release_notes.md.

Latest(unstable)

Latest source code(master branch) can be downloaded: https://github.com/itead/ITEADLIB_Arduino_Nextion/archive/master.zip.

You can also clone it via git:

git clone https://github.com/itead/ITEADLIB_Arduino_Nextion

Releases(stable)

All releases can be available from: https://github.com/itead/ITEADLIB_Arduino_Nextion/releases.

Documentation

Offline Documentation's entry doc/Documentation/index.html shiped with source code can be open in your browser such as Chrome, Firefox or any one you like.

Suppported Mainboards

All boards, which has one or more hardware serial, can be supported.

For example:

  • Iteaduino MEGA2560
  • Iteaduino UNO
  • Arduino MEGA2560
  • Arduino UNO

Configuration

In configuration file NexConfig.h, you can find two macros below:

  • dbSerial: Debug Serial (baudrate:9600), needed by beginners for debug your nextion applications or sketches. If your complete your work, it will be a wise choice to disable Debug Serial.

  • nexSerial: Nextion Serial, the bridge of Nextion and your mainboard.

Note: the default configuration is for MEGA2560.

Redirect dbSerial and nexSerial

If you want to change the default serial to debug or communicate with Nextion , you need to modify the line in configuration file:

#define dbSerial Serial    ---> #define dbSerial Serialxxx
#define nexSerial Serial2  ---> #define nexSeria Serialxxx

Disable Debug Serial

If you want to disable the debug information,you need to modify the line in configuration file:

#define DEBUG_SERIAL_ENABLE ---> //#define DEBUG_SERIAL_ENABLE

UNO-like Mainboards

If your board has only one hardware serial, such as UNO, you should disable dbSerial and redirect nexSerial to Serial(Refer to section:Serial configuration).

Useful Links

http://blog.iteadstudio.com/nextion-tutorial-based-on-nextion-arduino-library/

License


The MIT License (MIT) 

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: 

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.