1

Open a web browser, go tohttp://start.atmel.com, and selectCREATE NEW PROJECT.

2

Select a specific board for the project.

• Click on ‘Show only boards’ from the "RESULTS" section then select the ‘SAM D21 Xplained Pro’ board
• ClickCREATE NEW PROJECT to complete the project creation.

1

The I/O1 Xplained Pro uses a TEMT6000 light sensor. The sensor data can be read by an ADC pin on any Xplained Pro MCU board. Determine which pin from the SAM D21 Xplained Pro interfaces with it.

• Determine which pin on the I/O1 Explained Pro board is used for the light sensor.
  • TheI/O1 Xplained Pro Extension Kit User Guide specifies this:

• Determine which SAM D21 pin connects to pin 3 on the EXT2 interface.
  • TheSAM D21 Xplained Pro Users Guide specifies this:

Notice SAM D21 pin number PA10 (function AIN[18]) is connected to the light sensor.

2

Add the ADC driver:

• Atmel START displays the 'DASHBOARD' tab (left side) by default. Click theAdd software component button.

• Type 'ADC' in the 'Filter' field, look for the ADC driver and add it. You can also directly look for it in the 'Drivers' list.

3

Configure the ADC driver:

• Click on the 'ADC_0' component block to start its configuration.

• Configure ADC Component Settings:
  • Driver:HAL:Driver:ADC_Async

• Configure ADC Signals:
  • AIN/18 - PA10:Enabled

• Configure ADC Basic Configuration:
  • Positive Mux Input Selection:ADC AIN18 pin
  • Negative Mux Input Selection:Internal ground

The ADC driver is now configured.

1

Determine which pins from the SAM D21 Xplained Pro interface with the temperature sensor.

• Determine which pins on the I/O1 Explained Pro board is used for the temperature sensor.
  • TheI/O1 Xplained Pro Extension Kit User Guide specifies this:

• Determine which SAM D21 pins connect to pins 11 and 12 on the EXT2 interface.
  • TheSAM D21 Xplained Pro Users Guide specifies this:

Notice SAM D21 pin numbers PA08 and PA09 (function SERCOM2 I²C SDA and SCL) are connected to the temperature sensor.

2

Add the Temperature Sensor Middleware.

• Select 'DASHBOARD' and click ‘Add software component’.
• ExpandMiddleware > Sensors, find the Temperature Sensor middleware and click on it.
• ClickAdd component(s).

3

Configure the I²C driver.

• Click on the 'I2C_INSTANCE' component block to start its configuration.
• Configure the I²C Component Settings:
  • Driver:HAL:Driver:I2C_Master_Sync
  • Mode:I²C Master Standard/Fast-mode
  • Instance:SERCOM2
• Configure I²C Signals:
  • SCL:PA09
  • SDA:PA08
• Configure I²C Basic Configuration:
  • I²C Bus Clock speed (Hz):100 kHz

The I²C driver is now configured.

1

Save your Atmel START project.

• SelectSAVE CONFIGURATION.
• Click onDOWNLOAD CONFIGURATION.
• Provide a filename and location and then clickSave.

2

Export the project for the Studio 7 IDE.

• SelectEXPORT PROJECT thenDOWNLOAD PACK.
• Provide a filename and location, then clickSave.

1

Open Studio 7 and select:

• File > Import > Atmel Start Project

2

Browse to the project you exported from START (*.atzip) and clickOK. Your project is now created.

Note a default project name and location have been selected for you. Feel free to change these.

Want to see what these functions do?
Right-click on the function name and select 'Go to Implementation' to see the function definition (C file) and description (header file).
For more details, see theASF4 API Reference Manual.

1

In step 2, you configured the ADC driver as 'HAL:Driver:ADC_Async'. This means that the ADC takes a measurement and then generates an interrupt. The ADC interrupt then calls a callback function that will have to be implemented.

• Opendriver_examples.c (in theexamples folder) and copy the following functions:
  • convert_cb_ADC_0()
  • ADC_0_example()
• Paste them above themain() function in themain.c file.
• Rename theADC_0_example() function asADC_light_init().
• Rename theconvert_cb_ADC_0() function asconvert_cb_ADC().
• Updateconvert_cb_ADC() callback call inADC_light_init().

Your code should look like this:

2

Initialize the ADC by calling this function afteratmel_start_init():

• ADC_light_init();

3

Start an ADC conversion every second.
First, use the Delay driver you added to implement a one second delay.

• Add this delay function inside thewhile(1) loop inmain().
  • delay_ms(1000);

Now you have to call a function to start the conversion. TheADC_light_init() function uses thisstart conversion function, but it doesn't need to be in there.

• Cut the following function fromADC_light_init() and paste it after thedelay(1000) function:
  • adc_async_start_conversion(&ADC_0)

Yourmain.c should look like this:

4

Add code for ADC callback function.

• Add the following variable declaration after the include startement inmain.c. This is used to indicate if the conversion is completed or not.
  • volatile bool conversion_done = false;

• Update the ADC callback to indicate the conversion is done:
  • conversion_done = true;

• Wait for conversion done in the while loop:
  • while(!conversion_done);
  • conversion_done = false;

5

Declare a two-byte buffer to store the 12-bit ADC value from the light sensor.

• Add the following code to the variable declarations at the top ofmain.c:
  • uint8_t ADC_buffer[2];

6

Read the light sensor data.

• Call the following function in the while loop, once data is converted to read the 12-bit value.
  • adc_async_read_channel(&ADC_0, 0, ADC_buffer, 2);

1

Connect the SAM D21 Xplained Pro Evaluation Kit to your computer.

• Power-up your SAM D21 Xplained Pro board using DEBUG USB Connector.
• Please be patient as the driver installs (it may take a minute or so).

2

Select the embedded (on-board) debugger found on the SAM D21 XPRO board as the Debugger/Programmer for the project.

• Click onProject > Properties.

• SelectTool > EDBG … as debugger/programmer.

3

Compile the project and program the board.

• Compile the project by clicking on the 'Build Solution' icon or by typing ‘F7’, and verify that it builds successfully.

• Program the application by clicking on the 'Start Without Debugging' icon.

Your application is now running on the evaluation board.

1

Add your application code to retrieve the Temperature Sensor data over I²C.

• Calltemperature_sensors_init() afterADC_light_init() as shown below:

A global variable will be used to get temperature data.

• Add temperature global variable:
  • float temperature;

• Get the temperature using theat30tse75x_read() function:
  • temperature = at30tse75x_read(TEMPERATURE_SENSOR_0);

The I²C Temperature Sensor implementation is now completed.

2

Use aWatch window to view the temperature sensor value.

• Stop the debugger.

• Compile the project by clicking the 'Build Solution' icon or by typing ‘F7’, and verify it builds successfully.
• Launch the debugger by clicking the 'Start Debugging' icon then break the application by clicking the 'Break All' icon.
• Right-click on the temperature variable then 'Add Watch' (Unselect Hexadecimal Display).
• Put a breakpoint after theat30tse_read call and execute the application to get the temperature value:

Place your warm finger on the temperature sensor and click the debugger’s 'Continue' icon to verify the temperature rises as expected.