diff --git a/docs/en/unit/accel.md b/docs/en/unit/accel.md index e14b9fed..2225e10c 100644 --- a/docs/en/unit/accel.md +++ b/docs/en/unit/accel.md @@ -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 diff --git a/docs/en/unit/adc.md b/docs/en/unit/adc.md index abace373..43fd9b4f 100644 --- a/docs/en/unit/adc.md +++ b/docs/en/unit/adc.md @@ -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 diff --git a/docs/en/unit/ameter.md b/docs/en/unit/ameter.md index a9ec6939..be38d72c 100644 --- a/docs/en/unit/ameter.md +++ b/docs/en/unit/ameter.md @@ -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 - + @@ -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(); - \ No newline at end of file + diff --git a/docs/en/unit/angle.md b/docs/en/unit/angle.md index 011919ee..471a5281 100644 --- a/docs/en/unit/angle.md +++ b/docs/en/unit/angle.md @@ -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 - +
Resources
@@ -127,4 +129,4 @@ If you want the complete code, please click [here](https://github.com/m5stack/M5 anchor_search(purchase_link); scrollFunc(); - \ No newline at end of file + diff --git a/docs/en/unit/bps.md b/docs/en/unit/bps.md index 04eb2e0b..426df4c9 100644 --- a/docs/en/unit/bps.md +++ b/docs/en/unit/bps.md @@ -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)
@@ -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(); - \ No newline at end of file + diff --git a/docs/en/unit/butterfly.md b/docs/en/unit/butterfly.md index a8299b5f..164f19da 100644 --- a/docs/en/unit/butterfly.md +++ b/docs/en/unit/butterfly.md @@ -2,19 +2,26 @@ SKU:A041-B -
+
+ + +
## 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. +



-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.

-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. +


@@ -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 - +
@@ -82,7 +89,7 @@ So, ## PinMap -**Mega328 ISP**Download interface Pin foot definition +**Mega328 ISP** Download interface footprint PIN definition @@ -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




-*Notice:*
+*Notice:*
+ 1) Add a power supply at the end of the line, either with (grove 2 usbA cable + power bank) or (wall plug)
2) grove 2 usbA cable
-3) wall plug with GROVE male port +3) wall plug with GROVE male port *recommended step:*
+ 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
-1, Navigate to Custom, click open *m5d
-2, Choose butterfly.m5d
-3, Unfold Custom, there appears the butterfly program block.


@@ -145,4 +157,4 @@ I will show you how to set up the develope environment on UIflow
anchor_search(purchase_link); scrollFunc(); - \ No newline at end of file + diff --git a/docs/en/unit/weight.md b/docs/en/unit/weight.md index 4a9ba412..2c2e470d 100644 --- a/docs/en/unit/weight.md +++ b/docs/en/unit/weight.md @@ -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. @@ -152,4 +153,4 @@ To get complete code, please click [here](https://github.com/m5stack/M5-ProductE anchor_search(purchase_link); scrollFunc(); - \ No newline at end of file +