General Purpose I/O Documentation

From Seamonster

Gen 3.2

• General                           Microservers, Vexcel Microservers, Quick Reference, Data Acquisition, Middleware
• Components                   GPS, SBC
• Configuration                   Microserver, SBC, SD Card, Power
• Operation                       Communication Protocol (SBC <--> uc), SBC Operations, Agent
• Operation (background)   Task Manager "milo", config files, MACRO
• Microcontroller                 Microcontroller, Firmware, Skeleton firmware
• Evaluation                       2008 Cairn relay failure evaluation, Lab evaluation, Eval-Firmware, BPMS, Source notes
• PCS Board                     PCS Board Design, Voltage Monitoring Circuit

Gen 3.1

• Gen 3.1 Kernel Upgrade and Field Notes (Spring 2007)
• Gen 3.1 Microserver, README, Schematics
• Gen 3.1 Task Manager "milo", GPS, Firmware

Microcontroller-related

• Power Management / Microcontroller documentation, Instruction Set, General Purpose I/O (GPIO)

Other Microserver-Related

• Project Technical Notes, Microserver GPS, EmStar

GPIO Example

// filename button.c
// connect a button to DIO pin 1 and ground
// blinks green and red led on the ts-7200 when button is pressed
//
// compile arm-linux-gcc -o button button.c
//
.
#include<unistd.h>
#include<sys/types.h>
#include<sys/mman.h>
#include<stdio.h>
#include<fcntl.h>
#include<string.h>
.
int main(int argc, char **argv)
{
  volatile unsigned int *PEDR, *PEDDR, *PBDR, *PBDDR, *GPIOBDB;
  int i;
  unsigned char state;
  unsigned char *start;
  int fd = open("/dev/mem", O_RDWR|O_SYNC);
.
  start = mmap(0, getpagesize(), PROT_READ|PROT_WRITE, MAP_SHARED, fd, 0x80840000);
  PBDR = (unsigned int *)(start + 0x04);     // port b
  PBDDR = (unsigned int *)(start + 0x14);    // port b direction register
  PEDR = (unsigned int *)(start + 0x20);     // port e data
  PEDDR = (unsigned int *)(start + 0x24);    // port e direction register
  GPIOBDB = (unsigned int *)(start + 0xC4);  // debounce on port b
.
  *PBDDR = 0xf0;			      // upper nibble output, lower nibble input
  *PEDDR = 0xff;                             // all output (just 2 bits)
  *GPIOBDB = 0x01;			      // enable debounce on bit 0
.   
  state = *PBDR;                             // read initial state
  while (state & 0x01) {                     // wait until button goes low
     state = *PBDR;                          // remember bit 0 is pulled up with 4.7k ohm
  }
. 
.
  // blink 5 times, sleep 1 second so it's visible
  for (i = 0; i < 5; i++) {
     *PEDR = 0xff;
     sleep(1);
     *PEDR = 0x00;
     sleep(1);
  }
  close(fd);
  return 0;
}

Jumper Configuration Example

#include<unistd.h>
#include<sys/types.h>
#include<sys/mman.h>
#include<stdio.h>
#include<fcntl.h>
#include<string.h>
.
#define TSSTATUS 0x10800000
#define TSJP6 0x22800000
.
// Queries jumper setting on TS-7200 and exits with return code according to
// jumper status
.
int main(int argc, char **argv) {
       off_t page;
       unsigned char *dat;
       unsigned short *dat16;
       unsigned char *start;
       int jp = -1, ret;
       int fd = open("/dev/mem", O_RDWR|O_SYNC);
. 
       if (argc != 2 || strcmp("-h", argv[1]) == 0 || 
         strcmp("--help", argv[1]) == 0) {
           fprintf(stdout, "Usage: jp [number]\n");
           return 1;
       }
.
       ret = sscanf(argv[1], "%d", &jp);
       if (ret == 0) {
         fprintf(stderr, "Usage: jp [number]\n");
         return 1;
       }
.
       if (fd == -1) {
         perror("/dev/mem");
         return 1;
       }
.
       if (jp != 6) {
         page = TSSTATUS & 0xfffff000;
         start = mmap(0, getpagesize(), PROT_READ|PROT_WRITE,
                      MAP_SHARED, fd, page);
         dat = (unsigned char *)(start + (TSSTATUS & 0xfff));
         switch (jp) {
           case 2:
             return ((*dat & 0x1) ? 0 : 1);
           case 3:
             return ((*dat & 0x2) ? 0 : 1);
           case 4:
             return ((*dat & 0x8) ? 1 : 0);
           case 5:
            return ((*dat & 0x10) ? 1 : 0);
         }
       } else if (jp == 6) {
         page = TSJP6 & 0xfffff000;
         start = mmap(0, getpagesize(), PROT_READ|PROT_WRITE, 
                      MAP_SHARED, fd, page);
         dat16 = (unsigned short *)(start + (TSJP6 & 0xfff));
         return ((*dat16 & 0x1) ? 0 : 1);
       } 
       close(fd);
       return 1;
}