Book improvements

[SergioGasquez]

• When we only want to build the project --target is not required as its already specified in the config.toml
• If we only want to open a serial monitor without flashing the device again, we can use the serial-monitor subcommand of cargo-espflash
  • It may also be worth adding a note saying that when no serial device is specified in the cargo-espflash command, it will print a list of the available serial devices so the user can choose.
  • espmonitor is not being installed but its mentioned. espmonitor is no longer required.
  • We will be releasing espflash and cargo-espflash v2.0 soon. With this new release, subcommands will change a bit, so it may be worth waiting for the new release and update all the flashing/monitoring commands at once.
  • We noticed many users having errors to flash, most of those errors were because they were using an old version of espflash/cargo-espflash. It may help add a note so users are using a recent version of it, or having a fixed version on the book so we make sure they all install the same version.
  • We could add a custom runner to allow using cargo run to flash and monitor. by adding the following to .cargo/config.toml:

  [target.riscv32imc-esp-espidf]
  runner = "espflash --monitor"

  If we add the custom runner we would also need to install espflash
• The esp-idf-template was improved, and the prompts to configure the project are outdated. We now have the following items:

• Project name: hello-world
• DevContainer Support: false
• STD support: true
• MCU: esp32c3
• ESP-IDF version: 4.4

• The Setup section of HTTP Server has a small typo (http_serve should be http_server ):
  cargo espflash --release --example **http_serve** --monitor $SERIALDEVICE
• It would be good to have some notes about Wokwi, as we now support some of the examples on it:
  • Training exercises:
    • intro/hardware-check
    • intro/http-client*
    • intro/http-server*
    • intro/mqtt*
    • advanced/i2c-sensor-reading
    • advanced/i2c-driver
    • advanced/button-interrupt
      Projects with * are building fine but not running properly, they need to be reviewed.
  • Other examples
  • GDB Debugging