Skip to content
LeafonyDocsSupport

FAQ

First questions and checks when something does not work.

Ask a question
TopicSelect multiple

10 questions

Identifying leaves

How do I identify the leaf I have?

Look for the model number (part number) printed on the board. Start with the back. Many leaves have a code such as AZ01C or AI04A printed on the back. The position varies by leaf, so check the front too if you cannot find it.

  1. Look for text on the board itself. Black components may also have text on them, but those markings identify the components. The leaf’s model number is printed directly on the board.
  2. Read the complete model number. For example, if it says AZ01C, include the final C when you write it down.
  3. Open the matching documentation from the leaf catalog. Compare the model number, front and back photos, and features such as the USB connector or display with the leaf you have.
Back of AZ01C, with Leafony AZ01C printed in white near the center of the board.
Example: the back of the USB-C leaf. AZ01C is its model number. Select the photo to enlarge it.
Example marking on the boardWhat the leaf doesDocumentation
AZ01CConnects to a computer via USB-CAZ01C USB-C
AI04ADisplays text and numbersAI04 LCD
AP01ARuns a programAP01 AVR MCU

Before separating stacked leaves to check the markings, unplug the USB cable and disconnect batteries and any other power sources.

Identifying leaves

Does the letter at the end of the model number matter?

Yes. Check the complete printed model number when choosing instructions.

A page title may use a shorter name such as AP01 or AI04, while the board is marked AP01A, AP01B or AI04A. Different suffixes may indicate differences in board specifications or operating procedures. For example, AZ01 USB and AZ01C USB-C have different USB connectors and reset procedures when uploading to AP01.

After opening the documentation, check that the instructions apply to the model you have.

Identifying leaves

What if I cannot find or read the model number?

Try taking photos of both sides of the board with your smartphone and zooming in. If the markings are hidden in a stack, you can also compare the leaves listed on your kit’s product page with the photos in the leaf catalog.

To narrow down the candidates, compare readable markings, connector type, and the positions of switches and components with front and back photos in the documentation. For example, a USB-C connector suggests AZ01C, a text display suggests AI04, and a CR2032 holder suggests AV01. Compare the whole board and suffix rather than deciding from one feature alone. Disconnect all power before separating leaves to take photos.

Power and assembly

If it doesn't turn on...

If Leafony won’t turn on, check the following:

  • Is there enough remaining battery power?
  • Is the button battery inserted in the correct direction?
  • Is the power switch turned on?
  • Are the connectors clean? If they are dirty, wipe them lightly with a paper wiper moistened with anhydrous ethanol. If the problem persists, replace the connectors. See Installing and removing connectors for details.
  • Are the screws tight enough? If they are loose, tighten them alternately.
Connections and uploads

Upload fails

Read the complete IDE error message, then open the instructions for your microcontroller and USB leaf.

  • AP01 / AP01B (AVR MCU) + AZ01C (USB-C): Follow the AZ01C upload instructions to check the board and port settings and the manual reset procedure.
  • Other configurations: Use development environment setup to select the instructions for AP01 (AVR), AP02 (ESP32) or AP03 (STM32) and your development tools.
Displays and wireless

No text appears on the LCD

For AI04, check LCD power, initialization, and contrast, in that order.

  1. Choose the LCD example for your MCU from the example catalog. The published examples use tomozh’s arduino_ST7032 library.
  2. Enable LCD power through the I2C I/O Expander. Calling lcd.begin() alone does not control the leaf’s power switch.
  3. Initialize the LCD in the sample’s order, set the contrast, and display text.

See AI04 power and initialization for the operations and addresses. If ST7032.h is missing, see the library error checklist.

Displays and wireless

BLE will not connect or no device is found

Use the guide that matches your kit and the program currently installed on it to check supported devices, browsers and connection methods.

  • The preinstalled AVR MCU demo in Basic Kit or Basic Kit 2: Follow the Basic Kit getting started guide for your Android device, computer, iPhone or iPad.
  • The preinstalled STM32 MCU demo in Basic Kit 2: See the Basic Kit 2 getting started guide for beacon reception, connections and browser requirements.
  • After uploading an example or your own program: Open the relevant article in the example catalog and check that program’s instructions, including its device name and receiving application. Its behavior may differ from the preinstalled demos above.

Once a device is found, use its symptoms to narrow down the cause:

Displays and wireless

ESP32 Wi-Fi cannot connect or the demo page will not open

This checklist is for the preinstalled touch-sensor demo in ESP32 Wi-Fi Kit / Kit 2. Work from the first stage that fails.

StageWhat to check
Leafony_ESP32-AP does not appearPower, battery orientation and charge, and whether the MCU still contains the demo. Another sketch will not necessarily create this network.
The network appears but connection failsSelect Leafony_ESP32-AP and enter password as shown in the getting started guide. Use the new credentials if you changed the sketch.
Connected, but the page does not openConfirm that the device is still connected to Leafony’s Wi-Fi. Enter http://192.168.4.1 in the address bar, including http://. This demo serves a local page and does not require an internet connection. If asked whether to stay on a network without internet, keep the Leafony connection.
The page opens but readings do not changeTouch pin 26 as shown in the guide. If automatic updates are stopped, select 1 second or reload the page. Check the pin assignment before touching other pins.

If you changed the program, use the SSID and address configured by that program. To test with the preinstalled demo’s instructions, follow the demo restoration steps and select the program for your MCU.

Connections and uploads

Restore the kit demo after uploading another program

Resetting or cycling power restarts the uploaded program; it does not restore the preinstalled sketch. Select the demo for the MCU you have, then upload its source again.

MCU / kitDemo to uploadWhere to check the result
AP01 AVR in Basic Kit / Basic Kit 2Web Bluetooth IoT example, using the 4-Sensors_BLE source linked thereBasic Kit guide: connect to Leafony_AC02 and view readings
AP03 STM32 in Basic Kit 2STM32 Logger BeaconBasic Kit 2 guide: connect, record, then read data
AP02 ESP32 in ESP32 Wi-Fi Kit / Kit 2Wi-Fi touch sensorESP32 guide: join Leafony_ESP32-AP and view touch readings

Before uploading, check the example’s required leaves and libraries and follow setup for your MCU. Save any source code you want to keep. Re-uploading a demo does not necessarily reset settings or erase stored measurements; follow that demo’s instructions for those operations.

Check connections and power

Work through MCU, power, pins, and I2C addresses.

Open the combination guide