text clean up

2 files changed, 16 insertions, 6 deletions

diff --git a/src/class/cdc/cdc_device.h b/src/class/cdc/cdc_device.h
index 6c59bac7a..18d6f842f 100644
--- a/src/class/cdc/cdc_device.h
+++ b/src/class/cdc/cdc_device.h
@@ -89,9 +89,17 @@ static inline bool     tud_cdc_write_flush     (void)
 //--------------------------------------------------------------------+

 // APPLICATION CALLBACK API (WEAK is optional)

 //--------------------------------------------------------------------+

+

+// Invoked when received new data

 ATTR_WEAK void tud_cdc_rx_cb(uint8_t itf);

+

+// Invoked when received `wanted_char`

 ATTR_WEAK void tud_cdc_rx_wanted_cb(uint8_t itf, char wanted_char);

+

+// Invoked when line state DTR & RTS are changed via SET_CONTROL_LINE_STATE

 ATTR_WEAK void tud_cdc_line_state_cb(uint8_t itf, bool dtr, bool rts);

+

+// Invoked when line coding is change via SET_LINE_CODING

 ATTR_WEAK void tud_cdc_line_coding_cb(uint8_t itf, cdc_line_coding_t const* p_line_coding);

 

 /** @} */

diff --git a/src/class/msc/msc_device.h b/src/class/msc/msc_device.h
index 6e3aef8bb..b1e7e8da1 100644
--- a/src/class/msc/msc_device.h
+++ b/src/class/msc/msc_device.h
@@ -64,10 +64,11 @@ TU_VERIFY_STATIC(CFG_TUD_MSC_BUFSIZE < UINT16_MAX, "Size is not correct");
 bool tud_msc_set_sense(uint8_t lun, uint8_t sense_key, uint8_t add_sense_code, uint8_t add_sense_qualifier);

 

 //--------------------------------------------------------------------+

-// APPLICATION CALLBACK (WEAK is optional)

+// Application Callbacks (WEAK is optional)

 //--------------------------------------------------------------------+

+

 /**

- * Callback invoked when received \ref SCSI_CMD_READ_10 command

+ * Invoked when received \ref SCSI_CMD_READ_10 command

  * \param[in]   lun         Logical unit number

  * \param[in]   lba         Logical Block Address to be read

  * \param[in]   offset      Byte offset from LBA

@@ -86,7 +87,7 @@ bool tud_msc_set_sense(uint8_t lun, uint8_t sense_key, uint8_t add_sense_code, u
 int32_t tud_msc_read10_cb (uint8_t lun, uint32_t lba, uint32_t offset, void* buffer, uint32_t bufsize);

 

 /**

- * Callback invoked when received \ref SCSI_CMD_WRITE_10 command

+ * Invoked when received \ref SCSI_CMD_WRITE_10 command

  * \param[in]   lun         Logical unit number

  * \param[in]   lba         Logical Block Address to be write

  * \param[in]   offset      Byte offset from LBA

@@ -104,7 +105,8 @@ int32_t tud_msc_read10_cb (uint8_t lun, uint32_t lba, uint32_t offset, void* buf
  */

 int32_t tud_msc_write10_cb (uint8_t lun, uint32_t lba, uint32_t offset, uint8_t* buffer, uint32_t bufsize);

 

-// Invoked to determine the disk size

+// Invoked when received SCSI_CMD_READ_CAPACITY_10 and SCSI_CMD_READ_FORMAT_CAPACITY to determine the disk size

+// Application update block count and block size

 void tud_msc_capacity_cb(uint8_t lun, uint32_t* block_count, uint16_t* block_size);

 

 /**

@@ -128,13 +130,13 @@ int32_t tud_msc_scsi_cb (uint8_t lun, uint8_t const scsi_cmd[16], void* buffer,
 

 /*------------- Optional callbacks -------------*/

 

-// Invoked to determine max LUN

+// Invoked when received GET_MAX_LUN request

 ATTR_WEAK uint8_t tud_msc_maxlun_cb(void);

 

 // Invoked when Read10 command is complete

 ATTR_WEAK void tud_msc_read10_complete_cb(uint8_t lun);

 

-// Invoke when Write10 command is complete

+// Invoke when Write10 command is complete, can be used to flush flash caching

 ATTR_WEAK void tud_msc_write10_complete_cb(uint8_t lun);

 

 // Invoked when command in tud_msc_scsi_cb is complete