12 - BA - D1 - Mini - ESP32 (EN)
12 - BA - D1 - Mini - ESP32 (EN)
operating manual
AZ-Delivery D1 mini 32
1
Machine Translated by Google
Neither AZ-Delivery Vertriebs GmbH nor its affiliates or subsidiaries are responsible
or liable for any misuse of the information contained herein. If you have suggestions
for improvement or changes, or have found errors in this publication,
All pertinent state, provincial, and local safety regulations should be observed when
installing and using this product. For safety reasons and to ensure compliance with
the documented system data, only the manufacturer may carry out repairs on
components.
Failure to follow these instructions could result in personal injury or property damage.
2
Machine Translated by Google
All rights reserved. No part of this publication may be reproduced without prior written
permission of the publisher in any form or with any
means, including photocopy, recording or other electronic or
mechanical processes, reproduced, distributed or transmitted. For
For permission requests, please contact the publisher with the
inscription " For: Permissions Coordinator", at the address below.
Trademark
corresponding company.
product changes
3
Machine Translated by Google
Table of Contents
foreword 6
retention instructions 8
Internet 9
Other languages 9
Documentation feedback 9
Intended Use 10
Product description 10
scope of delivery 10
Dimensions 11
Technical specifications 12
product elements 14
Pinout Diagram 15
functionality 15
ESP32 WROOM 32 16
CP2104 17
operator interface 17
control panels 17
safety instructions 18
Installation 22
4
Machine Translated by Google
driver installation 26
error table 41
disposal 42
License Information 43
Arduino-Core 43
Espressif Firmware 43
Espressif ESP32_NONOS_SDK 44
1. Scope 2. Contractual 45
48
48
49
49
5
Machine Translated by Google
1 Introduction
1.1. Description of the target group
This manual is intended for hardware and software developers with specialist knowledge in the field of
electrical engineering and for original equipment manufacturers (OEM).
bold
Italic
6
Machine Translated by Google
personal injury:
ÿ DANGER
DANGER indicates an imminent danger. If not avoided, death or serious injury will result.
ÿ WARNING
WARNING indicates a potentially imminent danger. If not avoided, it can result in death or serious injury.
ÿ CAUTION
CAUTION indicates a potentially imminent danger. If not avoided, minor or minor injuries may result.
A NOTICE
NOTICE indicates a potentially harmful situation. If not avoided, the plant or something in its vicinity may be
damaged.
7
Machine Translated by Google
The product may only be used by persons who have fully read and understood the
contents of these operating instructions.
Make sure that everyone using the product has read and followed these warnings and
instructions.
Retain all safety information and instructions for future reference and pass them on to
subsequent users of the product.
The manufacturer is not liable for damage to property or personal injury resulting from
improper handling or non-observance of the safety instructions. In such cases, the
warranty expires.
8
Machine Translated by Google
The latest version of the documentation is available at the following address: www.az-
delivery.de
9
Machine Translated by Google
The AZ-Delivery D1 mini ESP32 may only be used with the following software, original accessories and
components:
• Espressif SDK
• Arduino-Core
Module consisting of two components, a USB-serial converter (CP2104) and a microcontroller with a
highly integrated TCP/IP stack (ESP32). The module also has a micro-USB socket for power supply and
as a programming interface, a controllable LED and a fixed voltage regulator.
10
Machine Translated by Google
2.4. Dimensions
11
Machine Translated by Google
Technical specifications
device name AZ-Delivery D1 mini ESP 32
model V3
processor ESP32-WROOM-32
I / O Pins 9
pitch 2.54 mm
requirements to the
Exclusively indoors
operating environment
weight 3g
12
Machine Translated by Google
Note that the processor develops heat during operation and ensure adequate ventilation
to dissipate it.
Protect the module from conductive surfaces during operation to avoid short circuits.
Each voltage source must comply with the country-specific relevant standards and
regulations. Use only a fused, stable DC power source rated at 5V and at least 500mA.
13
Machine Translated by Google
14
Machine Translated by Google
3. Functionality
The AZ-Delivery D1 mini ESP32 was created from the requirement to provide
specialists on the European market with the cheapest possible WiFi development
board with the simplest possible wiring. The module essentially consists of the following
components:
15
Machine Translated by Google
The best part is that it comes with wireless networking, which makes it different from other
microcontrollers like the Arduino. This means it offers easy remote control and monitoring of devices
over Wi-Fi and Bluetooth® at an affordable price.
It offers 2.4 GHz Wi-Fi (802.11 b/g/n, supports speeds up to 150MB/s), BLE and classic Bluetooth®
wireless communication, A total of 40 pins provide connectivity to GPIO pins to support PWM (Pulse
Width Modulation) , GPI pins (input only), capacitive touch sensors, I2C and I2S interfaces, ADC
(analog to digital) conversion), DAC (digital to analog conversion), SPI interface or UART
dedicated pins.
16
Machine Translated by Google
3.2. CP2104
The CP2104 IC is a widely used USB to serial converter with TTL and UART
Compatibility. It serves as a cheap and reliable programming interface and can be found in many IoT
devices as well as in everyday hardware such as coffee machines, barcode scanners, children's toys or
vehicles.
The AZ-Delivery D1 mini ESP32 only offers a single button for operation.
Pressing the button triggers a reset of the ESP32 WROOM 32 by pulling pin 1 'RST' to 'LOW'.
17
Machine Translated by Google
4. Safety Instructions
ÿ CAUTION
Read and understand this manual and its
Safety precautions before using this product.
Non-observance can lead to property damage.
will.
• In Schools, training institutions, Hobby- and
Self-help workshops are operated by trained personnel
to monitor responsibly.
• The product should not be dropped or subjected to strong mechanical pressure, as the
impact may damage it.
18
Machine Translated by Google
• Before starting work, check that soldering equipment is in good condition, especially
electrical soldering equipment and damaged cables and cable entries.
• The temperature of the hot soldering iron is over 300°C. There is a risk of burns if handled
improperly! • Do not inhale soldering fumes! They are hazardous to health. • Place
the soldering iron in the holder immediately after soldering, before you continue with further
work steps.
19
Machine Translated by Google
4.1.4. Explanation of the safety instructions on the packaging and the product
Symbol meaning
WEEE-Reg.-No.: DE 62624346
20
Machine Translated by Google
21
Machine Translated by Google
6. Commissioning
6.1. Soldering the pin or pin strips
During assembly, you have the option of using the pin strips. Alternatively, you can use the socket strips
with long pins or the socket strips with short ones
use pins.
To avoid moving the pins during the soldering process, it is recommended to place the headers in a
breadboard as shown below.
The long side of the pins should sit down in the breadboard.
With the ESP32 WROOM 32 chip facing up, place the D1 mini ESP32 module over the headers so the
short pins protrude through the designated openings.
22
Machine Translated by Google
When using the female headers (either with long or short pins) you can place the female header on top
of the male headers in the breadboard for easier positioning during the soldering process.
fig 6.1.4 - Breadboard with pin headers on which the female headers have been placed
Now place the D1 mini ESP32 module over the socket strips and press it
module all the way down until it is flush. The pins should stick out as much as possible.
23
Machine Translated by Google
fig 6.1.5 - Breadboard with male headers on which female headers with long pins are placed,
figure 6.1.6 - Breadboard with male headers on which female headers with short pins have been
24
Machine Translated by Google
figure 6.1.7 - The soldering process with female headers and long pins
25
Machine Translated by Google
The CP2104 USB to serial converter driver is automatically installed via Windows
Update when used with Windows 10. If you are using a different operating system, you
can obtain the corresponding driver directly from the manufacturer at the following
address:
https://www.silabs.com/products/development-tools/software/usb-to-uart
bridge-vcp-drivers
Windows users are strongly advised to use one of the first two Arduino IDE download
options. The “Windows App”
Version from the Windows Store leads to connection problems, especially when using
third-party board definitions.
26
Machine Translated by Google
figure 6.2.3.1 - Download Arduino IDE with hint arrow for Windows
user
27
Machine Translated by Google
Option Explanation
Associate .ino files Creates a filename extension for files ending in .ino and
associates it with the Arduino IDE
Finally, the target folder must be specified. The installation takes approx.
500MB free disk space.
28
Machine Translated by Google
After successful installation, the installation program can be closed with the
“Close” button .
29
Machine Translated by Google
30
Machine Translated by Google
The D1 mini 32 is not part of the standard Arduino IDE repertoire. Therefore, additional
board definitions must be installed via the board manager. So that
If the board manager has access to the definitions, the board manager URL must first
be specified in the Arduino IDE preferences.
This setting is found in the File -> Preferences menu. The following URL must be
entered in the "Additional board manager URLs:" input field:
https://dl.espressif.com/dl/package_esp32_index.json
figure 6.3.2 - Arduino IDE - “File” -> “Preferences” -> “Additional Board Manager URLs”
31
Machine Translated by Google
figure 6.3.3 - Arduino IDE - “Tools” -> “Board:” -> “Board Manager …” -> “ESP32”
After assembling the module and installing the software, you can connect the module to
your PC. If a new USB device is detected, the typical signal tone can be heard in
Windows. To check whether the module is recognized correctly and the driver installation
was successful, the interface can be displayed in the device manager.
The easiest way to open the device manager is to open the command prompt using the
key combination WIN+R . Then enter “devmgmt.msc” and confirm with the Enter key or
with the
OK button.
32
Machine Translated by Google
figure 6.5.1 Choosing the right board with the associated port
33
Machine Translated by Google
The “Arduino programming language is closely related to C and C++. A complete overview and
explanation in German can be found directly on the Arduino website under the following link:
https://www.arduino.cc/reference/de/
In order to be able to program the board, many included examples are available. You can find these
directly in the development environment under File -> Examples. You will also find examples specifically
for boards with an ESP8266 processor.
To start the programming process, connect your controller to the PC, select the correct board definitions
and the relevant COM port.
By then clicking on the “Upload” button, the
Program code compiled with all necessary libraries and sent via serial
Transfer connection (COM port) to the controller:
34
Machine Translated by Google
figure 6.5.2.2 Start the process of compiling and transferring the code to the controller
The language reference mentioned in chapter 6.5.2 can be used without significant restrictions.
However, for boards with an ESP processor, a variety of functionalities have been added that cannot
be found in the Arduino documentation. An up-to-date version of the Arduino core documentation for
Boards with an ESP processor can be accessed at any time via the following link:
https://arduino-esp32.readthedocs.io/en/latest/
35
Machine Translated by Google
36
Machine Translated by Google
Deep sleep when the Ultra Low Power (ULP) co-processor is running.
The following GPIOs can be used as external wake-up source:
RTC_GPIO0(GPIO36), RTC_GPIO3(GPIO39), RTC_GPIO4(GPIO34),
RTC_GPIO5(GPIO35), RTC_GPIO6(GPIO25), RTC_GPIO7(GPIO26),
RTC_GPIO8(GPIO33), RTC_GPIO9 (GPIO32), RTC_GPIO10(GPIO4),
RTC_GPIO11(GPIO0), RTC_GPIO12(GPIO2), RTC_GPIO13(GPIO15),
RTC_GPIO14(GPIO13), RTC_GPIO15(GPIO12), RTC_GPIO16(GPIO14),
RTC_GPIO17(GPIO27).
37
Machine Translated by Google
Most development boards set pins in the correct state for flashing or booting
Mode. If some peripherals are connected to the strapping pins and the IDE is unable
to upload the code or flash the ESP32, it may be because those peripherals are
preventing the ESP32 from entering the correct mode. After a reset, blink, or boot,
these pins work as expected. There is
Boot
Mode selection documentation guide at the following link. Further and more
detailed explanations are beyond the scope of this eBook, so please refer to the
data sheet.
38
Machine Translated by Google
where “pin” is the GPIO pin name and the mode can be either INPUT (which is the
default) or OUTPUT or INPUT_PULLUP to enable the built-in pull-up resistors for
pins GPIO0-15. To enable the pulldown resistor for GPIO16 use
INPUT_PULLDOWN_16.
To set an output pin HIGH (3.3V) or LOW (0V), use the following line of
code: digitalWrite(pin, value)
where pin is the name of the GPIO pin and the value is either 1 or 0 (or HIGH and
LOW).
The range of the PWM output can be changed using the following line of code:
analogWriteRange(new_range)
The frequency of the PWM can be changed using the following line of code:
analogWriteFreq(new_frequency) where new_frequency
should be between 100Hz and 1000Hz.
39
Machine Translated by Google
Now select the board and load the example onto the board.
40
Machine Translated by Google
delivery condition
as in chap. 7
described
41
Machine Translated by Google
10. Disposal
Do not discard with household waste! Your microcontroller must be disposed of in an environmentally friendly
manner in accordance with European Directive 2012/19/EG on waste electrical and electronic equipment.
The valuable raw materials it contains can thus be recycled. The application of this guideline contributes to
environmental and health protection.
Use the collection point set up by your municipality to return and recycle old electrical and electronic equipment.
WEEE Reg. No.: DE 62624346
http://www.az-delivery.de/pages/agb
as well as in Appendix I of this documentation. The terms and conditions apply in the version at the time the
contract was concluded between the buyer and AZ-Delivery Vertriebs GmbH.
42
Machine Translated by Google
Arduino IDE is developed and maintained by the Arduino team. The IDE is licensed
under GPL.
ESP8266 core includes an xtensa gcc toolchain, which is also under GPL.
SPI Flash File System (SPIFFS) written by Peter Andersson is used in this
project. It is distributed under the MIT license.
LittleFS library written by ARM Limited and released under the BSD 3-clause
license.
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:
43
Machine Translated by Google
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.
Permission is hereby granted for use on ESPRESSIF SYSTEMS ESP32 only, in which case, it is 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
44
Machine Translated by Google
The following terms and conditions apply to all orders via our online shop by
consumers and entrepreneurs.
A consumer is any natural person who enters into a legal transaction for purposes
that are predominantly neither commercial nor self-employed. Entrepreneur is a
natural or legal person or a partnership with legal capacity who, when concluding a
legal transaction, acts in the exercise of their commercial or independent professional
activity.
them again.
If the entrepreneur uses conflicting or supplementary general terms and conditions,
their validity is hereby contradicted; they only become part of the contract if we have
expressly agreed to this.
The presentation of the products in the online shop does not represent a legally
binding offer, but a non-binding online catalogue. You can initially place our products
in the shopping cart without obligation and correct your entries at any time before
sending your binding order by using the steps provided for this purpose in the
ordering process and use the explained correction aids. By clicking the order button,
you place a binding order for the goods contained in the shopping cart. The receipt
of your order will be confirmed by e-mail immediately after the order has been sent.
When the contract is concluded with us depends on the payment method you have
chosen:
invoice
45
Machine Translated by Google
When you place your order, you send us your credit card details at the same time.
After your legitimation as the legitimate cardholder, we will request your credit card company
to initiate the payment transaction and thereby accept your offer.
PayPal Express
During the ordering process, you will be redirected to the website of the online provider
PayPal. There you can enter your payment details and confirm the payment order to PayPal.
After placing the order in the shop, we request PayPal to initiate the payment transaction and
thereby accept your offer.
Instantly
After placing the order, you will be redirected to the website of the online provider Sofort
GmbH, where you can confirm the payment order. This creates the contract with us.
Cash on pickup
We accept your order by sending a declaration of acceptance in a separate email within two
days.
The buyer can issue a SEPA basic mandate to AZ-Delivery Vertriebs GmbH.
The period for the advance notice (pre-notification) is reduced to one day.
The buyer undertakes to ensure that the account is covered. Costs incurred as a result of non-
payment or reversal of the direct debit are borne by the buyer, provided the non-payment or
reversal was not caused by AZ-Delivery Vertriebs GmbH.
The languages available for the conclusion of the contract are German and English.
We save the text of the contract and send you the order data and our terms and conditions by
email. For security reasons, the text of the contract is no longer accessible via the Internet.
46
Machine Translated by Google
In principle, you have the option of collecting the goods from AZ-Delivery Vertriebs GmbH, Plattlinger
Straße 5, 94469 Deggendorf, Germany
, (Monday
during the
to Saturday).
following business hours: 8:00 a.m. to 6:00 p.m.
5. Payment
Credit card
When you place your order, you send us your credit card details at the same time.
After your legitimation as the legitimate cardholder, we will request your credit card company to initiate
the payment transaction immediately after the order has been placed.
The Payment transaction will through that
credit card company carried out automatically and charged to your card.
PayPal Express
During the ordering process, you will be redirected to the website of the online provider PayPal. In order
to be able to pay the invoice amount via PayPal, you must be registered there or register first, identify
yourself with your access data and confirm the payment order to us. After placing the order in the shop,
we ask PayPal to initiate the payment transaction.
Instantly
After placing the order, you will be redirected to the website of the online provider Sofort GmbH. In order
to be able to pay the invoice amount via Sofort, you must have an activated online banking account with
PIN/TAN procedure for participation in Sofort, identify yourself accordingly and confirm the payment
order to us. You'll get more information during the ordering process. The payment transaction will be
carried out immediately afterwards by Sofort and your account will be debited.
47
Machine Translated by Google
You pay the invoice amount after receipt of the goods and the invoice by bank transfer
to our bank account. We reserve the right to offer purchase on account only after a
successful credit check.
Cash on pickup
6. Retention of Title
The following also applies to entrepreneurs: We reserve title to the goods until all
claims from an ongoing business relationship have been settled in full. You may
the resell
reserved goods in the ordinary course of business; You assign all claims arising from
this resale to us in advance - regardless of whether the reserved goods are combined
or mixed with a new item - in the amount of the invoice amount, and we accept this
assignment. You remain authorized to collect the claims, but we may also collect
claims ourselves if you do not meet your payment obligations.
7. Damage in transit
If goods are delivered with obvious transport damage, please report such defects to
the deliverer as soon as possible and contact us immediately. The omission of a
complaint or contact has no consequences for your legal claims and their enforcement,
in particular your warranty rights. However, they help us to be able to assert our own
claims against the carrier or the transport insurance.
The risk of accidental loss and accidental deterioration passes to you as soon as we
have delivered the item to the forwarding agent, carrier or other person or institution
responsible for carrying out the shipment.
The obligation to examine and give notice of defects regulated in Section 377 of the German Commercial Code (HGB) applies to merchants.
If you omit the notification regulated there, the goods are deemed to have been
approved, unless there is a defect that was not recognizable during the inspection.
This does not apply if we have fraudulently concealed a defect.
48
Machine Translated by Google
Unless otherwise stated in these General Terms and Conditions, including the following provisions, we
are liable in the event of a breach of contractual and non-contractual obligations in accordance with the
statutory provisions.
We are liable for damages - for whatever legal reason - within the framework of fault-based liability in
the event of intent and gross negligence. In the case of simple negligence, we are liable, subject to
statutory limitations of liability (e.g
diligence in one's own affairs; insignificant breach of duty), only
A. for damage resulting from injury to life, limb or health, B. for damage resulting from the breach
of a material contractual obligation (obligation, the fulfillment of which is essential for the proper execution
of the contract and on the observance of which the contractual partner regularly relies and may rely );
in this case, however, our liability is limited to compensation for the foreseeable, typically occurring
damage.
The limitations of liability set out above also apply to breaches of duty by or in favor of persons whose
fault we are responsible for according to statutory provisions. They do not apply if we have fraudulently
concealed a defect or have assumed a guarantee for the quality of the goods and for claims under the
Product Liability Act.
9. Dispute Resolution
The European Commission provides a platform for online dispute resolution (OS),
which you can find here https://ec.europa.eu/consumers/odr/.
If you are an entrepreneur, then German law applies to the exclusion of the UN Sales Convention.
If you are a merchant within the meaning of the Commercial Code, a legal entity under public law or a
special fund under public law, the exclusive place of jurisdiction for all disputes arising from contractual
relationships between us and you is our place of business.
49
Machine Translated by Google
50
Machine Translated by Google
Email: [email protected]
51