Code in Doxygen einbinden

[Mirco G. (mirco432)]

Hi. Ich versuche gerade verzweifelt Code in meiner Dokumentation 
anzeigen zu lassen.

Ich möchte den Code von der Funktion SPI_send einbinden. Wenn ich es mit 
\code und \endcode mache wird mir zwar der Code angezeigt aber bei der 
Funktion SPI_empfangen. Die Funktion send wird auch gar nicht mehr in 
der Dokumentation angezeigt.

/**
  \brief senden von 16 Bit Befehl u. ggf. Daten

   s. S. 56 Bus Protokoll zuerst Befehl dann PEC z. Befehl, danach die Daten und dann Pec zu den Daten 
   SS muss waehrend der gesamten Zeit einer Befehlssequenz low sein also fuer Daten und Befehl => alles in einem Befehl machen.
   Zuerst muss Highbyte dann Lowbyte gesendet werden. s.S. 56
   
   Moegliche Faelle:
   Befehl und Daten senden  direkt hintereinader weg SS muss die ganze zeit 0 sein
   Nur befehl befehl senden
   
   wenn keine Daten gesendet werden diese einfach als 0 uebergeben    => dann wird for schleife unten unterborchen
  \code
   */

void SPI_send(uint16_t Befehl, uint16_t Daten)
{
  char Nachricht[2];
  uint16_t PEC, Senden;
  
  PORT_SPI &= ~(1<<SS);                      // SS auf Low => Kommunikation Starten

  for(uint8_t i = 0; i<2; i++)
  {
    if(i==0) 
    {
      Senden=Befehl;                        //erster Durchlauf Befehl senden
    }
    else
    {
      Senden=Daten;                          //zweiter Durchlauf Nachricht senden
    }
  
  Nachricht[0]=SHORT_H_BYTE(Senden);        //Zerlegen in High und Low Byte
  Nachricht[1]=SHORT_L_BYTE(Senden);
  
  PEC=pec15(Nachricht,2);                      //PEC für die entspechende Nachricht berechnen
  
  SPDR =  Nachricht[0];                        //H_Byte Befehl senden
  while(!(SPSR & (1<<SPIF)));                    //Warten bis gesndet wurde
  
  SPDR =  Nachricht[1];                        //L_Byte Befehl senden
  while(!(SPSR & (1<<SPIF)));                    //Warten bis gesndet wurde
  
  SPDR =  SHORT_H_BYTE(PEC);                //H_Byte PEC_Befehl senden
  while(!(SPSR & (1<<SPIF)));                    //Warten bis gesndet wurde
  
  SPDR =  SHORT_L_BYTE(PEC);                //L_Byte PEC_Befehl senden
  while(!(SPSR & (1<<SPIF)));                    //Warten bis gesndet wurde
  
  if (Daten == 0) break;                         //wenn keine Daten gesendet werden sollen => Daten =0 => dann for schleife verlassen ansonsten wieder in Schleife eintreten
  }
  PORT_SPI  |=(1<<SS);
}  
  /** \endcode*/




/**\brief Funktion zum Auslesen eines 16 bit Wertes aus SPI Register

Fuer manche Abfragen muss man IC ein wenig Zeit geeben deswegen die moeglichkeit einen Delay zu uebergeben
*/
uint16_t SPI_empfangen     (uint8_t Anzahl_Bytes)
{
      uint16_t Empfangen=0;
      
      PORT_SPI &= ~(1<<SS);                      //SS auf Low => Kommunikation Starten
     //_delay_us     (5);
      
      for(uint8_t i=0;i<Anzahl_Bytes; i++)
      {
        SPDR =  0;                              //H_Byte Befehl senden
        while(!(SPSR & (1<<SPIF)));
      
      Empfangen |= SPDR;                        //Falsch!!! anders machen
       
       if (i > 0)
       {
          Empfangen =  (Empfangen <<8);
       }
      }
       PORT_SPI  |=(1<<SS);
      return Empfangen;
}

Habe jetzt schon lange gesucht aber bin irgendwie nicht wirklich fündig 
geworden. Manchmal ist das Manual von Doxygen irgendwie ein bisschen 
schwer zu deuten  :D.

Danke

[tictactoe (Gast)]

Das sollte gar nicht notwendig sein. In der erzeugten Doku gibt es einen 
Link zum Source-Code aus dem die Doku erzeugt worden ist. Kann aber 
sein, dass man dies im Doxyfile einschalten muss.

[Rolf M. (rmagnus)]

Verstehe ich das richtig, dass du den Quellcode der Funktion inline in 
die Doxygen-Doku integrieren willst, aber nur bei dieser einen Funktion 
und bei den anderen nicht?
Ich dachte, dass \code dazu dient, Code einzubinden, der im 
Doxygen-Kommentar selbst steht. In der Doku kann ich auch keinen Hinweis 
darauf erkennen, dass es möglich wäre, das so zu verwenden, wie du es 
tust.
Es gäbe noch \snippet, vielleicht hilft das.