To follow the discussion started in#458, it would be nice to document the usage of this core for users coming for official Arduino core.

Even if a dedicated website would be nice, it requires some work to setup a template with some style, categories... So instead, I propose to leverage theexisting wiki.

I have started by adding theHardwareSerial info reported in#458, see here:
https://github.com/stm32duino/wiki/wiki/API#hardwareserial

Do you think it is the right place? I am open to any suggestions.

@fpistm For theHardwareSerial case, using the first method (declaring aHardwareSerial in the sketch) will not enable theserialEvent() callback, right?
For what I understand here:

Only passing-DENABLE_HWSERIAL1 will enable it. Am I right?

ToDo:

• Core debug
• Pin mapping vs Pin number
• Digital(Read|Write)Fast(),digitalToggle() anddigitalToggleFast()
  ...