add examples

Author: oclyke

libraries/Apollo3/examples/AnalogWrite/AnalogWrite.ino

@@ -34,6 +34,9 @@
 */
 
 void setup() {
+  Serial.begin(115200);
+  Serial.println("Apollo3 - analogWrite");
+
   // pinMode is not needed for PWM output
 
   analogWrite(LED_BUILTIN, 127);    // 50% duty cycle w/ 8-bit resolution

libraries/Apollo3/examples/AttachInterrupt/AttachInterrupt.ino

@@ -0,0 +1,77 @@
+/* 
+// This file is subject to the terms and conditions defined in
+// file 'LICENSE.md', which is part of this source code package.
+*/
+
+#define INT_PIN 16
+#define AUTO_PIN D35 // connect this pin to INT_PIN for auto control
+
+rtos::Thread statusThread;
+
+volatile uint32_t count = 0;
+uint32_t expected_count = 0;
+
+void status_fn( void ){
+  while(1){
+    rtos::ThisThread::sleep_for(1000);
+    printf("time (ms): %d, count: %d, expected: %d, diff: %d\n", millis(), count, expected_count, (expected_count - count));
+    digitalWrite(LED_BUILTIN, (digitalRead(LED_BUILTIN)) ? LOW : HIGH);
+  }
+}
+
+void myISR(void){
+  count++;  // access count because it is a global variable
+}
+
+void myParamISR(void *arg){
+  uint32_t* pcount = (uint32_t *)arg;
+  *(pcount)++;  // access count via the passed in argument
+}
+
+void setup()
+{
+  Serial.begin(115200);
+  
+  printf("Apollo3 - attachInterrupt\n\n");
+
+  pinMode(LED_BUILTIN, OUTPUT);
+  pinMode(AUTO_PIN, OUTPUT);
+  
+  digitalWrite(AUTO_PIN, LOW);
+  digitalWrite(LED_BUILTIN, LOW);
+
+  pinMode(INT_PIN, INPUT_PULLUP);
+
+  // interrupts can occur on several kinds of conditions
+  attachInterrupt(INT_PIN, myISR, RISING);
+  attachInterrupt(INT_PIN, myISR, FALLING);
+  attachInterrupt(INT_PIN, myISR, LOW);
+  attachInterrupt(INT_PIN, myISR, HIGH);
+  attachInterrupt(INT_PIN, myISR, CHANGE);
+
+  // there is another function that you can use to attach an interrupt with parameters
+  // you can supply a pointer as the 'param' argument, this will be available in the 
+  // isr as the void* parameter
+  // attachInterruptParam(INT_PIN, myParamISR, INT_MODE, void* param);
+  attachInterruptParam(INT_PIN, myParamISR, RISING, (void*)&count);
+
+  // attaching a different interrupt to the same pin overwrites the existing ISR
+  attachInterrupt(INT_PIN, myISR, RISING);
+  
+  // finally you may notice that this example does not use 'digitalPinToInterrupt()'
+  // on the Apollo3 all digital pins are interrupts and they are identified by their
+  // normal pin numbers
+  // you may still use 'digitalPinToInterrupt()' for compatibility with legacy code
+  // #define digitalPinToInterrupt(P) (P)
+  // attachInterrupt(digitalPinToInterrupt(INT_PIN), myISR, INT_MODE);
+  // attachInterruptParam(digitalPinToInterrupt(INT_PIN), myParamISR, INT_MODE, void* param);
+
+  statusThread.start(status_fn);
+}
+
+void loop()
+{
+  expected_count++;
+  digitalWrite(AUTO_PIN, HIGH);
+  digitalWrite(AUTO_PIN, LOW);
+}

libraries/Apollo3/examples/DetachInterrupt/DetachInterrupt.ino

@@ -0,0 +1,74 @@
+/* 
+// This file is subject to the terms and conditions defined in
+// file 'LICENSE.md', which is part of this source code package.
+*/
+
+// Wiring:
+// INT_PIN <-> AUTO_PIN (for automatic interrupt generation)
+
+#define INT_PIN 16
+#define AUTO_PIN D35 // connect this pin to INT_PIN for auto control
+#define INT_TYPE RISING
+
+rtos::Thread autoISRThread;
+rtos::Thread heartbeatThread;
+
+volatile uint32_t count = 0;
+uint32_t expected_count = 0;
+volatile bool isr_flag = false;
+
+void myParamISR( void *param ){
+  isr_flag = true;
+  volatile uint32_t* pcount = (volatile uint32_t *)param;
+  *pcount += 1; // access count via the passed in parameter
+}
+
+void generateAutoISRs( void ){
+  while(1){
+    delay(1000);
+    expected_count++;
+    digitalWrite(AUTO_PIN, HIGH);
+    digitalWrite(AUTO_PIN, LOW);
+    digitalWrite(LED_BUILTIN, (digitalRead(LED_BUILTIN)) ? LOW : HIGH);
+    if(INT_TYPE == CHANGE){
+      expected_count++;
+    } 
+  }
+}
+
+void hearbeat( void ){
+  while(1){
+    delay(10000);
+    printf("blub blub. current time (ms): %d\n", millis());
+  }
+}
+
+void setup()
+{
+  printf("Apollo3 - detachInterrupt\n\n");
+
+  pinMode(LED_BUILTIN, OUTPUT);
+  digitalWrite(LED_BUILTIN, LOW);
+
+  pinMode(AUTO_PIN, OUTPUT);
+  digitalWrite(AUTO_PIN, LOW);
+
+  pinMode(INT_PIN, INPUT_PULLUP);
+  attachInterruptParam(INT_PIN, myParamISR, INT_TYPE, (void*)&count);
+
+  autoISRThread.start(generateAutoISRs);
+  heartbeatThread.start(hearbeat);
+}
+
+void loop()
+{
+  if(isr_flag){
+    isr_flag = false;
+    printf("isr fired. count: %d, expected: %d, diff: %d, time (ms): %d\n", count, expected_count, (expected_count - count), millis());
+    if(count >= 5){
+      count = 0;
+      printf("shutting off interrupts\n\n");
+      detachInterrupt(INT_PIN);
+    }
+  }
+}