]> granicus.if.org Git - esp-idf/commitdiff
doc(pcnt): Update pcnt example README.md file.
authorhou wen xiang <houwenxiang@espressif.com>
Fri, 29 Jun 2018 10:48:57 +0000 (18:48 +0800)
committerkooho <2229179028@qq.com>
Thu, 6 Dec 2018 04:16:45 +0000 (12:16 +0800)
examples/peripherals/pcnt/README.md
examples/peripherals/pcnt/main/pcnt_example_main.c

index b1df510dfe10b718db663bcb1000099bb2557343..4ab5395ebacf23114382a49aea8e52ef736116d8 100644 (file)
@@ -1,32 +1,48 @@
-# Example: pcnt
+# PCNT Example
+
+(See the README.md file in the upper level 'examples' directory for more information about examples.)
 
 This example uses the pulse counter module (PCNT) to count the rising edges of the PWM pulses generated by the LED Controller module (LEDC).
 
-The examples is setting up and then using the following GPIO pins:
-  * GPIO18 - output pin of a sample 1 Hz pulse generator,
-  * GPIO4 - pulse input pin,
-  * GPIO5 - control input pin.
+## How to use example
 
-The configuration parameters of this example (pin numbers, etc.) may be modified at the top of the `main/pcnt_test.c` file.
+### Hardware Required
 
-## Run the Test
+* A development board with ESP32 SoC (e.g., ESP32-DevKitC, ESP-WROVER-KIT, etc.)
+* A USB cable for power supply and programming
 
-1, Compile and load the example.
-2. Open a serial port monitor to view the message printed out on your screen.
-3. Connect GPIO18 with GPIO4.
-4. GPIO5 is the control signal, you can leave it floating with internal pull up, or connect it to ground. If left floating, the count value will be increasing. If you connect GPIO5 to GND, the count will be decreasing.
+Pin connection:
 
+* GPIO4 is the default output GPIO of the 1 Hz pulse generator.
+* GPIO18 is the default pulse input GPIO. We need to short GPIO4 and GPIO18.
+* GPIO5 is the default control signal, which can be left floating with internal pull up, or connected to Ground (If GPIO5 is left floating, the value of counter increases with the rising edges of the PWM pulses. If GPIO15 is connected to Ground, the value decreases).
 
-## Check Functionality
+### Configure the project
 
-The example will print out the current counter values and events. 
+```
+make menuconfig
+```
 
-An interrupt will be triggered when the counter value:
-  * reaches 'thresh1' or 'thresh0' value,
-  * reaches 'l_lim' value or 'h_lim' value,
-  * will be reset to zero.
+* Set serial port under Serial Flasher Options.
 
-A sample output on the serial monitor:
+### Build and Flash
+
+Build the project and flash it to the board, then run monitor tool to view serial output:
+
+```
+make -j4 flash monitor
+```
+
+(To exit the serial monitor, type ``Ctrl-]``.)
+
+
+See the Getting Started Guide for full steps to configure and use ESP-IDF to build projects.
+
+## Example Output
+
+
+Run this example, and you can see the following output log on the serial monitor:
+(Here, GPIO5 is connected to Ground)
 
 ```
 Current counter value :-1
@@ -47,5 +63,12 @@ Current counter value :0
 Current counter value :-1
 ...
 ```
-  
-See the README.md file in the upper level 'examples' directory for more information about examples.
+
+## Troubleshooting
+
+* program upload failure
+
+    * Hardware connection is not correct: run `make monitor`, and reboot your board to see if there are any output logs.
+    * The baud rate for downloading is too high: lower your baud rate in the `menuconfig` menu, and try again.
+
+For any technical queries, please open an [issue](https://github.com/espressif/esp-idf/issues) on GitHub. We will get back to you soon.
index a5da7946b3c54ff25ec5329b721f97d85592ead7..3a37c55fd0058f4f871ed804336179686f2b1c62 100644 (file)
@@ -111,6 +111,7 @@ static void ledc_init(void)
     ledc_channel.intr_type  = LEDC_INTR_DISABLE;
     ledc_channel.gpio_num   = LEDC_OUTPUT_IO;
     ledc_channel.duty       = 100; // set duty at about 10%
+    ledc_channel.hpoint     = 0;
     ledc_channel_config(&ledc_channel);
 }