Updated

Author: pantaluna

README.md

@@ -6,7 +6,33 @@ This example shows how to control the intensity of LEDs using the standard ESP-I
 
 Espressif Reference Documentation: https://esp-idf.readthedocs.io/en/latest/api-reference/peripherals/ledc.html
 
+
+
+## What are the HW SW requirements of the ESP32 MJD Starter Kit?
+
+### Hardware
+
+- A decent ESP development board. I suggest to buy a popular development board with good technical documentation and a significant user base. Examples: [Adafruit HUZZAH32](https://www.adafruit.com/product/3405),  [Espressif ESP32-DevKitC](http://espressif.com/en/products/hardware/esp32-devkitc/overview), [Pycom WiPy](https://pycom.io/hardware/), [Wemos D32](https://wiki.wemos.cc/products:d32:d32).
+- The peripherals that are used in the project.
+  @tip The README of each component contains a section "Shop Products".
+  @example A Bosch BME280 meteo sensor breakout board.
+
+### Software: ESP-IDF v3.2
+
+- A working installation of the **Espressif ESP-IDF *V3.2* development framework**** (detailed instructions @ http://esp-idf.readthedocs.io/en/latest/get-started/index.html).
+
+```
+mkdir ~/esp
+cd    ~/esp
+git clone -b v3.3 --recursive https://github.com/espressif/esp-idf.git esp-idf-v3.2
+```
+
+- A C language editor or the Eclipse IDE CDT (instructions also @ http://esp-idf.readthedocs.io/en/latest/get-started/index.html).
+
+
+
 ## FAQ
+
 - LEDC: the available duty resolution steps = (2 ^ bit_num bit_num of the duty resolution) - 1
 - LEDC: the maximal frequency is 80000000 / (2 ^ bit_num of the duty resolution)
 - https://physics.stackexchange.com/questions/19040/limit-of-human-eye-flicker-perception

components/mjd/README.md

@@ -1,22 +1,14 @@
 # ESP32 MJD Component
-This is a component based on ESP-IDF for the ESP32 hardware from Espressif. 
-
-
+This is a component based on ESP-IDF for the ESP32 hardware from Espressif.
 
 It is the base component of the MJD Starter Kit which contains general purpose functions.
 
-
-
 ## Example ESP-IDF project
 esp32_mjd_components
 
-
-
 ## Reference: the ESP32 MJD Starter Kit SDK
-
 Do you also want to create innovative IoT projects that use the ESP32 chip, or ESP32-based modules, of the popular company Espressif? Well, I did and still do. And I hope you do too.
 
 The objective of this well documented Starter Kit is to accelerate the development of your IoT projects for ESP32 hardware using the ESP-IDF framework from Espressif and get inspired what kind of apps you can build for ESP32 using various hardware modules.
 
 Go to https://github.com/pantaluna/esp32-mjd-starter-kit
-

components/mjd/include/mjd.h

@@ -95,8 +95,13 @@ extern "C" {
 int mjd_compare_ints(const void * a, const void * b);
 
 /**********
- * BYTES and BINARY REPRESENTATION
+ * BYTES/WORDS and BINARY REPRESENTATION
  */
+#define MJD_HIBYTE(x) ((uint8_t)((uint16_t)(x) >> 8))
+#define MJD_LOBYTE(x) ((uint8_t)(x))
+#define MJD_HIWORD(x) ((uint16_t)((uint32_t)(x) >> 16))
+#define MJD_LOWORD(x) ((uint16_t)((uint32_t)(x)))
+
 uint8_t mjd_byte_to_bcd(uint8_t val);
 uint8_t mjd_bcd_to_byte(uint8_t val);
 esp_err_t mjd_byte_to_binary_string(uint8_t input_byte, char * output_string);

components/mjd/mjd.c

@@ -366,8 +366,8 @@ void mjd_log_clanguage_details() {
 
     ESP_LOGI(TAG, "  float");
     ESP_LOGI(TAG, "    Storage size (bytes): %d", sizeof(float));
-    ESP_LOGI(TAG, "    FLT_MIN positive value: %E", FLT_MIN);
-    ESP_LOGI(TAG, "    FLT_MAX maximum positive value: %E", FLT_MAX);
+    ESP_LOGI(TAG, "    FLT_MIN Minimum normalized positive floating-point value:  %E", FLT_MIN);
+    ESP_LOGI(TAG, "    FLT_MAX Maximum representable finite floating-point value: %E", FLT_MAX);
     ESP_LOGI(TAG, "    FLT_DIG precision value: %d", FLT_DIG);
 
     ESP_LOGI(TAG, "  size_t");

github-commands.txt

@@ -43,7 +43,7 @@ git commit -m "Updated"
 git config credential.helper store
 git push --set-upstream origin master
 
-git tag --annotate v0.82 --message "Second tag"
+git tag --annotate v1.3 --message "Upgraded for ESP-IDF v3.2 of April 2019"
 git push origin --tags
 
 git describe --tags --dirt