mirror of
https://github.com/m5stack/m5-docs.git
synced 2026-05-20 10:23:01 -07:00
update docs
This commit is contained in:
Zontex
@@ -113,7 +113,7 @@ By measuring the amount of static acceleration, due to gravity, you can find out
|
||||
|
||||
>2. After downloading the software, double-click to run the application, connect the M5 device to the computer through the data cable, select the port parameters, click **"Burn"** to start burning. (**For M5StickC burning, please Set the baud rate to 750000 or 115200**)
|
||||
|
||||
?> 3. Currently EasyLoader is only suitable for Windows operating system, compatible with M5 system adopts ESP32 as the control core host. Before installing for M5Core, you need to install CP210X driver (you do not need to install with M5StickC as controller)[Click here to view the driver installation tutorial](en/related_documents/M5Burner#install-usb-driver)
|
||||
> 3. Currently EasyLoader is only suitable for Windows operating system, compatible with M5 system adopts ESP32 as the control core host. Before installing for M5Core, you need to install CP210X driver (you do not need to install with M5StickC as controller)[Click here to view the driver installation tutorial](en/related_documents/M5Burner#install-usb-driver)
|
||||
|
||||
## Example
|
||||
|
||||
|
||||
+2
-3
@@ -9,12 +9,11 @@
|
||||
**ADC** integrated with ADS1100 which is a fully differential, 16-bit, self-calibrating,delta-sigma A/D converter.
|
||||
It communicates through an I2C interface,which means you can collect AD data thru PortA on M5 core from this unit to enhence your A/D performance.
|
||||
|
||||
The I2C address is 0x48.
|
||||
The default I2C address is 0x48.
|
||||
|
||||
## Product Features
|
||||
|
||||
- COMPLETE DATA ACQUISITION SYSTEM IN A
|
||||
TINY SOT23-6 PACKAGE
|
||||
- COMPLETE DATA ACQUISITION SYSTEM IN A TINY SOT23-6 PACKAGE
|
||||
- 16-BITS NO MISSING CODES
|
||||
- INL: 0.0125% of FSR MAX
|
||||
- CONTINUOUS SELF-CALIBRATION
|
||||
|
||||
@@ -6,7 +6,9 @@
|
||||
|
||||
## Description
|
||||
|
||||
**Ammeter Unit** is a current meter that can monitor the current in real time. The 16-bit ADC (analog-to-digital) converter ADS1115 is used internally to communicate through I2C (0X48). In order to ensure the measurement accuracy, there is a built-in DC-DC isolated power supply, and the I2C interface is also electrically isolated through the low-power isolator CA-IS3020S. This prevents noise and surges on the data bus or other circuits from entering the local ground terminal to interfere or damage sensitive circuits. Each Unit is individually calibrated when leaving the factory, with inital Accurancy 0.1%FS, ±1 count, resolution 0.3mA. The unit has a maximum measurement current of ±4A, and an internal integrated 4A fuse to prevent excessive measurement current from burning out the circuit.
|
||||
**Ammeter Unit** is a current meter that can monitor the current in real time. The 16-bit ADC (analog-to-digital) converter ADS1115 is used internally to communicate through I2C (By default the address is 0X48).
|
||||
|
||||
In order to ensure the measurement accuracy, there is a built-in DC-DC isolated power supply, and the I2C interface is also electrically isolated through the low-power isolator CA-IS3020S. This prevents noise and surges on the data bus or other circuits from entering the local ground terminal to interfere or damage sensitive circuits. Each Unit is individually calibrated when leaving the factory, with initial accuracy 0.1%FS, ±1 count, resolution 0.3mA. The unit has a maximum measurement current of ±4A, and an internal integrated 4A fuse to prevent excessive measurement current from burning out the circuit.
|
||||
|
||||
>? EEPROM (0x51) has built-in calibration parameters when leaving the factory. Please do not write to the EEPROM, otherwise the calibration data will be overwritten and the measurement results will be inaccurate.
|
||||
|
||||
@@ -34,7 +36,7 @@
|
||||
- galvanometer
|
||||
|
||||
## Specification
|
||||
|
||||
|
||||
<table>
|
||||
<tr style="font-weight:bold">
|
||||
<td>Resources</td>
|
||||
@@ -129,7 +131,7 @@ bool Ammeter::saveCalibration2EEPROM(ammeterGain_t gain, int16_t hope, int16_t a
|
||||
|
||||
## Related Link
|
||||
|
||||
- **Datasheet**
|
||||
- **Datasheet**
|
||||
- [CA-IS3020S](https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/docs/datasheet/unit/CA-IS3020S.pdf)
|
||||
- [ADS1115](https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/docs/datasheet/unit/ADS1115.PDF)
|
||||
|
||||
@@ -157,4 +159,4 @@ bool Ammeter::saveCalibration2EEPROM(ammeterGain_t gain, int16_t hope, int16_t a
|
||||
anchor_search(purchase_link);
|
||||
scrollFunc();
|
||||
|
||||
</script>
|
||||
</script>
|
||||
|
||||
@@ -6,12 +6,14 @@
|
||||
|
||||
## Description
|
||||
|
||||
**ANGLE** is a rotary switch Unit,simply having a **10K** potentiometer inside. This unit can be used for Continuous singal dialing control, such as volume, brightness, or motor speed.
|
||||
**ANGLE** is a rotary switch Unit which simply includes a **10K** Ohm potentiometer inside. This unit can be used for Continuous singal dialing control, such as volume, brightness, or motor speed.
|
||||
|
||||
A potentiometer is a manually adjustable variable resistor with three terminals. Two terminals are connected to a resistive element, the third terminal is connected to an adjustable wiper. The position of the wiper determines the output voltage.
|
||||
|
||||
A potentiometer is a manually adjustable, variable resistor with three terminals. Two terminals are connected to a resistive element, the third terminal is connected to an adjustable wiper. The position of the wiper determines the output voltage.
|
||||
The out voltage is captured and converted by AD on ESP32 on portB.
|
||||
|
||||
*In M5Stack product system, Normally the Grove color indicates the type of communications.*
|
||||
|
||||
- Black: Single BUS (AD ,DA ,GPIO)
|
||||
- Red: I2C
|
||||
- Blue：Uart
|
||||
@@ -35,7 +37,7 @@ The Unit's Grove interface is black, specify it is an analog interface that shou
|
||||
|
||||
|
||||
## Specification
|
||||
|
||||
|
||||
<table class="table-1">
|
||||
<thead>
|
||||
<tr>
|
||||
@@ -127,4 +129,4 @@ If you want the complete code, please click [here](https://github.com/m5stack/M5
|
||||
anchor_search(purchase_link);
|
||||
scrollFunc();
|
||||
|
||||
</script>
|
||||
</script>
|
||||
|
||||
+3
-3
@@ -96,7 +96,7 @@
|
||||
|
||||
## EasyLoader
|
||||
|
||||
>EasyLoader is a concise and fast program writer, which has a built-in case program related to the product. It can be burned to the main control by simple steps to perform a series of function verification. Please install the corresponding driver according to the device type. M5Core host [Please click here to view the CP210X driver installation tutorial](en/arduino/arduino_development), M5StickC/V/T/ATOM series can be used without driver)
|
||||
>EasyLoader is a precise and fast program writer, which has a built-in case program related to the product. It can be burned to the main control by simple steps to perform a series of function verification. Please install the corresponding driver according to the device type. M5Core host [Please click here to view the CP210X driver installation tutorial](en/arduino/arduino_development), M5StickC/V/T/ATOM series can be used without driver)
|
||||
|
||||
<div class="easyloader-box">
|
||||
<div style="background-color:white;">
|
||||
@@ -121,7 +121,7 @@
|
||||
|
||||
## Related Link
|
||||
|
||||
- **Datasheet**
|
||||
- **Datasheet**
|
||||
- [BMP 280](https://m5stack.oss-cn-shenzhen.aliyuncs.com/resource/docs/datasheet/hat/BMP280-DS001-11_en.pdf)
|
||||
|
||||
## Schematic
|
||||
@@ -148,4 +148,4 @@ To get complete code, please click [here](https://github.com/m5stack/M5-ProductE
|
||||
anchor_search(purchase_link);
|
||||
scrollFunc();
|
||||
|
||||
</script>
|
||||
</script>
|
||||
|
||||
+34
-22
@@ -2,19 +2,26 @@
|
||||
|
||||
<el-tag effect="plain">SKU:A041-B</el-tag>
|
||||
|
||||
<div class="product_pic"><img src="assets/img/product_pics/app/butterfly/butterfly_01.webp"><img src="assets/img/product_pics/app/butterfly/butterfly_02.webp"></div>
|
||||
<div class="product_pic">
|
||||
<img src="assets/img/product_pics/app/butterfly/butterfly_01.webp">
|
||||
<img src="assets/img/product_pics/app/butterfly/butterfly_02.webp">
|
||||
</div>
|
||||
|
||||
## Description
|
||||
|
||||
**BUTTERFLY** This is an upgrade of old Butterfly. In comparison, this new launcher has packed with a microprocessor MEGA328 and 18 RGB LEDs. It also has a Lipo battery assembly onto the device, plus two ports for power, serial communication, and connection. One standout feather is that you can have many devices connected in serial, and control them independently. Therefore you can create a very nice effect.
|
||||
**BUTTERFLY** launcher is an upgrade to the old Butterfly product. In comparison, this new launcher has packed with a microprocessor MEGA328 and 18 RGB LEDs. It also has a Lipo battery assembly onto the device, plus two ports for power, serial communication, and connection. One standout feather is that you can have many devices connected in serial, and control them independently. Therefore you can create a very nice effect.
|
||||
|
||||
<br><br>
|
||||
<img src="assets/img/product_pics/app/butterfly/5.webp" height="300px">
|
||||
<br><br>
|
||||
The mechanism of series communication: the devices are connected in series. to identified a certain device and to sent an instruction to a certain device, we will attach an 'id' variable with the command, which will be sent from the controller(M5 core) to the serial connection, in this process, the 'id' variable will minus 1 by each device at each time when the command passes through the line. The device that got id = 0, will execute the command.
|
||||
|
||||
The mechanism of series communication: the devices are connected in series, to identify a certain device and to send command to a certain device we will attach an 'id' variable with the command which will be sent from the controller (M5 core) by the serial connection. in this process, the 'id' variable will minus 1 by each device at each time when the command passes through the line. The device that got id = 0, will execute the command.
|
||||
<br><br>
|
||||
So,
|
||||
1, Each of them can be controlled independently, they are allowed to constrain the led color, blink mode, brightness and servo status which is used to launch the butterflies.
|
||||
2, As we can see from the video below, from LED demonstration, the delay is obvious, if there is a 100ms delay for every device, and we have 10 in total the last device will have a 1s delay. To optimate this delay, we could program the first device to wait for the last device. However, based on the protocol, a delay will exist no matter what.
|
||||
|
||||
1. Each of the LEDs controlled independently, they are allowed to constrain the LED color, blink mode, brightness and servo status which is used to launch the butterflies.
|
||||
|
||||
2. As we can see from the video below in the LED demonstration, the delay is obvious. if there is a 100ms delay for every device, and we have 10 in total the last device will have a 1s delay. To optimize this delay, we could program the first device to wait for the last device. However, based on the protocol, a delay will exist no matter what.
|
||||
|
||||
<br><br><br>
|
||||
<img src="assets/img/product_pics/app/butterfly/butterfly_03.webp" width="30%" height="30%">
|
||||
<img src="assets/img/product_pics/app/butterfly/butterfly_04.webp" width="30%" height="30%">
|
||||
@@ -24,14 +31,14 @@ So,
|
||||
- Serial extendable
|
||||
- 18x RGB LED
|
||||
- UART serial communication
|
||||
- UIflow (graphic/blockly language allowed)
|
||||
- UIflow (graphic/blockly language allowed)
|
||||
|
||||
## Include
|
||||
|
||||
- BUTTERFLY Launcher
|
||||
- Butterfly paper model
|
||||
- Cable
|
||||
- Rubber band
|
||||
- Rubber band
|
||||
|
||||
## Applications
|
||||
|
||||
@@ -39,7 +46,7 @@ So,
|
||||
- Stem Education
|
||||
|
||||
## Specification
|
||||
|
||||
|
||||
<table class="table-1">
|
||||
<thead>
|
||||
<tr>
|
||||
@@ -82,7 +89,7 @@ So,
|
||||
|
||||
## PinMap
|
||||
|
||||
**Mega328 ISP**Download interface Pin foot definition
|
||||
**Mega328 ISP** Download interface footprint PIN definition
|
||||
|
||||
<img src="assets\img\product_pics\app\mega328_isp.webp" width="30%" height="30%">
|
||||
|
||||
@@ -97,7 +104,7 @@ Please click，[here](https://github.com/m5stack/M5-ProductExampleCodes/tree/mas
|
||||
### Button Function (see from LED side)
|
||||
|
||||
- Right: single- press to power on, double press to power off.
|
||||
- Left: long-press until the led cricle changed to another color, release the button. Then short press it will adjust the servo arm. repeat the above the process to get the right position.
|
||||
- Left: long-press till the LED circle change to different color then release the button. Short press will adjust the servo arm. repeat the above the process to get the right position.
|
||||
|
||||
### Load Butterfly Pattern
|
||||
|
||||
@@ -109,24 +116,29 @@ Please click，[here](https://github.com/m5stack/M5-ProductExampleCodes/tree/mas
|
||||
<br><br>
|
||||
<img src="assets/img/product_pics/app/butterfly/6.webp" width="30%" height="30%">
|
||||
<br><br><br>
|
||||
*Notice:*<br>
|
||||
*Notice:*<br>
|
||||
|
||||
1) Add a power supply at the end of the line, either with (grove 2 usbA cable + power bank) or (wall plug)<br>
|
||||
2) grove 2 usbA cable <br>
|
||||
3) wall plug with GROVE male port
|
||||
3) wall plug with GROVE male port
|
||||
|
||||
*recommended step:* <br>
|
||||
|
||||
1) wire up the devices with m5go at beginning and additional power supply at end.
|
||||
2) use the uiflow test code to test the line make sure every units is working normally.
|
||||
2) use the UIFlow test code to test the line make sure every units is working normally.
|
||||
3) use the button on the device to load the butterfly.
|
||||
4) Program the button on M5GO to launch the butteryfly
|
||||
4) Program the button on M5GO to launch the butterfly
|
||||
|
||||
## Developement Environment Set-up
|
||||
## Development Environment Set-up
|
||||
|
||||
We have integrated the programming blocks on UIFLow that should allow us t o program the project in the easiest way.
|
||||
|
||||
To setup the UIFlow Development environment, follow the steps:
|
||||
|
||||
1. Navigate to Custom, click open *m5d
|
||||
2. Choose butterfly.m5d
|
||||
3. Unfold Custom, there appears the butterfly program block.
|
||||
|
||||
Regarding the coding, We have encapsulated a specific Block on UIFLow. so that you can program your project as easy as possible.
|
||||
I will show you how to set up the develope environment on UIflow<br>
|
||||
1, Navigate to Custom, click open *m5d <br>
|
||||
2, Choose butterfly.m5d <br>
|
||||
3, Unfold Custom, there appears the butterfly program block. <br><br><br>
|
||||
<img src="assets/img/product_pics/app/butterfly/1.webp" width="30%" height="30%">
|
||||
<img src="assets/img/product_pics/app/butterfly/2.webp" width="30%" height="30%">
|
||||
<img src="assets/img/product_pics/app/butterfly/3.webp" width="30%" height="30%">
|
||||
@@ -145,4 +157,4 @@ I will show you how to set up the develope environment on UIflow<br>
|
||||
anchor_search(purchase_link);
|
||||
scrollFunc();
|
||||
|
||||
</script>
|
||||
</script>
|
||||
|
||||
@@ -6,14 +6,15 @@
|
||||
|
||||
## Description
|
||||
|
||||
**WEIGHT** intergrates an 24 bits A/D chip **HX711** that is specifically designed for electronic weighing device.
|
||||
**WEIGHT** integrates a 24 bits A/D chip **HX711** that is specifically designed for electronic weighing device.
|
||||
|
||||
The input multiplexer selects either Channel A or B differential input to the low-noise programmable gain amplifier (PGA). Channel A can be programmed with a gain of 128 or 64, corresponding to a full-scale differential input
|
||||
voltage of ±20mV or ±40mV respectively, when a 5V supply is connected to AVDD analog power supply pin. Channel B has a fixed gain of 32. There is no programming needed for the
|
||||
internal registers. All controls to the HX711 are
|
||||
through the pins.
|
||||
The input multiplexer selects either Channel A or B differential input to the low-noise programmable gain amplifier (PGA). Channel "A" can be programmed with a gain of 128 or 64, corresponding to a full-scale differential input voltage of ±20mV or ±40mV respectively.
|
||||
|
||||
In the test, we have this Unit channel A to connect a pressure sensor. Then use M5Core screen to display the weight data.
|
||||
when a 5V supply is connected to AVDD analog power supply pin.
|
||||
|
||||
Channel B has a fixed gain of 32. There is no programming needed for the internal registers. All controls to the HX711 are through the pins.
|
||||
|
||||
In the test, we have this Unit channel A to connect a pressure sensor. Then, use M5Core screen to display the weight data.
|
||||
|
||||
<img src="assets/img/product_pics/unit/unit_weight_04.webp">
|
||||
|
||||
@@ -152,4 +153,4 @@ To get complete code, please click [here](https://github.com/m5stack/M5-ProductE
|
||||
anchor_search(purchase_link);
|
||||
scrollFunc();
|
||||
|
||||
</script>
|
||||
</script>
|
||||
|
||||
Reference in New Issue
Block a user