1
0
mirror of https://github.com/RIOT-OS/RIOT.git synced 2024-12-29 04:50:03 +01:00
Go to file
iosabi 52107b2416 esp8266: Support UART1 and other UART0 pins.
The esp8266 CPU has actually two hardware UART peripherals. UART0 is
used by the boot ROM for flashing and serial output during boot,
typically at a baudrate of 74880 bps until the bootloader or application
sets the more standard 115200 baudrate. This UART0 device has two
possible pins for TXD, GPIO1 and GPIO2, which are both set to TXD by the
boot ROM. esp8266 modules will typically have GPIO1 labeled as the TX
pin, but it is possible to use GPIO2 for that purpose even while
flashing the device with esptool.py.

The second device, UART1, also has two options for TXD, GPIO2 and GPIO7,
and only one option for RXD, GPIO8. However, GPIO7 and GPIO8 are used
by the flash internally so those options are not very useful unless
maybe while running from IRAM with the flash disabled, for example for
a debugger over UART1.

This patch allows boards to override UART{0,1}_{R,T}XD in their
periph_conf.h to configure the uart selection. Defining UART1_TX will
make the UART_DEV(1) device available.

Tested with:

```CFLAGS='-DUART1_TXD=GPIO2' make -C tests/periph_uart BOARD=esp8266-esp-12x flash term```

* Connected one USB-UART to the standard GPIO1 and GPIO3 for flashing
  and console. After flashing we see the manual test output at 115200
  bps

* Connected a second USB-UART with RX to GPIO2 running at 74880.

Then run on the first console:
```
> init 1 74880
> send 1 hello
```

The word "hello" appears on the second UART connection.

Note that GPIO2 is used during boot for UART0's TX until the application
or bootloader set it to a regular GPIO, so some boot ROM messages at
74880 bps are visible. After running `init 1 74880` it is set to UART1's
TX.
2021-05-02 12:27:27 +00:00
.circleci .circleci: use riot/static-test-tools Docker image 2021-01-14 19:08:15 +01:00
.github gh-actions: release-tests: do not run linters for release tests 2021-04-23 10:56:19 +02:00
boards esp8266: Support UART1 and other UART0 pins. 2021-05-02 12:27:27 +00:00
bootloaders bootloaders/riotboot_dfu: update doc now that DFU_ALT gets set 2021-04-03 18:18:57 +02:00
core Merge pull request #16330 from kfessel/p-add-clist-special 2021-04-15 12:14:58 +02:00
cpu esp8266: Support UART1 and other UART0 pins. 2021-05-02 12:27:27 +00:00
dist dist/tools/avarice/debug.sh: less noise 2021-04-22 08:45:57 +02:00
doc build system: add new compile-commands make target 2021-04-14 14:51:46 +02:00
drivers drivers/periph: flashpage: fix type error 2021-04-28 14:17:42 +02:00
examples examples/nanocoap_server: remove unneed case block 2021-04-27 10:16:15 +02:00
fuzzing all: remove traces of kernel_types.h 2020-11-25 17:52:34 +01:00
kconfigs cpu: add periph_rtt_overflow feature 2021-04-30 11:58:00 +02:00
makefiles makefiles/kconfig: add pkg-prepare as menuconfig dependency 2021-04-28 11:19:24 +02:00
pkg Merge pull request #16352 from kfessel/p-doc-pkg 2021-04-30 12:00:13 +02:00
sys pkg/lvgl: model dependency resolution in Kconfig 2021-04-28 11:19:24 +02:00
tests tests/periph_flashpage: respect FLASHPAGE_WRITE_BLOCK_SIZE 2021-04-29 17:57:05 +02:00
.bandit codacy: disable complaining about python assert 2019-03-01 13:43:37 +01:00
.drone.yml .drone.yml: remove mcu groups from the build test matrix 2019-06-14 11:32:15 +02:00
.gitattributes git: handle patch files as binary 2015-12-04 11:46:33 +01:00
.gitignore .gitignore: add *.plist and .cache/ 2021-03-17 09:55:00 +01:00
.mailmap mailmap: deduplicate @benpicco 2020-04-28 11:58:44 +02:00
.murdock .murdock: whitelist tests/pkg_lvgl* apps for TEST_KCONFIG 2021-04-28 11:19:25 +02:00
CODE_OF_CONDUCT.md github: add Code of Conduct 2017-12-08 09:10:01 +01:00
CODEOWNERS CODEOWNERS: Add nandojve for xmega things 2021-03-15 20:16:10 -03:00
CODING_CONVENTIONS_C++.md CODING_CONVENTIONS_C++.md: Fixed typos and links 2019-11-08 10:36:27 +01:00
CODING_CONVENTIONS.md Coding_Convention: clarify: none return is allowed 2021-03-08 14:46:34 +01:00
CONTRIBUTING.md CONTRIBUTING.md: add link to forum 2020-12-09 17:24:05 +01:00
doc.txt doc: Describe interaction between DEVELHELP and assert 2020-10-25 23:27:51 +01:00
Kconfig Kconfig: source EXTERNAL_MODULES configurations 2021-02-23 19:16:33 +01:00
LICENSE * updated LICENSE file from GPL to LPGL 2013-06-18 17:19:53 +02:00
LOSTANDFOUND.md lostandfound: document removal of boards/slwstk6220a 2021-01-05 12:19:47 +01:00
MAINTAINING.md MAINTAINING: Clarify guidelines 2020-07-13 10:57:03 +02:00
Makefile Makefile: advertise forum on make 2020-12-10 10:10:03 +01:00
Makefile.base Merge pull request #16129 from maribu/compile_commands_json 2021-04-14 18:10:28 +02:00
Makefile.dep Merge pull request #15865 from benpicco/pm_layered-default 2021-02-03 08:17:29 +01:00
Makefile.features treewide: model newlib as a FEATURE 2021-01-27 09:24:25 +01:00
Makefile.include Merge pull request #16129 from maribu/compile_commands_json 2021-04-14 18:10:28 +02:00
README.md README: Add merge-chance badge 2021-01-11 13:13:58 +01:00
release-notes.txt release-notes.txt: Fix typo 2021-02-10 03:40:01 +01:00
SECURITY.md SECURITY.md: fix mailto link 2020-12-10 14:18:19 +01:00
uncrustify-riot.cfg uncrustify-riot.cfg: update to coding convention 2021-03-04 17:23:46 +01:00
Vagrantfile tools/packer: adapt for Ubuntu 18.04 2020-02-19 19:23:07 +01:00

Nightly CI status master GitHub release License API docs Wiki Merge chance Stack Overflow questions Twitter IRC Matrix

                      ZZZZZZ
                    ZZZZZZZZZZZZ
                  ZZZZZZZZZZZZZZZZ
                 ZZZZZZZ     ZZZZZZ
                ZZZZZZ        ZZZZZ
                ZZZZZ          ZZZZ
                ZZZZ           ZZZZZ
                ZZZZ           ZZZZ
                ZZZZ          ZZZZZ
                ZZZZ        ZZZZZZ
                ZZZZ     ZZZZZZZZ       777        7777       7777777777
          ZZ    ZZZZ   ZZZZZZZZ         777      77777777    77777777777
      ZZZZZZZ   ZZZZ  ZZZZZZZ           777     7777  7777       777
    ZZZZZZZZZ   ZZZZ    Z               777     777    777       777
   ZZZZZZ       ZZZZ                    777     777    777       777
  ZZZZZ         ZZZZ                    777     777    777       777
 ZZZZZ          ZZZZZ    ZZZZ           777     777    777       777
 ZZZZ           ZZZZZ    ZZZZZ          777     777    777       777
 ZZZZ           ZZZZZ     ZZZZZ         777     777    777       777
 ZZZZ           ZZZZ       ZZZZZ        777     777    777       777
 ZZZZZ         ZZZZZ        ZZZZZ       777     777    777       777
  ZZZZZZ     ZZZZZZ          ZZZZZ      777     7777777777       777
   ZZZZZZZZZZZZZZZ            ZZZZ      777      77777777        777
     ZZZZZZZZZZZ               Z
        ZZZZZ

The friendly Operating System for IoT!

RIOT is a real-time multi-threading operating system that supports a range of devices that are typically found in the Internet of Things (IoT): 8-bit, 16-bit and 32-bit microcontrollers.

RIOT is based on the following design principles: energy-efficiency, real-time capabilities, small memory footprint, modularity, and uniform API access, independent of the underlying hardware (this API offers partial POSIX compliance).

RIOT is developed by an international open source community which is independent of specific vendors (e.g. similarly to the Linux community). RIOT is licensed with LGPLv2.1, a copyleft license which fosters indirect business models around the free open-source software platform provided by RIOT, e.g. it is possible to link closed-source code with the LGPL code.

FEATURES

RIOT is based on a microkernel architecture, and provides features including, but not limited to:

  • a preemptive, tickless scheduler with priorities
  • flexible memory management
  • high resolution, long-term timers
  • support 100+ boards based on AVR, MSP430, ESP8266, ESP32, MIPS, RISC-V, ARM7 and ARM Cortex-M
  • the native port allows to run RIOT as-is on Linux, BSD, and MacOS. Multiple instances of RIOT running on a single machine can also be interconnected via a simple virtual Ethernet bridge
  • IPv6
  • 6LoWPAN (RFC4944, RFC6282, and RFC6775)
  • UDP
  • RPL (storing mode, P2P mode)
  • CoAP
  • CCN-Lite
  • Sigfox
  • LoRaWAN

GETTING STARTED

  • You want to start the RIOT? Just follow our quickstart guide or try this tutorial. For specific toolchain installation, follow instructions in the getting started page.
  • The RIOT API itself can be built from the code using doxygen. The latest version of the documentation is uploaded daily to riot-os.org/api.

FORUM

Do you have a question, want to discuss a new feature, or just want to present your latest project using RIOT? Come over to our forum and post to your hearts content.

CONTRIBUTE

To contribute something to RIOT, please refer to our contributing document.

MAILING LISTS

LICENSE

  • Most of the code developed by the RIOT community is licensed under the GNU Lesser General Public License (LGPL) version 2.1 as published by the Free Software Foundation.
  • Some external sources, especially files developed by SICS are published under a separate license.

All code files contain licensing information.

For more information, see the RIOT website:

https://www.riot-os.org